Go-Excelize API源码阅读(三)——OpenReader()

简介: Excelize 是 Go 语言编写的用于操作 Office Excel 文档基础库,基于 ECMA-376,ISO/IEC 29500 国际标准。可以使用它来读取、写入由 Microsoft Excel™ 2007 及以上版本创建的电子表格文档。支持 XLAM / XLSM / XLSX / XLTM / XLTX 等多种文档格式,高度兼容带有样式、图片(表)、透视表、切片器等复杂组件的文档,并提供流式读写 API,用于处理包含大规模数据的工作簿。可应用于各类报表平台、云计算、边缘计算等系统。使用本类库要求使用的 Go 语言为 1.15 或更高版本。

Go-Excelize API源码阅读(三)——OpenReader()

开源摘星计划(WeOpen Star) 是由腾源会 2022 年推出的全新项目,旨在为开源人提供成长激励,为开源项目提供成长支持,助力开发者更好地了解开源,更快地跨越鸿沟,参与到开源的具体贡献与实践中。

不管你是开源萌新,还是希望更深度参与开源贡献的老兵,跟随“开源摘星计划”开启你的开源之旅,从一篇学习笔记、到一段代码的提交,不断挖掘自己的潜能,最终成长为开源社区的“闪亮之星”。

我们将同你一起,探索更多的可能性!

项目地址: WeOpen-Star:https://github.com/weopenprojects/WeOpen-Star

一、Go-Excelize简介

Excelize 是 Go 语言编写的用于操作 Office Excel 文档基础库,基于 ECMA-376,ISO/IEC 29500 国际标准。可以使用它来读取、写入由 Microsoft Excel™ 2007 及以上版本创建的电子表格文档。支持 XLAM / XLSM / XLSX / XLTM / XLTX 等多种文档格式,高度兼容带有样式、图片(表)、透视表、切片器等复杂组件的文档,并提供流式读写 API,用于处理包含大规模数据的工作簿。可应用于各类报表平台、云计算、边缘计算等系统。使用本类库要求使用的 Go 语言为 1.15 或更高版本。

二、OpenReader()

func OpenReader(r io.Reader, opt ...Options) (*File, error)OpenReader 的作用是从 io.Reader 读取数据流。

func OpenReader(r io.Reader, opt ...Options) (*File, error) {
    b, err := ioutil.ReadAll(r)
    if err != nil {
        return nil, err
    }
    f := newFile()
    f.options = parseOptions(opt...)
    if f.options.UnzipSizeLimit == 0 {
        f.options.UnzipSizeLimit = UnzipSizeLimit
        if f.options.UnzipXMLSizeLimit > f.options.UnzipSizeLimit {
            f.options.UnzipSizeLimit = f.options.UnzipXMLSizeLimit
        }
    }
    if f.options.UnzipXMLSizeLimit == 0 {
        f.options.UnzipXMLSizeLimit = StreamChunkSize
        if f.options.UnzipSizeLimit < f.options.UnzipXMLSizeLimit {
            f.options.UnzipXMLSizeLimit = f.options.UnzipSizeLimit
        }
    }
    if f.options.UnzipXMLSizeLimit > f.options.UnzipSizeLimit {
        return nil, ErrOptionsUnzipSizeLimit
    }
    if bytes.Contains(b, oleIdentifier) {
        if b, err = Decrypt(b, f.options); err != nil {
            return nil, ErrWorkbookFileFormat
        }
    }
    zr, err := zip.NewReader(bytes.NewReader(b), int64(len(b)))
    if err != nil {
        if len(f.options.Password) > 0 {
            return nil, ErrWorkbookPassword
        }
        return nil, err
    }
    file, sheetCount, err := f.ReadZipReader(zr)
    if err != nil {
        return nil, err
    }
    f.SheetCount = sheetCount
    for k, v := range file {
        f.Pkg.Store(k, v)
    }
    f.CalcChain = f.calcChainReader()
    f.sheetMap = f.getSheetMap()
    f.Styles = f.stylesReader()
    f.Theme = f.themeReader()
    return f, nil
}

ioutil.ReadAll(r)先从 io.Reader 读取整条数据流,newFile()创建一个 Excel 工作薄。

f.options.UnzipSizeLimit: UnzipSizeLimit指定了打开电子表格时的解压大小限制,以字节为单位,这个值应该大于或等于 UnzipXMLSizeLimit,默认的大小限制是16GB。

f.options.UnzipXMLSizeLimit:UnzipXMLSizeLimit指定解压工作表和共享字符串表的内存限制,单位为字节,当文件大小超过此值时,工作表的XML将被解压到系统的临时目录中,此值应小于或等于UnzipSizeLimit,默认值为 16MB。

UnzipSizeLimit = 1000 << 24
StreamChunkSize = 1 << 24

然后判断读取的数据流中是不是包含oleIdentifier = []byte{0xd0, 0xcf, 0x11, 0xe0, 0xa1, 0xb1, 0x1a, 0xe1}这是OLE 程序标识符,具体查看微软文档:https://docs.microsoft.com/zh-cn/office/vba/outlook/concepts/getting-started/ole-programmatic-identifiers-outlook

zip.NewReader返回一个从bytes.NewReader(b)读取的新的阅读器,它被赋值为给定的字节大小int64(len(b))。

f.ReadZipReader(zr)中ReadZipReader通过给定的选项提取电子表格。给定的选项主要是密码等:

type Options struct {
    MaxCalcIterations uint
    Password          string
    RawCellValue      bool
    UnzipSizeLimit    int64
    UnzipXMLSizeLimit int64
}

后面和新建文件API差不多NewFile(),给 f 结构体的成员赋值。

三、结语
这里是老岳,这是Go语言相关源码的解读第三篇,我会不断努力,给大家带来更多类似的文章,恳请大家不吝赐教。

目录
相关文章
|
2月前
|
缓存 前端开发 中间件
[go 面试] 前端请求到后端API的中间件流程解析
[go 面试] 前端请求到后端API的中间件流程解析
|
2月前
|
缓存 弹性计算 API
用 Go 快速开发一个 RESTful API 服务
用 Go 快速开发一个 RESTful API 服务
|
7天前
|
中间件 Go API
使用Go语言构建高性能RESTful API
在现代软件开发中,RESTful API因其简洁和高效而成为构建网络服务的首选。Go语言以其并发处理能力和高性能著称,是开发RESTful API的理想选择。本文将介绍如何使用Go语言构建RESTful API,包括基础的路由设置、中间件的使用、数据验证、错误处理以及性能优化。通过实际代码示例,我们将展示Go语言在API开发中的强大功能和灵活性。
|
12天前
|
存储 数据可视化 JavaScript
可视化集成API接口请求+变量绑定+源码输出
可视化集成API接口请求+变量绑定+源码输出
27 4
|
29天前
|
JSON Go API
使用Go语言和Gin框架构建RESTful API:GET与POST请求示例
使用Go语言和Gin框架构建RESTful API:GET与POST请求示例
|
1月前
|
Go API 开发者
深入探讨:使用Go语言构建高性能RESTful API服务
在本文中,我们将探索Go语言在构建高效、可靠的RESTful API服务中的独特优势。通过实际案例分析,我们将展示Go如何通过其并发模型、简洁的语法和内置的http包,成为现代后端服务开发的有力工具。
|
2月前
|
存储 算法 Java
Go 通过 Map/Filter/ForEach 等流式 API 高效处理数据
Go 通过 Map/Filter/ForEach 等流式 API 高效处理数据
|
2月前
|
存储 Linux API
Linux源码阅读笔记08-进程调度API系统调用案例分析
Linux源码阅读笔记08-进程调度API系统调用案例分析
|
2月前
|
Linux API
Linux源码阅读笔记07-进程管理4大常用API函数
Linux源码阅读笔记07-进程管理4大常用API函数
|
2月前
|
JSON 算法 API
京东以图搜图功能API接口调用算法源码python
京东图搜接口是一款强大工具,通过上传图片即可搜索京东平台上的商品。适合电商平台、比价应用及需商品识别服务的场景。使用前需了解接口功能并注册开发者账号获取Key和Secret;准备好图片的Base64编码和AppKey;生成安全签名后,利用HTTP客户端发送POST请求至接口URL;最后解析JSON响应数据以获取商品信息。