當前位置：首頁 > 编程资源 > 编程问答 >内容正文

编程问答

第一章——快速入门

發布時間：2025/3/21 编程问答 31 豆豆

生活随笔收集整理的這篇文章主要介紹了第一章——快速入门小編覺得挺不錯的,現在分享給大家,幫大家做個參考.

為什么80%的碼農都做不了架構師？>>> ??

1? ? 介紹

jXLS是用于生成Excel報表的小型Java類庫。jXLS使用特殊標記在Excel模板中定義輸出格式和數據布局。

Java有優秀的創建Excel文件的開源和社區類庫。值得關注的開源類庫有Apache POI和Java Excel API。在某種意義上，這些類庫非常低級，需要編寫許多Java代碼才能創建一個簡單的Excel文件。通常需要手動設置每個單元格的格式和數據。報表布局和數據格式越復雜會導致Java代碼非常復雜和難以調試和維護。此外，不是所有的Excel特性都支持和使用API操作（例如，宏或圖表）。

在使用jXLS時，你所需要做的就是在一個Excel模板中定義所有報表格式和數據布局，并運行jXLS引擎，為它提供數據以填充模板。在大多數情況下，你需要編寫的唯一代碼是使用適當配置的jXLS引擎的簡單調用。

2????主要概念

2.1????Area（區域）

Area代表Excel文件中的矩形區域。可以使用單元格范圍或使用開始單元格和區域大小（行和列數）定義矩形區域。Area包括特定范圍的所有Excel單元格。

每個Area可以關聯一組命令，jXLS引擎處理區域時執行和區域相關的命令。Area可以嵌套子區域。每個子區域也是一個Area，也可以包含自己的命令和自己的子區域。

Area可以使用以下方式定義：

在Excel模板文件中使用特定標記語法。
使用XML配置。
使用jXLS Java API。

2.2????Command（命令）

命令代表一個或多個Area的轉換動作。Command接口如下所示：?

public interface Command {String getName();List<Area> getAreaList();Command addArea(Area area);Size applyAt(CellRef cellRef, Context context);void reset(); }

Command的主要方法是Size applyAt(CellRef cellRef, Context context)。該方法在單元格cellRef執行命令動作。context類似于一個map，用于為命令傳遞數據。該方法返回轉換后區域的大小作為Size對象。

當前，jXLS提供以下內置命令：

Each
If
Image

2.3????Transformer

Transformer接口允許Area與特定Excel實現無關。這意味著通過提供不同的Transformer接口實現，我們可以使用不同的底層Java->Excel庫。

Transformer接口如下所示：

public interface Transformer {void transform(CellRef srcCellRef, CellRef targetCellRef, Context context, boolean updateRowHeight);void setFormula(CellRef cellRef, String formulaString);Set<CellData> getFormulaCells();CellData getCellData(CellRef cellRef);List<CellRef> getTargetCellRef(CellRef cellRef);void resetTargetCellRefs();void resetArea(AreaRef areaRef);void clearCell(CellRef cellRef);List<CellData> getCommentedCells();void addImage(AreaRef areaRef, byte[] imageBytes, ImageType imageType);void write() throws IOException;TransformationConfig getTransformationConfig();void setTransformationConfig(TransformationConfig transformationConfig);boolean deleteSheet(String sheetName);void setHidden(String sheetName, boolean hidden);void updateRowHeight(String srcSheetName, int srcRowNum, String targetSheetName, int targetRowNum); }

盡管Transformer接口看起來有很多方法，但大多數方法已經在AbstractTransformer基礎抽象類中實現，如果需要提供新Java->Excel實現，只需繼承抽象類即可。

當前，jXLS提供兩種Transformer接口實現：

PoiTransformer
JexcelTransformer

PoiTransformer使用Apache POI類庫生成Excel文件。JexcelTransformer基于較老的Java Excel API類庫。

3? ? 例子：使用jXLS基于模板輸出員工列表到Excel中

3.1? ? 引入依賴

jXLS對Apache POI和Java Excel API進行高級封裝，因此，要使用jXLS必須引入底層Apache POI或Java Excel API，毋庸置疑，Apache POI是Java開源社區最強Excel解決方案，因此，我們選擇使用Apache POI作為jXLS的底層API。下面是引入Apache POI的依賴配置：

<dependency><groupId>org.apache.poi</groupId><artifactId>poi</artifactId><version>3.15</version> </dependency> <dependency><groupId>org.apache.poi</groupId><artifactId>poi-ooxml</artifactId><version>3.15</version> </dependency> <dependency><groupId>org.apache.poi</groupId><artifactId>poi-scratchpad</artifactId><version>3.15</version> </dependency> <dependency><groupId>org.apache.poi</groupId><artifactId>poi-ooxml-schemas</artifactId><version>3.15</version> </dependency> <dependency><groupId>org.apache.poi</groupId><artifactId>poi-excelant</artifactId><version>3.15</version> </dependency>

接下來我們需要引入jXLS的核心類庫：

jXLS核心類庫，并沒有直接實現對Excel的操作，而是定義了兩個適配器，分別使用Apache POI和Java Excel API對Excel進行操作。因為我們選擇使用Apache POI作為底層API操作Excel，因此，我們需要導入Apache POI適配器依賴：

一個完整的Maven依賴配置如下所示：

<dependency><groupId>org.jxls</groupId><artifactId>jxls</artifactId><version>2.4.5</version> </dependency>  <dependency><groupId>org.jxls</groupId><artifactId>jxls-poi</artifactId><version>1.0.15</version> </dependency>  <dependency><groupId>org.apache.poi</groupId><artifactId>poi</artifactId><version>3.15</version> </dependency> <dependency><groupId>org.apache.poi</groupId><artifactId>poi-ooxml</artifactId><version>3.15</version> </dependency> <dependency><groupId>org.apache.poi</groupId><artifactId>poi-scratchpad</artifactId><version>3.15</version> </dependency> <dependency><groupId>org.apache.poi</groupId><artifactId>poi-ooxml-schemas</artifactId><version>3.15</version> </dependency> <dependency><groupId>org.apache.poi</groupId><artifactId>poi-excelant</artifactId><version>3.15</version> </dependency>

3.1? ? 定義員工實體類

/*** 員工實體類* * @since 2018年7月11日* @author 趙凡* @version 1.0**/ public class Employee {private String name;// 員工名稱private String sex;// 性別private String telephone;// 手機號碼private Date birthday;// 生日private BigDecimal payment;// 工資// ... 構造函數// ... getters/setters}

3.2? ??創建Excel模板

模板是使用特定標記規定jXLS應該如何輸出數據的Excel文件。jXLS提供一些內置標記處理器解析Excel模板和提取控制命令。如有需要可以自定義標記處理器。因此，可以為Excel模板定義自己的標記，并以適當的方式進行解析，以創建jXLS命令結構。

默認，jXLS以Apache JEXL作為表達式語言在Excel模板中引用Java對象屬性和方法。對象必須在jXLS上下文中某一鍵上可用。為了在單元格中輸出員工名稱，可以在單元格中放入${employee.name}。使用${和}環繞JEXL表達式。假設在上下文中employee鍵下有一個Employee對象。

輸出員工列表信息的最終模板如下所示：

模板中第三行的單元格使用JEXL表達式引用employee對象的屬性。單元格A1包含的Excel注釋jx:area(lastCell="E4")定義模板根區域為A1:E4。單元格A3包含的Excel注釋jx:each(items="employees" var="employee" lastCell="E4")定義jXLS Each命令。Each命令迭代employees（由items屬性定義）集合的條目到上下文的employee（由var屬性定義）鍵。執行Each命令的區域是A3:E4（有lastCell屬性定義），該區域將會被克隆，并使用上下文中的每個新的Employee對象處理。

3.3????使用jXLS API處理模板

List<Employee> employees = generateSampleEmployeeData(); try(InputStream is = ObjectCollectionDemo.class.getResourceAsStream("object_collection_template.xls")) {try (OutputStream os = new FileOutputStream("target/object_collection_output.xls")) {Context context = new Context();context.putVar("employees", employees);JxlsHelper.getInstance().processTemplate(is, os, context);} }

運行程序生成如下所示的Excel：

轉載于:https://my.oschina.net/leeck/blog/1844426

總結

以上是生活随笔為你收集整理的第一章——快速入门的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。