Enum HdbError

#[non_exhaustive]
pub enum HdbError {
    Initialization {
        source: Box<dyn Error + Sync + Send>,
    },
    Authentication {
        source: Box<HdbError>,
    },
    Deserialization {
        source: DeserializationError,
    },
    Serialization {
        source: SerializationError,
    },
    Cesu8,
    Cesu8AsBytes {
        bytes: Vec<u8>,
    },
    ConnParams {
        source: Box<dyn Error + Sync + Send>,
    },
    DbError {
        source: ServerError,
    },
    Decompression {
        source: DecompressError,
    },
    TlsInvalidDnsName {
        source: InvalidDnsNameError,
    },
    TlsInit {
        source: Box<dyn Error + Sync + Send>,
    },
    TlsProtocol {
        source: Error,
    },
    Evaluation(&'static str),
    ExecutionResults(ExecutionResults),
    Impl(Cow<'static, str>),
    Poison,
    SessionClosingTransactionError,
    Io {
        source: Error,
    },
    ErrorAfterReconnect {
        source: Error,
        second: Box<HdbError>,
    },
    Usage(Cow<'static, str>),
    ConnectionBroken {
        source: Option<Box<HdbError>>,
    },
}

A list specifying categories of HdbError.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Initialization

Initialization without TLS failed.

Fields

source: Box<dyn Error + Sync + Send>

The causing Error.

Authentication

Authentication failed.

Fields

source: Box<HdbError>

The causing Error.

Deserialization

Deserialization of a ResultSet, a Row, a single HdbValue, or an OutputParameter failed (methods try_into()).

Fields

source: DeserializationError

The causing Error.

Serialization

Serialization of a ParameterDescriptor or a ParameterRow failed.

Fields

source: SerializationError

The causing Error.

Cesu8

Some error occured while decoding CESU-8. This indicates a server issue!

Cesu8AsBytes

Decoding CESU-8 failed, original bytes are available.

Fields

bytes: Vec<u8>

ConnParams

Erroneous Connection Parameters, e.g. from a malformed connection URL.

Fields

source: Box<dyn Error + Sync + Send>

The causing Error.

DbError

Database server responded with an error; the contained ServerError describes the conrete reason.

Fields

source: ServerError

The causing Error.

Decompression

Decompression

Fields

source: DecompressError

The causing Error.

TlsInvalidDnsName

TLS set up failed because the server name was not valid.

Fields

source: InvalidDnsNameError

The causing Error.

TlsInit

TLS initialization error

Fields

source: Box<dyn Error + Sync + Send>

The causing Error.

TlsProtocol

TLS protocol error.

Fields

source: Error

The causing Error.

Evaluation(&'static str)

Error occured while evaluating an HdbResponse or an HdbReturnValue.

ExecutionResults(ExecutionResults)

Database server responded with at least one error.

Impl(Cow<'static, str>)

Implementation error.

Poison

Error occured in thread synchronization.

SessionClosingTransactionError

An error occurred on the server that requires the session to be terminated.

Io

Error occured in communication with the database.

Fields

source: Error

The causing Error.

ErrorAfterReconnect

Error occured

Fields

source: Error

second: Box<HdbError>

Usage(Cow<'static, str>)

Error caused by wrong usage.

ConnectionBroken

Connection is dead

Fields

source: Option<Box<HdbError>>

Implementations

impl HdbError

pub fn server_error(&self) -> Option<&ServerError>

Returns the contained ServerError, if any.

This method helps in case you need programmatic access to e.g. the error code.

Example:

    if let Err(hdberror) = hdb_result {
        if let Some(server_error) = hdberror.server_error() {
            let sys_m_error_code: (i32, String, String) = connection
                .query(&format!(
                    "select * from SYS.M_ERROR_CODES where code = {}",
                    server_error.code()
                ))?.try_into()?;
            println!("sys_m_error_code: {:?}", sys_m_error_code);
        }
    }

pub fn inner(&self) -> Option<&dyn Error>

Reveal the inner error

pub fn display_with_inner(&self) -> String

Returns a decently formed and hopefully helpful error description.

Trait Implementations

impl Debug for HdbError

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

Formats the value using the given formatter.

impl Display for HdbError

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

Formats the value using the given formatter.

impl Error for HdbError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Box<HdbError>> for HdbError

fn from(source: Box<HdbError>) -> HdbError

Converts to this type from the input type.

impl From<DecompressError> for HdbError

fn from(source: DecompressError) -> HdbError

Converts to this type from the input type.

impl From<DeserializationError> for HdbError

fn from(source: DeserializationError) -> HdbError

Converts to this type from the input type.

impl From<Error> for HdbError

fn from(source: Error) -> HdbError

Converts to this type from the input type.

impl From<Error> for HdbError

fn from(source: Error) -> HdbError

Converts to this type from the input type.

impl From<HdbError> for DeserializationError

fn from(e: HdbError) -> DeserializationError

Converts to this type from the input type.

impl From<InvalidDnsNameError> for HdbError

fn from(source: InvalidDnsNameError) -> HdbError

Converts to this type from the input type.

impl From<SerializationError> for HdbError

fn from(source: SerializationError) -> HdbError

Converts to this type from the input type.

impl From<ServerError> for HdbError

fn from(source: ServerError) -> HdbError

Converts to this type from the input type.