Enum UploadSource 

pub enum UploadSource {
    Bytes {
        data: Bytes,
        filename: String,
        mime_type: Option<String>,
    },
    Path {
        path: PathBuf,
        data: Bytes,
        filename: String,
        mime_type: Option<String>,
    },
    Reader {
        data: Bytes,
        filename: String,
        mime_type: Option<String>,
    },
}

表示一个可上传的文件来源。

Variants

Bytes

直接由内存字节构成。

Fields

data: Bytes

文件字节。

filename: String

文件名。

mime_type: Option<String>

可选 MIME 类型。

Path

由文件路径读取得到。

Fields

path: PathBuf

原始路径。

data: Bytes

文件字节。

filename: String

文件名。

mime_type: Option<String>

可选 MIME 类型。

Reader

由通用读取器读取得到。

Fields

data: Bytes

文件字节。

filename: String

文件名。

mime_type: Option<String>

可选 MIME 类型。

Implementations

impl UploadSource

pub fn from_path<P>(path: P) -> Result<Self>

where P: AsRef<Path>,

从文件路径创建上传源。

Errors

当文件不存在、无法读取或无法推导文件名时返回错误。

pub fn from_bytes<T, U>(bytes: T, filename: U) -> Self

where T: Into<Bytes>, U: Into<String>,

从内存字节创建上传源。

pub fn from_reader<R, U>(reader: R, filename: U) -> Result<Self>

where R: Read, U: Into<String>,

从通用读取器读取字节并创建上传源。

Errors

当读取器读取失败时返回错误。

pub async fn from_response(response: Response) -> Result<Self>

从 HTTP 响应中读取字节并创建上传源。

该方法会优先使用响应 URL 的最后一个路径段作为文件名。 如果无法推导，则回退为 upload.bin。

Errors

当响应体读取失败时返回错误。

pub fn with_mime_type<T>(self, mime_type: T) -> Self

where T: Into<String>,

覆盖 MIME 类型。

pub fn with_filename<T>(self, filename: T) -> Self

where T: Into<String>,

覆盖文件名。

pub fn filename(&self) -> &str

返回文件名。

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

返回 MIME 类型。

pub fn bytes(&self) -> &Bytes

返回原始字节。

pub fn to_part(&self) -> Result<Part>

把上传源转换为 reqwest::multipart::Part。

Errors

当 MIME 类型非法时返回错误。

Trait Implementations

impl Clone for UploadSource

fn clone(&self) -> UploadSource

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UploadSource

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

Formats the value using the given formatter.

impl From<UploadSource> for AudioPlaybackInput

fn from(value: UploadSource) -> Self

Converts to this type from the input type.

impl From<UploadSource> for ToFileInput

fn from(value: UploadSource) -> Self

Converts to this type from the input type.