Struct stellr::ZkSolrClient

pub struct ZkSolrClient { /* fields omitted */ }

Access a solr node using live_node information store in a Zookeeper ensemble.

Live nodes are picked at random from the children of /<zk_chroot>/live_nodes, and rechosen on each new request.

This takes zookeeper details as the arguments to new()

use stellr::prelude::*;
use stellr::ZkSolrClient;

let my_client = ZkSolrClient::new("localhost:9983", "/")?;
assert_eq!(my_client.live_node_url().unwrap(), "http://192.168.1.2:8983/solr");

Please see the SolrCoreMethods and SolrCloudMethods Traits for details on how to use these clients.

Also note that the zookeeper connection is stored within an Arc, so clone()'ed instances will share zookeeper connection instances, whereas new() will create new ZK clients each time.

Implementations

impl ZkSolrClient

pub fn new(zk_quorum: &str, zk_chroot: &str) -> SolrResult<ZkSolrClient>

Build a zookeeper based connection from zookeeper ensemble and chroot infomration

pub fn live_nodes(&self) -> ZkResult<Vec<String>>

Extract the list of all current live nodes from zookeeper

pub fn pick_one_live_node(&self) -> SolrResult<String>

Extract the details of just one node from live_nodes

pub fn reset_zookeeper(&self) -> ZkResult<()>

A basic method to reset dead zookeeper connections

Trait Implementations

impl Clone for ZkSolrClient

pub fn clone(&self) -> ZkSolrClient

Returns a copy of the value.

pub fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ZkSolrClient

pub fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ZkSolrClient

pub fn default() -> Self

Returns the "default value" for a type.

impl Display for ZkSolrClient

pub fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for ZkSolrClient

impl Hash for ZkSolrClient

pub fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

pub fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl PartialEq<ZkSolrClient> for ZkSolrClient

pub fn eq(&self, other: &Self) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl SolrCloudMethods for ZkSolrClient

pub fn select(&self, collection: &str) -> SolrResult<RequestBuilder>

Create a requestBuilder for a solrCloud select request

pub fn update(&self, collection: &str) -> SolrResult<RequestBuilder>

Create a requestBuilder for a solrCloud update request (using HTTP POST)

impl SolrCoreMethods for ZkSolrClient

pub fn live_node_url(&self) -> SolrResult<String>

Extract a string-encoded base URL for the protocol and domainname of one host

pub fn request_config(&self) -> &SolrClientConfig

Return a reference to a SolrClientConfig

pub fn set_request_config(&mut self, request_config: SolrClientConfig)

Return a reference to a SolrClientConfig

pub fn build_request_url(&self, path: &str) -> SolrResult<String>

Create a string-encoded URL using a supplied path and the result of live_node_url()

pub fn build_client(&self) -> SolrResult<Client>

Generate a new reqwest::Client using SolrClientConfig supplied by the caller

pub fn create_get_request(&self, path: &str) -> SolrResult<RequestBuilder>

Generate a GET request builder, based on the base_url from the client and a path from the caller

pub fn create_post_request(&self, path: &str) -> SolrResult<RequestBuilder>

Generate a POST request builder, based on the base_url from the client and a path from the caller