登录
首页 >  Golang >  Go教程

Go Excelize API源码阅读Close及NewSheet方法示例解析

来源:脚本之家

时间:2023-01-18 12:39:49 267浏览 收藏

本篇文章给大家分享《Go Excelize API源码阅读Close及NewSheet方法示例解析》,覆盖了Golang的常见基础知识,其实一个语言的全部知识点一篇文章是不可能说完的,但希望通过这些问题,让读者对自己的掌握程度有一定的认识(B 数),从而弥补自己的不足,更好的掌握它。

一、Go-Excelize简介

Excelize 是 Go 语言编写的用于操作 Office Excel 文档基础库,基于 ECMA-376,ISO/IEC 29500 国际标准。可以使用它来读取、写入由 Microsoft Excel™ 2007 及以上版本创建的电子表格文档。

支持 XLAM / XLSM / XLSX / XLTM / XLTX 等多种文档格式,高度兼容带有样式、图片(表)、透视表、切片器等复杂组件的文档,并提供流式读写 API,用于处理包含大规模数据的工作簿。可应用于各类报表平台、云计算、边缘计算等系统。

使用本类库要求使用的 Go 语言为 1.15 或更高版本。

二、Close()

1
func (f *File) Close() error

此API的作用是关闭工作簿并清理打开文档时可能产生的系统磁盘缓存。

下面来看看具体代码:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
func (f *File) Close() error {
    var err error
    if f.sharedStringTemp != nil {
        if err := f.sharedStringTemp.Close(); err != nil {
            return err
        }
    }
    f.tempFiles.Range(func(k, v interface{}) bool {
        if err = os.Remove(v.(string)); err != nil {
            return false
        }
        return true
    })
    return err
}

先判断sharedStringTemp 是不是为空,这是一个*os.File类型的变量。应该是关闭某个重要的缓存文件。

接下来就是遍历临时文件,os.Remove(v.(string))会删除这些临时文件和文件夹。 以上步骤清理了打开文档时可能产生的系统磁盘缓存。

三、NewSheet()

1
func (f *File) NewSheet(sheet string) int

该API的作用是根据给定的工作表名称来创建新工作表,并返回工作表在工作簿中的索引。请注意,在创建新的工作簿时,将包含名为 Sheet1 的默认工作表。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
func (f *File) NewSheet(name string) int {
    // Check if the worksheet already exists
    index := f.GetSheetIndex(name)
    if index != -1 {
        return index
    }
    f.DeleteSheet(name)
    f.SheetCount++
    wb := f.workbookReader()
    sheetID := 0
    for _, v := range wb.Sheets.Sheet {
        if v.SheetID > sheetID {
            sheetID = v.SheetID
        }
    }
    sheetID++
    // Update docProps/app.xml
    f.setAppXML()
    // Update [Content_Types].xml
    f.setContentTypes("/xl/worksheets/sheet"+strconv.Itoa(sheetID)+".xml", ContentTypeSpreadSheetMLWorksheet)
    // Create new sheet /xl/worksheets/sheet%d.xml
    f.setSheet(sheetID, name)
    // Update workbook.xml.rels
    rID := f.addRels(f.getWorkbookRelsPath(), SourceRelationshipWorkSheet, fmt.Sprintf("/xl/worksheets/sheet%d.xml", sheetID), "")
    // Update workbook.xml
    f.setWorkbook(name, sheetID, rID)
    return f.GetSheetIndex(name)
}

请注意,工作表名称是不区分大小写的。

先检查给定名字的工资表是否存在,如果不存在GetSheetIndex就会返回-1,否则返回工作表索引。

1
2
3
4
5
6
7
8
func (f *File) GetSheetIndex(name string) int {
    for index, sheet := range f.GetSheetList() {
        if strings.EqualFold(sheet, trimSheetName(name)) {
            return index
        }
    }
    return -1
}

如果GetSheetIndex就会返回-1,也就是工作表存在,就调用DeleteSheet把该工作表删除。 然后建立一个wb := f.workbookReader()工作簿读取器。

1
2
3
4
5
for _, v := range wb.Sheets.Sheet {
        if v.SheetID > sheetID {
            sheetID = v.SheetID
        }
    }

这段代码的意思应该是求工作表的最大SheetID ,赋值给sheetID。

然后再创建或更新docProps/app.xml、[Content_Types].xml、/xl/worksheets/sheet%d.xml、 workbook.xml.rels、workbook.xml这些文件。

1
2
3
4
5
6
7
8
9
10
// Update docProps/app.xml
f.setAppXML()
// Update [Content_Types].xml
f.setContentTypes("/xl/worksheets/sheet"+strconv.Itoa(sheetID)+".xml", ContentTypeSpreadSheetMLWorksheet)
// Create new sheet /xl/worksheets/sheet%d.xml
f.setSheet(sheetID, name)
// Update workbook.xml.rels
rID := f.addRels(f.getWorkbookRelsPath(), SourceRelationshipWorkSheet, fmt.Sprintf("/xl/worksheets/sheet%d.xml", sheetID), "")
// Update workbook.xml
f.setWorkbook(name, sheetID, rID)

最后返回这个Sheet。

终于介绍完啦!小伙伴们,这篇关于《Go Excelize API源码阅读Close及NewSheet方法示例解析》的介绍应该让你收获多多了吧!欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布Golang相关知识,快来关注吧!

声明:本文转载于:脚本之家 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>
评论列表