在 Go 语言的世界里，io.Reader 和 io.Writer 接口是数据流处理的基石。然而，标准库并没有提供一种便捷的方式来追踪通过这些接口传输的字节数。metered-io 库应运而生，它提供了 io.Reader 和 io.Writer 的替代品，并能够方便地获取传输的字节总数，为性能度量和监控提供了强大的支持。
metered-io 库简介
metered-io 库的核心价值在于其对标准库 io.Reader 和 io.Writer 接口的无缝替换。它提供了一系列函数，用于创建封装了原始 reader 和 writer 的 metered reader 和 writer 对象。这些 metered 对象在保留原有功能的基础上，还能够记录传输的字节数，并通过简单的方法供开发者获取。
使用 metered-io 库
安装
使用以下命令即可轻松安装 metered-io 库：
go get github.com/samber/go-metered-io创建 Metered Reader
metered.NewReader 函数用于创建一个 metered reader 对象：
import "github.com/samber/go-metered-io"
r := metered.NewReader(strings.NewReader("Hello, world!"))读取数据并获取传输字节数
使用 metered reader 读取数据的方式与标准库 io.Reader 完全相同。读取完成后，可以通过 Rx() 方法获取已读取的字节数：
buf := make([]byte, 5)
n, err := r.Read(buf)
// ... 处理数据和错误 ...
totalBytes := r.Rx()创建 Metered Writer
类似地，metered.NewWriter 函数用于创建一个 metered writer 对象：
var buf bytes.Buffer
w := metered.NewWriter(&buf)写入数据并获取传输字节数
使用 metered writer 写入数据的方式与标准库 io.Writer 完全相同。写入完成后，可以通过 Tx() 方法获取已写入的字节数：
n, err := w.Write([]byte("Hello, world!"))
// ... 处理错误 ...
totalBytes := w.Tx()metered-io 库的优势
- 无缝替换: metered-io 库的设计目标是成为标准库 io.Reader 和 io.Writer 的替代品，因此开发者可以轻松地将其集成到现有项目中。
- 使用简便: 创建 metered reader 和 writer 对象非常简单，获取传输字节数也只需调用一个方法。
- 功能丰富: 除了基本的字节计数功能外，metered-io 库还提供了 metered.NewReadCloser、metered.NewWriteCloser 等函数，用于创建支持 Close() 方法的 metered reader 和 writer。
应用场景
- 性能监控: metered-io 库可以帮助开发者实时监控数据传输量，及时发现性能瓶颈。
- 流量控制: 通过监控传输字节数，开发者可以实现精细化的流量控制策略。
- 日志记录: metered-io 库可以方便地记录数据传输量，为问题排查提供数据支持。
总结
metered-io 库是一个简单易用但功能强大的工具，为 Go 开发者提供了便捷的字节计数功能，极大地简化了性能度量和监控的开发工作。其无缝替换标准库接口的设计理念，使得开发者可以轻松地将其集成到现有项目中，并从中受益。
