---

mderka · aozarov · commit 5b5d511e39e2 · 2016-04-14T16:39:22.000-07:00
yaml --- r: 3897 b: refs/heads/pubsub-alpha c: 527c656 h: refs/heads/master i: 3895: 3b249cb
diff --git a/[refs] b/[refs]
@@ -2,7 +2,7 @@
 refs/heads/master: 36a62ef856d199f8efd09501b5ba65c422c01f23
 refs/heads/travis: e21ee7b88a5edc3f3d8c71f90c3fc32abf7e8dd6
 refs/heads/gh-pages: 7406918e071dd2c5677a638ae2a06e7592b6542c
-refs/heads/pubsub-alpha: 7d7b799c4ab14b6c0fd90520bc1060533607a1fe
+refs/heads/pubsub-alpha: 527c656bcb783a8d05dbfbd4f36d743dc8e7cc14
 refs/heads/update-datastore: 47aae517c2cb33f1dccd909adaced73ec9d0f4df
 refs/tags/0.0.9: 22f1839238f66c39e67ed4dfdcd273b1ae2e8444
 refs/tags/v0.0.10: 207ebd2a3472fddee69fe1298eb90429e3306efd
diff --git a/branches/pubsub-alpha/TESTING.md b/branches/pubsub-alpha/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:
 
