org.apache.solr.client.solrj.impl

类 BaseCloudSolrClient

java.lang.Object

org.apache.solr.client.solrj.SolrClient

org.apache.solr.client.solrj.impl.BaseCloudSolrClient

所有已实现的接口:

Closeable, Serializable, AutoCloseable

直接已知子类:

CloudHttp2SolrClient, CloudSolrClient

public abstract class BaseCloudSolrClient
extends SolrClient

另请参阅:

序列化表格

嵌套类概要

嵌套类

限定符和类型	类和说明
static class	BaseCloudSolrClient.RouteException
static class	BaseCloudSolrClient.RouteResponse<T extends LBSolrClient.Req>

字段概要

字段

限定符和类型	字段和说明
protected org.apache.solr.client.solrj.impl.BaseCloudSolrClient.StateCache	collectionStateCache
static String	STATE_VERSION

构造器概要

构造器

限定符	构造器和说明
protected	BaseCloudSolrClient(boolean updatesToLeaders, boolean parallelUpdates, boolean directUpdatesToLeadersOnly)

方法概要

限定符和类型	方法和说明
void	close()
BaseCloudSolrClient.RouteResponse	condenseResponse(NamedList response, int timeMillis)
protected <T extends BaseCloudSolrClient.RouteResponse> T	condenseResponse(NamedList response, int timeMillis, Supplier<T> supplier)
void	connect() Connect to the zookeeper ensemble.
void	connect(long duration, TimeUnit timeUnit) Connect to a cluster.
protected Map<String,? extends LBSolrClient.Req>	createRoutes(UpdateRequest updateRequest, ModifiableSolrParams routableParams, DocCollection col, DocRouter router, Map<String,List<String>> urlMap, String routeField)
abstract ClusterStateProvider	getClusterStateProvider()
String	getDefaultCollection() Gets the default collection for request
protected DocCollection	getDocCollection(String collection, Integer expectedVersion)
String	getIdField() 已过时。
protected abstract LBSolrClient	getLbClient()
int	getMinAchievedReplicationFactor(String collection, NamedList resp) Useful for determining the minimum achieved replication factor across all shards involved in processing an update request, typically useful for gauging the replication factor of a batch.
ResponseParser	getParser()
RequestWriter	getRequestWriter()
protected BaseCloudSolrClient.RouteException	getRouteException(SolrException.ErrorCode serverError, NamedList<Throwable> exceptions, Map<String,? extends LBSolrClient.Req> routes)
Map<String,Integer>	getShardReplicationFactor(String collection, NamedList resp) Walks the NamedList response after performing an update request looking for the replication factor that was achieved in each shard involved in the request.
String	getZkHost()
ZkStateReader	getZkStateReader()
boolean	isDirectUpdatesToLeadersOnly()
boolean	isParallelUpdates() Gets whether direct updates are sent in parallel
boolean	isUpdatesToLeaders()
protected static ArrayList<Object>	objectList(int n)
void	registerCollectionStateWatcher(String collection, CollectionStateWatcher watcher) Register a CollectionStateWatcher to be called when the cluster state for a collection changes or the set of live nodes changes.
void	registerDocCollectionWatcher(String collection, DocCollectionWatcher watcher) Register a DocCollectionWatcher to be called when the cluster state for a collection changes.
NamedList<Object>	request(SolrRequest request, String collection) Execute a request against a Solr server for a given collection
protected NamedList<Object>	requestWithRetryOnStaleState(SolrRequest request, int retryCount, List<String> inputCollections) As this class doesn't watch external collections on the client side, there's a chance that the request will fail due to cached stale state, which means the state must be refreshed from ZK and retried.
protected NamedList<Object>	sendRequest(SolrRequest request, List<String> inputCollections)
void	setCollectionCacheTTl(int seconds) Sets the cache ttl for DocCollection Objects cached .
void	setDefaultCollection(String collection) Sets the default collection for request
void	setIdField(String routeField) 已过时。
void	setParallelCacheRefreshes(int n) If caches are expired they are refreshed after acquiring a lock.
void	setParser(ResponseParser processor) Note: This setter method is not thread-safe.
void	setRequestWriter(RequestWriter requestWriter)
void	setRetryExpiryTime(int secs) This is the time to wait to refetch the state after getting the same state version from ZK secs
void	setRouteAliasCollection(boolean routeAliasCollection)
void	setZkClientTimeout(int zkClientTimeout) Set the timeout to the zookeeper ensemble in ms
void	setZkConnectTimeout(int zkConnectTimeout) Set the connect timeout to the zookeeper ensemble in ms
void	waitForState(String collection, long wait, TimeUnit unit, CollectionStatePredicate predicate) Block until a CollectionStatePredicate returns true, or the wait times out Note that the predicate may be called again even after it has returned true, so implementors should avoid changing state within the predicate call itself.
void	waitForState(String collection, long wait, TimeUnit unit, Predicate<DocCollection> predicate) Block until a Predicate returns true, or the wait times out Note that the predicate may be called again even after it has returned true, so implementors should avoid changing state within the predicate call itself.
protected abstract boolean	wasCommError(Throwable t)

从类继承的方法 org.apache.solr.client.solrj.SolrClient

add, add, add, add, add, add, add, add, add, add, addBean, addBean, addBean, addBean, addBeans, addBeans, addBeans, addBeans, addBeans, addBeans, commit, commit, commit, commit, commit, commit, deleteById, deleteById, deleteById, deleteById, deleteById, deleteById, deleteById, deleteById, deleteByQuery, deleteByQuery, deleteByQuery, deleteByQuery, getBinder, getById, getById, getById, getById, getById, getById, getById, getById, optimize, optimize, optimize, optimize, optimize, optimize, ping, ping, query, query, query, query, queryAndStreamResponse, queryAndStreamResponse, queryAndStreamResponse, request, rollback, rollback

从类继承的方法 java.lang.Object

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

字段详细资料

STATE_VERSION

public static final String STATE_VERSION

另请参阅:

常量字段值

collectionStateCache

protected final org.apache.solr.client.solrj.impl.BaseCloudSolrClient.StateCache collectionStateCache

构造器详细资料

BaseCloudSolrClient

protected BaseCloudSolrClient(boolean updatesToLeaders,
                              boolean parallelUpdates,
                              boolean directUpdatesToLeadersOnly)

方法详细资料

setRetryExpiryTime

public void setRetryExpiryTime(int secs)

This is the time to wait to refetch the state after getting the same state version from ZK

secs

setRouteAliasCollection

public void setRouteAliasCollection(boolean routeAliasCollection)

setCollectionCacheTTl

public void setCollectionCacheTTl(int seconds)

Sets the cache ttl for DocCollection Objects cached . This is only applicable for collections which are persisted outside of clusterstate.json

参数:

seconds - ttl value in seconds

getLbClient

protected abstract LBSolrClient getLbClient()

getClusterStateProvider

public abstract ClusterStateProvider getClusterStateProvider()

wasCommError

protected abstract boolean wasCommError(Throwable t)

close

public void close()
           throws IOException

抛出:

IOException

getParser

public ResponseParser getParser()

setParser

public void setParser(ResponseParser processor)

Note: This setter method is not thread-safe.

参数:

processor - Default Response Parser chosen to parse the response if the parser were not specified as part of the request.

另请参阅:

SolrRequest.getResponseParser()

getRequestWriter

public RequestWriter getRequestWriter()

setRequestWriter

public void setRequestWriter(RequestWriter requestWriter)

getZkHost

public String getZkHost()

返回:

the zkHost value used to connect to zookeeper.

getZkStateReader

public ZkStateReader getZkStateReader()

setIdField

@Deprecated
public void setIdField(String routeField)

已过时。

参数:

routeField - the field to route documents on.

getIdField

@Deprecated
public String getIdField()

已过时。

返回:

the field that updates are routed on.

setDefaultCollection

public void setDefaultCollection(String collection)

Sets the default collection for request

getDefaultCollection

public String getDefaultCollection()

Gets the default collection for request

setZkConnectTimeout

public void setZkConnectTimeout(int zkConnectTimeout)

Set the connect timeout to the zookeeper ensemble in ms

setZkClientTimeout

public void setZkClientTimeout(int zkClientTimeout)

Set the timeout to the zookeeper ensemble in ms

isParallelUpdates

public boolean isParallelUpdates()

Gets whether direct updates are sent in parallel

connect

public void connect()

Connect to the zookeeper ensemble. This is an optional method that may be used to force a connect before any other requests are sent.

connect

public void connect(long duration,
                    TimeUnit timeUnit)
             throws TimeoutException,
                    InterruptedException

Connect to a cluster. If the cluster is not ready, retry connection up to a given timeout.

参数:

duration - the timeout

timeUnit - the units of the timeout

抛出:

TimeoutException - if the cluster is not ready after the timeout

InterruptedException - if the wait is interrupted

waitForState

public void waitForState(String collection,
                         long wait,
                         TimeUnit unit,
                         CollectionStatePredicate predicate)
                  throws InterruptedException,
                         TimeoutException

Block until a CollectionStatePredicate returns true, or the wait times out

Note that the predicate may be called again even after it has returned true, so implementors should avoid changing state within the predicate call itself.

This implementation utilizes CollectionStateWatcher internally. Callers that don't care about liveNodes are encouraged to use a DocCollection Predicate instead

参数:

collection - the collection to watch

wait - how long to wait

unit - the units of the wait parameter

predicate - a CollectionStatePredicate to check the collection state

抛出:

InterruptedException - on interrupt

TimeoutException - on timeout

另请参阅:

waitForState(String, long, TimeUnit, Predicate), registerCollectionStateWatcher(java.lang.String, org.apache.solr.common.cloud.CollectionStateWatcher)

waitForState

public void waitForState(String collection,
                         long wait,
                         TimeUnit unit,
                         Predicate<DocCollection> predicate)
                  throws InterruptedException,
                         TimeoutException

Block until a Predicate returns true, or the wait times out

Note that the predicate may be called again even after it has returned true, so implementors should avoid changing state within the predicate call itself.

参数:

collection - the collection to watch

wait - how long to wait

unit - the units of the wait parameter

predicate - a Predicate to test against the DocCollection

抛出:

InterruptedException - on interrupt

TimeoutException - on timeout

另请参阅:

registerDocCollectionWatcher(java.lang.String, org.apache.solr.common.cloud.DocCollectionWatcher)

registerCollectionStateWatcher

public void registerCollectionStateWatcher(String collection,
                                           CollectionStateWatcher watcher)

Register a CollectionStateWatcher to be called when the cluster state for a collection changes or the set of live nodes changes.

The Watcher will automatically be removed when it's onStateChanged returns true

This implementation utilizes ZkStateReader.registerCollectionStateWatcher(java.lang.String, org.apache.solr.common.cloud.CollectionStateWatcher) internally. Callers that don't care about liveNodes are encouraged to use a DocCollectionWatcher instead

参数:

collection - the collection to watch

watcher - a watcher that will be called when the state changes

另请参阅:

registerDocCollectionWatcher(String, DocCollectionWatcher), ZkStateReader.registerCollectionStateWatcher(java.lang.String, org.apache.solr.common.cloud.CollectionStateWatcher)

registerDocCollectionWatcher

public void registerDocCollectionWatcher(String collection,
                                         DocCollectionWatcher watcher)

Register a DocCollectionWatcher to be called when the cluster state for a collection changes.

The Watcher will automatically be removed when it's onStateChanged returns true

参数:

collection - the collection to watch

watcher - a watcher that will be called when the state changes

另请参阅:

ZkStateReader.registerDocCollectionWatcher(java.lang.String, org.apache.solr.common.cloud.DocCollectionWatcher)

getRouteException

protected BaseCloudSolrClient.RouteException getRouteException(SolrException.ErrorCode serverError,
                                                               NamedList<Throwable> exceptions,
                                                               Map<String,? extends LBSolrClient.Req> routes)

createRoutes

protected Map<String,? extends LBSolrClient.Req> createRoutes(UpdateRequest updateRequest,
                                                              ModifiableSolrParams routableParams,
                                                              DocCollection col,
                                                              DocRouter router,
                                                              Map<String,List<String>> urlMap,
                                                              String routeField)

condenseResponse

protected <T extends BaseCloudSolrClient.RouteResponse> T condenseResponse(NamedList response,
                                                                           int timeMillis,
                                                                           Supplier<T> supplier)

condenseResponse

public BaseCloudSolrClient.RouteResponse condenseResponse(NamedList response,
                                                          int timeMillis)

request

public NamedList<Object> request(SolrRequest request,
                                 String collection)
                          throws SolrServerException,
                                 IOException

从类复制的说明: SolrClient

Execute a request against a Solr server for a given collection

指定者:

request 在类中 SolrClient

参数:

request - the request to execute

collection - the collection to execute the request against

返回:

a NamedList containing the response from the server

抛出:

SolrServerException - if there is an error on the server

IOException - If there is a low-level I/O error.

requestWithRetryOnStaleState

protected NamedList<Object> requestWithRetryOnStaleState(SolrRequest request,
                                                         int retryCount,
                                                         List<String> inputCollections)
                                                  throws SolrServerException,
                                                         IOException

As this class doesn't watch external collections on the client side, there's a chance that the request will fail due to cached stale state, which means the state must be refreshed from ZK and retried.

抛出:

SolrServerException

IOException

sendRequest

protected NamedList<Object> sendRequest(SolrRequest request,
                                        List<String> inputCollections)
                                 throws SolrServerException,
                                        IOException

抛出:

SolrServerException

IOException

isUpdatesToLeaders

public boolean isUpdatesToLeaders()

isDirectUpdatesToLeadersOnly

public boolean isDirectUpdatesToLeadersOnly()

返回:

true if direct updates are sent to shard leaders only

setParallelCacheRefreshes

public void setParallelCacheRefreshes(int n)

If caches are expired they are refreshed after acquiring a lock. use this to set the number of locks

objectList

protected static ArrayList<Object> objectList(int n)

getDocCollection

protected DocCollection getDocCollection(String collection,
                                         Integer expectedVersion)
                                  throws SolrException

抛出:

SolrException

getMinAchievedReplicationFactor

public int getMinAchievedReplicationFactor(String collection,
                                           NamedList resp)

Useful for determining the minimum achieved replication factor across all shards involved in processing an update request, typically useful for gauging the replication factor of a batch.

getShardReplicationFactor

public Map<String,Integer> getShardReplicationFactor(String collection,
                                                     NamedList resp)

Walks the NamedList response after performing an update request looking for the replication factor that was achieved in each shard involved in the request. For single doc updates, there will be only one shard in the return value.