更好用的excel国际化多语言导出

菩提树下的杨过

发布于 2018-09-20 11:14:29

1.6K0

发布于 2018-09-20 11:14:29

不知道大家在开发中有没有遇到过『excel导出』的需求，反正我最近写了不少这种功能，刚开始利用poi，一行行的手动塞数据，生成excel，而且还有国际化需求，比如：标题栏有一列，用户切换成"简体中文"时，导出的标题应该是『用户姓名』，而切换到"英文"时，导出的标题应该变成『Customer Name』（当然还有一些细节，比如英文环境，日期通常是 "月/日/年"格式，而中文格式是"年-月-日"）

偶尔干一两次还行，经常这么手动处理，纯体力活就太枯燥了，在一个小伙伴的抱怨下，到网上搜索了下，看看有没有更省力的通用解决方案，还真找到了，比如Excel4J （向原作者致敬，提供这么方便的开源项目）。大致原理是基于注解，用法很简单：

public class Student2 {

    @ExcelField(title = "学号", order = 1)
    private Long id;

    @ExcelField(title = "姓名", order = 2)
    private String name;

    ...
}

打个注解就行，导出一行搞定：

        List<Student2> list = new ArrayList<>();
        ...
        ExcelUtils.getInstance().exportObjects2Excel(list, Student2.class, true, "学生信息", true, BASE_PATH + "student2.xlsx");

不过原作者并没有提供国际化多语言的功能，于是顺着这个思路，略为修改了一下，再定义一个多语言的注解：

/**
 * 国际化标题注解
 *
 * @author 菩提树下的杨过
 */
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.FIELD)
public @interface I18nField {

    /**
     * 国际化标题栏(例如: ["zh-cn|学生","en-us|student"])
     *
     * @return 国际化标题配置数组
     */
    String[] titles();

}

导出的地方去判断有无这个注解就行（详细大家可以看源码），修改后，原来的Student2改成：

@Data
public class Student2 {

    @ExcelField(title = "学号", order = 1)
    @I18nField(titles = {"en-us|student id"})
    private Long id;

    @ExcelField(title = "姓名", order = 2)
    @I18nField(titles = {"en-us|name"})
    private String name;

    ...  
}

导出时指定语言：

        List<Student2> list = new ArrayList<>();
       ...
        ExcelUtils.getInstance().exportObjects2Excel(list, Student2.class, true, "student", true, BASE_PATH + "student2-en.xlsx", "en-us");
        ExcelUtils.getInstance().exportObjects2Excel(list, Student2.class, true, "学生信息", true, BASE_PATH + "student2-cn.xlsx", "zh-cn");

效果如下：

中文导出：