GroupDocs.Assembly Cloud 是一项全托管、基于 REST 的服务,使 Java 开发者能够直接在云端创建高度自定义的文档、报告、合同、发票和邮件合并信件。该解决方案支持多种输入和输出格式,允许你将模板文件存储在 GroupDocs Cloud Storage,并将其绑定到 XML 或 JSON 数据源,随后以你选择的格式(如 DOCX、PDF、HTML、PPTX、XLSX 等)获取组装后的文档。由于所有处理均在服务器端完成,无需在客户端机器上安装任何第三方软件或库;唯一的要求是 Java 运行时以及 Assembly Cloud SDK,后者为 API 端点提供轻量封装。
典型的 Java 工作流包括三个简单步骤。第一步,将 Assembly Cloud SDK 依赖添加到你的 Maven 或 Gradle 项目中,并使用你的个人 App SID 和 App Key 初始化 ApiClient。第二步,使用 uploadFile 方法将模板文件上传至 GroupDocs Cloud Storage。第三步,创建一个 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);