com.atlassian.confluence.internal.index.lucene

Class DefaultCustomSearchIndexRegistry

java.lang.Object

com.atlassian.confluence.internal.index.lucene.DefaultCustomSearchIndexRegistry

All Implemented Interfaces:

CustomSearchIndexRegistry

public class DefaultCustomSearchIndexRegistry
extends Object
implements CustomSearchIndexRegistry

see CustomSearchIndexRegistry

Since:

7.17

Constructor Summary

Constructors

Constructor and Description
DefaultCustomSearchIndexRegistry(LuceneFieldVisitor luceneFieldVisitor, LuceneSearchMapper luceneSearchMapper, CustomLuceneConnectionFactory customLuceneConnectionFactory)

Method Summary

Modifier and Type	Method and Description
SearchIndexAccessor	add(String name, String relativeIndexPath, ScoringStrategy scoringStrategy, AnalyzerDescriptorProvider analyzerDescriptorProvider) This method can be called multiple times but a new SearchIndexAccessor instance will be created only once for the first call.
void	destroy()
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.

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultCustomSearchIndexRegistry

public DefaultCustomSearchIndexRegistry(LuceneFieldVisitor luceneFieldVisitor,
                                        LuceneSearchMapper luceneSearchMapper,
                                        CustomLuceneConnectionFactory customLuceneConnectionFactory)

Method Detail

add

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

Description copied from interface: CustomSearchIndexRegistry

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.

Specified by:

add in interface CustomSearchIndexRegistry

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 seperators 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

public SearchIndexAccessor get(String name)
                        throws SearchIndexAccessException

Description copied from interface: CustomSearchIndexRegistry

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

Specified by:

get in interface CustomSearchIndexRegistry

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

public void remove(String name)
            throws SearchIndexAccessException

Description copied from interface: CustomSearchIndexRegistry

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

Specified by:

remove in interface CustomSearchIndexRegistry

Parameters:

name - the name of the custom index

Throws:

SearchIndexAccessException - if the custom search index does not exist

destroy

public void destroy()