GroupDocs.Assembly Cloud 是一项完全托管的、基于 REST 的服务,使 Java 开发者能够直接从云端创建高度定制的文档、报告、合同、发票和邮件合并信函。该解决方案支持多种输入和输出格式,允许您将模板文件存储在 GroupDocs 云存储中,将其绑定到 XML 或 JSON 数据源,并以您选择的格式(DOCX、PDF、HTML、PPTX、XLSX 等)接收组装好的文档。由于所有处理都在服务器端进行,因此无需在客户端计算机上安装任何第三方软件或库;唯一需要的是 Java 运行时和 Assembly Cloud SDK,后者为 API 端点提供了精简的封装。
典型的 Java 工作流程包含三个简单的步骤。首先,将 Assembly Cloud SDK 依赖项添加到您的 Maven 或 Gradle 项目,并使用您的个人 AppSID 和 AppKey 初始化 ApiClient。其次,使用 uploadFile 方法将模板文件上传到 GroupDocs 云存储。第三,创建一个 AssembleOptions 对象,指定模板路径、数据文件(XML 或 JSON)和所需的输出格式,并调用 assembleDocument。该服务将组装好的文档以流的形式返回,该流可以保存在本地或进一步处理。SDK 还提供了用于预览模板、检索支持的格式和处理错误的辅助方法。这种简单的方法让您能够以最少的代码将文档生成功能集成到 Web 应用程序、批处理作业或微服务中。
所有通信均使用 SSL/TLS 加密,并由个人密钥控制访问权限。该平台可自动扩展以处理大量请求,并支持批量邮件合并操作,单个 API 调用即可生成数千封个性化信件。此外,SDK 还支持嵌入图像、图表、条形码,并使用 LINQ 风格的表达式直接在模板中应用条件逻辑,让您完全控制最终的文档布局。
以下代码片段演示了如何使用 Assembly Cloud API 上传模板、设置数据源并生成 DOCX 报告。 步骤
AssembleOptions – 模板路径、输出格式和数据文件。assembleDocument 生成结果。import com.groupdocs.assembly.*;
AssemblyApi assemblyApi = new AssemblyApi(new ApiClient());
ApiClient client = assemblyApi.getApiClient();
client.setAppKey("......##").setAppSid(".#-.#-.#-.#-.#");
String fileName = "Input1.docx";
String dataFile = "Input2.docx";
File requestFileContent = new File(fileName);
UploadFileRequest uploadDocumentRequest =
new UploadFileRequest(requestFileContent, fileName, null);
assemblyApi.uploadFile(uploadDocumentRequest);
AssembleOptions assembleOptions = new AssembleOptions();
assembleOptions.setTemplateFileInfo(new TemplateFileInfo().filePath(fileName));
assembleOptions.setSaveFormat("docx");
assembleOptions.setReportData(Paths.get(dataFile).toString());
AssembleDocumentRequest request = new AssembleDocumentRequest(assembleOptions);
assemblyApi.assembleDocument(request);