Go?Excelize?API源碼閱讀Close及NewSheet方法示例解析

更新時(shí)間：2022年08月08日 15:26:26 作者：丘山子

這篇文章主要為大家介紹了Go?Excelize?API源碼閱讀Close及NewSheet方法示例解析，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進(jìn)步，早日升職加薪

一、Go-Excelize簡介

Excelize 是 Go 語言編寫的用于操作 Office Excel 文檔基礎(chǔ)庫，基于 ECMA-376，ISO/IEC 29500 國際標(biāo)準(zhǔn)?？梢允褂盟鼇碜x取、寫入由 Microsoft Excel™ 2007 及以上版本創(chuàng)建的電子表格文檔。

支持 XLAM / XLSM / XLSX / XLTM / XLTX 等多種文檔格式，高度兼容帶有樣式、圖片(表)、透視表、切片器等復(fù)雜組件的文檔，并提供流式讀寫 API，用于處理包含大規(guī)模數(shù)據(jù)的工作簿?？蓱?yīng)用于各類報(bào)表平臺(tái)、云計(jì)算、邊緣計(jì)算等系統(tǒng)。

使用本類庫要求使用的 Go 語言為 1.15 或更高版本。

二、Close()

func (f *File) Close() error

此API的作用是關(guān)閉工作簿并清理打開文檔時(shí)可能產(chǎn)生的系統(tǒng)磁盤緩存。

下面來看看具體代碼：

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 是不是為空，這是一個(gè)*os.File類型的變量。應(yīng)該是關(guān)閉某個(gè)重要的緩存文件。

接下來就是遍歷臨時(shí)文件，os.Remove(v.(string))會(huì)刪除這些臨時(shí)文件和文件夾。以上步驟清理了打開文檔時(shí)可能產(chǎn)生的系統(tǒng)磁盤緩存。

三、NewSheet()

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

該API的作用是根據(jù)給定的工作表名稱來創(chuàng)建新工作表，并返回工作表在工作簿中的索引。請(qǐng)注意，在創(chuàng)建新的工作簿時(shí)，將包含名為 Sheet1 的默認(rèn)工作表。

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)
}

請(qǐng)注意，工作表名稱是不區(qū)分大小寫的。

先檢查給定名字的工資表是否存在，如果不存在GetSheetIndex就會(huì)返回-1，否則返回工作表索引。

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

如果GetSheetIndex就會(huì)返回-1，也就是工作表存在，就調(diào)用DeleteSheet把該工作表刪除。然后建立一個(gè)wb := f.workbookReader()工作簿讀取器。

for _, v := range wb.Sheets.Sheet {
		if v.SheetID > sheetID {
			sheetID = v.SheetID
		}
	}

這段代碼的意思應(yīng)該是求工作表的最大SheetID ，賦值給sheetID。

然后再創(chuàng)建或更新docProps/app.xml、[Content_Types].xml、/xl/worksheets/sheet%d.xml、 workbook.xml.rels、workbook.xml這些文件。

	// 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)

最后返回這個(gè)Sheet。

以上就是Go Excelize API源碼閱讀Close及NewSheet方法示例解析的詳細(xì)內(nèi)容，更多關(guān)于Go-Excelize API的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

您可能感興趣的文章: