rbdc-oracle 0.10.0

Oracle driver for rbdc
Documentation 
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
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112

mod connect;
mod parse;

use futures_core::future::BoxFuture;
use rbdc::Error;
use rbdc::db::{ConnectOptions, Connection};
use serde::{Deserialize, Serialize};

/// Connection options for Oracle.
///
/// Prefer `OracleConnectOptions::new()` / `Default::default()` plus the builder
/// methods instead of direct struct literals, so new configuration fields can be
/// added without breaking downstream code.
#[derive(Serialize, Deserialize, Debug, Clone, Eq, PartialEq)]
#[non_exhaustive]
pub struct OracleConnectOptions {
    pub username: String,
    pub password: String,
    pub connect_string: String,
    #[serde(default = "OracleConnectOptions::default_statement_cache_capacity")]
    pub statement_cache_capacity: usize,
    #[serde(default = "OracleConnectOptions::default_row_channel_size")]
    pub row_channel_size: usize,
    #[serde(default = "OracleConnectOptions::default_command_channel_size")]
    pub command_channel_size: usize,
}

impl Default for OracleConnectOptions {
    fn default() -> Self {
        Self::new()
    }
}

impl OracleConnectOptions {
    pub fn new() -> Self {
        Self {
            username: "scott".to_owned(),
            password: "tiger".to_owned(),
            connect_string: "//localhost/XE".to_owned(),
            statement_cache_capacity: Self::default_statement_cache_capacity(),
            row_channel_size: Self::default_row_channel_size(),
            command_channel_size: Self::default_command_channel_size(),
        }
    }

    pub fn with_credentials(
        username: impl Into<String>,
        password: impl Into<String>,
        connect_string: impl Into<String>,
    ) -> Self {
        Self::new()
            .username(username)
            .password(password)
            .connect_string(connect_string)
    }

    fn default_statement_cache_capacity() -> usize {
        100
    }

    fn default_row_channel_size() -> usize {
        50
    }

    fn default_command_channel_size() -> usize {
        50
    }

    pub fn username(mut self, username: impl Into<String>) -> Self {
        self.username = username.into();
        self
    }

    pub fn password(mut self, password: impl Into<String>) -> Self {
        self.password = password.into();
        self
    }

    pub fn connect_string(mut self, connect_string: impl Into<String>) -> Self {
        self.connect_string = connect_string.into();
        self
    }

    pub fn statement_cache_capacity(mut self, capacity: usize) -> Self {
        self.statement_cache_capacity = capacity;
        self
    }

    pub fn row_channel_size(mut self, size: usize) -> Self {
        self.row_channel_size = size;
        self
    }

    pub fn command_channel_size(mut self, size: usize) -> Self {
        self.command_channel_size = size;
        self
    }
}

impl ConnectOptions for OracleConnectOptions {
    fn connect(&self) -> BoxFuture<'_, Result<Box<dyn Connection>, Error>> {
        Box::pin(async move {
            let connection = self.connect().await?;
            Ok(Box::new(connection) as Box<dyn Connection>)
        })
    }

    fn set_uri(&mut self, uri: &str) -> Result<(), Error> {
        *self = uri.parse()?;
        Ok(())
    }
}