Struct ClientBuilder

pub struct ClientBuilder { /* private fields */ }

Builder for Client with more options than Client::connect.

Implementations

impl ClientBuilder

pub fn with_session_timeout(&mut self, timeout: Duration) -> &mut Self

Specifies target session timeout to negotiate with ZooKeeper server.

Defaults to 6s.

pub fn with_connection_timeout(&mut self, timeout: Duration) -> &mut Self

Specifies idle timeout to conclude a connection as loss.

Defaults to 2/5 of session timeout.

pub fn with_readonly(&mut self, readonly: bool) -> &mut ClientBuilder

Specifies whether readonly session is allowed.

pub fn with_auth(&mut self, scheme: String, auth: Vec<u8>) -> &mut ClientBuilder

Specifies auth info for given authentication scheme.

pub fn assume_server_version( &mut self, major: u32, minor: u32, patch: u32, ) -> &mut Self

Specifies client assumed server version of ZooKeeper cluster.

Client will issue server compatible protocol to avoid Error::Unimplemented for some operations. See Client::create for an example.

See ZOOKEEPER-1381 and ZOOKEEPER-3762 for references.

pub fn detach(&mut self) -> &mut Self

Detaches creating session so it will not be closed after all client instances dropped.

pub async fn connect(&mut self, cluster: &str) -> Result<Client, Error>

Connects to ZooKeeper cluster.

Notable errors

• Error::NoHosts if no host is available
• Error::SessionExpired if specified session expired

Trait Implementations

impl Clone for ClientBuilder

fn clone(&self) -> ClientBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ClientBuilder

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

Formats the value using the given formatter.