Crate qiniu_etag

qiniu-etag

七牛 Etag 计算器

负责根据输入的数据计算七牛 Etag，适配 V1 和 V2 版本，同时提供阻塞接口和异步接口（异步接口需要启用 async 功能）

七牛 Etag 文档：https://developer.qiniu.com/kodo/1231/appendix

代码示例

Etag V1 计算示例

use qiniu_etag::{EtagV1, prelude::*};

let mut etag_v1 = EtagV1::new();
etag_v1.update(b"etag");
assert_eq!(etag_v1.finalize_fixed().as_slice(), b"FpLiADEaVoALPkdb8tJEJyRTXoe_");

Etag V1 计算输入流示例

阻塞代码示例

use std::io::{copy, Cursor};
use qiniu_etag::{EtagV1, prelude::*};

let mut etag_v1 = EtagV1::new();
copy(&mut Cursor::new(b"etag"), &mut etag_v1)?;
assert_eq!(etag_v1.finalize_fixed().as_slice(), b"FpLiADEaVoALPkdb8tJEJyRTXoe_");

异步代码示例

use futures_lite::io::{copy, Cursor};
use qiniu_etag::{EtagV1, prelude::*};

let mut etag_v1 = EtagV1::new();
copy(&mut Cursor::new(b"etag"), &mut etag_v1).await?;
assert_eq!(etag_v1.finalize_fixed().as_slice(), b"FpLiADEaVoALPkdb8tJEJyRTXoe_");

Etag V2 计算示例

use qiniu_etag::{EtagV2, prelude::*};

let mut etag_v2 = EtagV2::new();
etag_v2.update(b"hello");
etag_v2.update(b"world");
assert_eq!(etag_v2.finalize_fixed().as_slice(), b"ns56DcSIfBFUENXjdhsJTIvl3Rcu");

Etag V2 计算输入流示例

与 V1 不同的是，Etag V2 要求传入数据的分块方式

阻塞代码示例

use qiniu_etag::etag_with_parts;
use std::io::Cursor;

assert_eq!(
    etag_with_parts(
        &mut Cursor::new(data_of_size(9 << 20)),
        &[1 << 22, 1 << 22, 1 << 20]
    )?,
    "ljgVjMtyMsOgIySv79U8Qz4TrUO4",
);

异步代码示例

use qiniu_etag::async_etag_with_parts;
use futures_lite::io::Cursor;

assert_eq!(
    async_etag_with_parts(
        &mut Cursor::new(data_of_size(9 << 20)),
        &[1 << 22, 1 << 22, 1 << 20]
    ).await?,
    "ljgVjMtyMsOgIySv79U8Qz4TrUO4",
);

Modules

• prelude
  将所有 Trait 全部重新导出，方便统一导入

Structs

• EtagV1
  Etag V1 计算器，使用 Etag V1 算法计算七牛云存储上文件的 HASH 值
• EtagV2
  Etag V2 计算器，使用 Etag V2 算法计算七牛云存储上文件的 HASH 值
• GenericArray
  Struct representing a generic array - GenericArray<T, N> works like [T; N]

Enums

• Etag
  兼容 Etag 兼容计算器，可以为不同版本的 Etag 提供相同的接口
• EtagVersion
  Etag 版本

Constants

• ETAG_SIZE
  Etag 字符串固定长度

Traits

• FixedOutput
  Trait for returning digest result with the fixed size
• Reset
  Trait for resetting hash instances
• Update
  Trait for updating digest state with input data.

Functions

• async_etag_of
  异步读取 reader 中的数据并计算它的 Etag V1，生成结果
• async_etag_to_buf
  异步读取 reader 中的数据并计算它的 Etag V1，生成结果到指定的缓冲中
• async_etag_with_parts
  根据给出的数据块尺寸，异步读取 reader 中的数据并计算它的 Etag V2，生成结果
• async_etag_with_parts_to_buf
  根据给出的数据块尺寸，异步读取 reader 中的数据并计算它的 Etag V2，生成结果到指定的数组中
• etag_of
  读取 reader 中的数据并计算它的 Etag V1，生成结果
• etag_to_buf
  读取 reader 中的数据并计算它的 Etag V1，生成结果到指定的缓冲中
• etag_with_parts
  根据给出的数据块尺寸，读取 reader 中的数据并计算它的 Etag V2，生成结果
• etag_with_parts_to_buf
  根据给出的数据块尺寸，读取 reader 中的数据并计算它的 Etag V2，生成结果到指定的数组中

Type Aliases

• U28