1. Apache POI 简介
Apache POI是Apache软件基金会的开放源码函式库。
提供API给Java应用程序对Microsoft Office格式档案读和写的功能。
老外起名字总是很谦虚,POI为(Poor Obfuscation Implementation)的首字母缩写,意为“可怜的模糊实现”。
如果你查看过 Apache 开源库中的任意项目的源码,你会发现恰到好处的设计模式、高内聚低耦合的模块关系、
到位的接口抽象、优雅的实现方式,这样的一些特点。
o(︶︿︶)o 唉 需要多严谨的思维、多大的代码实现量,多少项目的设计积累,才能达到那样的高度?
POI 中主要提供的读写 Microsoft Office 功能点如下:
- HSSF -- 提供读写Microsoft Excel格式档案的功能。
- XSSF -- 提供读写Microsoft Excel OOXML格式档案的功能。
- HWPF -- 提供读写Microsoft Word格式档案的功能。
- HSLF -- 提供读写Microsoft PowerPoint格式档案的功能。
- HDGF -- 提供读写Microsoft Visio格式档案的功能。
本文借一次使用POI 实现读写 Excel 的过程,记述其中具体POI运用的方式。
由搜索引擎点进来的同学,上面这一句话就是本文的主旨句。若能解决你问题,请往下细看。
项目中使用的是最新的 poi-3.14-20160307.jar,百度云地址:http://pan.baidu.com/s/1bnWFWg3 密码: kame
Oschina 收录地址:https://www.oschina.net/p/poi
官方 Demo : http://poi.apache.org/spreadsheet/examples.html#hssf-only
2.一点点实现前的设计
因项目比较大,下面为单独新建工程后的例子。
3.POI 写 Excel
上图左侧用例图为 POI 写 Excel
a.getExcelData: 获取需要输出到Excel数据,这里的数据获取可以是从持久层,页面展示层......
(例子中的数据为Mysql自有数据库中表help_categroy 表记录),其中的 JavaBean建立 与 数据库获取的过程这里就不说了。
获取数据的数据类型是这样的 List<HelpCategory>
b.POI Write Workbook:这里才是关键的地方,使用POI 将数据实例化为 HSSFWorkbook。核心代码如下:
public HSSFWorkbook expExcel(List<HelpCategory> helpCategories) {Core Code
HSSFWorkbook workbook = new HSSFWorkbook();
HSSFSheet sheet = workbook.createSheet();
createSheetStyle(workbook, sheet);
HSSFRow row = sheet.createRow(0);
HSSFCell cell;
HelpCategory category = new HelpCategory();
Field[] fields = category.getClass().getDeclaredFields();
for (int j = 0; j < fields.length; j++) {
cell = row.createCell(j);
cell.setCellValue(fields[j].getName());
cell.setCellStyle(this.textAlignCenter);
}
for (int i = 0; i < helpCategories.size(); i++) {
category = helpCategories.get(i);
row = sheet.createRow(i + 1);
for (int k = 0; k < fields.length; k++) {
Field field = fields[k];
Object o = invokeGet(category, field.getName());
cell = row.createCell(k);
cell.setCellValue(o != null ? o.toString() : "");
cell.setCellStyle((k == 0 || k == 1) ? this.textAlignCenter : this.textAlignLeft);
}
}
return workbook;
}
获取JavaBean字段值作为表头,并设置表头的样式:
HSSFRow row = sheet.createRow(0);
HSSFCell cell;
HelpCategory category = new HelpCategory();
Field[] fields = category.getClass().getDeclaredFields();
for (int j = 0; j < fields.length; j++) {
cell = row.createCell(j);
cell.setCellValue(fields[j].getName());
cell.setCellStyle(this.textAlignCenter);
}
获取JavaBean HelpCategory 中字段的值填充到对应的表格中,并设置样式:
for (int i = 0; i < helpCategories.size(); i++) {
category = helpCategories.get(i);
row = sheet.createRow(i + 1);
for (int k = 0; k < fields.length; k++) {
Field field = fields[k];
Object o = invokeGet(category, field.getName());
cell = row.createCell(k);
cell.setCellValue(o != null ? o.toString() : "");
cell.setCellStyle((k == 0 || k == 1) ? this.textAlignCenter : this.textAlignLeft);
}
}
这里面用的了一点反射的东西,来获取javaBean属性的值。
如果你觉得反射的效率有点差劲,可以自己构造一个Map数据集合,同样能达到这样的效果。
private Object invokeGet(Object o, String fieldName) {
Method method = getGetMethod(o.getClass(), fieldName);
try {
return method.invoke(o, new Object[0]);
} catch (Exception e) {
e.printStackTrace();
}
return null;
}
private Method getGetMethod(Class objectClass, String fieldName) {
StringBuilder sb = new StringBuilder();
sb.append("get");
sb.append(fieldName.substring(0, 1).toUpperCase());
sb.append(fieldName.substring(1));
try {
return objectClass.getMethod(sb.toString());
} catch (Exception e) {
e.printStackTrace();
}
return null;
}
同样你可以设置表格样式、边框样式:
private void createSheetStyle(HSSFWorkbook _workbook, HSSFSheet _sheet) {
// 设置表字体
HSSFFont font10 = _workbook.createFont();
font10.setFontHeightInPoints((short) 12);
font10.setFontName("黑体");
// 设置表样
this.textAlignCenter = getCellStyle(_workbook, font10, HSSFCellStyle.ALIGN_CENTER);
this.textAlignLeft = getCellStyle(_workbook, font10, HSSFCellStyle.ALIGN_LEFT);
// 设置列宽
_sheet.setColumnWidth(0, 4000);
_sheet.setColumnWidth(1, 4000);
_sheet.setColumnWidth(2, 10000);
_sheet.setColumnWidth(3, 10000);
}
上面的样式设置,如果还满足不了你的功能需求,更多的设置请参考博客:
http://langhua9527.iteye.com/blog/388005
http://blog.csdn.net/tolcf/article/details/48346697
4.POI 读 Excel
上图左侧用例图为 POI 写 Excel
a.getExcleFile:获取要读取的Excel文件...这里就不说了。(注意:判断获取的文件后缀名)
String fileName = excel.getName();
int iIndex = fileName.lastIndexOf(".");
String ext = (iIndex < 0) ? "" : fileName.substring(iIndex + 1).toLowerCase();
if (!"xls,xlsx".contains(ext) || "".contains(ext)) {
System.out.println("文件类型不是EXCEL!");
}
b.POI Read Workbook:这里就是重点啦,使用POI读取Excel文件,解析并进行保存到你自己数据类型当中。
ArrayList<HelpCategory> categories = new ArrayList<>();
try {
POIFSFileSystem poifsFileSystem = new POIFSFileSystem(new FileInputStream(excel));
HSSFWorkbook workbook = new HSSFWorkbook(poifsFileSystem);
HSSFSheet sheet = workbook.getSheetAt(0);
HelpCategory category = new HelpCategory();
Field[] declaredField = category.getClass().getDeclaredFields();
for (int k = 1; k <= sheet.getLastRowNum(); k++) {
HSSFRow row = sheet.getRow(k);
category = new HelpCategory();
for (int j = 0; j < declaredField.length; j++) {
HSSFCell cell = row.getCell(j);
invokeSet(category, declaredField[j].getName(), cell.getStringCellValue());
}
categories.add(category);
}
} catch (Exception e) {
e.printStackTrace();
}
上面也同样用到了一些反射的东西,这里获取JavaBean 的set方法,来设置具体的属性。
public void invokeSet(Object o, String fieldName, Object value) {
Method method = getSetMethod(o.getClass(), fieldName);
try {
method.invoke(o, new Object[]{value});
} catch (Exception e) {
e.printStackTrace();
}
}
public Method getSetMethod(Class objectClass, String fieldName) {
try {
Class[] parameterTypes = new Class[1];
Field field = objectClass.getDeclaredField(fieldName);
parameterTypes[0] = field.getType();
StringBuffer sb = new StringBuffer();
sb.append("set");
sb.append(fieldName.substring(0, 1).toUpperCase());
sb.append(fieldName.substring(1));
Method method = objectClass.getMethod(sb.toString(), parameterTypes);
return method;
} catch (Exception e) {
e.printStackTrace();
}
return null;
}
上述例子仅当作抛砖引玉之用,项目中的具体需求随时都有其他的变化。
如获取数据的途径可能是多表联合查询或者是展现层、结果需要进行其他运算、写Excel表格样式的变化........
但熟悉具体核心读写实现,已不变应万变,可为上将。