Enum pliantdb_core::Error

pub enum Error {
    SchemaMismatch {
        database_name: String,
        schema: SchemaName,
        stored_schema: SchemaName,
    },
    SchemaAlreadyRegistered(SchemaName),
    SchemaNotRegistered(SchemaName),
    InvalidDatabaseName(String),
    DatabaseNotFound(String),
    DatabaseNameAlreadyTaken(String),
    Database(String),
    Server(String),
    Transport(String),
    Websocket(String),
    Networking(Error),
    Io(String),
    Configuration(String),
    Client(String),
    CollectionNotFound,
    DocumentNotFound(CollectionName, u64),
    DocumentConflict(CollectionName, u64),
    UniqueKeyViolation {
        view: ViewName,
        conflicting_document_id: u64,
        existing_document_id: u64,
    },
    InvalidName(InvalidNameError),
    PermissionDenied(PermissionDenied),
}

an enumeration of errors that this crate can produce

Variants

SchemaMismatch

The database named database_name was created with a different schema (stored_schema) than provided (schema).

Fields of SchemaMismatch

database_name: String

The name of the database being accessed.

schema: SchemaName

The schema provided for the database.

stored_schema: SchemaName

The schema stored for the database.

SchemaAlreadyRegistered(SchemaName)

The SchemaName returned has already been registered with this server.

SchemaNotRegistered(SchemaName)

The SchemaName requested was not registered with this server.

InvalidDatabaseName(String)

An invalid database name was specified. See ServerConnection::create_database() for database name requirements.

DatabaseNotFound(String)

The database name given was not found.

DatabaseNameAlreadyTaken(String)

The database name already exists.

Database(String)

An error from interacting with local storage.

Server(String)

An error from interacting with a server.

Transport(String)

An error occurred from the QUIC transport layer.

Websocket(String)

An error occurred from the websocket transport layer.

Networking(Error)

An error occurred from networking.

Io(String)

An error occurred from IO.

Configuration(String)

An error occurred with the provided configuration options.

Client(String)

An error occurred inside of the client.

CollectionNotFound

An attempt to use a Collection with a Database that it wasn’t defined within.

DocumentNotFound(CollectionName, u64)

An attempt to update a document that doesn’t exist.

DocumentConflict(CollectionName, u64)

When updating a document, if a situation is detected where the contents have changed on the server since the Revision provided, a Conflict error will be returned.

UniqueKeyViolation

When saving a document in a collection with unique views, a document emits a key that is already emitted by an existing ocument, this error is returned.

Fields of UniqueKeyViolation

view: ViewName

The name of the view that the unique key violation occurred.

conflicting_document_id: u64

The document that caused the violation.

existing_document_id: u64

The document that already uses the same key.

InvalidName(InvalidNameError)

An invalid name was specified during schema creation.

PermissionDenied(PermissionDenied)

Permission was denied.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Error

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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

The lower-level source of this error, if any.

fn backtrace(&self) -> Option<&Backtrace>

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

Returns a stack backtrace, if available, of where this error occurred.

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

impl From<Error> for Error

fn from(err: Error) -> Self

Performs the conversion.

impl From<InvalidNameError> for Error

fn from(source: InvalidNameError) -> Self

Performs the conversion.

impl From<PermissionDenied> for Error

fn from(source: PermissionDenied) -> Self

Performs the conversion.

impl Serialize for Error

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

Serialize this value into the given Serde serializer.