Apache POI环形图小占比数据标签重叠问题解决问询

针对环形图中小数据段标签重叠的问题，以下是几种实用的编程解决方案：

1. 合并低占比数据段（最有效） #

从根源减少标签数量是解决重叠的核心方案。设定一个占比阈值（比如2%），将所有低于该阈值的数据合并为“其他”类别，再生成图表：

// 假设原始数据是Map<String, Double> dataMap
double threshold = 0.02; // 2%阈值
Map<String, Double> processedData = new HashMap<>();
double othersSum = 0.0;
double totalValue = dataMap.values().stream().mapToDouble(Double::doubleValue).sum();

for (Map.Entry<String, Double> entry : dataMap.entrySet()) {
    double percentage = entry.getValue() / totalValue;
    if (percentage < threshold) {
        othersSum += entry.getValue();
    } else {
        processedData.put(entry.getKey(), entry.getValue());
    }
}

if (othersSum > 0) {
    processedData.put("其他", othersSum);
}

// 用processedData生成环形图

2. 利用POI内置的标签自动布局（需适配POI版本） #

Apache POI 4.x及以上版本支持部分图表标签的自动布局设置，通过调整数据标签的布局模式，让Excel自动处理位置：

XDDFPieChartData pieData = (XDDFPieChartData) chart.createData(ChartTypes.DOUGHNUT, null, null);
// 配置数据系列、数据源...

// 获取数据标签并启用自动布局
XDDFChartData.Series series = pieData.getSeries().get(0);
series.setDataLabel(true);
XDDFDataLabel label = series.getDataLabel();
label.setShowValue(true);

// 设置标签布局为自动（不同版本API可能有差异，需测试）
if (label.getCTDLbl().isSetLayout()) {
    label.getCTDLbl().getLayout().setMode(STLayoutMode.AUTO);
} else {
    CTLayout layout = label.getCTDLbl().addNewLayout();
    layout.setMode(STLayoutMode.AUTO);
}

3. 优化自定义标签位置算法 #

如果必须保留所有小数据段标签，可以改进角度偏移算法，加入相邻标签的位置检测：

XDDFChartData.Series series = pieData.getSeries().get(0);
List<XDDFDataLabel> labels = series.getDataLabels();
List<Point> labelPositions = new ArrayList<>();
double totalValue = dataMap.values().stream().mapToDouble(Double::doubleValue).sum();
double currentAngle = -90; // 环形图起始角度为顶部

for (int i = 0; i < labels.size(); i++) {
    XDDFDataLabel label = labels.get(i);
    double value = dataMap.values().stream().skip(i).findFirst().get();
    double percentage = value / totalValue;
    double segmentAngle = percentage * 360;
    double centerAngle = currentAngle + segmentAngle / 2; // 当前数据段的中心角度

    // 小数据段增大偏移量
    double offset = percentage < 0.05 ? 0.3 : 0.1;
    double deltaX = Math.cos(Math.toRadians(centerAngle)) * offset;
    double deltaY = Math.sin(Math.toRadians(centerAngle)) * offset;

    // 检测相邻标签是否重叠，若重叠则放大偏移
    Point currentPos = new Point(deltaX, deltaY);
    for (Point pos : labelPositions) {
        double distance = Math.sqrt(Math.pow(currentPos.x - pos.x, 2) + Math.pow(currentPos.y - pos.y, 2));
        if (distance < 0.1) {
            deltaX *= 1.5;
            deltaY *= 1.5;
            break;
        }
    }

    label.setXOffset(deltaX);
    label.setYOffset(deltaY);
    labelPositions.add(currentPos);
    currentAngle += segmentAngle;
}

// 辅助内部类：存储标签坐标
private static class Point {
    double x;
    double y;
    Point(double x, double y) {
        this.x = x;
        this.y = y;
    }
}

4. 辅助调整：缩小标签字体或换行显示 #

作为补充手段，可以缩小标签字体，或者让标签内容自动换行，减少横向占用空间：

XDDFDataLabel label = series.getDataLabel();
// 设置字体大小
XDDFRunProperties runProps = label.getRunProperties();
if (runProps == null) {
    runProps = new XDDFRunProperties();
    label.setRunProperties(runProps);
}
runProps.setFontSize(8d); // 缩小到8号字

// 启用标签自动换行（部分POI版本支持）
if (label.getCTDLbl().isSetTxPr()) {
    label.getCTDLbl().getTxPr().getBodyPr().setWrap(STWrapText.TRUE);
}

内容的提问来源于stack exchange，提问作者maher