EasyExcel导出添加水印(设置背景,非插入图片的方式)

引言

本文添加水印通过java生成图片,设置为excel背景图片实现。不仅仅局限于EasyExcel,凡是采用POI实现都可以采用该方案,但唯一的局限在于必须使用POI中的XSSFWorkbook对象,也就是对应Excel2007的版本,扩展名是.xlsx,具体实现可查看以下代码。

maven依赖

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>easyexcel</artifactId>
    <version>2.2.5</version>
</dependency>
<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>1.18.12</version>
    <scope>provided</scope>
</dependency>
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>ooxml-schemas</artifactId>
    <version>1.4</version>
</dependency>
<!-- springboot相关依赖自行添加 -->

代码实现

主要思路还是通过easyexcel获取XSSFSheet对象,可以实现SheetWriteHandler,重写afterSheetCreate方法来实现设置背景。easyexcel默认使用的SXSSFWorkbook(低内存操作excel的方式),设置inMemory(true)则会使用XSSFWorkbook构造excel操作对象。
如果不是使用easyexcel框架,使用XSSFWorkbook对象来创建excel操作对象即可。

1.eaysexcel Handler编写

/**
 * excel添加水印,只支持XSSFWorkbook,其余类别:SXSSFWorkbook、SXSSFWorkbook请另寻他法
 * easyExcel使用时需要设置inMemory(true),否者默认使用的是SXSSFWorkbook,会报错!
 */
@RequiredArgsConstructor
public class WaterMarkHandler implements SheetWriteHandler {

    private final String WATER_MARK;

    public static ByteArrayOutputStream createWaterMark(String content) throws IOException {
        int width = 200;
        int height = 150;
        BufferedImage image = new BufferedImage(width, height, BufferedImage.TYPE_INT_RGB);// 获取bufferedImage对象
        String fontType = "微软雅黑";
        int fontStyle = Font.BOLD;
        int fontSize = 20;
        Font font = new Font(fontType, fontStyle, fontSize);
        Graphics2D g2d = image.createGraphics(); // 获取Graphics2d对象
        image = g2d.getDeviceConfiguration().createCompatibleImage(width, height, Transparency.TRANSLUCENT);
        g2d.dispose();
        g2d = image.createGraphics();
        g2d.setColor(new Color(0, 0, 0, 20)); //设置字体颜色和透明度,最后一个参数为透明度
        g2d.setStroke(new BasicStroke(1)); // 设置字体
        g2d.setFont(font); // 设置字体类型  加粗 大小
        g2d.rotate(-0.5, (double) image.getWidth() / 2, (double) image.getHeight() / 2);//设置倾斜度
        FontRenderContext context = g2d.getFontRenderContext();
        Rectangle2D bounds = font.getStringBounds(content, context);
        double x = (width - bounds.getWidth()) / 2;
        double y = (height - bounds.getHeight()) / 2;
        double ascent = -bounds.getY();
        double baseY = y + ascent;
        // 写入水印文字原定高度过小,所以累计写水印,增加高度
        g2d.drawString(content, (int) x, (int) baseY);
        // 设置透明度
        g2d.setComposite(AlphaComposite.getInstance(AlphaComposite.SRC_OVER));
        // 释放对象
        g2d.dispose();
        ByteArrayOutputStream os = new ByteArrayOutputStream();
        ImageIO.write(image, "png", os);
        return os;
    }


    /**
     * 为Excel打上水印工具函数
     *
     * @param sheet excel sheet
     * @param bytes 水印图片字节数组
     */
    public static void putWaterRemarkToExcel(XSSFSheet sheet, byte[] bytes) {
        //add relation from sheet to the picture data
        XSSFWorkbook workbook = sheet.getWorkbook();
        int pictureIdx = workbook.addPicture(bytes, Workbook.PICTURE_TYPE_PNG);
        String rID = sheet.addRelation(null, XSSFRelation.IMAGES, workbook.getAllPictures().get(pictureIdx))
                .getRelationship().getId();
        //set background picture to sheet
        sheet.getCTWorksheet().addNewPicture().setId(rID);
    }

    @Override
    public void beforeSheetCreate(WriteWorkbookHolder writeWorkbookHolder, WriteSheetHolder writeSheetHolder) {
    }

    @SneakyThrows
    @Override
    public void afterSheetCreate(WriteWorkbookHolder writeWorkbookHolder, WriteSheetHolder writeSheetHolder) {
        try (ByteArrayOutputStream waterMark = createWaterMark(WATER_MARK)){
            XSSFSheet sheet = (XSSFSheet) writeSheetHolder.getSheet();
            putWaterRemarkToExcel(sheet, waterMark.toByteArray());
        }
    }
}

2.导出示例

@GetMapping("/export")
public void export(HttpServletResponse response) throws IOException {
    response.setContentType("application/vnd.ms-excel");
    response.setCharacterEncoding("utf-8");
    // 这里URLEncoder.encode可以防止中文乱码 当然和easyexcel没有关系
    String fileName = URLEncoder.encode("导出测试", "UTF-8");
    response.setHeader("Content-disposition", "attachment;filename=" + fileName + ".xlsx");
    EasyExcel.write(response.getOutputStream(), DemoData.class)
                .inMemory(true) // 注意,此项配置不能少
                .registerWriteHandler(new WaterMarkHandler("我是水印"))
                .sheet("模板")
                .doWrite(data());
}


private List<DemoData> data() {
    List<DemoData> list = new ArrayList<DemoData>();
    for (int i = 0; i < 10; i++) {
        DemoData data = new DemoData();
        data.setString("字符串" + i);
        data.setDate(new Date());
        data.setDoubleData(0.56);
        list.add(data);
    }
    return list;
}


@Data
public class DemoData {
    @ExcelProperty("字符串标题")
    private String string;
    @ExcelProperty("日期标题")
    private Date date;
    @ExcelProperty("数字标题")
    private Double doubleData;
    /**
     * 忽略这个字段
     */
    @ExcelIgnore
    private String ignore;
}

3.导出效果

效果

4.基于POI

public static void main(String[] args) throws IOException {
    FileOutputStream fileOutputStream = new FileOutputStream(new File("F:\\test.xlsx"));
    XSSFWorkbook workbook = new XSSFWorkbook();
    XSSFSheet sheet = workbook.createSheet("Sheet1");
    try (ByteArrayOutputStream byteArrayOutputStream = WaterMarkHandler.createWaterMark("我是水印")){
        int pictureIdx = workbook.addPicture(byteArrayOutputStream.toByteArray(), Workbook.PICTURE_TYPE_PNG);
        //add relation from sheet to the picture data
        String rID = sheet.addRelation(null, XSSFRelation.IMAGES, workbook.getAllPictures().get(pictureIdx))
                .getRelationship().getId();
        //set background picture to sheet
        sheet.getCTWorksheet().addNewPicture().setId(rID);
        workbook.write(fileOutputStream);
    }
}

如此以来也算是实现了水印的功能,比插入图片的方式强多了。excel是没有水印功能的,目前来看也就只有插入图片和设置背景图片两种方式。
通过以上两种方式对比,可以发现核心代码就sheet.getCTWorksheet().addNewPicture().setId(rID);是设置背景的方法,在Sheet的几个实现中,只有XSSFSheet支持,当然使用XSSF来操作excel的唯一问题就是耗内存,如果有更好的实现也请告知一下哈!


作者:风雨兼程_ad4d
链接:https://www.jianshu.com/p/4332f5feab2e
来源:简书
著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。

<think>好的,我现在要解决用户关于如何在EasyExcel插入设置图片的问题。首先,我需要回忆一下EasyExcel的相关文档和常见用法。用户提到了引用中的内容,特别是引用[2]中提到了设置背景图片作为水印,但用户现在想了解的是直接插入图片的方法。 首先,我应该确认EasyExcel是否支持直接插入图片。根据以往的经验,Apache POI支持插入图片,而EasyExcel作为其封装库,应该也有相应的方法。可能需要通过自定义样式或者使用注解来实现。 接下来,查找官方文档或社区示例。例如,在EasyExcel中,插入图片通常涉及使用`WriteHandler`接口,通过自定义处理器在写入Excel时添加图片。另外,可能需要在实体类中使用注解来指定图片的位置和类型。 然后,用户可能需要示例代码。我需要构造一个简单的例子,比如在某个单元格插入图片。比如,创建一个实体类,使用`@ExcelProperty`注解,并结合`@ContentRowHeight`和`@ColumnWidth`调整行列尺寸。然后,在写入Excel时,通过`write`方法添加自定义的`WriteHandler`来处理图片插入。 还需要注意图片的格式,比如支持PNG、JPEG等。同时,图片的定位可能需要指定起始行、列以及相对于单元格的偏移量。例如,使用`ImageData`设置图片的二进制数据,并指定位置参数。 另外,引用[2]提到设置背景图片,但用户的问题是关于插入图片,所以需要区分这两种方法。插入图片是作为内容添加到单元格中,而背景图片是整个工作表或区域的背景,两者实现方式不同。 最后,整理步骤:1. 创建实体类定义表头;2. 实现WriteHandler接口,在afterCellCreate方法中插入图片;3. 配置Excel参数并写入数据。同时,需要提醒用户注意图片路径、格式以及行列宽高的调整,确保图片显示正确。 可能的问题点包括图片的位置计算是否正确,以及处理器的执行时机是否合适。需要确保在正确的sheet和行创建后添加图片,避免覆盖或位置错误。此外,示例代码中的路径需要用户替换为实际图片路径,并提供异常处理建议,比如文件未找到的情况。 总结,通过自定义WriteHandler,在特定单元格位置插入图片,并调整行列尺寸以适应图片显示,是EasyExcel中实现插入图片的主要方法。</think>在EasyExcel插入图片需要通过自定义`WriteHandler`实现,结合单元格位置和图片数据配置。以下是具体方法及示例代码: --- ### **方法步骤** 1. **添加依赖**:确保使用支持图片处理的EasyExcel版本(建议≥2.2.6) 2. **创建实体类**:定义表头结构 3. **实现WriteHandler接口**:重写`afterCellCreate`方法插入图片 4. **写入Excel时注入处理器** --- ### **示例代码** ```java public class ImageDemo { // 定义实体类(表头) public static class ImageData { @ExcelProperty("图片示例") private String name; } // 自定义WriteHandler插入图片 public static class ImageWriteHandler implements WriteHandler { @Override public void afterCellCreate(WriteSheetHolder writeSheetHolder, WriteTableHolder writeTableHolder, Cell cell, Head head, Integer relativeRowIndex, Boolean isHead) { if (isHead || cell.getRowIndex() != 1) return; // 仅在第二行插入图片 try (InputStream imageStream = new FileInputStream("path/to/image.png")) { byte[] bytes = IOUtils.toByteArray(imageStream); // 配置图片位置:第2行第1列,偏移量(0,0),占2行2列 ImageData imageData = new ImageData(); WriteCellData<Void> writeCellData = new WriteCellData<>(); writeCellData.setImage(bytes); writeCellData.setFirstRowIndex(1); writeCellData.setFirstColumnIndex(0); writeCellData.setLastRowIndex(3); writeCellData.setLastColumnIndex(2); cell.setCellValue(writeCellData); } catch (IOException e) { e.printStackTrace(); } } } public static void main(String[] args) { // 写入Excel String fileName = "output.xlsx"; EasyExcel.write(fileName, ImageData.class) .registerWriteHandler(new ImageWriteHandler()) .sheet("Sheet1") .doWrite(Collections.singletonList(new ImageData())); } } ``` --- ### **关键参数说明** - **图片位置**:通过`setFirstRowIndex`和`setFirstColumnIndex`指定起始单元格,`setLastRowIndex`和`setLastColumnIndex`控制图片占据范围 - **图片格式**:支持`PNG`, `JPEG`, `BMP`等常见格式 - **行列尺寸**:需通过`@ContentRowHeight`和`@ColumnWidth`调整单元格大小,否则图片可能被压缩[^3] --- ### **注意事项** 1. 图片路径需替换为实际文件路径 2. 复杂布局建议使用`ImageData`结合模板导出[^1] 3.图片插入时需动态计算单元格位置
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值