在java中从模板生成单词

报告生成过程通常包括填充包含所需字段占位符的预定义文档模板。报告引擎将模板文档作为输入，用数据动态填充占位符并生成结果报告。本文还将展示一个类似的用例，您可以通过使用 Java 以编程方式动态填充 Word 模板来生成 Word 文档。

要从 DOCX 模板生成 Word 文档，我们将使用 Aspose.Words for Java API 提供的 LINQ Reporting Engine。 LINQ 报告引擎支持用于 Word 模板的文本、图像、列表、表格、超链接和书签的各种标记。包含这些标签的模板文档由引擎填充来自 Java 对象以及 XML、JSON 或 CSV 数据源的数据。因此，让我们开始使用 Java 从模板生成 Word 文档。

本文将介绍如何使用以下模板从模板生成 Word 文档：

  • Java 对象的值，
  • XML 数据源，
  • JSON数据源，
  • 和 CSV 数据源。

安装 Aspose.Words for Java - Word 自动化和报告生成 API

您可以下载 Aspose.Words for Java JAR 或使用以下配置将其添加到基于 Maven 的应用程序中。

存储库：

<repository>
    <id>AsposeJavaAPI</id>
    <name>Aspose Java API</name>
    <url>https://repository.aspose.com/repo/</url>
</repository>

依赖：

<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-words</artifactId>
    <version>20.1</version>
    <type>pom</type>
</dependency>

使用 Java 对象从模板生成 Word 文档

要开始生成报告，我们首先通过使用 Java 对象中的值填充模板来创建一个 Word 文档。为了定义文档模板，创建一个新的 Word 文档，插入以下标签并将其保存为 DOCX 文档。

<<[s.getName()]>> says: "<<[s.getMessage()]>>."

在上面的模板中，“s”将被视为 Java 类的对象，用于填充标签。因此，让我们创建一个名为 Sender 的类，其中包含两个数据成员。

public class Sender {
    public Sender(String name, String message) {
        _name = name;
        _message = message;
    } 
    public String getName() {
        return _name;
    } 
    public String getMessage() {
        return _message;
    } 
    private String _name;
    private String _message;
}

现在，是时候将 Word 模板传递给 LINQ 报告引擎并根据 Sender 对象的值生成 Word 文档了。以下是生成Word文档的步骤：

以下代码示例展示了如何使用 Java 对象的值从 Word 模板生成 Word 文档。

// 创建 Document 对象并使用 DOCX 模板进行初始化。
Document doc = new Document("template.docx");
// 创建发件人对象。
Sender sender = new Sender("LINQ Reporting Engine", "Hello World");
// 创建 ReportingEngine 对象。
ReportingEngine engine = new ReportingEngine();
// 建立报告。
engine.buildReport(doc, sender, "s");
// 另存为 Word 文档。
doc.save("word.docx");

输出

使用 Java 对象通过模板生成 word 文档

使用 XML 数据从模板创建 Word 文档

现在让我们更进一步，看看如何在有点复杂的场景中使用 XML 数据源填充 Word 模板。以下是我们将用于填充 Word 模板的 XML 数据源。

<Persons>
   <Person>
       <Name>John Doe</Name>
       <Age>30</Age>
       <Birth>1989-04-01 4:00:00 pm</Birth>
   </Person>
   <Person>
       <Name>Jane Doe</Name>
       <Age>27</Age>
       <Birth>1992-01-31 07:00:00 am</Birth>
   </Person>
   <Person>
       <Name>John Smith</Name>
       <Age>51</Age>
       <Birth>1968-03-08 1:00:00 pm</Birth>
   </Person>
</Persons>

在这种情况下，我们将在模板文档中为 XML 数据源中的多条记录使用以下标记。

<<foreach [in persons]>>Name: <<[Name]>>, Age: <<[Age]>>, Date of Birth: <<[Birth]:"dd.MM.yyyy">>
<</foreach>>
Average age: <<[persons.average(p => p.Age)]>>

在这种情况下，用于生成 Word 文档的 Java 代码是相同的，除了将 Java 对象作为数据源传递之外，我们将在 ReportingEngine.buildReport() 方法中传递 XmlDataSource 对象。以下代码示例展示了如何通过使用 Java 中的 XML 数据源填充文档模板来创建 Word 文档。

// 创建 Document 对象并使用 DOCX 模板进行初始化。
Document doc = new Document("template.docx");
// 加载 XML
XmlDataSource dataSource = new XmlDataSource("./datasource.xml");
// 创建 ReportingEngine 对象。
ReportingEngine engine = new ReportingEngine();
// 建立报告。
engine.buildReport(doc, dataSource, "persons");
// 另存为 Word 文档。
doc.save("word.docx");

输出

在Java中使用XML模板生成word文档

使用 JSON 数据从模板生成 Word 文档

现在让我们看看如何使用 JSON 数据源从 DOCX 模板生成 Word 文档。以下是我们将在此示例中使用的 JSON 数据。

[
   {
       Name: "John Smith",
       Contract:
       [
           {
               Client:
               {
                   Name: "A Company"
               },
               Price: 1200000
           },
           {
               Client:
               {
                   Name: "B Ltd."
               },
               Price: 750000
           },
           {
               Client:
               {
                   Name: "C & D"
               },
               Price: 350000
           }
       ]
   },
   {
       Name: "Tony Anderson",
       Contract:
       [
           {
               Client:
               {
                   Name: "E Corp."
               },
               Price: 650000
           },
           {
               Client:
               {
                   Name: "F & Partners"
               },
               Price: 550000
           }
       ]
   },
]

在此示例中，我们将生成 Word 文档，其中包含按经理分组的客户列表。根据这种情况，DOCX 模板将如下所示：

<<foreach [in managers]>>Manager: <<[Name]>>
Contracts:
<<foreach [in Contract]>>- <<[Client.Name]>> ($<<[Price]>>)
<</foreach>>
<</foreach>>

为了加载 JSON 数据源，Aspose.Words 提供了 JsonDataSource 类。以下代码示例展示了如何使用 Java 中的 JSON 数据源从模板创建 Word 文档。

// 创建 Document 对象并使用 DOCX 模板进行初始化。
Document doc = new Document("template.docx");
// 加载 JSON
JsonDataSource dataSource = new JsonDataSource("datasource.json");
// 创建 ReportingEngine 对象。
ReportingEngine engine = new ReportingEngine();
// 建立报告。
engine.buildReport(doc, dataSource, "managers");
// 另存为 Word 文档。
doc.save("word.docx");

输出

在 Java 中使用 JSON 创建 word 文档

使用 CSV 数据从模板生成 Word 文档

最后但同样重要的是，让我们看看如何通过使用以下 CSV 数据源填充 Word 模板来生成 Word 文档。

John Doe,30,1989-04-01 4:00:00 pm
Jane Doe,27,1992-01-31 07:00:00 am
John Smith,51,1968-03-08 1:00:00 pm

本示例将使用以下 Word 模板：

<<foreach [in persons]>>Name: <<[Column1]>>, Age: <<[Column2]>>, Date of Birth: <<[Column3]:"dd.MM.yyyy">>
<</foreach>>
Average age: <<[persons.average(p => p.Column2)]>>

为了处理 CSV 数据源，Aspose.Words 提供了 CsvDataSource 类。以下代码示例展示了如何使用 Java 中的 CSV 数据源生成 Word 文档。

// 创建 Document 对象并使用 DOCX 模板进行初始化。
Document doc = new Document("template.docx");
// 加载 CSV
CsvDataSource dataSource = new CsvDataSource("datasource.csv");
// 创建 ReportingEngine 对象。
ReportingEngine engine = new ReportingEngine();
// 建立报告。
engine.buildReport(doc, dataSource, "persons");
// 另存为 Word 文档。
doc.save("word.docx");

输出

在java中使用CSV创建word文档

了解有关 LINQ 报告引擎的更多信息

LINQ 报告引擎支持广泛的标签，用于在 Java 中动态生成功能齐全的 Word 文档。您可以在 本文 中探索有关这些标签及其语法的更多信息。

如果您有任何问题或疑问，可以发帖到 Aspose.Words 论坛。

相关文章）