---

vam-google · web-flow · commit a715617582c3 · 2017-08-11T14:09:36.000-07:00
yaml --- r: 8245 b: refs/heads/master c: 9ddeb40 h: refs/heads/master i: 8243: a73d27a
diff --git a/[refs] b/[refs]
@@ -1,5 +1,5 @@
 ---
-refs/heads/master: 2d5cbfe39ddd1b5334b0249d7f8196271a54a9d5
+refs/heads/master: 9ddeb40ad4440942493c3b98c6357129372cd11b
 refs/heads/travis: 47e4fee4fd5af9b2a8ce46f23c72ec95f9b195b2
 refs/heads/gh-pages: 0114589947fea527ea3831330789accedbecf45c
 refs/tags/0.0.9: 22f1839238f66c39e67ed4dfdcd273b1ae2e8444
diff --git a/trunk/TESTING.md b/trunk/TESTING.md
@@ -208,7 +208,9 @@ You can test against an in-memory local Resource Manager by following these step
 
 #### On your machine
 
-You can test against an in-memory local Storage by following these steps:
+You can test against an in-memory local Storage. The in-memory configuration supports only limited number of operations; please refer to the `LocalStorageHelper` class documentation for more details. Please use `RemoteStorageHelper` (see next section) if you need to use operations which are not supported by `LocalStorageHelper`. 
+
+To use the in-memory configuration please follow these steps:
 
 1. Follow the [Quickstart instructions][cloud-nio] to add the nio dependency to your project.
 2. In your program, create and use a fake Storage service object.  For example:
@@ -221,7 +223,7 @@ You can test against an in-memory local Storage by following these steps:
 
 #### Remote
 
-The alternative way of testing 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:
+The alternative way of testing is to create a test project. This way allows using operations not supported by the in-memory configuration.  `RemoteStorageHelper` contains convenience methods to make setting up and cleaning up the test project easier.  To use this class, follow the steps below:
 
 1. Create a test Google Cloud project.
 
diff --git a/trunk/google-cloud-contrib/google-cloud-nio/src/main/java/com/google/cloud/storage/contrib/nio/testing/LocalStorageHelper.java b/trunk/google-cloud-contrib/google-cloud-nio/src/main/java/com/google/cloud/storage/contrib/nio/testing/LocalStorageHelper.java
@@ -23,6 +23,31 @@
 /**
  * Utility to create an in-memory storage configuration for testing. Storage options can be
  * obtained via the {@link #getOptions()} method. Returned options will point to FakeStorageRpc.
+ *
+ * <p>Note, the created in-memory storage configuration supports limited set of operations and is <b>not</b> thread-safe:
+ * <ul>
+ * <li>Supported operations
+ *   <ul>
+ *   <li>object create
+ *   <li>object get
+ *   <li>object delete
+ *   <li>list the contents of a bucket
+ *   </ul>
+ * <li>Unsupported operations
+ *   <ul>
+ *   <li>bucket create
+ *   <li>bucket get
+ *   <li>bucket delete
+ *   <li>list all buckets
+ *   <li>generations
+ *   <li>file attributes
+ *   <li>patch
+ *   <li>continueRewrite
+ *   <li>createBatch
+ *   <li>checksums, etags
+ *   <li>IAM operations</li>
+ *   </ul>
+ * </ul>
  */
 public final class LocalStorageHelper {
 
