Struct opendal::Metadata

source ·
pub struct Metadata { /* private fields */ }
Expand description

Metadata contains all the information related to a specific path.

Depending on the context of the requests, the metadata for the same path may vary. For example, two versions of the same path might have different content lengths. Keep in mind that metadata is always tied to the given context and is not a global state.

§File Versions

In systems that support versioning, such as AWS S3, the metadata may represent a specific version of a file.

Users can access Metadata::version to retrieve the file’s version, if available. They can also use Metadata::is_current and Metadata::is_deleted to determine whether the metadata corresponds to the latest version or a deleted one.

The all possible combinations of is_current and is_deleted are as follows:

is_currentis_deleteddescription
Some(true)falseThe metadata’s associated version is the latest, current version. This is the normal state, indicating that this version is the most up-to-date and accessible version.
Some(true)trueThe metadata’s associated version is the latest, deleted version (Latest Delete Marker or Soft Deleted). This is particularly important in object storage systems like S3. It signifies that this version is the most recent delete marker, indicating the object has been deleted. Subsequent GET requests will return 404 errors unless a specific version ID is provided.
Some(false)falseThe metadata’s associated version is neither the latest version nor deleted. This indicates that this version is a previous version, still accessible by specifying its version ID.
Some(false)trueThe metadata’s associated version is not the latest version and is deleted. This represents a historical version that has been marked for deletion. Users will need to specify the version ID to access it, and accessing it may be subject to specific delete marker behavior (e.g., in S3, it might not return actual data but a specific delete marker response).
NonefalseThe metadata’s associated file is not deleted, but its version status is either unknown or it is not the latest version. This likely indicates that versioning is not enabled for this file, or versioning information is unavailable.
NonetrueThe metadata’s associated file is deleted, but its version status is either unknown or it is not the latest version. This typically means the file was deleted without versioning enabled, or its versioning information is unavailable. This may represent an actual data deletion operation rather than an S3 delete marker.

Implementations§

source§

impl Metadata

source

pub fn new(mode: EntryMode) -> Self

Create a new metadata

source

pub fn mode(&self) -> EntryMode

mode represent this entry’s mode.

source

pub fn set_mode(&mut self, v: EntryMode) -> &mut Self

Set mode for entry.

source

pub fn with_mode(self, v: EntryMode) -> Self

Set mode for entry.

source

pub fn is_file(&self) -> bool

Returns true if this metadata is for a file.

source

pub fn is_dir(&self) -> bool

Returns true if this metadata is for a directory.

source

pub fn is_current(&self) -> Option<bool>

Checks whether the metadata corresponds to the most recent version of the file.

This function is particularly useful when working with versioned objects, such as those stored in systems like AWS S3 with versioning enabled. It helps determine if the retrieved metadata represents the current state of the file or an older version.

Refer to docs in Metadata for more information about file versions.

§Return Value

The function returns an Option<bool> which can have the following values:

  • Some(true): Indicates that the metadata is associated with the latest version of the file. The metadata is current and reflects the most up-to-date state.
  • Some(false): Indicates that the metadata is not associated with the latest version of the file. The metadata belongs to an older version, and there might be a more recent version available.
  • None: Indicates that the currency of the metadata cannot be determined. This might occur if versioning is not supported or enabled, or if there is insufficient information to ascertain the version status.
source

pub fn set_is_current(&mut self, is_current: bool) -> &mut Self

Set the is_current status of this entry.

By default, this value will be None. Please avoid using this API if it’s unclear whether the entry is current. Set it to true if it is known to be the latest; otherwise, set it to false.

source

pub fn with_is_current(self, is_current: Option<bool>) -> Self

Set the is_current status of this entry.

By default, this value will be None. Please avoid using this API if it’s unclear whether the entry is current. Set it to true if it is known to be the latest; otherwise, set it to false.

source

pub fn is_deleted(&self) -> bool

Checks if the file (or version) associated with this metadata has been deleted.

This function returns true if the file represented by this metadata has been marked for deletion or has been permanently deleted. It returns false otherwise, indicating that the file (or version) is still present and accessible.

Refer to docs in Metadata for more information about file versions.

§Returns

bool: true if the object is considered deleted, false otherwise.

source

pub fn set_is_deleted(&mut self, v: bool) -> &mut Self

Set the deleted status of this entry.

source

pub fn with_is_deleted(self, v: bool) -> Self

Set the deleted status of this entry.

source

pub fn cache_control(&self) -> Option<&str>

Cache control of this entry.

Cache-Control is defined by RFC 7234 Refer to MDN Cache-Control for more information.

source

pub fn set_cache_control(&mut self, v: &str) -> &mut Self

Set cache control of this entry.

Cache-Control is defined by RFC 7234 Refer to MDN Cache-Control for more information.

source

pub fn with_cache_control(self, v: String) -> Self

Set cache control of this entry.

Cache-Control is defined by RFC 7234 Refer to MDN Cache-Control for more information.

source

pub fn content_length(&self) -> u64

Content length of this entry.

Content-Length is defined by RFC 7230

Refer to MDN Content-Length for more information.

§Returns

Content length of this entry. It will be 0 if the content length is not set by the storage services.

source

pub fn set_content_length(&mut self, v: u64) -> &mut Self

Set content length of this entry.

source

pub fn with_content_length(self, v: u64) -> Self

Set content length of this entry.

source

pub fn content_md5(&self) -> Option<&str>

Content MD5 of this entry.

Content MD5 is defined by RFC 2616. And removed by RFC 7231.

OpenDAL will try its best to set this value, but not guarantee this value is the md5 of content.

source

pub fn set_content_md5(&mut self, v: &str) -> &mut Self

Set content MD5 of this entry.

source

pub fn with_content_md5(self, v: String) -> Self

Set content MD5 of this entry.

source

pub fn content_type(&self) -> Option<&str>

Content Type of this entry.

Content Type is defined by RFC 9110.

Refer to MDN Content-Type for more information.

source

pub fn set_content_type(&mut self, v: &str) -> &mut Self

Set Content Type of this entry.

source

pub fn with_content_type(self, v: String) -> Self

Set Content Type of this entry.

source

pub fn content_encoding(&self) -> Option<&str>

Content Encoding of this entry.

Content Encoding is defined by RFC 7231

Refer to MDN Content-Encoding for more information.

source

pub fn set_content_encoding(&mut self, v: &str) -> &mut Self

Set Content Encoding of this entry.

source

pub fn content_range(&self) -> Option<BytesContentRange>

Content Range of this entry.

Content Range is defined by RFC 9110.

Refer to MDN Content-Range for more information.

source

pub fn set_content_range(&mut self, v: BytesContentRange) -> &mut Self

Set Content Range of this entry.

source

pub fn with_content_range(self, v: BytesContentRange) -> Self

Set Content Range of this entry.

source

pub fn last_modified(&self) -> Option<DateTime<Utc>>

Last modified of this entry.

Last-Modified is defined by RFC 7232

Refer to MDN Last-Modified for more information.

source

pub fn set_last_modified(&mut self, v: DateTime<Utc>) -> &mut Self

Set Last modified of this entry.

source

pub fn with_last_modified(self, v: DateTime<Utc>) -> Self

Set Last modified of this entry.

source

pub fn etag(&self) -> Option<&str>

ETag of this entry.

ETag is defined by RFC 7232

Refer to MDN ETag for more information.

OpenDAL will return this value AS-IS like the following:

  • "33a64df551425fcc55e4d42a148795d9f25f89d4"
  • W/"0815"

" is part of etag.

source

pub fn set_etag(&mut self, v: &str) -> &mut Self

Set ETag of this entry.

source

pub fn with_etag(self, v: String) -> Self

Set ETag of this entry.

source

pub fn content_disposition(&self) -> Option<&str>

Content-Disposition of this entry

Content-Disposition is defined by RFC 2616 and clarified usage in RFC 6266.

Refer to MDN Content-Disposition for more information.

OpenDAL will return this value AS-IS like the following:

  • “inline”
  • “attachment”
  • “attachment; filename="filename.jpg"”
source

pub fn set_content_disposition(&mut self, v: &str) -> &mut Self

Set Content-Disposition of this entry

source

pub fn with_content_disposition(self, v: String) -> Self

Set Content-Disposition of this entry

source

pub fn version(&self) -> Option<&str>

Retrieves the version of the file, if available.

The version is typically used in systems that support object versioning, such as AWS S3.

§Returns
  • Some(&str): If the file has a version associated with it, this function returns Some containing a reference to the version ID string.
  • None: If the file does not have a version, or if versioning is not supported or enabled for the underlying storage system, this function returns None.
source

pub fn set_version(&mut self, v: &str) -> &mut Self

Set the version of the file

source

pub fn with_version(self, v: String) -> Self

With the version of the file.

source

pub fn user_metadata(&self) -> Option<&HashMap<String, String>>

User defined metadata of this entry

The prefix of the user defined metadata key(for example: in oss, it’s x-oss-meta-) is remove from the key

source

pub fn with_user_metadata(&mut self, data: HashMap<String, String>) -> &mut Self

Set user defined metadata of this entry

Trait Implementations§

source§

impl Clone for Metadata

source§

fn clone(&self) -> Metadata

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 Metadata

source§

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

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

impl Default for Metadata

source§

fn default() -> Metadata

Returns the “default value” for a type. Read more
source§

impl From<MetaData> for Metadata

Available on crate feature services-sftp only.

REMOVE ME: we should not implement From<SftpMeta> for Metadata.

source§

fn from(meta: SftpMeta) -> Self

Converts to this type from the input type.
source§

impl PartialEq for Metadata

source§

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

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

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

impl Eq for Metadata

source§

impl StructuralPartialEq for Metadata

Auto Trait Implementations§

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
§

impl<T> CompatExt for T

§

fn compat(self) -> Compat<T>

Applies the [Compat] adapter by value. Read more
§

fn compat_ref(&self) -> Compat<&T>

Applies the [Compat] adapter by shared reference. Read more
§

fn compat_mut(&mut self) -> Compat<&mut T>

Applies the [Compat] adapter by mutable reference. Read more
§

impl<T> Conv for T

§

fn conv<T>(self) -> T
where Self: Into<T>,

Converts self into T using Into<T>. Read more
§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

source§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
§

impl<T> FmtForward for T

§

fn fmt_binary(self) -> FmtBinary<Self>
where Self: Binary,

Causes self to use its Binary implementation when Debug-formatted.
§

fn fmt_display(self) -> FmtDisplay<Self>
where Self: Display,

Causes self to use its Display implementation when Debug-formatted.
§

fn fmt_lower_exp(self) -> FmtLowerExp<Self>
where Self: LowerExp,

Causes self to use its LowerExp implementation when Debug-formatted.
§

fn fmt_lower_hex(self) -> FmtLowerHex<Self>
where Self: LowerHex,

Causes self to use its LowerHex implementation when Debug-formatted.
§

fn fmt_octal(self) -> FmtOctal<Self>
where Self: Octal,

Causes self to use its Octal implementation when Debug-formatted.
§

fn fmt_pointer(self) -> FmtPointer<Self>
where Self: Pointer,

Causes self to use its Pointer implementation when Debug-formatted.
§

fn fmt_upper_exp(self) -> FmtUpperExp<Self>
where Self: UpperExp,

Causes self to use its UpperExp implementation when Debug-formatted.
§

fn fmt_upper_hex(self) -> FmtUpperHex<Self>
where Self: UpperHex,

Causes self to use its UpperHex implementation when Debug-formatted.
§

fn fmt_list(self) -> FmtList<Self>
where &'a Self: for<'a> IntoIterator,

Formats each item in a sequence. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

§

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

§

fn from_ref(input: &T) -> T

Converts to this type from a reference to the input type.
§

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

§

fn from_ref(input: &T) -> T

Converts to this type from a reference to the input type.
§

impl<T> FutureExt for T

§

fn with_context(self, otel_cx: Context) -> WithContext<Self>

Attaches the provided Context to this type, returning a WithContext wrapper. Read more
§

fn with_current_context(self) -> WithContext<Self>

Attaches the current Context to this type, returning a WithContext wrapper. Read more
§

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> IntoEither for T

source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
source§

impl<T> IntoRequest<T> for T

source§

fn into_request(self) -> Request<T>

Wrap the input message T in a tonic::Request
source§

impl<T> IntoRequest<T> for T

source§

fn into_request(self) -> Request<T>

Wrap the input message T in a tonic::Request
§

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

§

fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> R
where Self: Sized,

Pipes by value. This is generally the method you want to use. Read more
§

fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> R
where R: 'a,

Borrows self and passes that borrow into the pipe function. Read more
§

fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> R
where R: 'a,

Mutably borrows self and passes that borrow into the pipe function. Read more
§

fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
where Self: Borrow<B>, B: 'a + ?Sized, R: 'a,

Borrows self, then passes self.borrow() into the pipe function. Read more
§

fn pipe_borrow_mut<'a, B, R>( &'a mut self, func: impl FnOnce(&'a mut B) -> R, ) -> R
where Self: BorrowMut<B>, B: 'a + ?Sized, R: 'a,

Mutably borrows self, then passes self.borrow_mut() into the pipe function. Read more
§

fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
where Self: AsRef<U>, U: 'a + ?Sized, R: 'a,

Borrows self, then passes self.as_ref() into the pipe function.
§

fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
where Self: AsMut<U>, U: 'a + ?Sized, R: 'a,

Mutably borrows self, then passes self.as_mut() into the pipe function.
§

fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
where Self: Deref<Target = T>, T: 'a + ?Sized, R: 'a,

Borrows self, then passes self.deref() into the pipe function.
§

fn pipe_deref_mut<'a, T, R>( &'a mut self, func: impl FnOnce(&'a mut T) -> R, ) -> R
where Self: DerefMut<Target = T> + Deref, T: 'a + ?Sized, R: 'a,

Mutably borrows self, then passes self.deref_mut() into the pipe function.
§

impl<T> Pointable for T

§

const ALIGN: usize = _

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
source§

impl<T> Same for T

§

type Output = T

Should always be Self
§

impl<T> Tap for T

§

fn tap(self, func: impl FnOnce(&Self)) -> Self

Immutable access to a value. Read more
§

fn tap_mut(self, func: impl FnOnce(&mut Self)) -> Self

Mutable access to a value. Read more
§

fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
where Self: Borrow<B>, B: ?Sized,

Immutable access to the Borrow<B> of a value. Read more
§

fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
where Self: BorrowMut<B>, B: ?Sized,

Mutable access to the BorrowMut<B> of a value. Read more
§

fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
where Self: AsRef<R>, R: ?Sized,

Immutable access to the AsRef<R> view of a value. Read more
§

fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
where Self: AsMut<R>, R: ?Sized,

Mutable access to the AsMut<R> view of a value. Read more
§

fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
where Self: Deref<Target = T>, T: ?Sized,

Immutable access to the Deref::Target of a value. Read more
§

fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
where Self: DerefMut<Target = T> + Deref, T: ?Sized,

Mutable access to the Deref::Target of a value. Read more
§

fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self

Calls .tap() only in debug builds, and is erased in release builds.
§

fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self

Calls .tap_mut() only in debug builds, and is erased in release builds.
§

fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
where Self: Borrow<B>, B: ?Sized,

Calls .tap_borrow() only in debug builds, and is erased in release builds.
§

fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
where Self: BorrowMut<B>, B: ?Sized,

Calls .tap_borrow_mut() only in debug builds, and is erased in release builds.
§

fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
where Self: AsRef<R>, R: ?Sized,

Calls .tap_ref() only in debug builds, and is erased in release builds.
§

fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
where Self: AsMut<R>, R: ?Sized,

Calls .tap_ref_mut() only in debug builds, and is erased in release builds.
§

fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
where Self: Deref<Target = T>, T: ?Sized,

Calls .tap_deref() only in debug builds, and is erased in release builds.
§

fn tap_deref_mut_dbg<T>(self, func: impl FnOnce(&mut T)) -> Self
where Self: DerefMut<Target = T> + Deref, T: ?Sized,

Calls .tap_deref_mut() only in debug builds, and is erased in release builds.
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
§

impl<T> TryConv for T

§

fn try_conv<T>(self) -> Result<T, Self::Error>
where Self: TryInto<T>,

Attempts to convert self into T using TryInto<T>. 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
§

impl<G1, G2> Within<G2> for G1
where G2: Contains<G1>,

§

fn is_within(&self, b: &G2) -> bool

§

impl<T> ErasedDestructor for T
where T: 'static,

source§

impl<T> MaybeSend for T
where T: Send,

§

impl<T> MaybeSendSync for T