Merged HEAD-BUG-FIX (5.1/Cloud) to HEAD (5.1/Cloud)

99376: BENCH-371: BM-0004: Copy Alfresco and set up build plan
    - Modify FileContentStore to service 'spoof://' URLs
    - SpoofedTextContentReader to generate consistent text for URL
    - Fix FileContentStoreTest so that tests actually execute
    - Add override for @After so that no NPEs are thrown
    - Add tests for the 'spoof://' protocol
    - Some additional checks for IllegalArgumentException on SpoofedTextContentReader construction
    - Force delete of 'spoof' to return false but not fail with an exception
      This is handled neatly by the EagerContentStoreCleaner, which accepts that the stores may protect data according to their own needs e.g. Centera
    - Add spoofing option to FileFolderPerformanceTester
      290 files/s for 1K files vs 460 files/s for spoofed text files (no binary streaming required)
    - Start FileFolderLoader component that will be used by the API  


git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/alfresco/HEAD/root@99502 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261

source/java/org/alfresco/repo/admin/RepositoryState.java

@@ -21,6 +21,8 @@ package org.alfresco.repo.admin;
 import java.util.concurrent.locks.ReentrantReadWriteLock;
 
 /**
+ * A class that maintains a thread-safe ready indicator on the current bootstrap state of the repository.
+ * 
  * @author Andy
  *
  */
@@ -29,6 +31,12 @@ public class RepositoryState
     private boolean bootstrapping;
     private final ReentrantReadWriteLock lock = new ReentrantReadWriteLock();
 
+    /**
+     * Determine if the repository is ready to use.
+     * 
+     * @return                  <tt>true</tt> if the repository bootstrap process is still going,
+     *                          or <tt>false</tt> if the repository is ready to use
+     */
     public boolean isBootstrapping()
     {
         this.lock.readLock().lock();