Package com.atlassian.confluence.search.v2

Interface CustomSearchIndexRegistry

All Known Implementing Classes:

DefaultCustomSearchIndexRegistry, OpenSearchCustomSearchIndexRegistry

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, @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 Details

add

SearchIndexAccessor add(String name,
 @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 name is 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.

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