org.apache.maven.index.context

Class MergedIndexingContext

java.lang.Object

org.apache.maven.index.context.AbstractIndexingContext

org.apache.maven.index.context.MergedIndexingContext

All Implemented Interfaces:

IndexingContext

public class MergedIndexingContext
extends AbstractIndexingContext

A merged indexing context that offers read only "view" on multiple other indexing contexts merged and presented as one. Usable for searching and publishing, but all write operations are basically noop.

Author:

cstamas

Field Summary

Fields inherited from interface org.apache.maven.index.context.IndexingContext

INDEX_CHAIN_ID, INDEX_CHUNK_COUNTER, INDEX_CHUNK_PREFIX, INDEX_FILE_PREFIX, INDEX_ID, INDEX_LEGACY_TIMESTAMP, INDEX_PACKER_PROPERTIES_FILE, INDEX_PROPERTY_PREFIX, INDEX_REMOTE_PROPERTIES_FILE, INDEX_TIME_DAY_FORMAT, INDEX_TIME_FORMAT, INDEX_TIMESTAMP, INDEX_UPDATER_PROPERTIES_FILE

Constructor Summary

Constructors

Constructor and Description
MergedIndexingContext(String id, String repositoryId, File repository, org.apache.lucene.store.Directory indexDirectory, boolean searchable, ContextMemberProvider membersProvider) Deprecated.
MergedIndexingContext(String id, String repositoryId, File repository, File indexDirectoryFile, boolean searchable, ContextMemberProvider membersProvider)

Method Summary

Modifier and Type	Method and Description
org.apache.lucene.search.IndexSearcher	acquireIndexSearcher() Acquires a fresh instance of IndexSearcher.
void	close(boolean deleteFiles) Shuts down this context.
void	commit() Commits changes to context, eventually refreshing readers/searchers too.
Set<String>	getAllGroups() Gets all group names stored in the current indexing context
org.apache.lucene.analysis.Analyzer	getAnalyzer() Returns the Lucene Analyzer of this context used for by IndexWriter and IndexSearcher.
GavCalculator	getGavCalculator() Returns the GavCalculator for this Context.
String	getId() Returns this indexing context id.
List<IndexCreator>	getIndexCreators() List of IndexCreators used in this context.
org.apache.lucene.store.Directory	getIndexDirectory()
File	getIndexDirectoryFile()
String	getIndexUpdateUrl() Returns url for the index update
org.apache.lucene.index.IndexWriter	getIndexWriter() Returns the Lucene IndexWriter (thread safe, shared instance) of this context.
Collection<IndexingContext>	getMembers()
File	getRepository() Returns location for the local repository.
String	getRepositoryId() Returns repository id.
String	getRepositoryUrl() Returns public repository url.
Set<String>	getRootGroups() Gets root group names stored in the current indexing context
int	getSize() Returns a number that represents the "size" useful for doing comparisons between contexts (which one has more data indexed?).
Date	getTimestamp() Returns index update time
boolean	isSearchable() Is the context searchable when doing "non-targeted" searches?
void	merge(org.apache.lucene.store.Directory directory) Merges content of given Lucene directory with this context.
void	merge(org.apache.lucene.store.Directory directory, DocumentFilter filter) Merges content of given Lucene directory with this context, but filters out the unwanted ones.
void	optimize() Optimizes index.
void	purge() Purge (cleans) the context, deletes/empties the index and restores the context to new/empty state.
void	rebuildGroups() Rebuilds stored group names from the index
void	releaseIndexSearcher(org.apache.lucene.search.IndexSearcher indexSearcher) Releases the IndexSearcher instance.
void	replace(org.apache.lucene.store.Directory directory) Replaces the Lucene index with the one from supplied directory.
void	replace(org.apache.lucene.store.Directory directory, Set<String> allGroups, Set<String> rootGroups)
void	rollback() Rolls back changes to context, eventually refreshing readers/searchers too.
void	setAllGroups(Collection<String> groups) Sets all group names stored in the current indexing context
protected void	setIndexDirectoryFile(File dir) Sets index location.
void	setRootGroups(Collection<String> groups) Sets root group names stored in the current indexing context
void	setSearchable(boolean searchable) Sets is the context searchable when doing "non-targeted" searches.
void	updateTimestamp()
void	updateTimestamp(boolean save)
void	updateTimestamp(boolean save, Date date)

Methods inherited from class org.apache.maven.index.context.AbstractIndexingContext

isReceivingUpdates

Methods inherited from class java.lang.Object

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

Constructor Detail

MergedIndexingContext

public MergedIndexingContext(String id,
                             String repositoryId,
                             File repository,
                             File indexDirectoryFile,
                             boolean searchable,
                             ContextMemberProvider membersProvider)
                      throws IOException

Throws:

IOException

MergedIndexingContext

@Deprecated
public MergedIndexingContext(String id,
                                          String repositoryId,
                                          File repository,
                                          org.apache.lucene.store.Directory indexDirectory,
                                          boolean searchable,
                                          ContextMemberProvider membersProvider)
                                   throws IOException

Deprecated.

Throws:

IOException

Method Detail

getMembers

public Collection<IndexingContext> getMembers()

getId

public String getId()

Description copied from interface: IndexingContext

Returns this indexing context id.

getRepositoryId

public String getRepositoryId()

Description copied from interface: IndexingContext

Returns repository id.

getRepository

public File getRepository()

Description copied from interface: IndexingContext

Returns location for the local repository.

getRepositoryUrl

public String getRepositoryUrl()

Description copied from interface: IndexingContext

Returns public repository url.

getIndexUpdateUrl

public String getIndexUpdateUrl()

Description copied from interface: IndexingContext

Returns url for the index update

isSearchable

public boolean isSearchable()

Description copied from interface: IndexingContext

Is the context searchable when doing "non-targeted" searches? Ie. Should it take a part when searching without specifying context?

Returns:

setSearchable

public void setSearchable(boolean searchable)

Description copied from interface: IndexingContext

Sets is the context searchable when doing "non-targeted" searches.

getTimestamp

public Date getTimestamp()

Description copied from interface: IndexingContext

Returns index update time

updateTimestamp

public void updateTimestamp()
                     throws IOException

Throws:

IOException

updateTimestamp

public void updateTimestamp(boolean save)
                     throws IOException

Throws:

IOException

updateTimestamp

public void updateTimestamp(boolean save,
                            Date date)
                     throws IOException

Throws:

IOException

getSize

public int getSize()
            throws IOException

Description copied from interface: IndexingContext

Returns a number that represents the "size" useful for doing comparisons between contexts (which one has more data indexed?). The number return does not represent the count of ArtifactInfos, neither other "meaningful" info, it is purely to be used for inter-context comparisons only!

Returns:

Throws:

IOException

acquireIndexSearcher

public org.apache.lucene.search.IndexSearcher acquireIndexSearcher()
                                                            throws IOException

Description copied from interface: IndexingContext

Acquires a fresh instance of IndexSearcher. You have to release the received instance with IndexingContext.releaseIndexSearcher(IndexSearcher) otherwise you are about to introduce leak.

Returns:

Throws:

IOException

releaseIndexSearcher

public void releaseIndexSearcher(org.apache.lucene.search.IndexSearcher indexSearcher)
                          throws IOException

Description copied from interface: IndexingContext

Releases the IndexSearcher instance.

Throws:

IOException

getIndexWriter

public org.apache.lucene.index.IndexWriter getIndexWriter()
                                                   throws IOException

Description copied from interface: IndexingContext

Returns the Lucene IndexWriter (thread safe, shared instance) of this context.

Returns:

indexWriter

Throws:

IOException

getIndexCreators

public List<IndexCreator> getIndexCreators()

Description copied from interface: IndexingContext

List of IndexCreators used in this context.

Returns:

list of index creators.

getAnalyzer

public org.apache.lucene.analysis.Analyzer getAnalyzer()

Description copied from interface: IndexingContext

Returns the Lucene Analyzer of this context used for by IndexWriter and IndexSearcher. Note: this method always creates a new instance of analyzer!

Returns:

commit

public void commit()
            throws IOException

Description copied from interface: IndexingContext

Commits changes to context, eventually refreshing readers/searchers too.

Throws:

IOException

rollback

public void rollback()
              throws IOException

Description copied from interface: IndexingContext

Rolls back changes to context, eventually refreshing readers/searchers too.

Throws:

IOException

optimize

public void optimize()
              throws IOException

Description copied from interface: IndexingContext

Optimizes index. According to Lucene 3.6+ Javadoc, there is no more sense to optimize, so this method might become "noop".

Throws:

IOException

close

public void close(boolean deleteFiles)
           throws IOException

Description copied from interface: IndexingContext

Shuts down this context.

Throws:

IOException

purge

public void purge()
           throws IOException

Description copied from interface: IndexingContext

Purge (cleans) the context, deletes/empties the index and restores the context to new/empty state.

Throws:

IOException

merge

public void merge(org.apache.lucene.store.Directory directory)
           throws IOException

Description copied from interface: IndexingContext

Merges content of given Lucene directory with this context.

Parameters:

directory - - the directory to merge

Throws:

IOException

merge

public void merge(org.apache.lucene.store.Directory directory,
                  DocumentFilter filter)
           throws IOException

Description copied from interface: IndexingContext

Merges content of given Lucene directory with this context, but filters out the unwanted ones.

Parameters:

directory - - the directory to merge

Throws:

IOException

replace

public void replace(org.apache.lucene.store.Directory directory)
             throws IOException

Description copied from interface: IndexingContext

Replaces the Lucene index with the one from supplied directory.

Throws:

IOException

replace

public void replace(org.apache.lucene.store.Directory directory,
                    Set<String> allGroups,
                    Set<String> rootGroups)
             throws IOException

Throws:

IOException

getIndexDirectory

public org.apache.lucene.store.Directory getIndexDirectory()

getIndexDirectoryFile

public File getIndexDirectoryFile()

setIndexDirectoryFile

protected void setIndexDirectoryFile(File dir)
                              throws IOException

Sets index location. As usually index is persistent (is on disk), this will point to that value, but in some circumstances (ie, using RAMDisk for index), this will point to an existing tmp directory.

Throws:

IOException

getGavCalculator

public GavCalculator getGavCalculator()

Description copied from interface: IndexingContext

Returns the GavCalculator for this Context. Implies repository layout.

setAllGroups

public void setAllGroups(Collection<String> groups)
                  throws IOException

Description copied from interface: IndexingContext

Sets all group names stored in the current indexing context

Throws:

IOException

getAllGroups

public Set<String> getAllGroups()
                         throws IOException

Description copied from interface: IndexingContext

Gets all group names stored in the current indexing context

Throws:

IOException

setRootGroups

public void setRootGroups(Collection<String> groups)
                   throws IOException

Description copied from interface: IndexingContext

Sets root group names stored in the current indexing context

Throws:

IOException

getRootGroups

public Set<String> getRootGroups()
                          throws IOException

Description copied from interface: IndexingContext

Gets root group names stored in the current indexing context

Throws:

IOException

rebuildGroups

public void rebuildGroups()
                   throws IOException

Description copied from interface: IndexingContext

Rebuilds stored group names from the index

Throws:

IOException