Struct hdbconnect::ConnectParamsBuilder

pub struct ConnectParamsBuilder { /* fields omitted */ }

A builder for ConnectParams.

Instantiating a ConnectParamsBuilder programmatically

use hdbconnect::ConnectParams;

let connect_params = ConnectParams::builder()
    .hostname("abcd123")
    .port(2222)
    .dbuser("MEIER")
    .password("schlau")
    .build()
    .unwrap();

Instantiating a ConnectParamsBuilder from a URL

See module url for details about the supported URLs.

use hdbconnect::IntoConnectParamsBuilder;

let conn_params = "hdbsql://abcd123:2222"
    .into_connect_params_builder()
    .unwrap()
    .dbuser("MEIER")
    .password("schlau")
    .build()
    .unwrap();

Implementations

impl ConnectParamsBuilder

pub fn new() -> Self

Creates a new builder.

pub fn hostname<H: AsRef<str>>(&mut self, hostname: H) -> &mut Self

Sets the hostname.

pub fn port(&mut self, port: u16) -> &mut Self

Sets the port.

pub fn dbuser<D: AsRef<str>>(&mut self, dbuser: D) -> &mut Self

Sets the database user.

pub fn password<P: AsRef<str>>(&mut self, pw: P) -> &mut Self

Sets the password.

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

Unsets the password.

pub fn dbname<D: AsRef<str>>(&mut self, dbname: D) -> &mut Self

Sets the database name.

This allows specifying host and port of the system DB and getting automatically redirected and connected to the specified tenant database.

pub fn network_group<D: AsRef<str>>(&mut self, network_group: D) -> &mut Self

Sets the network group.

pub fn clientlocale<P: AsRef<str>>(&mut self, cl: P) -> &mut Self

Sets the client locale.

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

Sets the client locale from the value of the environment variable LANG

pub fn tls_with(&mut self, server_certs: ServerCerts) -> &mut Self

Makes the driver use TLS for the connection to the database.

Requires that the server's certificate is provided with one of the enum variants of ServerCerts.

If needed, you can call this function multiple times with different ServerCert variants.

Example:

let mut conn_params = ConnectParams::builder()
   // ...more settings required...
   .tls_with(ServerCerts::Direct(string_with_certificate))
   .build();

pub fn build(&self) -> HdbResult<ConnectParams>

Constructs a ConnectParams from the builder.

Errors

HdbError::Usage if the builder was not yet configured to create a meaningful ConnectParams

pub fn to_url(&self) -> HdbResult<String>

Returns the url for this connection, without the password.

Errors

HdbError::Usage if the builder was not yet configured to build a correct url

pub fn get_hostname(&self) -> Option<&str>

Getter

pub fn get_dbuser(&self) -> Option<&str>

Getter

pub fn get_password(&self) -> Option<&SecUtf8>

Getter

pub fn get_port(&self) -> Option<u16>

Getter

pub fn get_clientlocale(&self) -> Option<&str>

Getter

pub fn get_server_certs(&self) -> &Vec<ServerCerts>

Getter

Trait Implementations

impl Clone for ConnectParamsBuilder

pub fn clone(&self) -> ConnectParamsBuilder

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ConnectParamsBuilder

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

Formats the value using the given formatter.

impl Default for ConnectParamsBuilder

pub fn default() -> ConnectParamsBuilder

Returns the "default value" for a type.

impl<'de> Deserialize<'de> for ConnectParamsBuilder

pub fn deserialize<D>(deserializer: D) -> Result<Self, D::Error> where
    D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl Display for ConnectParamsBuilder

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

Formats the value using the given formatter.

impl Into<String> for ConnectParamsBuilder

pub fn into(self) -> String

Performs the conversion.

impl IntoConnectParams for ConnectParamsBuilder

pub fn into_connect_params(self) -> HdbResult<ConnectParams>

Converts the value of self into a ConnectParams.

impl IntoConnectParams for &ConnectParamsBuilder

pub fn into_connect_params(self) -> HdbResult<ConnectParams>

Converts the value of self into a ConnectParams.

impl IntoConnectParamsBuilder for ConnectParamsBuilder

pub fn into_connect_params_builder(self) -> HdbResult<ConnectParamsBuilder>

Converts the value of self into a ConnectParamsBuilder.

impl PartialEq<ConnectParamsBuilder> for ConnectParamsBuilder

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

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

pub fn ne(&self, other: &ConnectParamsBuilder) -> bool

This method tests for !=.

impl Serialize for ConnectParamsBuilder

pub fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ConnectParamsBuilder