در گذشته اخیر، ما پست‌های وبلاگی درباره نحوه اضافه کردن واترمارک به PNG و Excel به صورت برنامه‌نویسی منتشر کردیم. این مقاله روند افزودن واترمارک در اسناد Word را با استفاده از GroupDocs.Watermark Cloud SDKs for Java توضیح می‌دهد. طیف گسترده‌ای از ویژگی‌ها توسط GroupDocs.Watermark از جمله Cloud SDKs و REST در معرض دید قرار گرفته‌اند. بنابراین، ما مراحل نصب و همچنین اجرا را طی خواهیم کرد. بنابراین، لطفاً این پست وبلاگ را به طور کامل مرور کنید تا یاد بگیرید که چگونه به صورت برنامه‌نویسی واترمارک به Word در جاوا اضافه کنید. در پایان این راهنما، شما قادر خواهید بود برای نرم افزار کسب و کار خود یک واترمارک ایجاد کنید.
در این پست وبلاگ به نکات زیر پرداخته خواهد شد:
نصب واترمارک Creator API
مراحل نصب این کتابخانه جاوا بسیار ساده است. با این حال، می‌توانید بدون وابستگی به شخص ثالث، واترمارک را در اسناد 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 از API Cloud داشبورد است. برای این منظور، لطفاً در صورت مواجه شدن با هر گونه مشکل، به این [راهنما] مراجعه کنید.
اضافه کردن واترمارک به Word در جاوا
اکنون، ما فایل منبع MS Word را در داشبورد API Cloud آپلود کرده ایم که می توانید با فراخوانی این روش UploadFile آن را به صورت دستی یا برنامه ای آپلود کنید.
مراحل زیر نحوه درج واترمارک در سند Word را به صورت برنامه‌ریزی نشان می‌دهد:
- یک نمونه از کلاس Configuration ایجاد کنید و آن را با Client ID و Client Secret مقداردهی کنید.
- یک شی از کلاس WatermarkApi را با نمونه پیکربندی راه‌اندازی کنید.
- یک شی از کلاس FileInfo ایجاد کنید.
- مسیر فایل Word را با فراخوانی متد setFilePath تنظیم کنید.
- با ایجاد نمونه ای از کلاس WatermarkOptions گزینه های Watermark را تنظیم کنید.
- برای تعریف فایل منبع، متد setFileInfo را فراخوانی کنید.
- گزینه های واترمارک متنی مانند خانواده فونت، متن واترمارک، اندازه فونت و غیره را تعریف کنید.
- یک شی از کلاس Color ایجاد کنید و رنگ متن Watermark را با فراخوانی متد setForegroundColor تنظیم کنید.
- جزئیات واترمارک را با فراخوانی متد setTextWatermarkOptions از کلاس WatermarkDetails تعریف کنید.
- یک نمونه از کلاس Position ایجاد کنید و موقعیت واترمارک را تنظیم کنید.
- با ایجاد نمونه ای از کلاس AddRequest یک درخواست برای اضافه کردن واترمارک ایجاد کنید.
- برای افزودن واترمارک به Word، متد add کلاس WatermarkApi را فراخوانی کنید.
کد زیر را در فایل اصلی خود کپی و پیست کنید:
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";
// یک نمونه از کلاس Configuration ایجاد کنید و آن را با Client ID و Client Secret مقداردهی کنید.
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 گزینه های Watermark را تنظیم کنید.
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 و تنظیم رنگ متن Watermark با فراخوانی متد setForegroundColor.
Color color = new Color();
color.setName("White");
textWatermarkOptions.setForegroundColor(color);
// جزئیات واترمارک را با فراخوانی متد setTextWatermarkOptions از کلاس WatermarkDetails تعریف کنید.
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 {
// برای افزودن واترمارک به Word متد add کلاس WatermarkApi را فراخوانی کنید.
response = apiInstance.add(request);
System.out.println("Resultant file path: " + response.getPath());
} catch (ApiException e) {
// TODO بلوک catch ایجاد شده به صورت خودکار
e.printStackTrace();
}
}
}
هنگامی که فایل سرور را اجرا کردید، فایل ایجاد شده را در داشبورد API Cloud که در تصویر زیر نشان داده شده است مشاهده خواهید کرد:
Watermark Generator آنلاین
علاوه بر این، می‌توانید از یک ابزار آنلاین برای تولید واترمارک آنلاین استفاده کنید و از GroupDocs.Watermark استفاده کنید. این سازنده واترمارک آنلاین بسیار کارآمد است و یک رابط کاربر پسند ارائه می دهد که در آن کاربران می توانند به راحتی فایل ها را بکشند و رها کنند. مهمتر از همه، رایگان است و می توانید از این ابزار آنلاین برای اضافه کردن واترمارک به اسناد Word استفاده کنید.
نتیجه
این پایان این پست وبلاگ است. ما GroupDocs.Watermark Cloud SDKs for Java و همچنین فرآیند پیاده سازی را گذرانده ایم. علاوه بر این، نحوه اضافه کردن واترمارک به Word در جاوا را یاد گرفته ایم. علاوه بر این، در صورتی که می‌خواهید توسعه را شروع کنید، می‌توانید به اسناد و [راهنمای شروع 18 مراجعه کنید. در پایان، تعامل با APIهای زنده ما را فراموش نکنید اینجا.
در نهایت، groupdocs.cloud در حال نوشتن مقالات جدید است. بنابراین، لطفا برای به روز رسانی های منظم در تماس باشید.
راهنما در دسترس است
می‌توانید در مورد سؤالات یا سؤالات خود در [تالار گفت‌وگو 21 ما با ما در میان بگذارید.
سوالات متداول - سوالات متداول
چگونه واترمارک را در سند Word وارد کنم؟
با استفاده از GroupDocs.Watermark Cloud SDKs for Java می توانید واترمارک را در اسناد Word وارد کنید. لطفاً برای کسب اطلاعات بیشتر به این لینک مراجعه کنید.
چگونه می توانم یک واترمارک رایگان آنلاین دریافت کنم؟
این آنلاین سازنده واترمارک مبتنی بر وب است و استفاده از آن رایگان است.