go语言内置io包中TreeReader函数的理解和使用示例

在go语言的内置io包中的这个 TreeReader函数,函数原型 func TeeReader(r Reader, w Writer) Reader 从函数原型中看是给他一个Reader, 和一个Writer 然后他给你返回一个Reader, 本文中我们把这个返回的Reader叫做 treeReader, 他是一个很特别的reader,。

他的作用就是将你输入的 r 和w建立一个对应关系, 当你在读取这个treeReader的时候,他会将读取到的数据同时写入到w中。同时在他的内部没有缓存,写入必须在读取完成之前完成。写入时遇到的任何错误都会报告为读取错误。

这个是官方的解释: " TeeReader returns a Reader that writes to w what it reads from r. All reads from r performed through it are matched with corresponding writes to w. There is no internal buffering - the write must complete before the read completes. Any error encountered while writing is reported as a read error. " 对于非英语母语的人来说看起来是不是有点绕啊? 😆

知道了他的作用, 那我们就可以根据他的作用来给他找合适的用处了, 我们一般用它来统计文件下载进度, 还有计算文件的HASH值等。

先看看官方给的小示例

这里的用途是在读取treeReader的时候同步将数据打印到标准输出中。

Go 复制代码
package main

import (
	"io"
	"log"
	"os"
	"strings"
)

func main() {
	var r io.Reader = strings.NewReader("some io.Reader stream to be read\n")

	r = io.TeeReader(r, os.Stdout)

	// Everything read from r will be copied to stdout.
	if _, err := io.ReadAll(r); err != nil {
		log.Fatal(err)
	}

}

使用io.ReeeReader来计算文件的hash值 sha256 Example测试用例

Go 复制代码
func ExampleCalSha() {
	file, err := os.Open("testdata/test.zip")
	if err != nil {
		fmt.Println("error opening file: ", err)
		return
	}
	hash256 := sha256.New()
	treeReader := io.TeeReader(file, hash256)
	// 又拷贝回去
	io.Copy(file, treeReader) // 这个的意义就在于用它来从treeReader中读取数据的同时写入到hash256中

	b256 := hash256.Sum(nil)
	fmt.Printf("文件 %v SHA256: %X", file.Name(), b256) // output: a
}

使用io.TreeReader来实时显示文件的下载进度

这个很简单,我们只需要自定义一个Writer, 然后 利用TreeReader将下载文件的返回流 resp.Body和我们自定义的这个Writer建议对应关系, 然后我们再来读取这treeReader的数据, 在我们呢读取数据的时候也会同步的将数据发送到我们自定义的Writer中, 我们的下载进度显示就在我们自定义的Writer中完成。 我们可以使用 io.Copy(outfile, treeReader) 来从treeReader中读取数据并拷贝到outfile输出文件中。

自定义的用来显示下载进度的Writer对象

Go 复制代码
// 自定义的用来统计和显示下载进度的对象
type DownProgress struct {
	CLen  uint64 //数据的总长度
	Total uint64 // 用来记录数据的总写入长度
}

// 注意,这个方法只有在treeReader中的数据被读取之后才会被调用, 每读一次这里调用一次
func (w *DownProgress) Write(b []byte) (int, error) {
	n := len(b) // number of bytes written
	w.Total += uint64(n)

	// 打印下载进度
	// 获取当前下载进度百分比,需要将除数和被除数数据类型都转为float64
	percent := float64(w.Total) / float64(w.CLen) * 100
	// 打印当前下载进度 注意这里的 %.2f 表示格式化浮点数 2位小数, 后面的 %% 表示在显示一个百分号 %
	fmt.Printf("\r下载中...  已完成百分比 %.2f%% ", percent)
	// 打印下载进度 end

	return n, nil
}

自定义Writer的使用

Go 复制代码
    resp,err:=http.DefaultClient.Get("https://cn.bing.com/th?id=OHR.MPPUnesco_ZH-CN8076198158_UHD.jpg")
	if err != nil {
		fmt.Println("request error: ", err)
		return
	}
	defer resp.Body.Close()

// 创建保存文件
	outfile, err := os.Create("abc.jpg")
	if err != nil {
		return err
	}
	defer outfile.Close()

   // 自定义一个用来统计下载进度的Writer
    downProgress := &DownProgress{CLen: uint64(resp.ContentLength)} // 下载进度显示对象, 这里利用io.TeeReader 将下载对象的数据和这个自定义的Writerd读取进行绑定, 在treeReader读取数据后会同步写入到这个自定义的write中,用来统计下载进度.

    treeReader := io.TeeReader(resp.Body, downProgress) //将自定义的writer和resp.Body建立联系

    io.Copy(outfile, treeReader) // 读取数据

执行后即可见到你的下载进度从0%到 100%显示

下载中... 已完成百分比 100.00%

还有其他的用法? 等待你的发现和探索。。。。。。

相关推荐
XiaoLeisj1 小时前
【JavaEE初阶 — 多线程】单例模式 & 指令重排序问题
java·开发语言·java-ee
励志成为嵌入式工程师2 小时前
c语言简单编程练习9
c语言·开发语言·算法·vim
捕鲸叉2 小时前
创建线程时传递参数给线程
开发语言·c++·算法
A charmer2 小时前
【C++】vector 类深度解析:探索动态数组的奥秘
开发语言·c++·算法
Peter_chq2 小时前
【操作系统】基于环形队列的生产消费模型
linux·c语言·开发语言·c++·后端
记录成长java4 小时前
ServletContext,Cookie,HttpSession的使用
java·开发语言·servlet
前端青山4 小时前
Node.js-增强 API 安全性和性能优化
开发语言·前端·javascript·性能优化·前端框架·node.js
睡觉谁叫~~~4 小时前
一文解秘Rust如何与Java互操作
java·开发语言·后端·rust
音徽编程4 小时前
Rust异步运行时框架tokio保姆级教程
开发语言·网络·rust
观音山保我别报错4 小时前
C语言扫雷小游戏
c语言·开发语言·算法