org.apache.solr.client.solrj

Class SolrServer

java.lang.Object

org.apache.solr.client.solrj.SolrServer

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

CommonsHttpSolrServer, ConcurrentUpdateSolrServer, EmbeddedSolrServer, HttpSolrServer, LBHttpSolrServer

public abstract class SolrServer
extends java.lang.Object
implements java.io.Serializable

Since:

solr 1.3

Version:

$Id: SolrServer.java 1235304 2012-01-24 15:39:17Z janhoy $

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
private DocumentObjectBinder	binder
private static long	serialVersionUID

Constructor Summary

Constructors

Constructor and Description
SolrServer()

Method Summary

Modifier and Type	Method and Description
UpdateResponse	add(java.util.Collection<SolrInputDocument> docs) Adds a collection of documents
UpdateResponse	add(java.util.Collection<SolrInputDocument> docs, int commitWithinMs) Adds a collection of documents, specifying max time before they become committed
UpdateResponse	add(SolrInputDocument doc) Adds a single document
UpdateResponse	add(SolrInputDocument doc, int commitWithinMs) Adds a single document specifying max time before it becomes committed
UpdateResponse	addBean(java.lang.Object obj) Adds a single bean
UpdateResponse	addBean(java.lang.Object obj, int commitWithinMs) Adds a single bean specifying max time before it becomes committed
UpdateResponse	addBeans(java.util.Collection<?> beans) Adds a collection of beans
UpdateResponse	addBeans(java.util.Collection<?> beans, int commitWithinMs) Adds a collection of beans specifying max time before they become committed
UpdateResponse	commit() Performs an explicit commit, causing pending documents to be committed for indexing
UpdateResponse	commit(boolean waitFlush, boolean waitSearcher) Performs an explicit commit, causing pending documents to be committed for indexing
UpdateResponse	deleteById(java.util.List<java.lang.String> ids) Deletes a list of documents by unique ID
UpdateResponse	deleteById(java.util.List<java.lang.String> ids, int commitWithinMs) Deletes a list of documents by unique ID, specifying max time before commit
UpdateResponse	deleteById(java.lang.String id) Deletes a single document by unique ID
UpdateResponse	deleteById(java.lang.String id, int commitWithinMs) Deletes a single document by unique ID, specifying max time before commit
UpdateResponse	deleteByQuery(java.lang.String query) Deletes documents from the index based on a query
UpdateResponse	deleteByQuery(java.lang.String query, int commitWithinMs) Deletes documents from the index based on a query, specifying max time before commit
DocumentObjectBinder	getBinder()
UpdateResponse	optimize() Performs an explicit optimize, causing a merge of all segments to one.
UpdateResponse	optimize(boolean waitFlush, boolean waitSearcher) Performs an explicit optimize, causing a merge of all segments to one.
UpdateResponse	optimize(boolean waitFlush, boolean waitSearcher, int maxSegments) Performs an explicit optimize, causing a merge of all segments to one.
SolrPingResponse	ping() Issues a ping request to check if the server is alive
QueryResponse	query(SolrParams params) Performs a query to the Solr server
QueryResponse	query(SolrParams params, SolrRequest.METHOD method) Performs a query to the Solr server
abstract NamedList<java.lang.Object>	request(SolrRequest request) SolrServer implementations need to implement how a request is actually processed
UpdateResponse	rollback() Performs a rollback of all non-committed documents pending.

Methods inherited from class java.lang.Object

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

Field Detail

serialVersionUID

private static final long serialVersionUID

See Also:

Constant Field Values

binder

private DocumentObjectBinder binder

Constructor Detail

SolrServer

public SolrServer()

Method Detail

add

public UpdateResponse add(java.util.Collection<SolrInputDocument> docs)
                   throws SolrServerException,
                          java.io.IOException

Adds a collection of documents

Parameters:

docs - the collection of documents

Throws:

SolrServerException

java.io.IOException

add

public UpdateResponse add(java.util.Collection<SolrInputDocument> docs,
                          int commitWithinMs)
                   throws SolrServerException,
                          java.io.IOException

Adds a collection of documents, specifying max time before they become committed

Parameters:

docs - the collection of documents

commitWithinMs - max time (in ms) before a commit will happen

Throws:

SolrServerException

java.io.IOException

Since:

solr 3.5

addBeans

public UpdateResponse addBeans(java.util.Collection<?> beans)
                        throws SolrServerException,
                               java.io.IOException

Adds a collection of beans

Parameters:

beans - the collection of beans

Throws:

SolrServerException

java.io.IOException

addBeans

public UpdateResponse addBeans(java.util.Collection<?> beans,
                               int commitWithinMs)
                        throws SolrServerException,
                               java.io.IOException

Adds a collection of beans specifying max time before they become committed

Parameters:

beans - the collection of beans

commitWithinMs - max time (in ms) before a commit will happen

Throws:

SolrServerException

java.io.IOException

Since:

solr 3.5

add

public UpdateResponse add(SolrInputDocument doc)
                   throws SolrServerException,
                          java.io.IOException

Adds a single document

Parameters:

doc - the input document

Throws:

SolrServerException

java.io.IOException

add

public UpdateResponse add(SolrInputDocument doc,
                          int commitWithinMs)
                   throws SolrServerException,
                          java.io.IOException

Adds a single document specifying max time before it becomes committed

Parameters:

doc - the input document

commitWithinMs - max time (in ms) before a commit will happen

Throws:

SolrServerException

java.io.IOException

Since:

solr 3.5

addBean

public UpdateResponse addBean(java.lang.Object obj)
                       throws java.io.IOException,
                              SolrServerException

Adds a single bean

Parameters:

obj - the input bean

Throws:

SolrServerException

java.io.IOException

addBean

public UpdateResponse addBean(java.lang.Object obj,
                              int commitWithinMs)
                       throws java.io.IOException,
                              SolrServerException

Adds a single bean specifying max time before it becomes committed

Parameters:

obj - the input bean

commitWithinMs - max time (in ms) before a commit will happen

Throws:

SolrServerException

java.io.IOException

Since:

solr 3.5

commit

public UpdateResponse commit()
                      throws SolrServerException,
                             java.io.IOException

Performs an explicit commit, causing pending documents to be committed for indexing

waitFlush=true and waitSearcher=true to be inline with the defaults for plain HTTP access

Throws:

SolrServerException

java.io.IOException

optimize

public UpdateResponse optimize()
                        throws SolrServerException,
                               java.io.IOException

Performs an explicit optimize, causing a merge of all segments to one.

waitFlush=true and waitSearcher=true to be inline with the defaults for plain HTTP access

Note: In most cases it is not required to do explicit optimize

Throws:

SolrServerException

java.io.IOException

commit

public UpdateResponse commit(boolean waitFlush,
                             boolean waitSearcher)
                      throws SolrServerException,
                             java.io.IOException

Performs an explicit commit, causing pending documents to be committed for indexing

Parameters:

waitFlush - block until index changes are flushed to disk

waitSearcher - block until a new searcher is opened and registered as the main query searcher, making the changes visible

Throws:

SolrServerException

java.io.IOException

optimize

public UpdateResponse optimize(boolean waitFlush,
                               boolean waitSearcher)
                        throws SolrServerException,
                               java.io.IOException

Performs an explicit optimize, causing a merge of all segments to one.

Note: In most cases it is not required to do explicit optimize

Parameters:

waitFlush - block until index changes are flushed to disk

waitSearcher - block until a new searcher is opened and registered as the main query searcher, making the changes visible

Throws:

SolrServerException

java.io.IOException

optimize

public UpdateResponse optimize(boolean waitFlush,
                               boolean waitSearcher,
                               int maxSegments)
                        throws SolrServerException,
                               java.io.IOException

Performs an explicit optimize, causing a merge of all segments to one.

Note: In most cases it is not required to do explicit optimize

Parameters:

waitFlush - block until index changes are flushed to disk

waitSearcher - block until a new searcher is opened and registered as the main query searcher, making the changes visible

maxSegments - optimizes down to at most this number of segments

Throws:

SolrServerException

java.io.IOException

rollback

public UpdateResponse rollback()
                        throws SolrServerException,
                               java.io.IOException

Performs a rollback of all non-committed documents pending.

Note that this is not a true rollback as in databases. Content you have previously added may have been committed due to autoCommit, buffer full, other client performing a commit etc.

Throws:

SolrServerException

java.io.IOException

deleteById

public UpdateResponse deleteById(java.lang.String id)
                          throws SolrServerException,
                                 java.io.IOException

Deletes a single document by unique ID

Parameters:

id - the ID of the document to delete

Throws:

SolrServerException

java.io.IOException

deleteById

public UpdateResponse deleteById(java.lang.String id,
                                 int commitWithinMs)
                          throws SolrServerException,
                                 java.io.IOException

Deletes a single document by unique ID, specifying max time before commit

Parameters:

id - the ID of the document to delete

commitWithinMs - max time (in ms) before a commit will happen

Throws:

SolrServerException

java.io.IOException

Since:

3.6

deleteById

public UpdateResponse deleteById(java.util.List<java.lang.String> ids)
                          throws SolrServerException,
                                 java.io.IOException

Deletes a list of documents by unique ID

Parameters:

ids - the list of document IDs to delete

Throws:

SolrServerException

java.io.IOException

deleteById

public UpdateResponse deleteById(java.util.List<java.lang.String> ids,
                                 int commitWithinMs)
                          throws SolrServerException,
                                 java.io.IOException

Deletes a list of documents by unique ID, specifying max time before commit

Parameters:

ids - the list of document IDs to delete

commitWithinMs - max time (in ms) before a commit will happen

Throws:

SolrServerException

java.io.IOException

Since:

3.6

deleteByQuery

public UpdateResponse deleteByQuery(java.lang.String query)
                             throws SolrServerException,
                                    java.io.IOException

Deletes documents from the index based on a query

Parameters:

query - the query expressing what documents to delete

Throws:

SolrServerException

java.io.IOException

deleteByQuery

public UpdateResponse deleteByQuery(java.lang.String query,
                                    int commitWithinMs)
                             throws SolrServerException,
                                    java.io.IOException

Deletes documents from the index based on a query, specifying max time before commit

Parameters:

query - the query expressing what documents to delete

commitWithinMs - max time (in ms) before a commit will happen

Throws:

SolrServerException

java.io.IOException

Since:

3.6

ping

public SolrPingResponse ping()
                      throws SolrServerException,
                             java.io.IOException

Issues a ping request to check if the server is alive

Throws:

SolrServerException

java.io.IOException

query

public QueryResponse query(SolrParams params)
                    throws SolrServerException

Performs a query to the Solr server

Parameters:

params - an object holding all key/value parameters to send along the request

Throws:

SolrServerException

query

public QueryResponse query(SolrParams params,
                           SolrRequest.METHOD method)
                    throws SolrServerException

Performs a query to the Solr server

Parameters:

params - an object holding all key/value parameters to send along the request

method - specifies the HTTP method to use for the request, such as GET or POST

Throws:

SolrServerException

request

public abstract NamedList<java.lang.Object> request(SolrRequest request)
                                             throws SolrServerException,
                                                    java.io.IOException

SolrServer implementations need to implement how a request is actually processed

Throws:

SolrServerException

java.io.IOException

getBinder

public DocumentObjectBinder getBinder()