Optimize 24 Watermark Java pages

.github/workflows/production.yml

@@ -26,23 +26,25 @@ jobs:
 
     # Steps represent a sequence of watermark that will be executed as part of the job
     steps:
-      # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
       - name: Checkout
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
         with:
-            submodules: true  # Fetch Hugo themes
-            fetch-depth: 0    # Fetch all history for .GitInfo and .Lastmod
+            submodules: true
+            fetch-depth: 0
       - name: Checkout theme repo
-        uses: actions/checkout@main
+        uses: actions/checkout@v4
         with:
           repository: groupdocs/tutorials-theme
           token: ${{ secrets.REPO_TOKEN }}
           fetch-depth: 0
           path: themes/tutorials-theme
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
       - name: Install Theme Dependencies
         run: npm install
-        working-directory: ./themes/tutorials-theme      
-      # Step 2 - Sets up the latest version of Hugo
+        working-directory: ./themes/tutorials-theme
       - name: Setup Hugo
         uses: peaceiris/actions-hugo@v3
         with:
@@ -54,7 +56,6 @@ jobs:
         run:  npm install -D --save postcss-cli
       - name: Install Dependicies3
         run:  npm install -D postcss
-      # Also specifies the theme we want to use
       - name: Build
         run: hugo --configDir config/watermark --environment production --minify
 

.github/workflows/staging.yml

@@ -39,7 +39,11 @@ jobs:
           token: ${{ secrets.REPO_TOKEN }}
           ref: beta
           fetch-depth: 0
-          path: themes/tutorials-theme      
+          path: themes/tutorials-theme 
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
       # Step 2 - Sets up the latest version of Hugo
       - name: Setup Hugo
         uses: peaceiris/actions-hugo@v2

content/chinese/java/pdf-document-watermarking/add-attachments-pdf-groupdocs-watermark-java/_index.md

@@ -0,0 +1,298 @@
+---
+date: '2026-07-20'
+description: 了解如何使用 GroupDocs.Watermark for Java 向 PDF 文件添加附件，包括 setup、code steps
+  和 best practices。
+keywords:
+- add attachments to pdf
+- embed file in pdf
+- attach documents to pdf
+- pdf embed attachment
+- add pdf attachment
+lastmod: '2026-07-20'
+og_description: 使用 GroupDocs.Watermark for Java 为 PDF 添加附件。遵循此 step‑by‑step guide
+  将文件 embed，提升 document utility，并高效 handle large PDFs。
+og_image_alt: Guide showing how to add file attachments to a PDF using GroupDocs.Watermark
+  Java SDK
+og_title: 使用 GroupDocs.Watermark for Java 为 PDF 添加附件
+schemas:
+- author: GroupDocs
+  dateModified: '2026-07-20'
+  description: Learn how to add attachments to PDF files using GroupDocs.Watermark
+    for Java, including setup, code steps, and best practices.
+  headline: Add Attachments to PDF with GroupDocs.Watermark for Java
+  type: TechArticle
+- description: Learn how to add attachments to PDF files using GroupDocs.Watermark
+    for Java, including setup, code steps, and best practices.
+  name: Add Attachments to PDF with GroupDocs.Watermark for Java
+  steps:
+  - name: '**Legal Documents** – Attach related contracts, evidence, or exhibits.'
+    text: '**Legal Documents** – Attach related contracts, evidence, or exhibits.'
+  - name: '**Project Proposals** – Include supplementary images, spreadsheets, or
+      CAD files.'
+    text: '**Project Proposals** – Include supplementary images, spreadsheets, or
+      CAD files.'
+  - name: '**Academic Papers** – Add source code, datasets, or multimedia as supporting
+      material.'
+    text: '**Academic Papers** – Add source code, datasets, or multimedia as supporting
+      material.'
+  type: HowTo
+- questions:
+  - answer: Yes, repeat the `add()` call for each file you wish to embed, and each
+      will appear as a separate entry in the PDF viewer’s attachment pane.
+    question: Can I add multiple attachments to a PDF?
+  - answer: Any file that can be represented as a byte array—common types include
+      DOCX, XLSX, PNG, ZIP, and even executable files.
+    question: What file types can be attached?
+  - answer: Compress files before attaching or store them externally and reference
+      them with a lightweight placeholder attachment; the library streams data to
+      keep RAM usage low.
+    question: How do I handle large files?
+  - answer: There are no explicit limits, but attaching hundreds of large files may
+      affect performance; monitor memory consumption and consider splitting the PDF
+      if needed.
+    question: Is there a limit to the number of attachments?
+  - answer: Yes, GroupDocs.Watermark is fully compatible with cloud environments such
+      as AWS Lambda, Azure Functions, and Google Cloud Run.
+    question: Can this feature be used in cloud applications?
+  type: FAQPage
+tags:
+- add attachments to pdf
+- GroupDocs.Watermark
+- Java PDF processing
+title: 使用 GroupDocs.Watermark for Java 为 PDF 添加附件
+type: docs
+url: /zh/java/pdf-document-watermarking/add-attachments-pdf-groupdocs-watermark-java/
+weight: 1
+---
+
+# 使用 GroupDocs.Watermark 在 Java 中向 PDF 添加附件
+
+## 介绍
+
+在本综合指南中，您将学习 **如何向 PDF 添加附件**，使用 GroupDocs.Watermark for Java。通过将额外文件（如合同、图像或数据集）直接嵌入 PDF 中，您可以创建一个自包含的包，便于在用户和系统之间轻松传输。我们将逐步演示环境设置、具体的 API 调用以及成熟的最佳实践，让您今天就能开始在 PDF 文档中嵌入文件。
+
+**您将学习**
+- 为 Java 中的 GroupDocs.Watermark 设置环境  
+- 向 PDF 文档添加附件的逐步过程  
+- 最佳实践、性能技巧和故障排除建议  
+
+让我们先回顾在实现此解决方案之前所需的前置条件。
+
+## 快速答疑
+
+- **哪个库可以向 PDF 添加附件？** GroupDocs.Watermark for Java.  
+- **我需要许可证吗？** 临时试用许可证可用于开发；生产环境需要正式许可证。  
+- **可以一次附加多个文件吗？** 可以——对每个要嵌入的文件调用 `add()`。  
+- **支持哪些文件类型？** 任何可以表示为字节数组的文件（例如 DOCX、PNG、ZIP）。  
+- **对大 PDF 安全么？** 安全——附件以流式方式处理，您可以使用 `PdfLoadOptions` 限制内存使用。
+
+## 什么是向 PDF 添加附件？
+
+**add attachments to pdf** 是将外部文件嵌入 PDF 容器的过程，使其与主文档一起携带。此技术广泛用于法律文书、项目提案和研究论文等需要将支持材料与主 PDF 关联的场景。
+
+## 为什么使用 GroupDocs.Watermark 在 PDF 中嵌入文件？
+
+GroupDocs.Watermark 支持 **50 多种输入和输出格式**，并且可以在不将整个 PDF 加载到内存的情况下嵌入附件，使您能够高效处理数百页的文件。该 API 还保留原始文档元数据并提供线程安全的操作，适合服务器端批处理。
+
+## 前置条件
+
+### 必需的库、版本和依赖项
+
+- **GroupDocs.Watermark for Java**：版本 24.11 或更高。  
+- **Java Development Kit (JDK)**：推荐使用 8 版或更高。  
+- **Maven**：用于依赖管理。
+
+### 环境搭建要求
+
+确保您的开发环境支持 Maven 项目，并且可以使用 IntelliJ IDEA 或 Eclipse 等 Java IDE。
+
+### 知识前置要求
+
+具备 Java 编程的基础知识并熟悉在 Java 中处理 PDF 将会有帮助。
+
+## 如何使用 GroupDocs.Watermark 向 PDF 添加附件？
+
+使用 `new WatermarkEngine()` 加载 PDF 并调用 `pdfContent.getAttachments().add()`——此单次调用将在内存中附加文件并一次性写回 PDF。API 会自动更新 PDF 的内部 file‑spec 字典，使附件在标准 PDF 查看器的 “Attachments” 面板中显示。该方法适用于任何可表示为字节数组的文件类型，并且由于库采用流式处理而非将整个文件加载到 RAM，能够扩展到大型文档。
+
+`WatermarkEngine` 类是 GroupDocs.Watermark 中加载和处理文档的主要入口。  
+`PdfContent` 对象提供对 PDF 结构的访问，包括页面、元数据和附件。  
+`getAttachments()` 方法返回 PDF 的附件集合。  
+`add()` 方法向该集合中插入新文件。
+
+### 为 Java 设置 GroupDocs.Watermark
+
+`WatermarkEngine` 类是所有 GroupDocs.Watermark 操作的入口，负责文件加载、处理和保存。添加 Maven 依赖后，您即可实例化引擎并开始处理 PDF。
+
+**Maven 设置**  
+在您的 `pom.xml` 文件中添加以下内容：
+```xml
+<repositories>
+   <repository>
+      <id>repository.groupdocs.com</id>
+      <name>GroupDocs Repository</name>
+      <url>https://releases.groupdocs.com/watermark/java/</url>
+   </repository>
+</repositories>
+
+<dependencies>
+   <dependency>
+      <groupId>com.groupdocs</groupId>
+      <artifactId>groupdocs-watermark</artifactId>
+      <version>24.11</version>
+   </dependency>
+</dependencies>
+```
+
+**直接下载**  
+或者，从 [GroupDocs.Watermark for Java releases](https://releases.groupdocs.com/watermark/java/) 下载最新版本。
+
+### 获取许可证的步骤
+
+您可以获取临时许可证或购买正式许可证以解锁全部功能。免费试用请按照其官方网站上的说明操作。
+
+### 基本初始化和设置
+
+在 Java 应用程序中按如下方式初始化 GroupDocs.Watermark：
+`Watermarker` 类表示 PDF 文档，并提供操作其内容的方法，包括添加附件。
+```java
+import com.groupdocs.watermark.Watermarker;
+
+public class WatermarkSetup {
+    public static void main(String[] args) {
+        // Initialize watermarker with a sample document path
+        try (Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_DIRECTORY/document.pdf")) {
+            System.out.println("GroupDocs.Watermark is set up successfully!");
+        } catch (Exception e) {
+            e.printStackTrace();
+        }
+    }
+}
+```
+
+## 实施指南
+
+现在，让我们逐步了解使用 GroupDocs.Watermark 在 Java 中向 PDF 添加附件的过程。
+
+### 向 PDF 文档添加附件
+
+#### 概述
+
+此功能允许您向现有 PDF 文档附加额外文件。将相关文档打包在一起可以显著提升其使用价值。
+
+#### 步骤指南
+
+##### 1. 加载 PDF 文档
+首先使用 `PdfLoadOptions` 加载 PDF：
+`PdfLoadOptions` 配置 PDF 的打开方式，允许您设置内存使用和密码选项。
+```java
+import com.groupdocs.watermark.Watermarker;
+import com.groupdocs.watermark.options.PdfLoadOptions;
+
+// Set options required for loading the PDF file
+PdfLoadOptions loadOptions = new PdfLoadOptions();
+
+// Initialize Watermarker with a specific document path and load options
+Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_DIRECTORY/document.pdf", loadOptions);
+```
+
+##### 2. 访问 PDF 内容
+获取 `PdfContent` 以处理附件：
+```java
+import com.groupdocs.watermark.contents.PdfContent;
+
+// Get the content of the PDF as PdfContent
+PdfContent pdfContent = watermarker.getContent(PdfContent.class);
+```
+
+##### 3. 加载附件字节
+准备要添加的附件数据：
+```java
+byte[] attachmentBytes = { /* Byte data for your document */ };
+```
+
+##### 4. 添加附件
+使用 `getAttachments().add()` 方法附加文件：
+```java
+// Add the attachment to the PDF
+groupdocs.watermark.contents.PdfAttachment attachment = new PdfAttachment(attachmentBytes, "sample doc", "sample doc as attachment");
+pdfContent.getAttachments().add(attachment);
+```
+
+##### 5. 保存更改并关闭资源
+确保正确保存更改并关闭资源：
+```java
+// Save changes to a new PDF file
+watermarker.save("YOUR_OUTPUT_DIRECTORY/output_document.pdf");
+
+// Close the watermarker instance
+watermarker.close();
+```
+
+### 故障排除技巧
+- **文件路径错误**：确保路径正确且可访问。  
+- **内存问题**：优化附件大小以提升性能；库采用流式处理以保持低内存使用。
+
+## 实际应用
+
+向 PDF 添加附件在多种场景下都很有用：
+
+1. **法律文件** – 附加相关合同、证据或展品。  
+2. **项目提案** – 包含补充图片、电子表格或 CAD 文件。  
+3. **学术论文** – 添加源代码、数据集或多媒体作为支持材料。  
+
+与文档管理系统（DMS）或云存储平台的集成可以进一步实现自动化打包。
+
+## 性能考虑
+
+为获得最佳性能：
+
+- 最小化附件大小以降低内存占用。  
+- 在 Java 中使用高效的文件处理实践（例如 `try‑with‑resources`）。  
+- 定期更新 GroupDocs.Watermark，以获得性能提升和错误修复。
+
+## 结论
+
+使用 GroupDocs.Watermark for Java 向 PDF 添加附件是一个简便的过程，能够显著提升文档的实用性。通过本指南，您已学会如何有效实现此功能并了解其实际应用。
+
+接下来，您可以探索 GroupDocs.Watermark 库的其他功能——如水印、编辑或内容提取，并将其集成到更大的文档处理流水线中。
+
+## 常见问题
+
+**Q: 我可以向 PDF 添加多个附件吗？**  
+A: 可以，对每个要嵌入的文件重复调用 `add()`，每个文件将在 PDF 查看器的附件面板中显示为单独的条目。
+
+**Q: 可以附加哪些文件类型？**  
+A: 任何可以表示为字节数组的文件——常见类型包括 DOCX、XLSX、PNG、ZIP，甚至可执行文件。
+
+**Q: 如何处理大文件？**  
+A: 在附加之前压缩文件，或将文件存储在外部并使用轻量占位附件进行引用；库采用流式处理以保持低 RAM 使用。
+
+**Q: 附件数量有上限吗？**  
+A: 没有明确的限制，但附加数百个大文件可能影响性能；请监控内存消耗，并在必要时考虑拆分 PDF。
+
+**Q: 此功能可以在云应用中使用吗？**  
+A: 可以，GroupDocs.Watermark 完全兼容 AWS Lambda、Azure Functions 和 Google Cloud Run 等云环境。
+
+**Q: 添加附件会影响 PDF 的安全性吗？**  
+A: 附件会继承 PDF 的安全设置。如果 PDF 已加密，加载时必须提供密码，附件也会被加密。
+
+## 资源
+
+- **文档**: [GroupDocs Watermark Java Documentation](https://docs.groupdocs.com/watermark/java/)
+- **API 参考**: [GroupDocs API Reference](https://reference.groupdocs.com/watermark/java)
+- **下载**: [Latest GroupDocs Releases](https://releases.groupdocs.com/watermark/java/)
+- **GitHub**: [GroupDocs Watermark GitHub Repository](https://github.com/groupdocs-watermark/GroupDocs.Watermark-for-Java)
+- **免费支持**: [GroupDocs Forum](https://forum.groupdocs.com/c/watermark/10)
+- **临时许可证**: [Obtain a Temporary License](https://purchase.groupdocs.com/temporary-license/)
+
+---
+
+**最后更新：** 2026-07-20  
+**测试环境：** GroupDocs.Watermark 24.11 for Java  
+**作者：** GroupDocs
+
+## 相关教程
+
+- [如何使用 GroupDocs Watermark for Java 在电子邮件文档管理中提取 PDF 附件](/watermark/java/email-document-watermarking/extract-pdf-attachments-groupdocs-java/)
+- [使用 GroupDocs.Watermark for Java 访问并遍历 PDF 工件进行文档水印](/watermark/java/pdf-document-watermarking/access-iterate-pdf-artifacts-groupdocs-watermark-java/)
+- [如何使用 GroupDocs Watermark for Java 保护 PDF 附件：综合指南](/watermark/java/pdf-document-watermarking/groupdocs-watermark-java-pdf-attachments/)