建站
咨詢
售后
建站咨詢
新聞中心
注解是 Java 的一個高級特性，Spring 更是以注解為基礎(chǔ)，發(fā)展出一套“注解驅(qū)動編程”。
這聽起來高大上，但畢竟是框架的事，我們也能用好注解嗎？
的確，我們很少有機(jī)會自己寫注解，導(dǎo)致我們搞不清楚注解是怎么回事，更別提用好注解了。
既然這樣，我們就從具體的工作出發(fā)，開發(fā)一個 Excel 導(dǎo)出功能。我相信，你在搞懂這個例子后，就能明白注解是怎么個用法。
Excel 導(dǎo)出-需求拆解
在后臺管理系統(tǒng)中，常常需要把數(shù)據(jù)導(dǎo)出 Excel 表。
比如，在雙十一過后，銷售部要把商品訂單錄入到 Excel 表，財務(wù)部要把支付訂單錄入到 Excel 表，然后各部門匯總分析，最后找個時間討論怎么改善公司的服務(wù)。
你想呀，雙十一的訂單成千上萬，靠人工錄入，少說也要花三四天，而且還特別容易出錯。所以，你必須開發(fā) Excel 導(dǎo)出功能。
那么，具體怎么做呢？
上次我們提到，注解想發(fā)揮作用，有三個要素：定義、使用、讀取。這次，我們就利用注解的三個特性，來實現(xiàn) Excel 導(dǎo)出功能，設(shè)計過程是這樣的。
第一步，我們要創(chuàng)建不同的 Excel 模型。雙十一過后，銷售部要訂單數(shù)據(jù)，財務(wù)部要支付數(shù)據(jù)，兩個部門要的 Excel 表肯定也不一樣，這就得幫每個部門創(chuàng)建不同的 Excel 模型，他們拿到想要的數(shù)據(jù)。
第二步，我們要根據(jù) Excel 模型，來導(dǎo)出 Excel 表。
看到這，你應(yīng)該明白 Excel 導(dǎo)出的設(shè)計過程了。接下來，我們就來一步步實現(xiàn)這個功能。
創(chuàng)建 Excel 模型
創(chuàng)建 Excel 模型，涉及到注解三要素中的定義、使用。
首先，定義 Excel 注解，我們直接看關(guān)鍵代碼。
- @Target({ElementType.FIELD})
- @Retention(RetentionPolicy.RUNTIME)
- public @interface ExcelField {
- /**
- * 導(dǎo)出字段標(biāo)題
- */
- String title();
- /**
- * 導(dǎo)出字段排序（升序）
- */
- int sort() default 0;
- /**
- * 對齊方式（0：自動；1：靠左；2：居中；3：靠右）
- */
- int align() default 0;
- }
這里用到了兩個元注解@Retention和@Target。@Target代表這個注解只能放在成員變量上；@Retention代表這個注解要加載到 JVM 內(nèi)存，我們可以用反射來讀取注解。
此外，注解還有 3 個成員變量，分別對應(yīng)：Excel 的字段標(biāo)題、字段排序、對齊方式，方便大家微調(diào)表格。到了這，定義 Excel 注解就完成了。
接下來，使用注解，我們還是直接看代碼。
- public class OrderModel {
- @ExcelField(title = "訂單號", align = 2, sort = 20)
- private String orderNo;
- @ExcelField(title = "金額", align = 2, sort = 20)
- private String amount;
- // 創(chuàng)建時間
- private Date createTime;
- // 省略 getter/setter 方法
- }
訂單模型有 3 個字段：訂單號、金額、創(chuàng)建時間，但這里注解只加到訂單號、金額上，表示這兩個字段會導(dǎo)出 Excel 表，而創(chuàng)建時間會忽略，你可以看看這副圖片。
至此，我們完成了定義注解、使用注解，得到了一個 Excel 模型。但要想實現(xiàn)導(dǎo)出功能，還必須根據(jù)這個模型，生成出 Excel 表。
讀取 Excel 模型
讀取 Excel 模型，涉及到注解三要素中的讀取。 我們需要讀取注解，生成 Excel 表，這主要分成 3 個步驟：初始化 Excel 表對象—>寫入數(shù)據(jù)到 Excel 表對象—>輸出文件。
第一步，初始化 Excel 表對象。在這一步中，我們要根據(jù) Excel 模型，生成一個 Excel 表對象，要創(chuàng)建這幾個東西：標(biāo)題、表頭、樣式等等。我們來看代碼。
- public class ExcelExporter {
- // ...省略無數(shù)代碼
- /***************************** 初始化 Excel 表對象 ****************************/
- /**
- * 構(gòu)造函數(shù)
- * @param title 表格標(biāo)題，傳“空值”，表示無標(biāo)題
- * @param cls excel模型對象
- */
- public ExcelExporter(String title, Class cls) {
- // 獲取注解list
- Field[] fs = cls.getDeclaredFields();
- for (Field f : fs) {
- ExcelField ef = f.getAnnotation(ExcelField.class);
- if (ef != null) {
- annotationList.add(new Object[]{ef, f});
- }
- }
- annotationList.sort(comparing(o -> ((ExcelField) o[0]).sort()));
- // 通過注解獲取表頭
- List
headerList = new ArrayList<>(); - for (Object[] os : annotationList) {
- String t = ((ExcelField) os[0]).title();
- headerList.add(t);
- }
- // 初始化excel表：創(chuàng)建excel表、添加表標(biāo)題、創(chuàng)建表頭等等
- initialize(title, headerList);
- }
- }
在初始化的時候，我們先從 Excel 模型對象中讀取注解，獲得一個注解列表；然后，再從注解列表中，讀取 title-字段標(biāo)題；最后，再初始化 Excel 表對象，包括：創(chuàng)建 Excel 表對象、添加表標(biāo)題、創(chuàng)建表頭、添加樣式。
第二步，寫入數(shù)據(jù)到 Excel 表對象。在這一步中，我們要把 Java 的列表數(shù)據(jù)寫到 Excel 表對象里，讓這些數(shù)據(jù)能變成 Excel 表的一行行信息。還是來看代碼。
- public class ExcelExporter {
- /***************************** 初始化 Excel 表對象 ****************************/
- // ...省略無數(shù)代碼
- /***************************** 寫入數(shù)據(jù)到 Excel 表對象 ****************************/
- /**
- * 寫入數(shù)據(jù)
- * @return list 數(shù)據(jù)列表
- */
- public
ExcelExporter setDataList(List list) { - for (E dataObj : list) {
- // 添加行
- Row row = this.addRow();
- // 獲取數(shù)據(jù)，并寫入單元格
- int cellNo = 0;
- for (Object[] os : annotationList) {
- // 獲取成員變量的值
- Object value = null;
- try {
- value = Reflections.invokeGetter(dataObj, ((Field) os[1]).getName());
- } catch (Exception ex) {
- log.info(ex.toString());
- value = "";
- }
- if (value == null) {
- value = "";
- }
- // 寫入單元格
- ExcelField ef = (ExcelField) os[0];
- this.addCell(row, cellNo++, value, ef.align());
- }
- }
- return this;
- }
- }
我們先傳入一個數(shù)據(jù)列表 dataList，然后用循環(huán)來遍歷 dataList，在這個循環(huán)中，我們不斷把數(shù)據(jù)寫進(jìn) Excel 表對象里，具體操作是：創(chuàng)建了一個空白行，利用注解獲取成員變量里的值，最后寫進(jìn) Excel 表的單元格里。
第三步，輸出文件。在這一步中，就是 Excel 表對象變成一個文件，來看下最后的代碼吧。
- public class ExcelExporter {
- /***************************** 初始化 Excel 表對象 ****************************/
- // ...省略無數(shù)代碼
- /***************************** 寫入數(shù)據(jù)到 Excel 表對象 ****************************/
- // ...省略無數(shù)代碼
- /***************************** 輸出相關(guān) ****************************/
- /**
- * 輸出到文件
- * @param fileName 輸出文件名，加上絕對路徑
- */
- public ExcelExporter writeFile(String fileName) throws IOException {
- FileOutputStream os = new FileOutputStream(fileName);
- this.write(os);
- return this;
- }
- }
輸出文件就沒什么好說的了，就是指定文件名，然后把文件輸出到指定的地方。
到了這，讀取 Excel 模型就完成了。
當(dāng)然，讀取 Excel 模型涉及到注解的讀取，這是最難理解的地方，因為讀取注解要用到 Java 另一個高級特性—反射。而且，注解一般是用來簡化業(yè)務(wù)，如果你對業(yè)務(wù)沒有深刻的了解，是很難用好的。
限于篇幅，我只講了最核心的代碼，項目的完整代碼放在文末的鏈接上，大家可以好好看看。
寫在最后
注解想發(fā)揮作用，有三個要素：定義、使用、讀取。這篇文章利用了注解的三要素，實現(xiàn)了 Excel 導(dǎo)出功能。
這分成兩步。第一步，創(chuàng)建 Excel 模型，這涉及到注解三要素中的定義、使用；第二步，讀取 Excel 模型，這涉及到注解三要素中的讀取。
總之，注解一般用來簡化業(yè)務(wù)，你要想用好注解，不但得熟練掌握 Java 的高級用法，還得對業(yè)務(wù)有深刻的理解。
分享文章：Java高級特性-注解：注解實現(xiàn)Excel導(dǎo)出功能
本文URL：http://m.5511xx.com/article/codoepp.html
