Enum bonsaidb_core::Error

source ·
pub enum Error {
Show 27 variants SchemaMismatch { database_name: String, schema: SchemaName, stored_schema: SchemaName, }, SchemaAlreadyRegistered(SchemaName), SchemaNotRegistered(SchemaName), ViewAlreadyRegistered(ViewName), InvalidDatabaseName(String), DatabaseNotFound(String), ViewNotFound, CollectionNotFound, ApiNotFound(ApiName), DatabaseNameAlreadyTaken(String), Networking(Error), CollectionAlreadyDefined, DocumentNotFound(CollectionName, Box<DocumentId>), DocumentIdTooLong, DocumentConflict(CollectionName, Box<Header>), UniqueKeyViolation { view: ViewName, conflicting_document: Box<Header>, existing_document: Box<Header>, }, DocumentPush(CollectionName, NextValueError), InvalidName(InvalidNameError), PermissionDenied(PermissionDenied), Password(String), UserNotFound, InvalidUnicode(String), InvalidCredentials, ReduceUnimplemented, NotANumber, Time(TimeError), Other { origin: String, error: String, },
}
Expand description

an enumeration of errors that this crate can produce

Variants§

§

SchemaMismatch

Fields

§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.

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

§

SchemaAlreadyRegistered(SchemaName)

The SchemaName returned has already been registered.

§

SchemaNotRegistered(SchemaName)

The SchemaName requested was not registered.

§

ViewAlreadyRegistered(ViewName)

The ViewName returned has already been registered.

§

InvalidDatabaseName(String)

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

§

DatabaseNotFound(String)

The database name given was not found.

§

ViewNotFound

The view was not found.

§

CollectionNotFound

The collection was not found.

§

ApiNotFound(ApiName)

The api invoked was not found.

§

DatabaseNameAlreadyTaken(String)

The database name already exists.

§

Networking(Error)

An error occurred from networking.

§

CollectionAlreadyDefined

A Collection being added already exists. This can be caused by a collection name not being unique.

§

DocumentNotFound(CollectionName, Box<DocumentId>)

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

§

DocumentIdTooLong

A value provided as a DocumentId exceeded DocumentId::MAX_LENGTH.

§

DocumentConflict(CollectionName, Box<Header>)

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

Fields

§view: ViewName

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

§conflicting_document: Box<Header>

The document that caused the violation.

§existing_document: Box<Header>

The document that already uses the same key.

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.

§

DocumentPush(CollectionName, NextValueError)

When pushing a document, an error occurred while generating the next unique id.

§

InvalidName(InvalidNameError)

An invalid name was specified during schema creation.

§

PermissionDenied(PermissionDenied)

Permission was denied.

§

Password(String)

An internal error handling passwords was encountered.

§

UserNotFound

The user specified was not found. This will not be returned in response to an invalid username being used during login. It will be returned in other APIs that operate upon users.

§

InvalidUnicode(String)

An error occurred converting from bytes to Utf-8.

§

InvalidCredentials

The credentials specified are not valid.

§

ReduceUnimplemented

Returned when the a view’s reduce() function is unimplemented.

§

NotANumber

A floating point operation yielded Not a Number.

§

Time(TimeError)

An error while operating with a time

§

Other

Fields

§origin: String

The origin of the error.

§error: String

The error message.

An error from another crate.

Implementations§

source§

impl Error

source

pub fn other(origin: impl Display, error: impl Display) -> Self

Returns an instance of Self::Other with the given parameters.

source

pub fn is_unique_key_error<View: View, C: HasSchema>( &self, connection: &C ) -> bool

Returns true if this error is a Error::UniqueKeyViolation from View.

source

pub fn conflicting_document<Collection: Collection>(&self) -> Option<Header>

Returns the header of the conflicting document if this error is a Error::DocumentConflict from Collection.

Trait Implementations§

source§

impl Clone for Error

source§

fn clone(&self) -> Error

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl Debug for Error

source§

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

Formats the value using the given formatter. Read more
source§

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

source§

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

Deserialize this value from the given Serde deserializer. Read more
source§

impl Display for Error

source§

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

Formats the value using the given formatter. Read more
source§

impl Error for Error

source§

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

The lower-level source of this error, if any. Read more
1.0.0 · source§

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()
1.0.0 · source§

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

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

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. Read more
source§

impl From<Error> for Error

source§

fn from(err: Error) -> Self

Converts to this type from the input type.
source§

impl From<Error> for Error

source§

fn from(err: Error) -> Self

Converts to this type from the input type.
source§

impl From<Error> for Error

source§

fn from(source: Error) -> Self

Converts to this type from the input type.
source§

impl From<FromUtf8Error> for Error

source§

fn from(err: FromUtf8Error) -> Self

Converts to this type from the input type.
source§

impl<T> From<InsertError<T>> for Error

source§

fn from(err: InsertError<T>) -> Self

Converts to this type from the input type.
source§

impl From<InvalidHexadecimal> for Error

source§

fn from(err: InvalidHexadecimal) -> Self

Converts to this type from the input type.
source§

impl From<InvalidNameError> for Error

source§

fn from(source: InvalidNameError) -> Self

Converts to this type from the input type.
source§

impl From<PermissionDenied> for Error

source§

fn from(source: PermissionDenied) -> Self

Converts to this type from the input type.
source§

impl From<TimeError> for Error

source§

fn from(source: TimeError) -> Self

Converts to this type from the input type.
source§

impl Serialize for Error

source§

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

Serialize this value into the given Serde serializer. Read more

Auto Trait Implementations§

§

impl RefUnwindSafe for Error

§

impl Send for Error

§

impl Sync for Error

§

impl Unpin for Error

§

impl UnwindSafe for Error

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> Same for T

§

type Output = T

Should always be Self
source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T> ToString for T
where T: Display + ?Sized,

source§

default fn to_string(&self) -> String

Converts the given value to a String. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V

§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more
source§

impl<T> AnyError for T
where T: Error + Send + Sync + 'static,

source§

impl<T> ApiError for T
where T: Display + Clone + Serialize + for<'de> Deserialize<'de> + Send + Sync + Debug,

source§

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,