文章详情

短信预约-IT技能 免费直播动态提醒

请输入下面的图形验证码

提交验证

短信预约提醒成功

Java高级特性-注解:注解实现Excel导出功能

2024-12-03 16:10

关注

 注解是 Java 的一个高级特性,Spring 更是以注解为基础,发展出一套“注解驱动编程”。

这听起来高大上,但毕竟是框架的事,我们也能用好注解吗?

的确,我们很少有机会自己写注解,导致我们搞不清楚注解是怎么回事,更别提用好注解了。

既然这样,我们就从具体的工作出发,开发一个 Excel 导出功能。我相信,你在搞懂这个例子后,就能明白注解是怎么个用法。

Excel 导出-需求拆解

在后台管理系统中,常常需要把数据导出 Excel 表。

比如,在双十一过后,销售部要把商品订单录入到 Excel 表,财务部要把支付订单录入到 Excel 表,然后各部门汇总分析,最后找个时间讨论怎么改善公司的服务。

你想呀,双十一的订单成千上万,靠人工录入,少说也要花三四天,而且还特别容易出错。所以,你必须开发 Excel 导出功能。

那么,具体怎么做呢?

上次我们提到,注解想发挥作用,有三个要素:定义、使用、读取。这次,我们就利用注解的三个特性,来实现 Excel 导出功能,设计过程是这样的。

第一步,我们要创建不同的 Excel 模型。双十一过后,销售部要订单数据,财务部要支付数据,两个部门要的 Excel 表肯定也不一样,这就得帮每个部门创建不同的 Excel 模型,他们拿到想要的数据。

第二步,我们要根据 Excel 模型,来导出 Excel 表。

看到这,你应该明白 Excel 导出的设计过程了。接下来,我们就来一步步实现这个功能。

创建 Excel 模型

创建 Excel 模型,涉及到注解三要素中的定义、使用。

首先,定义 Excel 注解,我们直接看关键代码。 

  1. @Target({ElementType.FIELD})  
  2. @Retention(RetentionPolicy.RUNTIME)  
  3. public @interface ExcelField {  
  4.       
  5.     String title();     
  6.       
  7.     int sort() default 0;     
  8.       
  9.     int align() default 0;     

这里用到了两个元注解@Retention和@Target。@Target代表这个注解只能放在成员变量上;@Retention代表这个注解要加载到 JVM 内存,我们可以用反射来读取注解。

此外,注解还有 3 个成员变量,分别对应:Excel 的字段、字段排序、对齐方式,方便大家微调表格。到了这,定义 Excel 注解就完成了。

接下来,使用注解,我们还是直接看代码。 

  1. public class OrderModel {  
  2.     @ExcelField(title = "订单号"align = 2sort = 20 
  3.     private String orderNo;  
  4.     @ExcelField(title = "金额"align = 2sort = 20
  5.     private String amount;   
  6.      // 创建时间  
  7.     private Date createTime;    
  8.      // 省略 getter/setter 方法  

订单模型有 3 个字段:订单号、金额、创建时间,但这里注解只加到订单号、金额上,表示这两个字段会导出 Excel 表,而创建时间会忽略,你可以看看这副图片。

至此,我们完成了定义注解、使用注解,得到了一个 Excel 模型。但要想实现导出功能,还必须根据这个模型,生成出 Excel 表。

读取 Excel 模型

读取 Excel 模型,涉及到注解三要素中的读取。 我们需要读取注解,生成 Excel 表,这主要分成 3 个步骤:初始化 Excel 表对象—>写入数据到 Excel 表对象—>输出文件。

第一步,初始化 Excel 表对象。在这一步中,我们要根据 Excel 模型,生成一个 Excel 表对象,要创建这几个东西:、表头、样式等等。我们来看代码。 

  1. public class ExcelExporter {  
  2.     // ...省略无数代码  
  3.       
  4.       
  5.     public ExcelExporter(String title, Class> cls) {  
  6.         // 获取注解list  
  7.         Field[] fs = cls.getDeclaredFields();  
  8.         for (Field f : fs) {  
  9.             ExcelField ef = f.getAnnotation(ExcelField.class); 
  10.             if (ef != null) {  
  11.                 annotationList.add(new Object[]{ef, f});  
  12.             }  
  13.         }  
  14.         annotationList.sort(comparing(o -> ((ExcelField) o[0]).sort()));  
  15.         // 通过注解获取表头  
  16.         List<String> headerList = new ArrayList<>();  
  17.         for (Object[] os : annotationList) {  
  18.             String t = ((ExcelField) os[0]).title();  
  19.             headerList.add(t);  
  20.         }  
  21.         // 初始化excel表:创建excel表、添加表、创建表头等等  
  22.         initialize(title, headerList);  
  23.     }  

在初始化的时候,我们先从 Excel 模型对象中读取注解,获得一个注解列表;然后,再从注解列表中,读取 title-字段;最后,再初始化 Excel 表对象,包括:创建 Excel 表对象、添加表、创建表头、添加样式。

第二步,写入数据到 Excel 表对象。在这一步中,我们要把 Java 的列表数据写到 Excel 表对象里,让这些数据能变成 Excel 表的一行行信息。还是来看代码。 

  1. public class ExcelExporter {  
  2.       
  3.     // ...省略无数代码  
  4.       
  5.       
  6.     public <E> ExcelExporter setDataList(List<E> list) {  
  7.         for (E dataObj : list) {  
  8.             // 添加行  
  9.             Row row = this.addRow();  
  10.             // 获取数据,并写入单元格  
  11.             int cellNo = 0 
  12.             for (Object[] os : annotationList) {  
  13.                 // 获取成员变量的值  
  14.                 Object value = null 
  15.                 try {  
  16.                     value = Reflections.invokeGetter(dataObj, ((Field) os[1]).getName());  
  17.                 } catch (Exception ex) {  
  18.                     log.info(ex.toString());  
  19.                     value = "" 
  20.                 }  
  21.                 if (value == null) {  
  22.                     value = "" 
  23.                 }  
  24.                 // 写入单元格  
  25.                 ExcelField ef = (ExcelField) os[0];  
  26.                 this.addCell(row, cellNo++, value, ef.align());  
  27.             }  
  28.         }  
  29.         return this;  
  30.     }  

我们先传入一个数据列表 dataList,然后用循环来遍历 dataList,在这个循环中,我们不断把数据写进 Excel 表对象里,具体操作是:创建了一个空白行,利用注解获取成员变量里的值,最后写进 Excel 表的单元格里。

第三步,输出文件。在这一步中,就是 Excel 表对象变成一个文件,来看下最后的代码吧。 

  1. public class ExcelExporter {  
  2.       
  3.     // ...省略无数代码  
  4.       
  5.     // ...省略无数代码  
  6.       
  7.       
  8.     public ExcelExporter writeFile(String fileName) throws IOException {  
  9.         FileOutputStream os = new FileOutputStream(fileName);  
  10.         this.write(os);  
  11.         return this;  
  12.     }  

输出文件就没什么好说的了,就是指定文件名,然后把文件输出到指定的地方。

到了这,读取 Excel 模型就完成了。

当然,读取 Excel 模型涉及到注解的读取,这是最难理解的地方,因为读取注解要用到 Java 另一个高级特性—反射。而且,注解一般是用来简化业务,如果你对业务没有深刻的了解,是很难用好的。

限于篇幅,我只讲了最核心的代码,项目的完整代码放在文末的链接上,大家可以好好看看。

写在最后

注解想发挥作用,有三个要素:定义、使用、读取。这篇文章利用了注解的三要素,实现了 Excel 导出功能。

这分成两步。第一步,创建 Excel 模型,这涉及到注解三要素中的定义、使用;第二步,读取 Excel 模型,这涉及到注解三要素中的读取。

总之,注解一般用来简化业务,你要想用好注解,不但得熟练掌握 Java 的高级用法,还得对业务有深刻的理解。 

 

来源:segmentfault内容投诉

免责声明:

① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。

② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341

软考中级精品资料免费领

  • 历年真题答案解析
  • 备考技巧名师总结
  • 高频考点精准押题
  • 2024年上半年信息系统项目管理师第二批次真题及答案解析(完整版)

    难度     813人已做
    查看
  • 【考后总结】2024年5月26日信息系统项目管理师第2批次考情分析

    难度     354人已做
    查看
  • 【考后总结】2024年5月25日信息系统项目管理师第1批次考情分析

    难度     318人已做
    查看
  • 2024年上半年软考高项第一、二批次真题考点汇总(完整版)

    难度     435人已做
    查看
  • 2024年上半年系统架构设计师考试综合知识真题

    难度     224人已做
    查看

相关文章

发现更多好内容

猜你喜欢

AI推送时光机
位置:首页-资讯-后端开发
咦!没有更多了?去看看其它编程学习网 内容吧
首页课程
资料下载
问答资讯