feat(decode): 减少对自定义类型的限制条件

当使用内部 ObjectList 类型，附加自定义的 RefineObject 实现时，定义 Error 的方式更加灵活

refrence #12

examples/custom.rs

@@ -2,7 +2,7 @@ use std::env;
 
 use aliyun_oss_client::{
     builder::BuilderError,
-    decode::{RefineObject, RefineObjectList},
+    decode::{CustomItemError, RefineObject, RefineObjectList},
     BucketName, Client,
 };
 use dotenv::dotenv;
@@ -46,8 +46,13 @@ enum MyError {
 
     #[error(transparent)]
     BuilderError(#[from] BuilderError),
+
+    #[error(transparent)]
+    Item(#[from] aliyun_oss_client::decode::ItemError),
 }
 
+impl CustomItemError for MyError {}
+
 async fn get_with_client() -> Result<(), MyError> {
     dotenv().ok();
 

examples/object_custom.rs

@@ -1,7 +1,9 @@
+use std::fmt::{self, Display};
+
 use aliyun_oss_client::{
-    builder::{ArcPointer, BuilderError},
+    builder::ArcPointer,
     config::{InvalidObjectDir, ObjectDir, ObjectPath},
-    decode::RefineObject,
+    decode::{CustomItemError, RefineObject},
     object::ObjectList,
     BucketName, Client,
 };
@@ -31,23 +33,12 @@ impl RefineObject<MyError> for MyObject {
 
 struct MyError(String);
 
-impl From<quick_xml::Error> for MyError {
-    fn from(value: quick_xml::Error) -> Self {
-        Self(value.to_string())
-    }
-}
-
-impl From<BuilderError> for MyError {
-    fn from(value: BuilderError) -> Self {
-        Self(value.to_string())
-    }
-}
-
-impl From<std::num::ParseIntError> for MyError {
-    fn from(value: std::num::ParseIntError) -> Self {
-        Self(value.to_string())
+impl Display for MyError {
+    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
+        f.write_fmt(format_args!("{}", self.0))
     }
 }
+impl CustomItemError for MyError {}
 
 impl From<InvalidObjectDir> for MyError {
     fn from(value: InvalidObjectDir) -> Self {

examples/parse_xml.rs

@@ -1,4 +1,4 @@
-use aliyun_oss_client::decode::{RefineObject, RefineObjectList};
+use aliyun_oss_client::decode::{CustomItemError, RefineObject, RefineObjectList};
 use thiserror::Error;
 
 struct MyFile {
@@ -35,8 +35,14 @@ impl RefineObjectList<MyFile, MyError> for MyBucket {
 enum MyError {
     #[error(transparent)]
     QuickXml(#[from] quick_xml::Error),
+
+    /// TODO 这里是没有必要的，更好的方式是，不需要这个 From 限制
+    #[error(transparent)]
+    Item(#[from] aliyun_oss_client::decode::ItemError),
 }
 
+impl CustomItemError for MyError {}
+
 fn get_with_xml() -> Result<(), MyError> {
     // 这是阿里云接口返回的原始数据
     let xml = r#"<?xml version="1.0" encoding="UTF-8"?>

src/errors.rs

@@ -86,6 +86,15 @@ pub enum OssError {
     #[doc(hidden)]
     #[error("Without More Content")]
     WithoutMore,
+
+    #[cfg(feature = "decode")]
+    #[doc(hidden)]
+    #[error("{0}")]
+    ItemError(#[from] crate::decode::ItemError),
+
+    #[doc(hidden)]
+    #[error("{0}")]
+    BuildInItemError(#[from] crate::object::BuildInItemError),
 }
 
 impl OssError {

src/file.rs

@@ -79,7 +79,7 @@ use crate::{
     bucket::Bucket,
     builder::{ArcPointer, BuilderError, RequestBuilder},
     config::{InvalidObjectPath, ObjectBase, ObjectPath},
-    decode::RefineObject,
+    decode::{CustomItemError, RefineObject},
     object::{Object, ObjectList},
     types::{CanonicalizedResource, ContentRange},
     Client,
@@ -330,7 +330,7 @@ impl Files for Bucket {
 }
 
 /// 可将 `Object` 实例作为参数传递给各种操作方法
-impl<Item: RefineObject<E> + Send + Sync, E: From<quick_xml::Error> + Send + Sync> Files
+impl<Item: RefineObject<E> + Send + Sync, E: CustomItemError + Send + Sync> Files
     for ObjectList<ArcPointer, Item, E>
 {
     type Path = Object<ArcPointer>;
@@ -551,7 +551,7 @@ impl AlignBuilder for Bucket {
     }
 }
 
-impl<Item: RefineObject<E> + Send + Sync, E: From<quick_xml::Error> + Send + Sync> AlignBuilder
+impl<Item: RefineObject<E> + Send + Sync, E: CustomItemError + Send + Sync> AlignBuilder
     for ObjectList<ArcPointer, Item, E>
 {
     #[inline]