excel导入工具
1 介绍
excel导入工具
整个项目的代码结构如下
\---excelExport # 导出工具包
| AsyncExportExcel.java #多线程导出
| ExcelImport.java # 导出工具类
|
+---data
| BaseParam.java # 基础导出参数类
|
+---dataConversion
| DataExportConversion.java # 属性导出转换接口
|
+---defaultDataHandle # 默认的数据处理
| AbstractDataHandler.java
| BooleanDataHandler.java
| DataHandlerFactory.java
| DateDataHandler.java
| StringDataHandler.java
|
\---style # 默认的样式
AbstractCellStyle.java
DefaultDataCellStyle.java
DefaultTitleCellStyle.java
com
\---utils
+---demo # 案例相关
| | ExcelImportApplication.java # springboot启动类
| |
| +---bean
| | DemoBean.java # 测试bean
| |
| +---controller
| | ExcelImportController.java # 测试从web导入excel和从文件导入excel
| |
| \---importParam
| | DemoImportParam.java # 导入参数
| |
| \---dataConversion
| HobbyConversion.java # 爱好属性导入转换类
|
\---excelImport # 导入工具包
| ExcelImport.java # 导入工具类
|
+---data
| CellParam.java # 导入列参数类
|
\---dataConversion
| DataImportConversion.java # 属性导入转换接口
|
\---impl
DateConversion.java # 日期属性导入转换接口
MapConversion.java # 键值对属性导入转换接口
简单的来说excel导入可以分为几步
- 上传excel文件
- 将excel转换为数据,有需要的数据进行转换
2 使用
2.1 ExcelImport工具类
首先实例化ExcelImport工具类,我这里提供了一个构造函数
public ExcelImport(Class<T> clazz, List<CellParam> cellParams)
参数 | 含义 |
---|---|
clazz | Class对象(需要转换为Bean的Class对象) |
cellParams | CellParam的list列表(每一列对应的字段及数据转换类) |
实例化ExcelImport工具类之后,需要调用importExcel方法,方法定义如下
public List<T> importExcel(InputStream is)
只需要传入InputStream即可。
2.2 导入列参数类CellParam
CellParam类代码如下
public class CellParam {
private String fieldName;
private DataImportConversion conversion;
//Set Get Constructor
}
2.2.1 属性
可以看到CellParam类有两个属性
private String fieldName;
private DataImportConversion conversion;
参数 | 含义 |
---|---|
fieldName | 列对应Bean的属性 |
conversion | 数据转换类 |
2.3 数据转换接口DataImportConversion
public interface DataImportConversion<T> {
T transferData(Object data);
}
我这里默认提供了两种数据转换,一个是键值对,另一个是日期
2.3.1 键值对数据转换
键值对数据转换类是为了将一些通用数据转换而提供的。
例如:男女、是否和一些不同名称对应的不同数字(正常-->0,异常-->1,其他-->2)
使用者可以通过传入的map的泛型决定返回值的类型。
public class MapConversion<K,V> implements DataImportConversion<V> {
private Map<K,V> map ;
private V defaultReturnValue;
public MapConversion(Map<K, V> map) {
this(map,null);
}
public MapConversion(Map<K, V> map,V defaultReturnValue) {
this.map = map;
this.defaultReturnValue = defaultReturnValue;
}
@Override
public V transferData(Object data) {
if (map == null) return null;
//如果data为null且map的null对应的值不为null,则直接返回map中null对应的值
if (data == null && map.get(null) != null){
return map.get(null);
}
//循环查找对应的key
for (Map.Entry<K,V> entry:map.entrySet()){
if (entry.getKey() != null && entry.getKey().equals(data)){
return entry.getValue();
}
}
//如果map里面找不到对应的数据,则返回defaultReturnValue
return defaultReturnValue;
}
}
2.3.2 日期数据转换
提供日期转换功能,通过传入的日期转换格式进行转换。
public class DateConversion implements DataImportConversion<Date> {
private SimpleDateFormat format;
public DateConversion(String pattern) {
this.format = new SimpleDateFormat(pattern);
}
@Override
public Date transferData(Object data) {
try {
return format.parse(data.toString());
} catch (Exception e){
e.printStackTrace();
}
return null;
}
}
3 案例
3.1 场景
原始数据如下
姓名 | 性别 | 出生日期 | 爱好 |
---|---|---|---|
尘心 | 女 | 2018-08-08 14:59:11 | 舞刀,弄枪 |
千月 | 男 | 2018-08-08 14:59:11 | 唱歌,跳舞 |
需要转换为实体bean的列表,如下
DemoBean{name='尘心', sex=0, birthday=Wed Aug 08 14:13:45 CST 2018, hobbies=[舞刀, 弄枪]}
DemoBean{name='千月', sex=1, birthday=Wed Aug 08 14:13:45 CST 2018, hobbies=[唱歌, 跳舞]}
实体类如下
public class DemoBean {
//姓名
private String name;
//性别,0->女,1->男
private Integer sex;
//出生日期
private Date birthday;
//爱好
private List<String> hobbies;
//Set Get
}
3.2 数据转换
可以看到有三个属性需要转换,分别是性别、日期和爱好。性别和日期的数据转换可以使用默认的数据转换。爱好需要将字符串根据,
分割并转换为list列表数据,下面是爱好的数据转换,
public class HobbyConversion implements DataImportConversion<List<String>> {
@Override
public List<String> transferData(Object data) {
if (data == null) return null;
//根据,分割字符串
String hobbyStr = data.toString();
String[] hobbyArray = hobbyStr.split(",");
//转换成list
List<String> hobbies = Arrays.asList(hobbyArray);
return hobbies;
}
}
3.3 导入参数类
数据转换类写好了之后,开始编写导入参数类,代码如下
public class DemoImportParam {
public static List<CellParam> getCellParams(){
Map<String,Integer> sexMap = new HashMap<>();
sexMap.put("女",0);
sexMap.put("男",1);
List<CellParam> cellParams = new ArrayList<>();
cellParams.add(new CellParam("name"));
cellParams.add(new CellParam("sex", new MapConversion(sexMap)));
cellParams.add(new CellParam("birthday", new DateConversion("yyyy-MM-dd HH:mm:ss")));
cellParams.add(new CellParam("hobbies", new HobbyConversion()));
return cellParams;
}
}
在DemoImportParam类中可以看到一个静态方法getCellParams,返回List
可以看到总共有4个列参数
- 第一列标题名称为姓名,对应的属性名称为name
- 第二列标题名称为性别,对应的属性名称为sex,数据转换对象MapConversion
- 第三列标题名称为出生日期,对应的属性名称为birthday,日期转换
- 第四列标题名称为爱好,对应的属性名称为hobbies,数据转换对象HobbyConversion
3.4 导出
接下来有两种数据导出方式,一种是url访问弹出下载excel文件,另外一种是导出excel到文件
3.4.1 从web导入excel
@ResponseBody
@PostMapping("/import")
public List<DemoBean> importByWeb(MultipartFile file) throws Exception {
ExcelImport excelImport = new ExcelImport(DemoBean.class, DemoImportParam.getCellParams());
List<DemoBean> list = excelImport.importExcel(file.getInputStream());
return list;
}
3.4.2 从文件导入excel
@Test
public void importByFile() throws Exception {
File file = new File("F:\\导出demo.xlsx");
FileInputStream inputStream = new FileInputStream(file);
//导入转换
ExcelImport excelImport = new ExcelImport(DemoBean.class, DemoImportParam.getCellParams());
List<DemoBean> list = excelImport.importExcel(inputStream);
//输出
for (DemoBean bean:list){
System.out.println(bean);
}
}
项目位置:https://github.com/rainbowda/utils/tree/master/excel_import,有需要的可以看看
作者: 云枭zd
Github: Github地址
出处: https://www.cnblogs.com/fixzd/
版权声明:本文欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接,否则视为侵权。