Java高級特性-注解：注解實現(xiàn)Excel導(dǎo)出功能
注解是 Java 的一個高級特性，Spring 更是以注解為基礎(chǔ)，發(fā)展出一套“注解驅(qū)動編程”。
這聽起來高大上，但畢竟是框架的事，我們也能用好注解嗎？
的確，我們很少有機會自己寫注解，導(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ù)寫進 Excel 表對象里，具體操作是：創(chuàng)建了一個空白行，利用注解獲取成員變量里的值，最后寫進 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ù)有深刻的理解。
文章演示代碼：復(fù)制鏈接跳轉(zhuǎn)
https://gitee.com/jiarupc/excel-export
