com.atlassian.jira.issue.index
Interface IssueIndexManager

All Superinterfaces:

IndexLifecycleManager, Shutdown, Sized

All Known Implementing Classes:

BulkOnlyIndexManager, DefaultIndexManager

@PublicApi
public interface IssueIndexManager
extends IndexLifecycleManager

Manages Lucene search indexes.

Field Summary

static org.apache.lucene.util.Version

LUCENE_VERSION

Method Summary

void	deIndex(org.ofbiz.core.entity.GenericValue issue) Deprecated. Use deIndex(com.atlassian.jira.issue.Issue) instead. Since v5.0.
void	deIndex(Issue issue) Remove an issue from the search index.
org.apache.lucene.analysis.Analyzer	getAnalyzerForIndexing() Returns an Analyzer for indexing.
org.apache.lucene.analysis.Analyzer	getAnalyzerForSearching() Returns an Analyzer for searching.
org.apache.lucene.search.IndexSearcher	getChangeHistorySearcher() Get an IndexSearcher that can be used to search the change history index.
org.apache.lucene.search.IndexSearcher	getCommentSearcher() Get an IndexSearcher that can be used to search the comment index.
Collection<String>	getExistingPluginsPaths() Returns a collection of Strings, each one representing the absolute path to the actual existing directory where a plugin keeps its indexes.
org.apache.lucene.search.IndexSearcher	getIssueSearcher() Get an IndexSearcher that can be used to search the issue index.
String	getPluginsRootPath() Get the root path of the index directory for plugins.
void	reIndex(org.ofbiz.core.entity.GenericValue issue) Deprecated. Use reIndex(com.atlassian.jira.issue.Issue) instead. Since v5.0.
void	reIndex(Issue issue) Reindex an issue (eg.
long	reIndexAll() Reindex all issues.
long	reIndexIssueObjects(Collection<? extends Issue> issueObjects) Reindex a set of issues.
long	reIndexIssues(Collection<org.ofbiz.core.entity.GenericValue> issues) Deprecated. Use reIndexIssueObjects(java.util.Collection) instead. Since v5.0.
long	reIndexIssues(IssuesIterable issuesIterable, Context context) Reindex a list of issues, passing an optional event that will be set progress

Methods inherited from interface com.atlassian.jira.util.index.IndexLifecycleManager

activate, deactivate, getAllIndexPaths, isIndexingEnabled, optimize, reIndexAll, shutdown, size

Methods inherited from interface com.atlassian.jira.util.collect.Sized

isEmpty

Field Detail

LUCENE_VERSION

static final org.apache.lucene.util.Version LUCENE_VERSION

Method Detail

reIndexAll

long reIndexAll()
                throws IndexException

Reindex all issues.

Returns:

Reindex time in ms.

Throws:

IndexException

reIndex

void reIndex(org.ofbiz.core.entity.GenericValue issue)
             throws IndexException

Deprecated. Use reIndex(com.atlassian.jira.issue.Issue) instead. Since v5.0.

Reindex an issue (eg. after field updates).

Throws:

IndexException

reIndexIssues

long reIndexIssues(IssuesIterable issuesIterable,
                   Context context)
                   throws IndexException

Reindex a list of issues, passing an optional event that will be set progress

Parameters:

issuesIterable - IssuesIterable

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

Returns:

Reindex time in ms.

Throws:

IndexException

reIndex

void reIndex(Issue issue)
             throws IndexException

Reindex an issue (eg. after field updates).

Throws:

IndexException

deIndex

void deIndex(org.ofbiz.core.entity.GenericValue issue)
             throws IndexException

Deprecated. Use deIndex(com.atlassian.jira.issue.Issue) instead. Since v5.0.

Remove an issue from the search index.

Throws:

IndexException

deIndex

void deIndex(Issue issue)
             throws IndexException

Remove an issue from the search index.

Throws:

IndexException

reIndexIssues

long reIndexIssues(Collection<org.ofbiz.core.entity.GenericValue> issues)
                   throws IndexException

Deprecated. Use reIndexIssueObjects(java.util.Collection) instead. Since v5.0.

Reindex a set of issues (GenericValues). Use reIndexIssueObjects(Collection) instead when possible.

Parameters:

issues - The Issue GenericValues to reindex.

Returns:

Reindex time in ms.

Throws:

IndexException

reIndexIssueObjects

long reIndexIssueObjects(Collection<? extends Issue> issueObjects)
                         throws IndexException

Reindex a set of issues.

Parameters:

issueObjects - Set of Issues to reindex.

Returns:

Reindex time in ms.

Throws:

IndexException

getPluginsRootPath

String getPluginsRootPath()

Get the root path of the index directory for plugins. Any plugin that keeps indexes should create its own sub-directory under this path and create its indexes in its own sub-directory

getExistingPluginsPaths

Collection<String> getExistingPluginsPaths()

Returns a collection of Strings, each one representing the absolute path to the actual existing directory where a plugin keeps its indexes. Each directory in the collection should be a sub-directory under the plugin's index root path. See getPluginsRootPath().

If a plugin index root path does not exist, or is empty (no sub-directopries exist) then an empty collection will be returned.

getIssueSearcher

org.apache.lucene.search.IndexSearcher getIssueSearcher()

Get an IndexSearcher that can be used to search the issue index.

Note: This is an unmanaged IndexSearcher. You MUST call IndexSearcher.close() when you are done with it. Alternatively you should really call SearchProviderFactory#getSearcher(String)) passing in SearchProviderFactory.ISSUE_INDEX as it is a managed searcher and all the closing semantics are handled for you.

getCommentSearcher

org.apache.lucene.search.IndexSearcher getCommentSearcher()

Get an IndexSearcher that can be used to search the comment index.

Note: This is an unmanaged IndexSearcher. You MUST call IndexSearcher.close() when you are done with it. Alternatively you should really call SearchProviderFactory#getSearcher(String)) passing in SearchProviderFactory.COMMENT_INDEX as it is a managed searcher and all the closing semantics are handled for you.

getChangeHistorySearcher

org.apache.lucene.search.IndexSearcher getChangeHistorySearcher()

Get an IndexSearcher that can be used to search the change history index.

Note: This is an unmanaged IndexSearcher. You MUST call IndexSearcher.close() when you are done with it. Alternatively you should really call SearchProviderFactory#getSearcher(String)) passing in SearchProviderFactory.CHANGE_HISTORY_INDEX as it is a managed searcher and all the closing semantics are handled for you.

getAnalyzerForSearching

org.apache.lucene.analysis.Analyzer getAnalyzerForSearching()

Returns an Analyzer for searching.

Returns:

an analyzer for searching

getAnalyzerForIndexing

org.apache.lucene.analysis.Analyzer getAnalyzerForIndexing()

Returns an Analyzer for indexing.

Returns:

an analyzer for indexing.