Struct Bucket

#[non_exhaustive]
pub struct Bucket<PointerSel: PointerFamily = ArcPointer> { /* private fields */ }

内置的存放单个 bucket 的类型

Implementations

impl<T: PointerFamily> Bucket<T>

pub fn new( base: BucketBase, creation_date: DateTime<Utc>, storage_class: StorageClass, client: T::PointerType, ) -> Self

初始化 Bucket

pub fn creation_date(&self) -> &DateTime<Utc>

获取 bucket 创建时间

pub fn storage_class(&self) -> &StorageClass

获取 storage_class

pub fn base(&self) -> &BucketBase

读取 bucket 基本信息

impl Bucket

pub async fn get_object_list<Q: IntoIterator<Item = (QueryKey, QueryValue)>>( &self, query: Q, ) -> Result<ObjectList, ExtractListError>

查询 Object 列表

参数 query 有多种写法：

• [] 查所有
• [("max-keys".into(), "5".into())] 数组（不可变长度），最大可支持 size 为 8 的数组
• [("max-keys".into(), "5".into()), ("prefix".into(), "babel".into())] 数组（不可变长度）
• vec![("max-keys".into(), "5".into())] Vec(可变长度)
• vec![("max-keys".into(), 5u8.into())] 数字类型
• vec![("max-keys".into(), 1000u16.into())] u16 数字类型

pub async fn get_object_list2( &self, query: Query, ) -> Result<ObjectList, ExtractListError>

查询 Object 列表

impl Bucket<RcPointer>

pub fn get_object_list<Q: IntoIterator<Item = (QueryKey, QueryValue)>>( &self, query: Q, ) -> Result<ObjectList<RcPointer>, ExtractListError>

查询默认 bucket 的文件列表

查询条件参数有多种方式，具体参考 get_object_list 文档

Trait Implementations

impl AlignBuilder for Bucket

fn builder_with_header<H: IntoIterator<Item = (HeaderName, HeaderValue)>>( &self, method: Method, url: Url, resource: CanonicalizedResource, headers: H, ) -> Result<RequestBuilder, BuilderError>

根据具体的 API 接口参数，返回请求的构建器

fn builder( &self, method: Method, url: Url, resource: CanonicalizedResource, ) -> Result<RequestBuilder, BuilderError>

根据具体的 API 接口参数，返回请求的构建器（不带 headers）

impl AlignBuilder for Bucket<RcPointer>

对齐 Client, Bucket, ObjectList 等结构体的 trait

用于他们方便的实现 File trait

fn builder_with_header<H: IntoIterator<Item = (HeaderName, HeaderValue)>>( &self, method: Method, url: Url, resource: CanonicalizedResource, headers: H, ) -> Result<RequestBuilder, BuilderError>

根据具体的 API 接口参数，返回请求的构建器

fn builder( &self, method: Method, url: Url, resource: CanonicalizedResource, ) -> Result<RequestBuilder, BuilderError>

根据具体的 API 接口参数，返回请求的构建器（不带 headers）

impl<T: PointerFamily> AsRef<BucketBase> for Bucket<T>

fn as_ref(&self) -> &BucketBase

Converts this type into a shared reference of the (usually inferred) input type.

impl<T: PointerFamily> AsRef<BucketName> for Bucket<T>

fn as_ref(&self) -> &BucketName

Converts this type into a shared reference of the (usually inferred) input type.

impl<T: PointerFamily> AsRef<EndPoint> for Bucket<T>

fn as_ref(&self) -> &EndPoint

Converts this type into a shared reference of the (usually inferred) input type.

impl<PointerSel: Clone + PointerFamily> Clone for Bucket<PointerSel>

where PointerSel::PointerType: Clone,

fn clone(&self) -> Bucket<PointerSel>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: PointerFamily> Debug for Bucket<T>

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

Formats the value using the given formatter.

impl<T: PointerFamily> Default for Bucket<T>

fn default() -> Self

Returns the “default value” for a type.

impl GetStdWithPath<&ObjectBase<RcPointer>> for Bucket

用于在 Bucket 上对文件进行操作

文件路径可以是 &ObjectBase 类型

fn get_std_with_path( &self, base: &ObjectBase<RcPointer>, ) -> Option<(Url, CanonicalizedResource)>

根据 path 获取 Url 和 CanonicalizedResource

impl GetStdWithPath<&ObjectBase> for Bucket

用于在 Bucket 上对文件进行操作

文件路径可以是 &ObjectBase 类型

fn get_std_with_path( &self, base: &ObjectBase<ArcPointer>, ) -> Option<(Url, CanonicalizedResource)>

根据 path 获取 Url 和 CanonicalizedResource

impl GetStdWithPath<ObjectBase<RcPointer>> for Bucket

用于在 Bucket 上对文件进行操作

文件路径可以是 ObjectBase 类型

fn get_std_with_path( &self, base: ObjectBase<RcPointer>, ) -> Option<(Url, CanonicalizedResource)>

根据 path 获取 Url 和 CanonicalizedResource

impl GetStdWithPath<ObjectBase> for Bucket

用于在 Bucket 上对文件进行操作

文件路径可以是 ObjectBase 类型

fn get_std_with_path( &self, base: ObjectBase<ArcPointer>, ) -> Option<(Url, CanonicalizedResource)>

根据 path 获取 Url 和 CanonicalizedResource

impl<PointerSel: Hash + PointerFamily> Hash for Bucket<PointerSel>

where PointerSel::PointerType: Hash,

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl InitObject<Bucket<RcPointer>> for ListBuckets<RcPointer>

fn init_object(&mut self) -> Option<Bucket<RcPointer>>

初始化 object 的类型

impl InitObject<Bucket> for ListBuckets

fn init_object(&mut self) -> Option<Bucket>

初始化 object 的类型

impl<T: PointerFamily> PartialEq<BucketBase> for Bucket<T>

fn eq(&self, other: &BucketBase) -> 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<T: PointerFamily> PartialEq<DateTime<Utc>> for Bucket<T>

fn eq(&self, other: &DateTime<Utc>) -> 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<T: PointerFamily> PartialEq for Bucket<T>

fn eq(&self, other: &Bucket<T>) -> 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<T: PointerFamily> RefineBucket<BucketError> for Bucket<T>

fn set_name(&mut self, name: &str) -> Result<(), BucketError>

提取 bucket name

fn set_location(&mut self, location: &str) -> Result<(), BucketError>

提取 location

fn set_creation_date(&mut self, creation_date: &str) -> Result<(), BucketError>

提取 bucket 创建时间

fn set_storage_class(&mut self, storage_class: &str) -> Result<(), BucketError>

提取 storage_class

fn set_extranet_endpoint( &mut self, _extranet_endpoint: &str, ) -> Result<(), Error>

提取 extranet_endpoint

fn set_intranet_endpoint( &mut self, _intranet_endpoint: &str, ) -> Result<(), Error>

提取 intranet_endpoint

fn decode(&mut self, xml: &str) -> Result<(), InnerItemError>

解析 OSS 接口返回的 xml 数据