我們不造輪子张惹,只是輪子的搬運(yùn)工息裸。(其實(shí)最好是造輪子蝇更,造比別人好的輪子)
開發(fā)中經(jīng)常會遇到excel的處理沪编,導(dǎo)入導(dǎo)出解析等等,java中比較流行的用poi簿寂,但是每次都要寫大段工具類來搞定這事兒漾抬,此處推薦一個別人造好的輪子【easypoi】,下面介紹下“輪子”的使用常遂。
pom引入
不再需要其他jar
<dependency>
<groupId>cn.afterturn</groupId>
<artifactId>easypoi-base</artifactId>
<version>3.0.3</version>
</dependency>
<dependency>
<groupId>cn.afterturn</groupId>
<artifactId>easypoi-web</artifactId>
<version>3.0.3</version>
</dependency>
<dependency>
<groupId>cn.afterturn</groupId>
<artifactId>easypoi-annotation</artifactId>
<version>3.0.3</version>
</dependency>
編寫實(shí)體類
此處注意必須要有空構(gòu)造函數(shù)纳令,否則會報錯“對象創(chuàng)建錯誤”
關(guān)于注解@Excel,其他還有@ExcelCollection克胳,@ExcelEntity 平绩,@ExcelIgnore,@ExcelTarget等漠另,此處我們用不到捏雌,可以去官方查看更多
屬性 | 類型 | 類型 | 說明 |
---|---|---|---|
name | String | null | 列名 |
needMerge | boolean | fasle | 縱向合并單元格 |
orderNum | String | "0" | 列的排序,支持name_id |
replace | String[] | {} | 值得替換 導(dǎo)出是{a_id,b_id} 導(dǎo)入反過來 |
savePath | String | "upload" | 導(dǎo)入文件保存路徑 |
type | int | 1 | 導(dǎo)出類型 1 是文本 2 是圖片,3 是函數(shù),10 是數(shù)字 默認(rèn)是文本 |
width | double | 10 | 列寬 |
height | double | 10 | 列高,后期打算統(tǒng)一使用@ExcelTarget的height,這個會被廢棄,注意 |
isStatistics | boolean | fasle | 自動統(tǒng)計數(shù)據(jù),在追加一行統(tǒng)計,把所有數(shù)據(jù)都和輸出這個處理會吞沒異常,請注意這一點(diǎn) |
isHyperlink | boolean | false | 超鏈接,如果是需要實(shí)現(xiàn)接口返回對象 |
isImportField | boolean | true | 校驗(yàn)字段,看看這個字段是不是導(dǎo)入的Excel中有,如果沒有說明是錯誤的Excel,讀取失敗,支持name_id |
exportFormat | String | "" | 導(dǎo)出的時間格式,以這個是否為空來判斷是否需要格式化日期 |
importFormat | String | "" | 導(dǎo)入的時間格式,以這個是否為空來判斷是否需要格式化日期 |
format | String | "" | 時間格式,相當(dāng)于同時設(shè)置了exportFormat 和 importFormat |
databaseFormat | String | "yyyyMMddHHmmss" | 導(dǎo)出時間設(shè)置,如果字段是Date類型則不需要設(shè)置 數(shù)據(jù)庫如果是string 類型,這個需要設(shè)置這個數(shù)據(jù)庫格式,用以轉(zhuǎn)換時間格式輸出 |
numFormat | String | "" | 數(shù)字格式化,參數(shù)是Pattern,使用的對象是DecimalFormat |
imageType | int | 1 | 導(dǎo)出類型 1 從file讀取 2 是從數(shù)據(jù)庫中讀取 默認(rèn)是文件 同樣導(dǎo)入也是一樣的 |
suffix | String | "" | 文字后綴,如% 90 變成90% |
isWrap | boolean | true | 是否換行 即支持\n |
mergeRely | int[] | {} | 合并單元格依賴關(guān)系,比如第二列合并是基于第一列 則{1}就可以了 |
mergeVertical | boolean | fasle | 縱向合并內(nèi)容相同的單元格 |
import cn.afterturn.easypoi.excel.annotation.Excel;
import java.util.Date;
public class Person {
@Excel(name = "姓名", orderNum = "0")
private String name;
@Excel(name = "性別", replace = {"男_1", "女_2"}, orderNum = "1")
private String sex;
@Excel(name = "生日", exportFormat = "yyyy-MM-dd", orderNum = "2")
private Date birthday;
public Person(String name, String sex, Date birthday) {
this.name = name;
this.sex = sex;
this.birthday = birthday;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getSex() {
return sex;
}
public void setSex(String sex) {
this.sex = sex;
}
public Date getBirthday() {
return birthday;
}
public void setBirthday(Date birthday) {
this.birthday = birthday;
}
}
導(dǎo)入導(dǎo)出公用方法
public static void exportExcel(List<?> list, String title, String sheetName, Class<?> pojoClass,String fileName,boolean isCreateHeader, HttpServletResponse response){
ExportParams exportParams = new ExportParams(title, sheetName);
exportParams.setCreateHeadRows(isCreateHeader);
defaultExport(list, pojoClass, fileName, response, exportParams);
}
public static void exportExcel(List<?> list, String title, String sheetName, Class<?> pojoClass,String fileName, HttpServletResponse response){
defaultExport(list, pojoClass, fileName, response, new ExportParams(title, sheetName));
}
public static void exportExcel(List<Map<String, Object>> list, String fileName, HttpServletResponse response){
defaultExport(list, fileName, response);
}
private static void defaultExport(List<?> list, Class<?> pojoClass, String fileName, HttpServletResponse response, ExportParams exportParams) {
Workbook workbook = ExcelExportUtil.exportExcel(exportParams,pojoClass,list);
if (workbook != null);
downLoadExcel(fileName, response, workbook);
}
private static void downLoadExcel(String fileName, HttpServletResponse response, Workbook workbook) {
try {
response.setCharacterEncoding("UTF-8");
response.setHeader("content-Type", "application/vnd.ms-excel");
response.setHeader("Content-Disposition",
"attachment;filename=" + URLEncoder.encode(fileName, "UTF-8"));
workbook.write(response.getOutputStream());
} catch (IOException e) {
throw new NormalException(e.getMessage());
}
}
private static void defaultExport(List<Map<String, Object>> list, String fileName, HttpServletResponse response) {
Workbook workbook = ExcelExportUtil.exportExcel(list, ExcelType.HSSF);
if (workbook != null);
downLoadExcel(fileName, response, workbook);
}
public static <T> List<T> importExcel(String filePath,Integer titleRows,Integer headerRows, Class<T> pojoClass){
if (StringUtils.isBlank(filePath)){
return null;
}
ImportParams params = new ImportParams();
params.setTitleRows(titleRows);
params.setHeadRows(headerRows);
List<T> list = null;
try {
list = ExcelImportUtil.importExcel(new File(filePath), pojoClass, params);
}catch (NoSuchElementException e){
throw new NormalException("模板不能為空");
} catch (Exception e) {
e.printStackTrace();
throw new NormalException(e.getMessage());
}
return list;
}
public static <T> List<T> importExcel(MultipartFile file, Integer titleRows, Integer headerRows, Class<T> pojoClass){
if (file == null){
return null;
}
ImportParams params = new ImportParams();
params.setTitleRows(titleRows);
params.setHeadRows(headerRows);
List<T> list = null;
try {
list = ExcelImportUtil.importExcel(file.getInputStream(), pojoClass, params);
}catch (NoSuchElementException e){
throw new NormalException("excel文件不能為空");
} catch (Exception e) {
throw new NormalException(e.getMessage());
}
return list;
}
對的,沒看錯笆搓,這就可以導(dǎo)出導(dǎo)入了,看起來代碼挺多性湿,其實(shí)是提供了多個導(dǎo)入導(dǎo)出方法而已
測試
@RequestMapping("export")
public void export(HttpServletResponse response){
//模擬從數(shù)據(jù)庫獲取需要導(dǎo)出的數(shù)據(jù)
List<Person> personList = new ArrayList<>();
Person person1 = new Person("路飛","1",new Date());
Person person2 = new Person("娜美","2", DateUtils.addDate(new Date(),3));
Person person3 = new Person("索隆","1", DateUtils.addDate(new Date(),10));
Person person4 = new Person("小貍貓","1", DateUtils.addDate(new Date(),-10));
personList.add(person1);
personList.add(person2);
personList.add(person3);
personList.add(person4);
//導(dǎo)出操作
FileUtil.exportExcel(personList,"花名冊","草帽一伙",Person.class,"海賊王.xls",response);
}
@RequestMapping("importExcel")
public void importExcel(){
String filePath = "F:\\海賊王.xls";
//解析excel,
List<Person> personList = FileUtil.importExcel(filePath,1,1,Person.class);
//也可以使用MultipartFile,使用 FileUtil.importExcel(MultipartFile file, Integer titleRows, Integer headerRows, Class<T> pojoClass)導(dǎo)入
System.out.println("導(dǎo)入數(shù)據(jù)一共【"+personList.size()+"】行");
//TODO 保存數(shù)據(jù)庫
}
導(dǎo)出結(jié)果
測試導(dǎo)入
導(dǎo)出結(jié)果再添加一行满败,執(zhí)行肤频,輸出導(dǎo)入數(shù)據(jù)行數(shù)
- 更多使用請參考官方網(wǎng)站