---

mderka · aozarov · commit 8f1f6ba7a979 · 2016-04-14T16:39:22.000-07:00
yaml --- r: 7205 b: refs/heads/tswast-patch-1 c: 527c656 h: refs/heads/master i: 7203: 89cfe46
diff --git a/[refs] b/[refs]
@@ -57,5 +57,5 @@ refs/tags/v0.18.0: 9d193c4c4b9d1c6f21515dd8e50836b9194ec9bb
 refs/tags/v0.19.0: e67b56e4d8dad5f9a7b38c9b2107c23c828f2ed5
 refs/tags/v0.20.0: 839f7fb7156535146aa1cb2c5aadd8d375d854e8
 refs/tags/v0.20.1: 370471f437f1f4f68a11e068df5cd6bf39edb1fa
-refs/heads/tswast-patch-1: 7d7b799c4ab14b6c0fd90520bc1060533607a1fe
+refs/heads/tswast-patch-1: 527c656bcb783a8d05dbfbd4f36d743dc8e7cc14
 refs/heads/pubsub-streaming-pull: 19262b752ee874eb2ca3b950eb2aef44d5a5267b
diff --git a/branches/tswast-patch-1/TESTING.md b/branches/tswast-patch-1/TESTING.md
@@ -54,6 +54,40 @@ We recommend that you start the emulator on the remote machine using the [Google
 gcloud beta emulators datastore start --host-port <hostname of machine>:<port>
 ```
 
+### Testing code that uses DNS
+
+#### On your machine
+
+You can test against an in-memory local DNS by following these steps:
+
+1. Before running your testing code, start the DNS emulator `LocalDnsHelper`. This can be done as follows:
+
+  ```java
+  long delay = 0;
+  LocalDnsHelper helper = LocalDnsHelper.create(delay);
+  helper.start();
+  ```
+
+  This will spawn a server thread that listens to `localhost` at an ephemeral port for DNS requests.
+  The `delay` parameter determines if change requests should be processed synchronously
+  (value `0`) or in a separate thread with a minimum of delay of `delay` milliseconds.
+
+2. In your program, create the DNS service by using the helper's `options()` method.  For example:
+
+  ```java
+  Dns dns = LocalDnsHelper.options().service();
+  ```
+
+3. Run your tests.
+
+4. Stop the DNS emulator.
+
+  ```java
+  helper.stop();
+  ```
+
+  This method will block until the server thread has been terminated.
+
 ### Testing code that uses Storage
 
 Currently, there isn't an emulator for Google Cloud Storage, so an alternative is to create a test project.  `RemoteStorageHelper` contains convenience methods to make setting up and cleaning up the test project easier.  To use this class, follow the steps below:
@@ -84,7 +118,7 @@ Here is an example that clears the bucket created in Step 3 with a timeout of 5
 
 #### On your machine
 
-You can test against a temporary local Resource Manager by following these steps:
+You can test against an in-memory local Resource Manager by following these steps:
 
 1. Before running your testing code, start the Resource Manager emulator `LocalResourceManagerHelper`. This can be done as follows:
 
