Package com.atlassian.confluence.search.v2

Interface CustomSearchIndexRegistry

All Known Implementing Classes:

DefaultCustomSearchIndexRegistry

public interface CustomSearchIndexRegistry

This interface is available to plugins and allows 3rd-party vendors to add their own custom indexes

Since:

7.17

Method Summary

Modifier and Type	Method	Description
SearchIndexAccessor	add(String name, String relativeIndexPath, ScoringStrategy scoringStrategy, @Nullable AnalyzerDescriptorProvider analyzerDescriptorProvider)	This method can be called multiple times but a new SearchIndexAccessor instance will be created only once for the first call.
SearchIndexAccessor	get(String name)	This method returns the SearchIndexAccessor corresponding to the index represented by its unique name.
void	remove(String name)	Remove the custom index from the registry.

Method Detail

add

SearchIndexAccessor add(String name,
                        String relativeIndexPath,
                        ScoringStrategy scoringStrategy,
                        @Nullable AnalyzerDescriptorProvider analyzerDescriptorProvider)
                 throws SearchIndexAccessException

This method can be called multiple times but a new SearchIndexAccessor instance will be created only once for the first call. The same instance will be returned by subsequent calls to the method with the same name.

It is highly recommended that the prefix name and relativeIndexPath are prefixed with the plugin key to avoid naming conflicts and/or unintentionally sharing indexes with another plugin.

Parameters:

name - the unique name of the custom index. The name should have a plugin key as its prefix to avoid naming conflicts. If the custom index directory is not created, it will be created under the default index directory.

relativeIndexPath - the path relative to the confluence lucene index directory expressed as a String. You must use forward slashes as separators i.e. plugin/usage. Underlying impl is filesystem independent.

scoringStrategy - the scoring strategy that will be used to scan the documents.

analyzerDescriptorProvider - provider for a MappingAnalyzerDescriptor representing a Lucene Analyzer, or null if KeywordAnalyzer is used.

Returns:

a SearchIndexAccessor that can access to this custom index.

Throws:

SearchIndexAccessException

get

SearchIndexAccessor get(String name)
                 throws SearchIndexAccessException

This method returns the SearchIndexAccessor corresponding to the index represented by its unique name.

Parameters:

name - the name of the custom index

Returns:

a SearchIndexAccessor that can access to this custom index

Throws:

SearchIndexAccessException - if the custom search index does not exist

remove

void remove(String name)
     throws SearchIndexAccessException

Remove the custom index from the registry. The internal lucene connection will be also closed.

Parameters:

name - the name of the custom index

Throws:

SearchIndexAccessException - if the custom search index does not exist