=========================== JEasyPoi Excel和 Word简易工具类

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

博客： http://blog.csdn.net/zhangdaiscott
论坛： http://www.jeecg.org
QQ群： 293658367

JEasyPoi的主要特点

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

JEasyPoi的几个入口工具类

1.ExcelExportUtil Excel导出(
普通导出,模板导出)
2.ExcelImportUtil Excel导入
3.WordExportUtil Word导出(只支持docx ,doc版本poi存在图片的bug,暂不支持)

关于Excel导出XLS和XLSX区别

1.导出时间XLS比XLSX快2-3倍
2.导出大小XLS是XLSX的2-3倍或者更多
3.导出需要综合网速和本地速度做考虑^~^

几个工程的说明

1.jeasypoi 父包--作用大家都懂得
2.jeasypoi-annotation 基础注解包,作用与实体对象上,拆分后方便maven多工程的依赖管理
3.jeasypoi-base 导入导出的工具包,可以完成Excel导出,导入,Word的导出,Excel的导出功能
4.jeasypoi-web  耦合了spring-mvc 基于AbstractView,极大的简化spring-mvc下的导出功能
5.sax 导入使用xercesImpl这个包(这个包可能造成奇怪的问题哈),word导出使用poi-scratchpad,都作为可选包了

maven

maven库应该都可以了 SNAPSHOT 版本 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>

版本修改

JEasyPoi 文档

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

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

后面都是新的了

JEasyPoi 在spring mvc中简易开发方式

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

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

JEasyPoi-Excel预览

JEasyPoi 模板 表达式支持

JEasyPoi导出实例

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);