Struct hdbconnect_impl::ConnectParamsBuilder

pub struct ConnectParamsBuilder { /* private fields */ }

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 is_tls(&self) -> bool

Whether TLS or a plain TCP connection is to be used.

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 always_uncompressed(&mut self, uncompressed: bool) -> &mut Self

Switch off compression (for debugging purposes?)

By default, compression is supported, like with always_uncompressed(false)

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 tls_without_server_verification(&mut self) -> &mut Self

Makes the driver use TLS for the connection to the database, but hazardously without verifying the server’s certificate. Erases all already configured server certs.

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

Trait Implementations

impl Clone for ConnectParamsBuilder

fn clone(&self) -> ConnectParamsBuilder

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ConnectParamsBuilder

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

Formats the value using the given formatter.

impl Default for ConnectParamsBuilder

fn default() -> ConnectParamsBuilder

Returns the “default value” for a type.

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

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

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

Formats the value using the given formatter.

impl From<ConnectParamsBuilder> for String

fn from(cpb: ConnectParamsBuilder) -> String

Converts to this type from the input type.

impl IntoConnectParams for &ConnectParamsBuilder

fn into_connect_params(self) -> HdbResult<ConnectParams>

Converts the value of self into a ConnectParams.

impl IntoConnectParams for ConnectParamsBuilder

fn into_connect_params(self) -> HdbResult<ConnectParams>

Converts the value of self into a ConnectParams.

impl IntoConnectParamsBuilder for ConnectParamsBuilder

fn into_connect_params_builder(self) -> HdbResult<ConnectParamsBuilder>

Converts the value of self into a ConnectParamsBuilder.

impl PartialEq for ConnectParamsBuilder

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

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

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ConnectParamsBuilder

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for ConnectParamsBuilder

impl StructuralEq for ConnectParamsBuilder

impl StructuralPartialEq for ConnectParamsBuilder