Java實現(xiàn)將數(shù)據(jù)導出為Word文檔的方法步驟

更新時間：2025年01月12日 08:25:43 作者：lzj2014

我們在開發(fā)一些系統(tǒng)的時候,例如OA系統(tǒng),經(jīng)常能遇到將審批單數(shù)據(jù)導出為word和excel文檔的需求,導出為excel是比較簡單的,但是word文檔的格式不像表格那樣可以輕松的定位,所以本文給大家介紹了Java怎樣實現(xiàn)將數(shù)據(jù)導出為Word文檔,需要的朋友可以參考下

我們在開發(fā)一些系統(tǒng)的時候，例如OA系統(tǒng)，經(jīng)常能遇到將審批單數(shù)據(jù)導出為word和excel文檔的需求，導出為excel是比較簡單的，因為excel有單元格來供我們定位數(shù)據(jù)位置，但是word文檔的格式不像表格那樣可以輕松的定位，要想將數(shù)據(jù)導出為一些帶有圖片和表格的這種結(jié)構(gòu)復雜的word文檔該怎樣實現(xiàn)呢。

poi-tl 1是一款可以幫助我們實現(xiàn)這種功能的Java開源項目，它把POI和Freemarker相結(jié)合，可以基于我們繪制好的word文檔模板來填充數(shù)據(jù)進去，然后生成新的word文檔。

例如，我們要生成一個差旅行程單，首先要繪制這樣的一個word文檔模板，用{{name}}代表姓名進行占位，姓名就是普通文字類型，以此類推。tripList作為渲染行程表格的數(shù)據(jù)源的名字，是ArrayList集合類型，放在表格的表頭，用[from]表示tripList集合中每個元素的from屬性的值，渲染到當前行的某一列上，以此類推。最后的三個簽署對應的是領(lǐng)導的簽名筆跡圖片，圖片類型要用變量名前多一個@的形式{{@****Pin}}來表示

如果表格中某一列是圖片，則表示為[@變量]

模板繪制好以后，開始使用poi-tl工具生成word文檔，首先新建maven項目，引入poi-tl的依賴和需要的其他依賴，然后將這個繪制好的word模板文件放在工程的根目錄下

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>org.example</groupId>
    <artifactId>poi-tl</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <maven.compiler.source>8</maven.compiler.source>
        <maven.compiler.target>8</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <dependencies>
        <dependency>
            <groupId>com.deepoove</groupId>
            <artifactId>poi-tl</artifactId>
            <version>1.12.2</version>
        </dependency>

        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.18.24</version>
            <scope>provided</scope>
        </dependency>
    </dependencies>

</project>

然后，新建一個Entity類: org.example.TravelApplyExportVO

package org.example;

import com.deepoove.poi.data.PictureRenderData;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

import java.util.ArrayList;
import java.util.List;

@Data
@AllArgsConstructor
@NoArgsConstructor
public class TravelApplyExportVO {
    private String no;
    private String name;
    private String dept;
    private String employeeNo;
    private String start;
    private String end;
    private String days;
    private String address;
    private String reason;
    /**
     * com.deepoove.poi.data.PictureRenderData 代表圖片
     */
    private PictureRenderData applyPin;
    private PictureRenderData bossPin;
    private PictureRenderData leaderPin;

    private String date;

    /**
     * 用于渲染表格的集合
     */
    private List<Route> tripList = new ArrayList<>();

    @Data
    @AllArgsConstructor
    @NoArgsConstructor
    public static class Route {
        private String from;
        private String to;
        private String flight;
        private String depTime;
        private String arrTime;
        private String cabin;
    }
}

新建測試類: org.example.Main，用poi-tl組件基于剛剛繪制的word模板生成一個差旅行程單

package org.example;

import com.deepoove.poi.XWPFTemplate;
import com.deepoove.poi.config.Configure;
import com.deepoove.poi.data.PictureRenderData;
import com.deepoove.poi.data.Pictures;
import com.deepoove.poi.plugin.table.LoopRowTableRenderPolicy;
import lombok.SneakyThrows;


import java.nio.file.Files;
import java.nio.file.Paths;
import java.util.ArrayList;

public class Main {

    @SneakyThrows
    public static void main(String[] args) {

        TravelApplyExportVO vo = new TravelApplyExportVO();
        vo.setNo("202500001");
        vo.setName("lzj");
        vo.setDept("技術(shù)部");
        vo.setEmployeeNo("00000001");
        vo.setStart("2025-01-01");
        vo.setEnd("2025-02-01");
        vo.setDays("30");
        vo.setAddress("中國香港");
        vo.setReason("系統(tǒng)維護");

        // 在項目根路徑讀取筆跡圖片，并設(shè)置大小
        PictureRenderData data1 = Pictures.ofBytes(Files.readAllBytes(Paths.get("img2.png")))
                .size(120, 60)
                .create();

        PictureRenderData data2 = Pictures.ofBytes(Files.readAllBytes(Paths.get("img.png")))
                .size(120, 60)
                .create();

        PictureRenderData data3 = Pictures.ofBytes(Files.readAllBytes(Paths.get("img.png")))
                .size(120, 60)
                .create();

        vo.setApplyPin(data1 );
        vo.setBossPin( data2);
        vo.setLeaderPin( data3);

        vo.setDate("2025-01-10");

        // 行程List，最終渲染到文檔的表格中
        vo.setTripList(new ArrayList<TravelApplyExportVO.Route>() {
            {
                add(new TravelApplyExportVO.Route("BJX","ZQZ","ZH5643","2025-01-01 15:00","2025-01-01 16:00","E"));
                add(new TravelApplyExportVO.Route("ZQZ","CDE","JUH6532","2026-01-01 15:00","2025-12-01 16:00","A"));
                add(new TravelApplyExportVO.Route("BJX","ZQZ","KJU0954","2027-01-01 15:00","2025-05-01 16:00","Q"));
            }
        });

        LoopRowTableRenderPolicy policy = new LoopRowTableRenderPolicy();

        // !!將tripList通過表格來渲染
        Configure config = Configure.builder()
                .bind("tripList", policy)
                .build();

        XWPFTemplate template = XWPFTemplate
                .compile("模板.docx", config)
                .render(vo);

        template.writeAndClose(Files.newOutputStream(Paths.get("output.docx")));
    }
}

然后領(lǐng)導簽名筆記圖片素材img.png,img2.png也需要放進工程根目錄下

都完成后，執(zhí)行main()方法測試，程序運行結(jié)束后，將在根路徑生成文件output.docx，打開就是我們想要的效果了。