[lucene-solr] 09/09: SOLR-13150 add some javadoc

[gu...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

gus pushed a commit to branch solr-13131
in repository https://gitbox.apache.org/repos/asf/lucene-solr.git

commit 01737e16c62e23e8034adda7a0b7ffaa61cf3388
Author: Gus Heck <gu...@apache.org>
AuthorDate: Tue Feb 19 09:51:50 2019 -0500

    SOLR-13150 add some javadoc
---
 .../apache/solr/cloud/api/collections/CategoryRoutedAlias.java    | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/solr/core/src/java/org/apache/solr/cloud/api/collections/CategoryRoutedAlias.java b/solr/core/src/java/org/apache/solr/cloud/api/collections/CategoryRoutedAlias.java
index a5a5bce..bf32609 100644
--- a/solr/core/src/java/org/apache/solr/cloud/api/collections/CategoryRoutedAlias.java
+++ b/solr/core/src/java/org/apache/solr/cloud/api/collections/CategoryRoutedAlias.java
@@ -148,6 +148,14 @@ public class CategoryRoutedAlias implements RoutedAlias {
     return aliasName + COLLECTION_INFIX + safeKeyValue(value);
   }
 
+  /**
+   * Method to possibly create a collection. It's possible that the collection will already have been created
+   * either by a prior invocation in this thread or another thread. This method is idempotent, multiple invocations
+   * are harmless.
+   *
+   * @param cmd The command that might cause collection creation
+   * @return the collection to which the the update should be directed, possibly a newly created collection.
+   */
   @Override
   public String createCollectionsIfRequired(AddUpdateCommand cmd) {
     SolrQueryRequest req = cmd.getReq();