不想用POI？几行代码完成Excel导出导入

时间  2020-01-21
标签 不想 poi 代码 完成 excel 导出 导入 栏目 Apache 繁體版
原文   原文链接

Octopus

Octopus 是一个简单的java excel导入导出工具。目的是不用接触Apache POI的API就能够完成简单的Excel导出导入。
同时，能够自定义表格样式，导入检验数据和转换数据java

Github地址ios

不BB，直接上图git

从Maven导入

<dependency>
    <groupId>cn.chenhuanming</groupId>
    <artifactId>octopus</artifactId>
    <version>1.1.4</version>
</dependency>

导出Excel

从最简单的例子开始

咱们从最简单的例子开始，导出一些地址数据github

定义Address类正则表达式

@Data
@AllArgsConstructor
@NoArgsConstructor
public class Address {
    private String city;
    private String detail;
}

用XML文件定义怎么导出ide

<?xml version="1.0" encoding="UTF-8"?>
<Root class="cn.chenhuanming.octopus.entity.Address">

    <Field name="city" description="City"/>
    <Field name="detail" description="Detail"/>

</Root>

Root标签的class属性，表明咱们要导出的类全限定名工具

一个Field标签表明Excel里的一列数据单元测试

name属性值就是Address里的属性名，实际上Octopus调用其getter方法获取值，因此要确保有getter方法测试

description属性会被用来绘制表头字体

咱们能够开始作最后一件事，编写Java代码

public class AddressExample {
    List<Address> addresses;

    /**
     * preparing testing data
     */
    @Before
    public void prepare() {
        addresses = new ArrayList<>();
        DataFactory df = new DataFactory();
        for (int i = 0; i < df.getNumberBetween(5, 10); i++) {
            addresses.add(new Address(df.getCity(), df.getAddress()));
        }
    }

    @Test
    public void export() throws Exception {

        //导出文件的is
        String rootPath = this.getClass().getClassLoader().getResource("").getPath();
        FileOutputStream os = new FileOutputStream(rootPath + "/address.xlsx");

        //从XML读取配置，建议单例模式
        InputStream is = this.getClass().getClassLoader().getResourceAsStream("address.xml");
        Config config = new XmlConfigFactory(is).getConfig();

        //用Octopus，只须要一行代码
        Octopus.writeOneSheet(os, config, "address", addresses);
    }
}

这是一个完整的单元测试，能够在单测测试路径找到它

自动绘制表头

Octopus支持导出复杂对象时自动绘制表头

此次咱们来导出一些公司数据，这里是Company类

@Data
@AllArgsConstructor
@NoArgsConstructor
public class Company {
    private String name;
    private Address address;
}

而后咱们建立一个 company.xml 配置文件

<Root class="cn.chenhuanming.octopus.entity.Address">


    <Field name="name"
           description="Name"
           color="#ff0000"/>

    <Header name="address" description="Address">
        <Field name="city" description="City"/>
        <Field name="detail" description="Detail"/>
    </Header>

</Root>

咱们用Header元素表明要导出Company的一个复杂属性，同时设置字体颜色是红色

Java代码基本跟以前的同样

public class CompanyExample {
    List<Company> companies;

    /**
     * preparing testing data
     */
    @Before
    public void prepare() {
        companies = new ArrayList<>();
        DataFactory df = new DataFactory();
        for (int i = 0; i < df.getNumberBetween(5, 10); i++) {
            companies.add(new Company(df.getBusinessName(), new Address(df.getCity(), df.getAddress())));
        }
    }

    @Test
    public void export() throws Exception {

        //导出文件的is
        String rootPath = this.getClass().getClassLoader().getResource("").getPath();
        FileOutputStream os = new FileOutputStream(rootPath + "/company.xlsx");

        //从XML读取配置，建议单例模式
        InputStream is = this.getClass().getClassLoader().getResourceAsStream("company.xml");
        Config config = new XmlConfigFactory(is).getConfig();

        Octopus.writeOneSheet(os, config, "company", companies);
    }
}

最后是导出的Excel文件

Octopus能够处理更复杂的数据，你能够在cn.chenhuanming.octopus.example.ApplicantExample查看这个更复杂的例子

转换数据

有时你想转换导出的数据。例如，在上一个例子中，咱们不想导出整个Address对象，把它当作一个一列数据导出

咱们所须要作的只是实现一个Formatter

public class AddressFormatter implements Formatter<Address> {
    @Override
    public String format(Address address) {
        return address.getCity() + "," + address.getDetail();
    }

    @Override
    public Address parse(String str) {
        String[] split = str.split(",");
        if (split.length != 2) {
            return null;
        }
        return new Address(split[0], split[1]);
    }
}

parse方法用于导入Excel，只要关注format方法。这里接受一个Address对象，返回一个字符串。

最后，配置AddressFormatter到XML文件

<Field name="name"
          description="Name"
          color="#ff0000"/>

<Field name="address"
      description="Address"
      formatter="cn.chenhuanming.octopus.formatter.AddressFormatter"/>

最后导出的结果

导入Excel

咱们直接拿上一个例子的导出结果来演示导入，共用同一个Config对象，直接编写导入的代码

SheetReader<Company> importData = Octopus.readFirstSheet(fis, config, new DefaultCellPosition(1, 0));

for (Company company : importData) {
    System.out.println(company);
}

在控制台能够看到打印导入结果，能够看到，以前的AddressFormatter也完成了数据的转换工做

Company(name=Graham Motor Services, address=Address(city=Monroe, detail=666 Bonnair Ave))
Company(name=Social Circle Engineering, address=Address(city=Fort Gaines, detail=956 Third Ridge))
Company(name=Enigma Cafe, address=Address(city=Mcdonough, detail=1278 Midway Trail))
Company(name=Hapeville Studios, address=Address(city=Riceboro, detail=823 Tuscarawas Blvd))
Company(name=Thalman Gymnasium, address=Address(city=Ebenezer, detail=1225 Blackwood Avenue))
Company(name=Sparks Pro Services, address=Address(city=Darien, detail=1362 Woodlawn Lane))
Company(name=Toccoa Development, address=Address(city=Ridgeville, detail=1790 Lawn Ave))

导入校验数据

有时候咱们对导入的数据有必定的要求，Octopus提供简单的数据校验配置

首先给咱们的Company增长一个status属性，只能是 good,bad和closed 三个值其中一个，同时name不能够为空，看一下XML配置文件

<?xml version="1.0" encoding="UTF-8"?>
<Root xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      class="cn.chenhuanming.octopus.entity.Company">


    <Field name="name"
           description="Name"
           color="#ff0000"
           is-blankable="false"/>

    <Field name="address"
           description="Address"
           formatter="cn.chenhuanming.octopus.formatter.AddressFormatter"
    />

    <Field name="status"
           description="Status"
           options="good|bad|closed"/>
    <!--| split options -->
    
</Root>

这是咱们要导入的Excel，能够看到里面有非法数据

看一下怎么编写Java代码

@Test
public void importCheckedData() throws IOException, InvalidFormatException {
    InputStream is = this.getClass().getClassLoader().getResourceAsStream("wrongCompany.xlsx");

    Config config = new XmlConfigFactory(this.getClass().getClassLoader().getResourceAsStream("company3.xml")).getConfig();

    final SheetReader<CheckedData<Company>> sheetReader = Octopus.readFirstSheetWithValidation(is,config,new DefaultCellPosition(1,0));

    for (CheckedData<Company> checkedData : sheetReader) {
        System.out.println(checkedData);
    }
}

这里咱们调用Octopus.readFirstSheetWithValidation，获取带校验结果的SheetReader，看一下导入的结果

CheckedData(data=Company(name=Graham Motor Services, address=Address(city=Monroe, detail=666 Bonnair Ave), status=good), exceptions=[])
CheckedData(data=Company(name=Social Circle Engineering, address=Address(city=Fort Gaines, detail=956 Third Ridge), status=null), exceptions=[cn.chenhuanming.octopus.exception.NotAllowValueException])
CheckedData(data=Company(name=null, address=Address(city=Mcdonough, detail=1278 Midway Trail), status=null), exceptions=[cn.chenhuanming.octopus.exception.CanNotBeBlankException, cn.chenhuanming.octopus.exception.NotAllowValueException])

能够看到每个CheckData有一个data属性和一个exceptions列表。
这个异常列表存放着导入时每个单元格可能出现的校验错误，异常类型都是ParseException

除了is-blankable和options，还能够经过regex配置正则表达式检查。当校验错误时，会抛出对应的ParseException子类

  • is-blankable：抛出 CanNotBeBlankException
  • options：抛出 NotAllowValueException
  • regex：抛出 PatternNotMatchException

你经过这些异常来进行跟进一步的处理。若是上面三种校验方式不能知足需求，在Formatter的parse抛出自定义的ParseException。Octopus会捕获它们放到exceptions列表中，并自动把单元格位置和你的配置内容塞到ParseException中

以上代码均可以在测试路径cn.chenhuanming.octopus.example找到，经过这些例子能够感觉下Octopus的魅力

注解

咱们推荐使用 xml 方式配置导入导出格式，由于 xml 配置与类不相耦合，相比注解更加灵活。
不过有时使用方可能不太在乎灵活性，但愿把配置和数据类放在一块儿，那么可使用注解版本。
注解与 xml 文件的使用方法相似，主要有 @Sheet,@Formatter,@Header,@Field 这几个。

  • @Sheet 注解在数据类上，可选 formatters 属性, 表示全局转换器
  • @Formatter 做为 @Sheet 的 formatters 属性值，表示一个转换器
  • @Header 注解在数据类的字段上，表示该字段是一个复合字段
  • @Field 注解在数据类的字段上，表示该字段是一个单一字段

注解的的属性取值请参考 xml 文件。下面是一个数据类的注解示例：

@Sheet(formatters = {
        @Formatter(target = BigDecimal.class, format = BigDecimalFormatter.class),
})
public class Applicants {
    @Field(description = "Value", color = "#74f441")
    private int id;
    @Field(description = "Name", fontSize = 20, border = "0,2,0,2", borderColor = ",#4242f4,,#4242f4")
    private String name;
    @Header(description = "Job", headerColor = "#4286f4")
    private Job job;
    @Field(description = "Entry Date", dateFormat = "yyyy-MM-dd")
    private Date entryDate;
    @Field(description = "Working/Leaved", options = "Working|Leaved",
            formatter = cn.chenhuanming.octopus.formatter.WorkingFormatter.class, color = "#42f4b9")
    private boolean working = true;
}

使用方法：

// 构造方法必须传入一个带有 @Sheet 注解的类
    Config config = new AnnotationConfigFactory(Applicants.class).getConfig();
    // ... 使用 config 就像 xml 的方式同样

Q&A

须要操做Apache POI？

Octopus类能够提供一行代码式的API，让你不用碰Apache POI的API。可是若是你确实须要用到Apache POI，能够先看一下Octopus核心类SheetWriter和SheetReader代码。我在设计的时候尽可能考虑扩展，而且彻底基于接口实现，实在不行能够选择继承重写，属性基本都是protected，或者直接本身实现接口

有建议或者问题？

提Issue或者email我chenhuanming.cn@gmail.com

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程