org.openrdf.sail.lucene

Class AbstractSearchIndex

java.lang.Object

org.openrdf.sail.lucene.AbstractSearchIndex

All Implemented Interfaces:

SearchIndex

Direct Known Subclasses:

AbstractLuceneIndex

public abstract class AbstractSearchIndex
extends Object
implements SearchIndex

Field Summary

Fields

Modifier and Type	Field and Description
protected int	maxDocs

Constructor Summary

Constructors

Constructor and Description
AbstractSearchIndex()

Method Summary

Modifier and Type	Method and Description
boolean	accept(Literal literal) Returns whether the provided literal is accepted by the LuceneIndex to be indexed.
protected abstract void	addDocument(SearchDocument doc)
void	addDocuments(Resource subject, List<Statement> statements) Add a complete Lucene Document based on these statements.
void	addRemoveStatements(Collection<Statement> added, Collection<Statement> removed) Add many statements at the same time, remove many statements at the same time.
void	addStatement(Statement statement) Indexes the specified Statement.
protected abstract SearchDocument	copyDocument(SearchDocument doc)
protected abstract void	deleteDocument(SearchDocument doc)
Collection<BindingSet>	evaluate(QuerySpec query)
protected abstract SearchDocument	getDocument(String id)
protected abstract Iterable<? extends SearchDocument>	getDocuments(String resourceId)
protected Resource	getResource(SearchDocument document) Returns the Resource corresponding with the specified Document.
void	initialize(Properties parameters)
protected abstract BulkUpdater	newBulkUpdate()
protected abstract SearchDocument	newDocument(String id, String resourceId, String context)
protected abstract SearchQuery	parseQuery(String q, URI property)
void	removeStatement(Statement statement) Removes the specified Statement from the indexes.
protected abstract void	updateDocument(SearchDocument doc)

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.openrdf.sail.lucene.SearchIndex

begin, beginReading, clear, clearContexts, commit, endReading, rollback, shutDown

Field Detail

maxDocs

protected int maxDocs

Constructor Detail

AbstractSearchIndex

public AbstractSearchIndex()

Method Detail

initialize

public void initialize(Properties parameters)
                throws Exception

Specified by:

initialize in interface SearchIndex

Throws:

Exception

accept

public boolean accept(Literal literal)

Returns whether the provided literal is accepted by the LuceneIndex to be indexed. It for instance does not make much since to index xsd:float.

Specified by:

accept in interface SearchIndex

Parameters:

literal - the literal to be accepted

Returns:

true if the given literal will be indexed by this LuceneIndex

addStatement

public final void addStatement(Statement statement)
                        throws IOException

Indexes the specified Statement.

Specified by:

addStatement in interface SearchIndex

Throws:

IOException

removeStatement

public final void removeStatement(Statement statement)
                           throws IOException

Description copied from interface: SearchIndex

Removes the specified Statement from the indexes. This should be called from within a begin-commit-rollback block.

Specified by:

removeStatement in interface SearchIndex

Throws:

IOException

addRemoveStatements

public final void addRemoveStatements(Collection<Statement> added,
                                      Collection<Statement> removed)
                               throws IOException

Add many statements at the same time, remove many statements at the same time. Ordering by resource has to be done inside this method. The passed added/removed sets are disjunct, no statement can be in both

Specified by:

addRemoveStatements in interface SearchIndex

Parameters:

added - all added statements, can have multiple subjects

removed - all removed statements, can have multiple subjects

Throws:

IOException

addDocuments

public final void addDocuments(Resource subject,
                               List<Statement> statements)
                        throws IOException

Add a complete Lucene Document based on these statements. Do not search for an existing document with the same subject id. (assume the existing document was deleted)

Specified by:

addDocuments in interface SearchIndex

Parameters:

statements - the statements that make up the resource

Throws:

IOException

evaluate

public final Collection<BindingSet> evaluate(QuerySpec query)
                                      throws SailException

Specified by:

evaluate in interface SearchIndex

Throws:

SailException

getResource

protected Resource getResource(SearchDocument document)

Returns the Resource corresponding with the specified Document.

getDocument

protected abstract SearchDocument getDocument(String id)
                                       throws IOException

Throws:

IOException

getDocuments

protected abstract Iterable<? extends SearchDocument> getDocuments(String resourceId)
                                                            throws IOException

Throws:

IOException

newDocument

protected abstract SearchDocument newDocument(String id,
                                              String resourceId,
                                              String context)

copyDocument

protected abstract SearchDocument copyDocument(SearchDocument doc)

addDocument

protected abstract void addDocument(SearchDocument doc)
                             throws IOException

Throws:

IOException

updateDocument

protected abstract void updateDocument(SearchDocument doc)
                                throws IOException

Throws:

IOException

deleteDocument

protected abstract void deleteDocument(SearchDocument doc)
                                throws IOException

Throws:

IOException

parseQuery

protected abstract SearchQuery parseQuery(String q,
                                          URI property)
                                   throws MalformedQueryException

Throws:

MalformedQueryException

newBulkUpdate

protected abstract BulkUpdater newBulkUpdate()