package com.ruoyi.satisfaction.api;
|
|
import com.ruoyi.common.utils.poi.ExcelUtil;
|
|
import java.util.Collections;
|
import java.util.List;
|
|
/**
|
* 「问题详情占比」导出包（满意度模块对外暴露的导出载体）。
|
* <p>
|
* <b>为什么需要它</b>：随访导出（{@code ServiceSubtaskController#patItemExport}）需要把满意度占比行
|
* 交给 {@code ExcelUtil.exportExcelTwoSheetWithChart(...)}，而这个方法要求同时给出
|
* 「行列表 + 行类型 {@code Class} + 图表构建器」。如果让调用方自己拿这三样，
|
* 它就必须 import 满意度模块内部的 {@code domain} 与 {@code support} 包，
|
* 违反「其它模块只能用本模块暴露的 api」的约束。
|
* <p>
|
* 因此这里把三样东西打包成一个 <b>api 层的值对象</b>：
|
* <ul>
|
* <li>{@link #getRows()} —— 占比行（调用方只当作 {@code List<?>} 透传，不需要知道具体类型）；</li>
|
* <li>{@link #getRowClass()} —— 行类型（同样只是透传给 {@code ExcelUtil}）；</li>
|
* <li>{@link #getChartBuilder()} —— 柱状图构建器（以 ruoyi-common 的
|
* {@link ExcelUtil.ChartSheetBuilder} 接口类型暴露，实现在模块内部，
|
* 模块关闭时为 {@code null}）。</li>
|
* </ul>
|
* 调用方只需 import 本类与 {@link SatisfactionFacade} 即可完成整个导出。
|
*/
|
public class SatisfactionExportBundle {
|
|
/**
|
* 模块关闭时使用的空导出包（无行、无图表构建器）
|
*/
|
private static final SatisfactionExportBundle EMPTY =
|
new SatisfactionExportBundle(Collections.emptyList(), null, null);
|
|
private final List<?> rows;
|
|
private final Class<?> rowClass;
|
|
private final ExcelUtil.ChartSheetBuilder chartBuilder;
|
|
public SatisfactionExportBundle(List<?> rows, Class<?> rowClass, ExcelUtil.ChartSheetBuilder chartBuilder) {
|
this.rows = rows == null ? Collections.emptyList() : rows;
|
this.rowClass = rowClass;
|
this.chartBuilder = chartBuilder;
|
}
|
|
/**
|
* 模块关闭时的空包（行列表为空、行类型与图表构建器为 null）。
|
* <p>配合 {@code ExcelUtil} 的"行列表为空则跳过该 Sheet"行为，导出可以照常完成。
|
*/
|
public static SatisfactionExportBundle empty() {
|
return EMPTY;
|
}
|
|
/**
|
* 占比行（调用方只作透传，不建议自行解析其字段语义）
|
*/
|
public List<?> getRows() {
|
return rows;
|
}
|
|
/**
|
* 占比行的类型（透传给 {@code ExcelUtil} 用；模块关闭时为 null）
|
*/
|
public Class<?> getRowClass() {
|
return rowClass;
|
}
|
|
/**
|
* 柱状图 Sheet 构建器（透传给 {@code ExcelUtil} 用；无数据或模块关闭时为 null）
|
*/
|
public ExcelUtil.ChartSheetBuilder getChartBuilder() {
|
return chartBuilder;
|
}
|
|
/**
|
* 是否没有可导出的行
|
*/
|
public boolean isEmpty() {
|
return rows.isEmpty();
|
}
|
}
|
