@InjectableComponent public interface

LuceneDirectoryUtils

com.atlassian.jira.util.LuceneDirectoryUtils
Known Indirect Subclasses

Summary

Public Methods
void createDirRobust(String path)
Creates a directory (robustly) or throws appropriate Exception
Directory getDirectory(File path)
Creates an index directory for the given path on the filesystem.
Collection<String> getStaleLockPaths(Collection<String> indexDirectoryPaths)
Given a Collection of paths that represent index directories checks if there are any existing Lucene lock files for the passed paths.

Public Methods

public void createDirRobust (String path)

Creates a directory (robustly) or throws appropriate Exception

Parameters
path Lucene index directory path
Throws
IOException if cannot create directory, write to the directory, or not a directory

public Directory getDirectory (File path)

Creates an index directory for the given path on the filesystem.

Parameters
path to the index directory.
Returns
Throws
IOException if there is a problem when creating the index directory for the given path.

public Collection<String> getStaleLockPaths (Collection<String> indexDirectoryPaths)

Given a Collection of paths that represent index directories checks if there are any existing Lucene lock files for the passed paths. This method returns a Collection of file paths of any existing Lucene lock files. If no lock files are found an empty collection is returned.

A common usage of this methdo would be:

 Collection existingLockFilepaths = LuceneUtils.getStaleLockPaths(indexManager.getAllIndexPaths());
 

Parameters
indexDirectoryPaths collection of index directory paths
Returns
  • collection of file paths of any existing Lucene lock files