com.atlassian.jira.sharing.index

Class DefaultSharedEntityIndexManager

java.lang.Object

com.atlassian.jira.sharing.index.DefaultSharedEntityIndexManager

All Implemented Interfaces:

BackupContributor, SharedEntityIndexManager, Sized, IndexLifecycleManager, Shutdown

public class DefaultSharedEntityIndexManager
extends Object
implements SharedEntityIndexManager

Default IndexManager for shared entities

Since:

v3.13

Constructor Summary

Constructors

Constructor and Description
DefaultSharedEntityIndexManager(SharedEntityIndexer indexer, SearchRequestManager searchRequestManager, PortalPageManager portalPageManager, FileFactory fileFactory, ApplicationProperties applicationProperties, IndexBackupContributorsManager indexBackupContributorsManager)

Method Summary

Modifier and Type	Method and Description
long	activate(Context context) Activates search indexes.
long	activate(Context context, boolean reindex) Activates search indexes.
void	contributeToBackup(BackupBuilder backupBuilder) Contribute a set of files to the given backupBuilder to include them in the backup being created when this method was called.
void	deactivate() De-activates indexing (as happens from the admin page) and removes index directories.
Collection<String>	getAllIndexPaths()
boolean	isEmpty()
boolean	isIndexAvailable() Whether this index is available.
boolean	isIndexConsistent()
boolean	isIndexingEnabled()
long	optimize() Optimize the underlying indexes.
long	reIndexAll()
long	reIndexAll(Context context) Reindex everything.
long	reIndexAll(Context context, IssueIndexingParams issueIndexingParams) Reindex indexes defined by the IssueIndexingParams.
long	reIndexAllIssuesInBackground(Context context) Reindex everything, but don't stop the world Comments and change history will not be reindexed.
long	reIndexAllIssuesInBackground(Context context, boolean reIndexComments, boolean reIndexChangeHistory) Reindex everything, but don't stop the world
long	reIndexIssuesInBackground(Context context, IssueIndexingParams issueIndexingParams) Reindex everything, but don't stop the world
long	reIndexSharedEntities(Context context, IssueIndexingParams issueIndexingParams, Set<SharedEntity.TypeDescriptor> sharedEntityTypes) Reindex the specified shared entity types.
void	shutdown() Shuts down the indexing manager and closes its resources (if any).
int	size()
String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

DefaultSharedEntityIndexManager

public DefaultSharedEntityIndexManager(SharedEntityIndexer indexer,
                                       SearchRequestManager searchRequestManager,
                                       PortalPageManager portalPageManager,
                                       FileFactory fileFactory,
                                       ApplicationProperties applicationProperties,
                                       IndexBackupContributorsManager indexBackupContributorsManager)

Method Detail

reIndexAll

public long reIndexAll(Context context)

Description copied from interface: IndexLifecycleManager

Reindex everything.

Specified by:

reIndexAll in interface IndexLifecycleManager

Parameters:

context - used to report progress back to the user or to the logs. Must not be null.

Returns:

Reindex time in ms.

reIndexAll

public long reIndexAll(Context context,
                       IssueIndexingParams issueIndexingParams)

Description copied from interface: IndexLifecycleManager

Reindex indexes defined by the IssueIndexingParams.

Specified by:

reIndexAll in interface IndexLifecycleManager

Parameters:

context - used to report progress back to the user or to the logs. Must not be null.

issueIndexingParams - indexes to reindex.

Returns:

Reindex time in ms.

reIndexSharedEntities

public long reIndexSharedEntities(@Nonnull
                                  Context context,
                                  @Nonnull
                                  IssueIndexingParams issueIndexingParams,
                                  @Nonnull
                                  Set<SharedEntity.TypeDescriptor> sharedEntityTypes)

Description copied from interface: SharedEntityIndexManager

Reindex the specified shared entity types.

Specified by:

reIndexSharedEntities in interface SharedEntityIndexManager

Parameters:

context - used to report progress back to the user or to the logs.

issueIndexingParams - indexes to reindex.

sharedEntityTypes - the shared entity types to reindex.

Returns:

Reindex time in ms.

reIndexAll

public long reIndexAll()
                throws IndexException

Throws:

IndexException

reIndexAllIssuesInBackground

public long reIndexAllIssuesInBackground(Context context)

Description copied from interface: IndexLifecycleManager

Reindex everything, but don't stop the world Comments and change history will not be reindexed.

Specified by:

reIndexAllIssuesInBackground in interface IndexLifecycleManager

Parameters:

context - used to report progress back to the user or to the logs. Must not be null.

Returns:

Reindex time in ms.

reIndexAllIssuesInBackground

public long reIndexAllIssuesInBackground(Context context,
                                         boolean reIndexComments,
                                         boolean reIndexChangeHistory)

Description copied from interface: IndexLifecycleManager

Reindex everything, but don't stop the world

Specified by:

reIndexAllIssuesInBackground in interface IndexLifecycleManager

Parameters:

context - used to report progress back to the user or to the logs. Must not be null.

reIndexComments - Also reindex all the issue comments.

reIndexChangeHistory - Also reindex the issue change history.

Returns:

Reindex time in ms.

reIndexIssuesInBackground

public long reIndexIssuesInBackground(Context context,
                                      IssueIndexingParams issueIndexingParams)

Description copied from interface: IndexLifecycleManager

Reindex everything, but don't stop the world

Specified by:

reIndexIssuesInBackground in interface IndexLifecycleManager

Parameters:

context - used to report progress back to the user or to the logs. Must not be null.

issueIndexingParams - determines witch related objects should be indexed together with issue.

Returns:

Reindex time in ms.

optimize

public long optimize()

Description copied from interface: IndexLifecycleManager

Optimize the underlying indexes. Make the subsequent searching more efficient.

Specified by:

optimize in interface IndexLifecycleManager

Returns:

the amount of time in millis this method took (because you are too lazy to time me), 0 if indexing is not enabled or -1 if we cannot obtain the index writeLock.

shutdown

public void shutdown()

Description copied from interface: IndexLifecycleManager

Shuts down the indexing manager and closes its resources (if any).

Specified by:

shutdown in interface IndexLifecycleManager

Specified by:

shutdown in interface Shutdown

activate

public long activate(Context context,
                     boolean reindex)

Description copied from interface: IndexLifecycleManager

Activates search indexes.

Specified by:

activate in interface IndexLifecycleManager

Parameters:

context - used to report progress back to the user or to the logs. Must not be null.

reindex - reindex after activation.

Returns:

Reindex time in ms

activate

public long activate(Context context)

Description copied from interface: IndexLifecycleManager

Activates search indexes. This will rebuild the indexes.

Specified by:

activate in interface IndexLifecycleManager

Parameters:

context - used to report progress back to the user or to the logs. Must not be null.

Returns:

Reindex time in ms

deactivate

public void deactivate()

Description copied from interface: IndexLifecycleManager

De-activates indexing (as happens from the admin page) and removes index directories.

Specified by:

deactivate in interface IndexLifecycleManager

isIndexingEnabled

public boolean isIndexingEnabled()

Specified by:

isIndexingEnabled in interface IndexLifecycleManager

Returns:

whether this index is enabled or true if all sub indexes are enabled

isIndexAvailable

public boolean isIndexAvailable()

Description copied from interface: IndexLifecycleManager

Whether this index is available. The index is not available if the index is being rebuilt or recovered. In a clustered environment this reflects only the state on the local node.

Specified by:

isIndexAvailable in interface IndexLifecycleManager

Returns:

Whether this index is available.

isIndexConsistent

public boolean isIndexConsistent()

Specified by:

isIndexConsistent in interface IndexLifecycleManager

Returns:

the result of a simple consistency check that compares the index state to the current number of issues. A background re-index should not be attempted when this returns false. Note that false is also returned if the index is not available IndexLifecycleManager.isIndexAvailable().

getAllIndexPaths

public Collection<String> getAllIndexPaths()

Specified by:

getAllIndexPaths in interface IndexLifecycleManager

Returns:

a collection of Strings that map to all paths that contain Lucene indexes. Must not be null.

size

public int size()

Specified by:

size in interface Sized

Specified by:

size in interface IndexLifecycleManager

Returns:

how many Entities will be re-indexed by IndexLifecycleManager.reIndexAll(Context)

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface Sized

toString

public String toString()

Overrides:

toString in class Object

contributeToBackup

public void contributeToBackup(BackupBuilder backupBuilder)

Description copied from interface: BackupContributor

Contribute a set of files to the given backupBuilder to include them in the backup being created when this method was called.

Specified by:

contributeToBackup in interface BackupContributor

Parameters:

backupBuilder - builder of the backup being created at the time of call. All existing and nonempty files passed to its accept method will be included. The builder may not be reusable and the reference should not be stored outside the scope of this method