Enum ReadDataBlockError

pub enum ReadDataBlockError {
    IoError,
    UnsupportedLocation,
    DifferentChecksum,
    BadByteShuffleItemSize,
    FileInUse,
    BadTextEncoding,
    UntrustedHost(Host),
    Unauthorized(Url),
    UnsupportedScheme(String),
    MissingHost,
}

A failure to read bytes from a DataBlock

Variants

IoError

Something went wrong while interacting with the underlying file or stream

UnsupportedLocation

The data block location is not supported for the current file

For example, trying to access a remote data block in a monolithic file, or trying to access an attached data block in a distributed file.

DifferentChecksum

The checksum failed verification

BadByteShuffleItemSize

FileInUse

Failed to read an attached data block because the file is in use by another data block

I’m pretty sure this is impossible to get with safe rust since Context doesn’t impl Send + Sync, and the file handle is released by the time the public API call finishes, but it’s here just in case I’m wrong.

BadTextEncoding

Failed to read an inline/embedded data block

UntrustedHost(Host)

The host is not in the context’s

Ask the user if they trust the provided host, and if yes, add it to the context with Context::trust_host, and try to read the block again

This should not be done automatically, as a malicious server could permanently hang the reader. Always ask before adding a trusted host.

Unauthorized(Url)

Failed to authenticate with the remote host

Some servers may enforce a cooldown period between attempts, so it's best to be proactive in asking for credentials before connecting. Consider asking for credentials at the same time as when you ask the user to trust the host.

UnsupportedScheme(String)

Current supported schemes: ftp, http, https, file

MissingHost

The URL for this data block is missing a remote host

Trait Implementations

impl Clone for ReadDataBlockError

fn clone(&self) -> ReadDataBlockError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ReadDataBlockError

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

Formats the value using the given formatter.

impl Display for ReadDataBlockError

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

Formats the value using the given formatter.

impl Error for ReadDataBlockError

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 PartialEq for ReadDataBlockError

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl StructuralPartialEq for ReadDataBlockError