Java 高级特性——注解,kafka 消息队列的实现原理
*/
int sort() default 0;
/**
对齐方式(0:自动;1:靠左;2:居中;3:靠右)
*/
int align() default 0;
}
这里用到了两个元注解?@Retention?和?@target?。?@target?代表这个注解只能放在成员变量上;?@Retention?代表这个注解要加载到 JVM 内存,我们可以用反射来读取注解。
此外,注解还有 3 个成员变量,分别对应:Excel 的字段标题、字段排序、对齐方式,方便大家微调表格。到了这,定义 Excel 注解就完成了。
接下来,使用注解,我们还是直接看代码。
public class OrderModel {
@ExcelField(title = "订单号", align = 2, sort = 20)
pr
ivate String orderNo;
@ExcelField(title = "金额", align = 2, sort = 20)
private String amount;
// 创建时间
private Date createTime;
// 省略 getter/setter 方法
}
订单模型有 3 个字段:订单号、金额、创建时间,但这里注解只加到订单号、金额上,表示这两个字段会导出 Excel 表,而创建时间会忽略,你可以看看这副图片。
至此,我们完成了定义注解、使用注解,得到了一个 Excel 模型。但要想实现导出功能,还必须根据这个模型,生成出 Excel 表。
===============================================================================
读取 Excel 模型,涉及到注解三要素中的读取。我们需要读取注解,生成 Excel 表,这主要分成 3 个步骤:初始化 Excel 表对象—>写入数据到 Excel 表对象—>输出文件。
第一步,初始化 Excel 表对象。在这一步中,我们要根据 Excel 模型,生成一个 Excel 表对象,要创建这几个东西:标题、表头、样式等等。我们来看代码。
public class ExcelExporter {
// ...省略无数代码
/***************************** 初始化 Excel 表对象 ****************************/
/**
构造函数
@param title 表格标题,传“空值”,表示无标题
@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<String> headerList = new ArrayList<>();
for (Object[] os : annotationList) {
String t = ((ExcelField) os[0]).title();
headerList.add(t);
}
// 初始化 excel 表:创建 excel 表、添加表标题、创建表头等等
initialize(title, headerList);
}
}
在初始化的时候,我们先从 Excel 模型对象中读取注解,获得一个注解列表;然后,再从注解列表中,读取 title-字段标题;最后,再初始化 Excel 表对象,包括:创建 Excel 表对象、添加表标题、创建表头、添加样式。
第二步,写入数据到 Excel 表对象。在这一步中,我们要把 Java 的列表数据写到 Excel 表对象里,让这些数据能变成 Excel 表的一行行信息。还是来看代码。
public class ExcelExporter {
/***************************** 初始化 Excel 表对象 ****************************/
// ...省略无数代码
/***************************** 写入数据到 Excel 表对象 ****************************/
/**
写入数据
@return list 数据列表
*/
public <E> ExcelExporter setDataList(List<E> list) {
for (E dataObj : list) {
// 添加行
Row row = this.addRow();
// 获取数据,并写入单元格
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;
}
}
我们先传入一个数据列表 dataList,然后用循环来遍历 dataList,在这个循环中,我们不断把数据写进 Excel 表对象里,具体操作是:创建了一个空白行,利用注解获取成员变量里的值,最后写进 Excel 表的单元格里。
第三步,输出文件。在这一步中,就是 Excel 表对象变成一个文件,来看下最后的代码吧。
public class ExcelExporter {
/***************************** 初始化 Excel 表对象 ****************************/
// ...省略无数代码
/***************************** 写入数据到 Excel 表对象 ****************************/
// ...省略无数代码
/***************************** 输出相关 ****************************/
/**
输出到文件
@param fileName 输出文件名,加上绝对路径
*/
public ExcelExporter writeFile(String fileName) throws IOException {
FileOutputStream os = new FileOutputStream(fileName);
this.write(os);
return this;
}
评论