数据导出组件

<dependency>
    <groupId>org.hzero.starter</groupId>
    <artifactId>hzero-starter-export</artifactId>
    <version>${hzero.starter.version}</version>
</dependency>

/**
 * Sheet(Excel)标题 首先根据多语言取，如果多语言为空则取title，title为空则取类名
 */
@AliasFor("zh")
String title() default "";

/**
 * 中文标题
 */
@AliasFor("title")
String zh() default "";

/**
 * 英文标题
 */
String en() default "";

/**
 * 多语言KEY 根据 key & code 获取多语言
 * @see #promptCode
 * @see #title
 */
String promptKey() default "";

/**
 * 多语言CODE 根据 key & code 获取多语言
 * @see #promptKey
 * @see #title
 */
String promptCode() default "";

/**
 * 行偏移量 从第几行开始显示数据 大于等于0
 */
int rowOffset() default 0;

/**
 * 占位符，偏移的列可使用占位符显示
 */
String placeholder() default "*****";

/**
 * 列偏移量 从第几列开始显示数据 大于等于0
 */
int colOffset() default 0;

/**
 * 分页大小 每次查询的数量
 */
int pageSize() default 5000;

/**
 * 列标题 首先根据多语言取，如果多语言为空则取title，title为空则取类名
 */
@AliasFor("zh")
String title() default "";

/**
 * 中文标题
 */
@AliasFor("title")
String zh() default "";

/**
 * 英文标题
 */
String en() default "";

/**
 * 多语言KEY 根据 key & code 获取多语言
 * @see #promptCode
 * @see #title
 */
String promptKey() default "";

/**
 * 多语言CODE 根据 key & code 获取多语言
 * @see #promptKey
 * @see #title
 */
String promptCode() default "";

/**
 * 在子列表中显示该列
 */
boolean showInChildren() default false;

/**
 * 列顺序
 */
int order() default 1;

/**
 * Cell 格式，参考 {@link BaseConstants.Pattern}
 */
String pattern() default "";

/**
 * 是否子节点
 */
boolean child() default false;

/**
 * 列宽度
 */
String width() default "3000";

/**
 * 是否可编辑
 */
boolean editable() default true;

/**
 * 分组标识
 */
Class<?>[] groups() default {};

/**
 * 数据渲染器，根据需求自行实现渲染器，设置Cell数据时会通过该渲染器来渲染数据和类型。
 *
 * <pre> example:
 *  public static class ExampleRenderer implements ValueRenderer {
 *
 *      public Object render(Object value, Object data) {
 *          ExampleDTO dto = (ExampleDTO) data;
 *          return "template name = " + dto.name;
 *      }
 *  }
 * </pre>
 */
Class<? extends ValueRenderer>[] renders() default {};

@ExcelSheet(zh = "收货记录", en = "Receiving record")
public class ReveRecodeDTO {
    @ExcelColumn(zh = "事务编号", en = "trxNum", showInChildren=true)
    private String trxNum;
    @ExcelColumn(zh = "客户", en = "companyName", groups = {Group2.class})
    private String companyName;
    @ExcelColumn(zh = "物品编码", en = "itemCode", order = 4, groups = {Group1.class})
    private String itemCode;
    @ExcelColumn(zh = "物品名称", en = "itemName", order = 3, groups = {Group1.class})
    private String itemName;
    @ExcelColumn(zh = "日期", en = "trxDate", pattern = BaseConstants.Pattern.DATE)
    private Date trxDate;
    @ExcelColumn(zh = "数量", en = "quantity", groups = {Group2.class})
    private BigDecimal quantity;
    @ExcelColumn(zh = "金额", en = "netAmount", pattern = BaseConstants.Pattern.TB_ONE_DECIMAL)
    private BigDecimal netAmount;
    @ExcelColumn(zh = "原因", en = "moveReason")
    private String moveReason;
    @ExcelColumn(zh = "接收人", en = "receiptPerson")
    private String receiptPerson;
    @ExcelColumn(zh = "备注", en = "remark", renders = RemarkValueRenderer.class)
    private String remark;
    @ExcelColumn(zh = "详情列表", en = "detailsList", child = true)
    List<RecordLineDTO> detailsList;

    public interface Group1 {}

    public interface Group2 {}

    public class RemarkValueRenderer implements ValueRenderer {
        @Override
        public Object render(Object value, Object data) {
            RecordLineDTO dto = (RecordLineDTO) data;
            return "显示备注：" + dto.remark;
        }
    }

    // getter/setter
}

/**
 * 将该注解加在请求数据的接口上：<br/>
 *
 * 接口方法必须带有 {@link HttpServletResponse} 参数，将通过 {@link HttpServletResponse#getWriter()} 返回数据 <br/>
 * 接口方法必须带有 {@link ExportParam} 参数：
 *  <ul>
 *      <li>通过 {@link ExportParam#fillerType} 指定导出方式</li>
 *      <li>通过 {@link ExportParam#exportType} 指定导出类型</li>
 *      <ul>
 *          <li>{@link ExportType#COLUMN} 查询导出的列</li>
 *          <li>{@link ExportType#DATA} 导出数据</li>
 *          <li>{@link ExportType#TEMPLATE} 导出模板</li>
 *      </ul>
 *      <li>通过 {@link ExportParam#ids} 传入选择导出的列</li>
 *  </ul>
 * 接口方法最好带有分页参数 {@link PageRequest}，支持分页查询数据，从而避免大数据量导致内存溢出 <br/>
 *
 * @author bojiangzhou 2018/07/25
 */
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface ExcelExport {

    /**
     * 导出对象
     */
    Class<?> value();

    /**
     * 分组标识
     */
    Class<?>[] groups() default {};
}

@GetMapping("/export")
@ExcelExport(ReveRecodeDTO.class)
public ResponseEntity export(ReveRecodeDTO record, ExportParam exportParam, HttpServletResponse response, PageRequest pageRequest) {
    List<ReveRecodeDTO> list = repository.export(record, exportParam, pageRequest);
    return Results.success(list);
}

/**
 * @return 填充器类型名称
 */
public abstract String getFillerType();

/**
 * 填充数据
 *
 * @param workbook 工作簿
 * @param root 导出列
 * @param data 数据
 */
protected abstract void fillData(SXSSFWorkbook workbook, ExportColumn root, List<?> data);