ceresdb_client/db_client/
builder.rs

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
// Copyright 2022 CeresDB Project Authors. Licensed under Apache-2.0.

//! Client builder

use std::sync::Arc;

use crate::{
    db_client::{raw::RawImpl, route_based::RouteBasedImpl, DbClient},
    rpc_client::RpcClientImplFactory,
    RpcConfig,
};

/// Access mode to CeresDB server(s).
#[derive(Debug, Clone)]
pub enum Mode {
    /// When accessing CeresDB cluster by `Direct` mode, the requests will be
    /// sent directly to the right CeresDB instance determined by routing
    /// information.
    Direct,
    /// When accessing CeresDB by `Proxy` mode, the requests are just sent to
    /// any one CeresDB instance, which takes the responsibilities for
    /// forwarding the requests.
    Proxy,
}

/// The builder for building [`DbClient`](DbClient).
#[derive(Debug, Clone)]
pub struct Builder {
    mode: Mode,
    endpoint: String,
    default_database: Option<String>,
    rpc_config: RpcConfig,
}

impl Builder {
    // We hide this detail new method for the convenience of users.
    pub fn new(endpoint: String, mode: Mode) -> Self {
        Self {
            mode,
            endpoint,
            rpc_config: RpcConfig::default(),
            default_database: None,
        }
    }

    #[inline]
    pub fn default_database(mut self, default_database: impl Into<String>) -> Self {
        self.default_database = Some(default_database.into());
        self
    }

    #[inline]
    pub fn rpc_config(mut self, rpc_config: RpcConfig) -> Self {
        self.rpc_config = rpc_config;
        self
    }

    pub fn build(self) -> Arc<dyn DbClient> {
        let rpc_client_factory = Arc::new(RpcClientImplFactory::new(self.rpc_config));

        match self.mode {
            Mode::Direct => Arc::new(RouteBasedImpl::new(
                rpc_client_factory,
                self.endpoint,
                self.default_database,
            )),
            Mode::Proxy => Arc::new(RawImpl::new(
                rpc_client_factory,
                self.endpoint,
                self.default_database,
            )),
        }
    }
}