java从word模板生成.doc和.wps文件

当遇到要生成一个word文档（证明文件等）的需求时，就可以考虑使用word模板生成.doc和.wps文件
一、需求
1、生成如下这样的订单数据.doc文件，红框部分是变化的，其余部分是固定的

2、生成如下这样的书籍列表，书的个数不固定是动态的。

二、使用Docx4j实现 
1、引入依赖

1. <dependency>
2.     <groupId>org.docx4j</groupId>
3.     docx4j-core</artifactId>
4.     <version>8.3.0</version>
5. </dependency>
8. <dependency>
9.     <groupId>org.docx4j</groupId>
10.     docx4j-JAXB-ReferenceImpl</artifactId>
11.     <version>8.3.0</version>
12. </dependency>
16. <dependency>
17.     <groupId>org.apache.velocity</groupId>
18.     velocity-engine-core</artifactId>
19.     <version>2.3</version>
20. </dependency>
22. <dependency>
23.     <groupId>org.docx4j</groupId>
24.     docx4j-JAXB-Internal</artifactId>
25.     <version>8.3.0</version>
26. </dependency>

复制代码

注： 前两个完成第一个需求就够了，后两个使用模板完成后一个需求
 2、制作模板
变量的地方用${}
模板contract_template.docx内容如下：

 
模板book_template.docx内容如下：
使用foreach进行循环

3、代码

1. Docx4jService类

复制代码

1. package com.example.demo.demos;
3. import org.docx4j.openpackaging.packages.WordprocessingMLPackage;
4. import org.docx4j.openpackaging.parts.WordprocessingML.MainDocumentPart;
5. import org.docx4j.wml.Document;
6. import org.springframework.core.io.ClassPathResource;
7. import org.springframework.stereotype.Service;
9. import javax.xml.bind.JAXBElement;
10. import java.io.ByteArrayOutputStream;
11. import java.util.List;
12. import java.util.Map;
14. @Service
15. public class Docx4jService {
17.     /**
18.      * 根据模板生成Word文档（修复没有write方法的问题）
19.      */
20.     public byte[] generateWord(String templatePath, Map<String, String> data) throws Exception {
21.         // 1. 加载模板
22.         ClassPathResource resource = new ClassPathResource(templatePath);
23.         WordprocessingMLPackage wordMLPackage = WordprocessingMLPackage.load(resource.getInputStream());
24.         MainDocumentPart mainDocumentPart = wordMLPackage.getMainDocumentPart();
26.         // 2. 获取文档XML内容
27.         Document document = mainDocumentPart.getJaxbElement();
28.         List<Object> content = document.getBody().getContent();
30.         // 3. 手动替换变量
31.         replaceVariables(content, data);
33.         // 4. 写回并生成字节数组（使用save方法替代write方法）
34.         try (ByteArrayOutputStream out = new ByteArrayOutputStream()) {
35.             // 关键修复：用save方法替代write方法
36.             wordMLPackage.save(out);
37.             return out.toByteArray();
38.         }
39.     }
41.     /**
42.      * 递归替换文档中的变量（修复Text节点无法识别问题）
43.      */
44.     @SuppressWarnings("unchecked")
45.     private void replaceVariables(List<Object> content, Map<String, String> data) {
46.         for (int i = 0; i < content.size(); i++) {
47.             Object obj = content.get(i);
49.             // 处理JAXB包装的元素（解开外层包装）
50.             if (obj instanceof JAXBElement) {
51.                 obj = ((JAXBElement<?>) obj).getValue();
52.             }
54.             // 关键修复：处理运行元素（R），Text节点一定在R里面
55.             if (obj instanceof org.docx4j.wml.R) {
56.                 org.docx4j.wml.R run = (org.docx4j.wml.R) obj;
57.                 // 遍历R元素中的内容，寻找Text节点
58.                 replaceVariables(run.getContent(), data);
59.             }
60.             // 现在可以找到Text节点了
61.             else if (obj instanceof org.docx4j.wml.Text) {
62.                 org.docx4j.wml.Text text = (org.docx4j.wml.Text) obj;
63.                 String value = text.getValue();
65.                 // 遍历所有变量进行替换
66.                 for (Map.Entry<String, String> entry : data.entrySet()) {
67.                     String key = "${" + entry.getKey() + "}";
68.                     if (value.contains(key)) {
69.                         value = value.replace(key, entry.getValue());
70.                         text.setValue(value);
71.                     }
72.                 }
73.             }
74.             // 处理段落（P）：继续遍历段落中的内容（会包含R元素）
75.             else if (obj instanceof org.docx4j.wml.P) {
76.                 org.docx4j.wml.P p = (org.docx4j.wml.P) obj;
77.                 replaceVariables(p.getContent(), data);
78.             }
79.             // 处理表格（Tbl）：继续遍历表格中的内容
80.             else if (obj instanceof org.docx4j.wml.Tbl) {
81.                 org.docx4j.wml.Tbl tbl = (org.docx4j.wml.Tbl) obj;
82.                 replaceVariables(tbl.getContent(), data);
83.             }
84.         }
85.     }
87. }

复制代码

 

1. Book类<br>

复制代码

1. package com.example.demo.demos;
3. public class Book {
4.     private String name;
5.     private String author;
8.     public String getName() {
9.         return name;
10.     }
12.     public void setName(String name) {
13.         this.name = name;
14.     }
16.     public String getAuthor() {
17.         return author;
18.     }
20.     public void setAuthor(String author) {
21.         this.author = author;
22.     }
25.     public Book(String name, String author) {
26.         this.name = name;
27.         this.author = author;
28.     }
29. }

复制代码

[code][/code] WordController类
 
[code]package com.example.demo.demos;import org.docx4j.jaxb.Context;import org.docx4j.openpackaging.parts.WordprocessingML.MainDocumentPart;import org.springframework.beans.factory.annotation.Autowired;import org.springframework.core.io.ClassPathResource;import org.springframework.http.HttpHeaders;import org.springframework.http.HttpStatus;import org.springframework.http.ResponseEntity;import org.springframework.web.bind.annotation.GetMapping;import org.springframework.web.bind.annotation.RequestMapping;import org.springframework.web.bind.annotation.RestController;import javax.servlet.http.HttpServletResponse;import javax.xml.bind.JAXBException;import javax.xml.bind.Unmarshaller;import javax.xml.stream.XMLInputFactory;import javax.xml.stream.XMLStreamException;import javax.xml.stream.XMLStreamReader;import javax.xml.transform.stream.StreamSource;import java.io.*;import java.net.URLEncoder;import java.util.*;import org.apache.velocity.VelocityContext;import org.apache.velocity.app.Velocity;import org.docx4j.Docx4J;import org.docx4j.openpackaging.packages.WordprocessingMLPackage;import org.docx4j.wml.Document;@RestController@RequestMapping("/word")public class WordController {    @Autowired    private Docx4jService docx4jService;    /**     * 生成并下载 Word 文档     */    @GetMapping("/generate")    public ResponseEntity generateWord() throws Exception {        // 1. 准备模板变量数据        Map data = new HashMap();        data.put("username", "张三");        data.put("orderNo", "ORD20250911001");        data.put("amount", "1000.00");        data.put("date", "2025-09-11");        // 2. 调用服务生成 Word 字节数组        byte[] wordBytes = docx4jService.generateWord("templates/contract_template.docx", data);        // 3. 配置响应头，实现文件下载        String fileName = URLEncoder.encode("订单详情.docx", "UTF-8");        HttpHeaders headers = new HttpHeaders();        headers.add("Content-Disposition", "attachment; filename=" + fileName);        headers.add("Content-Type", "application/vnd.openxmlformats-officedocument.wordprocessingml.document");        return new ResponseEntity(wordBytes, headers, HttpStatus.OK);    }    static {        try {            Properties props = new Properties();            props.setProperty("resource.loader", "class");            props.setProperty("class.resource.loader.class",                    "org.apache.velocity.runtime.resource.loader.ClasspathResourceLoader");            Velocity.init(props);        } catch (Exception e) {            throw new RuntimeException("Velocity引擎初始化失败", e);        }    }    @GetMapping("/export")    public void exportBooks(HttpServletResponse response) {        try (InputStream templateStream = new ClassPathResource("templates/book_template.docx").getInputStream()) {            WordprocessingMLPackage template = WordprocessingMLPackage.load(templateStream);            MainDocumentPart mainPart = template.getMainDocumentPart();            //生成books内容            List books = new ArrayList();            for (int i = 1; i