[ SEARCH-1717 ] Javadoc + logging (WARN level) for LRIS and EXPLICIT_ID+LRIS router

This commit is contained in:
agazzarini
2019-07-26 18:37:50 +02:00
parent 2e36156138
commit e71c97ce6c
2 changed files with 17 additions and 3 deletions

View File

@@ -62,10 +62,10 @@ public class DocRouterFactory
LOGGER.info("Sharding via PROPERTY");
return new PropertyRouter(properties.getProperty("shard.regex", ""));
case LAST_REGISTERED_INDEXING_SHARD:
LOGGER.info("Sharding via LAST_REGISTERED_INDEXING_SHARD");
LOGGER.warn("Sharding via LAST_REGISTERED_INDEXING_SHARD: Note this is available at the moment as an Early Access/preview feature!");
return new ExplicitShardIdWithStaticPropertyRouter();
case EXPLICIT_ID_FALLBACK_LRIS:
LOGGER.info("Sharding via EXPLICIT_ID_FALLBACK_LRIS");
LOGGER.warn("Sharding via EXPLICIT_ID_FALLBACK_LRIS: Note the LRIS Router (which is part of this composite router) is available at the moment as an Early Access/preview feature!");
return new DocRouterWithFallback(
new ExplicitShardIdWithDynamicPropertyRouter(false),
new ExplicitShardIdWithStaticPropertyRouter());

View File

@@ -24,11 +24,25 @@ import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
/**
* Routes the incoming nodes (not ACLs!) on the last registered indexing shard (LRIS).
* Routes the incoming nodes (not ACLs!) on the shard explicitly indicated in {@link Node#getExplicitShardId()} method.
* The access control information is duplicated in each shard.
*
* <p><br/><b>
* WARNING: This {@link DocRouter} is part of an early access/preview routing feature called
* Last-Registered-Indexing-Shard (LRIS), where the {@link Node#getExplicitShardId()} is filled with the identifier of
* the last Master Shard which subscribed the cluster.
*
* </b><br/><br/>
* </p>
*
* Specifically, until the whole feature will be officially released, the LRIS document routing feature is not compatible
* with the "Purge" action on the Alfresco Admin Console.
* Note that at time of writing, the "Purge on startup" option in the Admin Console is enabled by default so prior to
* build your search cluster, you have to make sure that option is unchecked.
*
* @author Elia
* @author agazzarini
* @since 1.4
*/
public class ExplicitShardIdWithStaticPropertyRouter extends ComposableDocRouter
{