最近，我們發布了有關如何以程式設計方式為 PNG 和 Excel 添加浮水印的部落格文章。本文介紹了使用 GroupDocs.Watermark Cloud SDKs for Java 在 Word 文件中加入浮水印的過程。 GroupDocs.Watermark 公開了廣泛的功能，包括雲端 SDK 和 REST API。因此，我們將完成安裝過程以及實施。因此，請仔細閱讀這篇博文，以了解如何以程式設計方式在 Java 中為 Word 添加浮水印。在本指南結束時，您將能夠為您的商業軟體建立浮水印創建器。
本篇博文將涵蓋以下幾點：
水印創建器 API 安裝
這個Java函式庫的安裝過程非常簡單。但是，您可以在 Word 文件中新增浮水印，而無需依賴任何第三方依賴項。因此，您可以透過下載此 JAR 檔案來安裝它，也可以使用下列 Maven 配置：
<repository>
<id>groupdocs-artifact-repository</id>
<name>GroupDocs Artifact Repository</name>
<url>https://repository.groupdocs.cloud/repo</url>
</repository>
<dependency>
<groupId>com.groupdocs</groupId
<artifactId>groupdocs-watermark-cloud</artifactId>
<version>22.3</version>
<scope>compile</scope>
</dependency>
安裝後，下一步是從 API Cloud 儀表板 取得 API 憑證。為此，如果您遇到任何困難，請訪問此指南。
在Java中為Word添加浮水印
現在，我們已將來源 MS Word 檔案上傳到 API Cloud 儀表板，您可以透過呼叫此 UploadFile 方法手動或以程式設計方式上傳該檔案。
以下步驟示範如何以程式設計方式在 Word 文件中插入浮水印：
- 建立配置類別的實例並使用客戶端 ID 和客戶端金鑰對其進行初始化。
- 使用配置實例初始化 WatermarkApi 類別的物件。
- 建立 FileInfo 類別的物件。
- 透過呼叫setFilePath方法設定Word檔案路徑。
- 透過建立 WatermarkOptions 類別的實例來設定浮水印選項。
- 呼叫setFileInfo方法定義來源檔。
- 定義文字浮水印選項，例如字體系列、浮水印文字、字體大小等。
- 建立 Color 類別的對象，並透過呼叫 setForegroundColor 方法來設定水印文字顏色。
- 透過呼叫 WatermarkDetails 類別的 setTextWatermarkOptions 方法定義水印詳細資訊。
- 建立Position類別的實例並設定浮水印位置。
- 透過建立 AddRequest 類別的實例來建立新增浮水印的請求。
- 呼叫WatermarkApi類別的add方法為Word新增浮水印。
將以下程式碼複製並貼上到您的主文件中：
package com.example;
import com.groupdocs.cloud.watermark.client.*;
import com.groupdocs.cloud.watermark.model.*;
import com.groupdocs.cloud.watermark.model.requests.AddRequest;
import com.groupdocs.cloud.watermark.api.WatermarkApi;
import java.util.*;
public class Main {
public static void main(String[] args) {
String ClientId = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx";
String ClientSecret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";
String myStorage = "test";
// 建立配置類別的實例並使用客戶端 ID 和客戶端金鑰對其進行初始化。
Configuration configuration = new Configuration(ClientId, ClientSecret);
// 使用配置實例初始化 WatermarkApi 類別的物件。
WatermarkApi apiInstance = new WatermarkApi(configuration);
// 建立 FileInfo 類別的物件。
FileInfo fileInfo = new FileInfo();
// 透過呼叫setFilePath方法設定Word檔案路徑。
fileInfo.setFilePath("sample.docx");
fileInfo.setStorageName(myStorage);
// 透過建立 WatermarkOptions 類別的實例來設定浮水印選項。
WatermarkOptions options = new WatermarkOptions();
// 呼叫setFileInfo方法定義來源檔。
options.setFileInfo(fileInfo);
// 定義文字浮水印選項，例如字體系列、浮水印文字、字體大小等。
TextWatermarkOptions textWatermarkOptions = new TextWatermarkOptions();
textWatermarkOptions.setText("GroupDocs watermark");
textWatermarkOptions.setFontFamilyName("Arial");
textWatermarkOptions.setFontSize(12d);
textWatermarkOptions.setTextAlignment("Center");
// 建立 Color 類別的對象，並透過呼叫 setForegroundColor 方法來設定水印文字顏色。
Color color = new Color();
color.setName("White");
textWatermarkOptions.setForegroundColor(color);
// 透過呼叫 WatermarkDetails 類別的 setTextWatermarkOptions 方法定義水印詳細資訊。
WatermarkDetails watermarkDetails = new WatermarkDetails();
watermarkDetails.setTextWatermarkOptions(textWatermarkOptions);
// 建立Position類別的實例並設定浮水印位置。
Position position = new Position();
position.setX(180.0);
position.setY(450.0);
watermarkDetails.setPosition(position);
// 設定水印詳細資訊
List<WatermarkDetails> watermarkDetailsList = new ArrayList<WatermarkDetails>();
watermarkDetailsList.add(watermarkDetails);
options.setWatermarkDetails(watermarkDetailsList);
// 透過建立 AddRequest 類別的實例來建立新增浮水印的請求。
AddRequest request = new AddRequest(options);
WatermarkResult response;
try {
// 呼叫WatermarkApi類別的add方法為Word新增浮水印。
response = apiInstance.add(request);
System.out.println("Resultant file path: " + response.getPath());
} catch (ApiException e) {
// TODO 自動產生的 catch 區塊
e.printStackTrace();
}
}
}
運行伺服器文件後，您將看到在 API Cloud 儀表板中建立的生成文件，如下圖所示：
線上水印產生器
此外，您可以利用線上工具在線上產生浮水印，該工具由GroupDocs.Watermark提供支援。這個線上浮水印創建器效率很高，並提供用戶友好的介面，用戶可以輕鬆拖放文件。最重要的是，它是免費的，您可以使用此線上工具為 Word 文件添加浮水印。
結論
本博文到此結束。我們已經完成了 GroupDocs.Watermark Cloud SDKs for Java 以及實施過程。此外，我們還學習如何在Java中以程式設計方式為Word添加浮水印。此外，如果您想開始開發，可以存取文件和入門指南。最後，不要忘記與我們的即時 API 進行互動 此處。
最後，groupdocs.cloud正在撰寫新文章。因此，請保持聯繫以獲取定期更新。
提供協助
您可以在我們的論壇上告訴我們您的問題或疑問。
常見問題 – 常見問題解答
如何在Word文件中插入浮水印？
您可以使用 GroupDocs.Watermark Cloud SDKs for Java 將浮水印插入 Word 文件中。請訪問此連結以了解更多資訊。
如何在線上獲得免費浮水印？
這個線上水印創建器是基於網路的並且可以免費使用。