org.opencms.search.solr
Class CmsSolrIndexWriter

java.lang.Object
  org.opencms.search.solr.CmsSolrIndexWriter

All Implemented Interfaces:

I_CmsIndexWriter

public class CmsSolrIndexWriter
extends java.lang.Object
implements I_CmsIndexWriter

Implements the index writer for the Solr server used by OpenCms.

Since:

8.5.0

Field Summary

protected static org.apache.commons.logging.Log

LOG The log object for this class.

Constructor Summary

CmsSolrIndexWriter(org.apache.solr.client.solrj.SolrServer server)
Constructor to create a Solr index writer.

CmsSolrIndexWriter(org.apache.solr.client.solrj.SolrServer server, CmsSolrIndex index)
Creates a new index writer based on the provided standard Lucene IndexWriter for the provided OpenCms search index instance.

Method Summary

void	close() Close this IndexWriter.
void	commit() Commit all previous operations.
void	deleteAllDocuments() Deletes all documents of the index belonging to this index writer.
void	deleteDocuments(java.lang.String rootPath) Delete a document from the index.
void	optimize() Optimizes the index.
void	updateDocument(java.lang.String rootPath, I_CmsSearchDocument document) Update a document in the index.

Methods inherited from class java.lang.Object

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

Field Detail

LOG

protected static final org.apache.commons.logging.Log LOG

The log object for this class.

Constructor Detail

CmsSolrIndexWriter

public CmsSolrIndexWriter(org.apache.solr.client.solrj.SolrServer server)

Constructor to create a Solr index writer.

Parameters:

server - the server to use

CmsSolrIndexWriter

public CmsSolrIndexWriter(org.apache.solr.client.solrj.SolrServer server,
                          CmsSolrIndex index)

Creates a new index writer based on the provided standard Lucene IndexWriter for the provided OpenCms search index instance.

The OpenCms search instance is currently used only for improved logging of the index operations.

Parameters:

server - the standard Lucene IndexWriter to use as delegate

index - the OpenCms search index instance this writer to supposed to write to

Method Detail

close

public void close()

Description copied from interface: I_CmsIndexWriter

Close this IndexWriter.

Specified by:

close in interface I_CmsIndexWriter

See Also:

I_CmsIndexWriter.close()

commit

public void commit()
            throws java.io.IOException

Description copied from interface: I_CmsIndexWriter

Commit all previous operations.

Specified by:

commit in interface I_CmsIndexWriter

Throws:

java.io.IOException

See Also:

I_CmsIndexWriter.commit()

deleteAllDocuments

public void deleteAllDocuments()
                        throws java.io.IOException

Deletes all documents of the index belonging to this index writer.

Throws:

java.io.IOException - if something goes wrong

deleteDocuments

public void deleteDocuments(java.lang.String rootPath)
                     throws java.io.IOException

Description copied from interface: I_CmsIndexWriter

Delete a document from the index.

Specified by:

deleteDocuments in interface I_CmsIndexWriter

Parameters:

rootPath - the root path of the document to delete

Throws:

java.io.IOException - in case something goes wrong

See Also:

I_CmsIndexWriter.deleteDocuments(java.lang.String)

optimize

public void optimize()

Description copied from interface: I_CmsIndexWriter

Optimizes the index.

Please note that as of Lucene 3.5, the direct use of optimize is discouraged as Lucene apparently is now able to manage the file structure so efficiently that frequent optimizations are not longer required.

Specified by:

optimize in interface I_CmsIndexWriter

See Also:

I_CmsIndexWriter.optimize()

updateDocument

public void updateDocument(java.lang.String rootPath,
                           I_CmsSearchDocument document)
                    throws java.io.IOException

Description copied from interface: I_CmsIndexWriter

Update a document in the index.

Specified by:

updateDocument in interface I_CmsIndexWriter

Parameters:

rootPath - the root path of the document to update

document - the document to update

Throws:

java.io.IOException - in case something goes wrong

See Also:

I_CmsIndexWriter.updateDocument(java.lang.String, org.opencms.search.I_CmsSearchDocument)