Excel和Word 简易工具类，JEasyPoi 2.1.5 版本发布

摘要：

jeasypoi 功能如同名字easy,主打的功能就是容易,让一个没见接触过poi的人员就可以方便的写出Excel导出,Excel模板导出,Excel导入,Word模板导出,通过简单的注解和模板语言(熟悉的表达式语法),完成以前复杂的写法。

主要特点：
1.设计精巧,使用简单
2.接口丰富,扩展简单
3.默认值多,write less do more
4.AbstractView 支持,web导出可以简单明了

一、升级日志

Excel和Word简易工具类，可以无缝集成springmvc，也为jeecg快速开发平台提供更便捷的，强大的导入导出。

一对多表结构导入导出BUG修正；
jeecg 个性化定制版；
支持配置jeecg字典code 翻译导出；
支持自定义字典扩展接口，方便用户自定义；
大数据导入导出优化；

二、在线WIKI文档

这几篇是旧的教程,不过和现在大同小异

Excel 介绍篇 Excel 工具类 Excel 注解介绍.第一篇 Excel 注解介绍.第二篇 Excel 实体类 Word模板导出教程

后面都是新的了

JEasyPoi 在spring mvc中简易开发方式

JEasyPoi-新版自定义导出样式类型

JEasyPoi-标签-模板导出的语法介绍

JEasyPoi-Excel预览

三、JEasyPoi 集成方法

1. 采用 maven方式

在pom.xml 引入以下依赖。配置私服http://maven.jeecg.org/nexus/

                <dependency>

			<groupId>org.jeecgframework</groupId>

			<artifactId>jeasypoi-base</artifactId>

			<version>2.1.5</version>

		</dependency>

		<dependency>

			<groupId>org.jeecgframework</groupId>

			<artifactId>jeasypoi-web</artifactId>

			<version>2.1.5</version>

		</dependency>

		<dependency>

			<groupId>org.jeecgframework</groupId>

			<artifactId>jeasypoi-annotation</artifactId>

			<version>2.1.5</version>

		</dependency>

2. 非maven方式

直接拷贝相关jar进项目Lib中

四、源码下载

http://git.oschina.net/jeecg/jeasypoi

https://github.com/zhangdaiscott/jeasypoi

五、技术交流

技术论坛：www.jeecg.org

QQ交流群： ⑥190866569、⑤ 293658367、④176031980(满)、②106838471(满)

在线体验： http://demo.jeecg.org

六、测试实战

1.注解,导入导出都是基于注解的,实体上做上注解,标示导出对象,同时可以做一些操作

	@ExcelTarget("courseEntity")

	public class CourseEntity implements java.io.Serializable {

	/** 主键 */

	private String id;

	/** 课程名称 */

	@Excel(name = "课程名称", orderNum = "1", needMerge = true)

	private String name;

	/** 老师主键 */

	@ExcelEntity(id = "yuwen")

	@ExcelVerify()

	private TeacherEntity teacher;

	/** 老师主键 */

	@ExcelEntity(id = "shuxue")

	private TeacherEntity shuxueteacher;

	@ExcelCollection(name = "选课学生", orderNum = "4")

	private List<StudentEntity> students;

2.基础导出传入导出参数,导出对象,以及对象列表即可完成导出

	HSSFWorkbook workbook = ExcelExportUtil.exportExcel(new ExportParams(

				"2412312", "测试", "测试"), CourseEntity.class, list);

3.基础导出,带有索引在到处参数设置一个值,就可以在导出列增加索引

	ExportParams params = new ExportParams("2412312", "测试", "测试");

	params.setAddIndex(true);

	HSSFWorkbook workbook = ExcelExportUtil.exportExcel(params,

			TeacherEntity.class, telist);

4.导出Map 创建类似注解的集合,即可完成Map的导出,略有麻烦

	List<ExcelExportEntity> entity = new ArrayList<ExcelExportEntity>();

	entity.add(new ExcelExportEntity("姓名", "name"));

	entity.add(new ExcelExportEntity("性别", "sex"));

	List<Map<String, String>> list = new ArrayList<Map<String, String>>();

	Map<String, String> map;

	for (int i = 0; i < 10; i++) {

		map = new HashMap<String, String>();

		map.put("name", "1" + i);

		map.put("sex", "2" + i);

		list.add(map);

	}

	HSSFWorkbook workbook = ExcelExportUtil.exportExcel(new ExportParams(

			"测试", "测试"), entity, list);

5.模板导出根据模板配置,完成对应导出

	TemplateExportParams params = new TemplateExportParams();

	params.setHeadingRows(2);

	params.setHeadingStartRow(2);

	Map<String,Object> map = new HashMap<String, Object>();

    map.put("year", "2013");

    map.put("sunCourses", list.size());

    Map<String,Object> obj = new HashMap<String, Object>();

    map.put("obj", obj);

    obj.put("name", list.size());

	params.setTemplateUrl("org/jeecgframework/poi/excel/doc/exportTemp.xls");

	Workbook book = ExcelExportUtil.exportExcel(params, CourseEntity.class, list,

			map);

6.导入设置导入参数,传入文件或者流,即可获得相应的list

	ImportParams params = new ImportParams();

	params.setTitleRows(2);

	params.setHeadRows(2);

	//params.setSheetNum(9);

	params.setNeedSave(true);

	long start = new Date().getTime();

	List<CourseEntity> list = ExcelImportUtil.importExcel(new File(

			"d:/tt.xls"), CourseEntity.class, params);

7.和spring mvc的无缝融合简单几句话,Excel导出搞定

	@RequestMapping(params = "exportXls")

	public String exportXls(CourseEntity course,HttpServletRequest request,HttpServletResponse response

			, DataGrid dataGrid,ModelMap map) {

        CriteriaQuery cq = new CriteriaQuery(CourseEntity.class, dataGrid);

        org.jeecgframework.core.extend.hqlsearch.HqlGenerateUtil.installHql(cq, course, request.getParameterMap());

        List<CourseEntity> courses = this.courseService.getListByCriteriaQuery(cq,false);

        map.put(NormalExcelConstants.FILE_NAME,"用户信息");

        map.put(NormalExcelConstants.CLASS,CourseEntity.class);

        map.put(NormalExcelConstants.PARAMS,new ExportParams("课程列表", "导出人:Jeecg",

                "导出信息"));

        map.put(NormalExcelConstants.DATA_LIST,courses);

        return NormalExcelConstants.JEECG_EXCEL_VIEW;

	}

8.Excel导入校验,过滤不符合规则的数据,追加错误信息到Excel,提供常用的校验规则,已经通用的校验接口

	/**

     * Email校验

     */

    @Excel(name = "Email", width = 25)

    @ExcelVerify(isEmail = true, notNull = true)

    private String email;

    /**

     * 手机号校验

     */

    @Excel(name = "Mobile", width = 20)

    @ExcelVerify(isMobile = true, notNull = true)

    private String mobile;

    ExcelImportResult<ExcelVerifyEntity> result = ExcelImportUtil.importExcelVerify(new File(

            "d:/tt.xls"), ExcelVerifyEntity.class, params);

    for (int i = 0; i < result.getList().size(); i++) {

        System.out.println(ReflectionToStringBuilder.toString(result.getList().get(i)));

    }

9.导入Map 设置导入参数,传入文件或者流,即可获得相应的list,自定义Key,需要实现IExcelDataHandler接口

	ImportParams params = new ImportParams();

	List<Map<String,Object>> list = ExcelImportUtil.importExcel(new File(

			"d:/tt.xls"), Map.class, params);