CloudSolrClient.Builder (Solr 7.4.0 API)

java.lang.Object
- org.apache.solr.client.solrj.impl.SolrClientBuilder<CloudSolrClient.Builder>
- - org.apache.solr.client.solrj.impl.CloudSolrClient.Builder

Enclosing class:: CloudSolrClient

public static class CloudSolrClient.Builder
extends SolrClientBuilder<CloudSolrClient.Builder>

Constructs CloudSolrClient instances from provided configuration.

Field Summary

Fields
Modifier and Type	Field and Description
`protected boolean`	`directUpdatesToLeadersOnly`
`protected LBHttpSolrClient.Builder`	`lbClientBuilder`
`protected LBHttpSolrClient`	`loadBalancedSolrClient`
`protected boolean`	`parallelUpdates`
`protected boolean`	`shardLeadersOnly`
`protected List<String>`	`solrUrls`
`protected ClusterStateProvider`	`stateProvider`
`protected String`	`zkChroot`
`protected Collection<String>`	`zkHosts`

Fields inherited from class org.apache.solr.client.solrj.impl.SolrClientBuilder
connectionTimeoutMillis, httpClient, responseParser, socketTimeoutMillis

Constructor Summary

Constructors
Constructor and Description
`Builder()` Deprecated. use other constructors instead. This constructor will be changing visibility in an upcoming release.
`Builder(List<String> solrUrls)` Provide a series of Solr URLs to be used when configuring `CloudSolrClient` instances.
`Builder(List<String> zkHosts, Optional<String> zkChroot)` Provide a series of ZK hosts which will be used when configuring `CloudSolrClient` instances.

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`CloudSolrClient`	`build()` Create a `CloudSolrClient` based on the provided configuration.
`CloudSolrClient.Builder`	`getThis()` The solution for the unchecked cast warning.
`CloudSolrClient.Builder`	`sendDirectUpdatesToAnyShardReplica()` Tells `CloudSolrClient.Builder` that created clients can send updates to any shard replica (shard leaders and non-leaders).
`CloudSolrClient.Builder`	`sendDirectUpdatesToShardLeadersOnly()` Tells `CloudSolrClient.Builder` that created clients should send direct updates to shard leaders only.
`CloudSolrClient.Builder`	`sendUpdatesOnlyToShardLeaders()` Tells `CloudSolrClient.Builder` that created clients should send updates only to shard leaders.
`CloudSolrClient.Builder`	`sendUpdatesToAllReplicasInShard()` Tells `CloudSolrClient.Builder` that created clients should send updates to all replicas for a shard.
`CloudSolrClient.Builder`	`withClusterStateProvider(ClusterStateProvider stateProvider)` Deprecated. since this is an expert feature we don't want to expose this to regular users. To use this feature extend CloudSolrClient.Builder and pass your custom ClusterStateProvider
`CloudSolrClient.Builder`	`withLBHttpSolrClient(LBHttpSolrClient loadBalancedSolrClient)` Provides a `LBHttpSolrClient` for the builder to use when creating clients.
`CloudSolrClient.Builder`	`withLBHttpSolrClientBuilder(LBHttpSolrClient.Builder lbHttpSolrClientBuilder)` Provides a `HttpClient` for the builder to use when creating clients.
`CloudSolrClient.Builder`	`withParallelUpdates(boolean parallelUpdates)` Should direct updates to shards be done in parallel (the default) or if not then synchronously?
`CloudSolrClient.Builder`	`withSolrUrl(Collection<String> solrUrls)` Deprecated. use Solr URL constructors instead
`CloudSolrClient.Builder`	`withSolrUrl(String solrUrl)` Deprecated. use Solr-URL constructor instead
`CloudSolrClient.Builder`	`withZkChroot(String zkChroot)` Deprecated. use Zk-host constructor instead
`CloudSolrClient.Builder`	`withZkHost(Collection<String> zkHosts)` Deprecated. use Zk-host constructor instead
`CloudSolrClient.Builder`	`withZkHost(String zkHost)` Deprecated. use Zk-host constructor instead

Methods inherited from class org.apache.solr.client.solrj.impl.SolrClientBuilder
withConnectionTimeout, withHttpClient, withResponseParser, withSocketTimeout

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - zkHosts
```
protected Collection<String> zkHosts
```
  - solrUrls
```
protected List<String> solrUrls
```
  - zkChroot
```
protected String zkChroot
```
  - loadBalancedSolrClient
```
protected LBHttpSolrClient loadBalancedSolrClient
```
  - lbClientBuilder
```
protected LBHttpSolrClient.Builder lbClientBuilder
```
  - shardLeadersOnly
```
protected boolean shardLeadersOnly
```
  - directUpdatesToLeadersOnly
```
protected boolean directUpdatesToLeadersOnly
```
  - parallelUpdates
```
protected boolean parallelUpdates
```
  - stateProvider
```
protected ClusterStateProvider stateProvider
```
- Constructor Detail
  - Builder
```
@Deprecated
public Builder()
```
    Deprecated. use other constructors instead. This constructor will be changing visibility in an upcoming release.
  - Builder
```
public Builder(List<String> solrUrls)
```
    Provide a series of Solr URLs to be used when configuring CloudSolrClient instances. The solr client will use these urls to understand the cluster topology, which solr nodes are active etc. Provided Solr URLs are expected to point to the root Solr path ("http://hostname:8983/solr"); it should not include any collections, cores, or other path components.
  - Builder
```
public Builder(List<String> zkHosts,
               Optional<String> zkChroot)
```
    Provide a series of ZK hosts which will be used when configuring CloudSolrClient instances.
    
    Parameters:
    
    zkHosts - a List of at least one ZooKeeper host and port
    
    zkChroot - the path to the root ZooKeeper node containing Solr data. May be empty if Solr-data is located at the ZooKeeper root
- Method Detail
  - withZkHost
```
@Deprecated
public CloudSolrClient.Builder withZkHost(String zkHost)
```
    Deprecated. use Zk-host constructor instead
    
    Provide a ZooKeeper client endpoint to be used when configuring CloudSolrClient instances. Method may be called multiple times. All provided values will be used.
    
    Parameters:
    
    zkHost - The client endpoint of the ZooKeeper quorum containing the cloud state.
  - withSolrUrl
```
@Deprecated
public CloudSolrClient.Builder withSolrUrl(String solrUrl)
```
    Deprecated. use Solr-URL constructor instead
    
    Provide a Solr URL to be used when configuring CloudSolrClient instances. Method may be called multiple times. One of the provided values will be used to fetch the list of live Solr nodes that the underlying HttpClusterStateProvider would be maintaining. Provided Solr URL is expected to point to the root Solr path ("http://hostname:8983/solr"); it should not include any collections, cores, or other path components.
  - withSolrUrl
```
@Deprecated
public CloudSolrClient.Builder withSolrUrl(Collection<String> solrUrls)
```
    Deprecated. use Solr URL constructors instead
    
    Provide a list of Solr URL to be used when configuring CloudSolrClient instances. One of the provided values will be used to fetch the list of live Solr nodes that the underlying HttpClusterStateProvider would be maintaining. Provided Solr URLs are expected to point to the root Solr path ("http://hostname:8983/solr"); they should not include any collections, cores, or other path components.
  - withLBHttpSolrClientBuilder
```
public CloudSolrClient.Builder withLBHttpSolrClientBuilder(LBHttpSolrClient.Builder lbHttpSolrClientBuilder)
```
    Provides a HttpClient for the builder to use when creating clients.
  - withZkHost
```
@Deprecated
public CloudSolrClient.Builder withZkHost(Collection<String> zkHosts)
```
    Deprecated. use Zk-host constructor instead
    
    Provide a series of ZooKeeper client endpoints for the builder to use when creating clients. Method may be called multiple times. All provided values will be used.
    
    Parameters:
    
    zkHosts - A Java Collection (List, Set, etc) of HOST:PORT strings, one for each host in the ZooKeeper ensemble. Note that with certain Collection types like HashSet, the order of hosts in the final connect string may not be in the same order you added them.
  - withZkChroot
```
@Deprecated
public CloudSolrClient.Builder withZkChroot(String zkChroot)
```
    Deprecated. use Zk-host constructor instead
    
    Provides a ZooKeeper chroot for the builder to use when creating clients.
  - withLBHttpSolrClient
```
public CloudSolrClient.Builder withLBHttpSolrClient(LBHttpSolrClient loadBalancedSolrClient)
```
    Provides a LBHttpSolrClient for the builder to use when creating clients.
  - sendUpdatesOnlyToShardLeaders
```
public CloudSolrClient.Builder sendUpdatesOnlyToShardLeaders()
```
    Tells CloudSolrClient.Builder that created clients should send updates only to shard leaders.
  - sendUpdatesToAllReplicasInShard
```
public CloudSolrClient.Builder sendUpdatesToAllReplicasInShard()
```
    Tells CloudSolrClient.Builder that created clients should send updates to all replicas for a shard.
  - sendDirectUpdatesToShardLeadersOnly
```
public CloudSolrClient.Builder sendDirectUpdatesToShardLeadersOnly()
```
    Tells CloudSolrClient.Builder that created clients should send direct updates to shard leaders only.
  - sendDirectUpdatesToAnyShardReplica
```
public CloudSolrClient.Builder sendDirectUpdatesToAnyShardReplica()
```
    Tells CloudSolrClient.Builder that created clients can send updates to any shard replica (shard leaders and non-leaders).
  - withParallelUpdates
```
public CloudSolrClient.Builder withParallelUpdates(boolean parallelUpdates)
```
    Should direct updates to shards be done in parallel (the default) or if not then synchronously?
  - withClusterStateProvider
```
@Deprecated
public CloudSolrClient.Builder withClusterStateProvider(ClusterStateProvider stateProvider)
```
    Deprecated. since this is an expert feature we don't want to expose this to regular users. To use this feature extend CloudSolrClient.Builder and pass your custom ClusterStateProvider
    
    Expert feature where you want to implement a custom cluster discovery mechanism of the solr nodes as part of the cluster.
  - build
```
public CloudSolrClient build()
```
    Create a CloudSolrClient based on the provided configuration.
  - getThis
```
public CloudSolrClient.Builder getThis()
```
    Description copied from class: SolrClientBuilder
    
    The solution for the unchecked cast warning.
    
    Specified by:
    
    getThis in class SolrClientBuilder<CloudSolrClient.Builder>

Class CloudSolrClient.Builder

Field Summary

Fields inherited from class org.apache.solr.client.solrj.impl.SolrClientBuilder

Constructor Summary

Method Summary

Methods inherited from class org.apache.solr.client.solrj.impl.SolrClientBuilder

Methods inherited from class java.lang.Object

Field Detail

zkHosts

solrUrls

zkChroot

loadBalancedSolrClient

lbClientBuilder

shardLeadersOnly

directUpdatesToLeadersOnly

parallelUpdates

stateProvider

Constructor Detail

Builder

Builder

Builder

Method Detail

withZkHost

withSolrUrl

withSolrUrl

withLBHttpSolrClientBuilder

withZkHost

withZkChroot

withLBHttpSolrClient

sendUpdatesOnlyToShardLeaders

sendUpdatesToAllReplicasInShard

sendDirectUpdatesToShardLeadersOnly

sendDirectUpdatesToAnyShardReplica

withParallelUpdates

withClusterStateProvider

build

getThis