
Java REST API برای تبدیل HTML به سند Word.
آیا شما به دنبال تبدیل HTML به Word documents در Java هستید؟ خواه در حال توسعه نرمافزار خودکارسازی سند باشید یا نیاز به تولید گزارشهای Word از تمپلیتهای HTML داشته باشید، این آموزش نشان میدهد که چگونه میتوانید بهطور کارآمد از SDK Cloud GroupDocs.Conversion برای Java استفاده کنید. با فقط چند خط کد، میتوانید HTML را به فرمت DOC یا DOCX تبدیل کنید در حالی که ساختار و استایل را حفظ میکنید.
چرا HTML را به ورد در Java تبدیل کنیم؟
تبدیل یک HTML به سند ورد به شما این امکان را میدهد که:
- مدارک حرفهای از محتوای وب ایجاد کنید.
- اتوماسیون گردش کار تولید مستندات.
- حفظ قالب بندی و استایل های CSS از HTML.
- قالبهای HTML پویا را به فایلهای Word قابل ویرایش صادر کنید.
بیایید موضوعات زیر را با جزئیات بیشتری بررسی کنیم.
- Java HTML to DOCX Conversion REST API
- چگونه HTML را در Java به ورد تبدیل کنیم
- تبدیل HTML به DOCX با استفاده از cURL
- سرویس آنلاین تبدیل HTML به Word را رایگان امتحان کنید
Java HTML به DOCX تبدیل REST API
GroupDocs.Conversion Cloud SDK for Java یک API REST قدرتمند ارائه میدهد که به شما امکان تبدیل بیش از 50 فرمت فایل، از جمله HTML به DOC و DOCX را میدهد. بنابراین، شما میتوانید به راحتی با API REST تعامل داشته باشید بدون اینکه نیاز به مدیریت درخواستهای HTTP خام داشته باشید.
🛠️ مزایای استفاده از Java SDK
در اینجا چند دلیل قانعکننده وجود دارد که چرا توسعهدهندگان Java از استفاده از این SDK مبتنی بر REST لذت میبرند:
🔧 ادغام آسان
به راحتی در برنامههای Java با تنها چند خط کد ادغام میشود.
📁 از ۵۰+ فرمت فایل پشتیبانی میکند
بین فرمتهای DOCX، PDF، HTML، XLSX، PPTX، JPG و بسیاری فرمتهای دیگر تبدیل کنید.
☁️ مبتنی بر Cloud و مستقل از پلتفرم
هیچ نیازی به نصب یا مدیریت کتابخانههای محلی یا وابستگیها نیست.
🔒 امن و قابل اعتماد
دادههای شما بهطور ایمن از طریق HTTPS با استفاده از احراز هویت OAuth 2.0 منتقل میشود.
🚀 خودکارسازی جریانهای کاری
کارهای تبدیل سند را خودکار کنید و تلاش دستی را کاهش دهید.
💡 نکته حرفهای: SDK را با وظایف زمانبندی شده (cron jobs) یا میکرو سرویسها ترکیب کنید تا هزاران سند را به صورت گروهی تبدیل کنید.
اکنون، برای استفاده از SDK، اولین قدم نصب مرجع GroupDocs.Conversion Cloud SDK برای Java است. لطفا وابستگی Maven زیر را در pom.xml اضافه کنید:
<repository>
<id>repository.groupdocs.cloud</id>
<name>repository.groupdocs.cloud</name>
<url>https://releases.groupdocs.cloud/java/repo/</url>
</repository>
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-conversion-cloud</artifactId>
<version>25.3</version>
</dependency>
دریافت اعتبارنامه API
در GroupDocs Cloud Dashboard ثبت نام کنید و Client ID و Client Secret خود را دریافت کنید (لطفاً دستورالعملهای مشخص شده در این tutorial را دنبال کنید).
چگونه HTML را در Java به ورد تبدیل کنیم
این بخش جزئیات مربوط به چگونگی تبدیل آسان HTML به سند Word را با استفاده از کد Java ارائه میدهد.
- مجوز دسترسی به API را تأیید کنید.
Configuration configuration = new Configuration("your-client-id", "your-client-secret");
ConvertApi apiInstance = new ConvertApi(configuration);
- فایل JSON را به فضای ذخیرهسازی ابری بارگذاری کنید.
FileUploadApi fileUpload = new FileUploadApi(configuration);
File inputFile = new File("input.html");
fileUpload.uploadFile(new UploadFileRequest("input.html", inputFile));
- پارامترهای تبدیل را تنظیم کنید.
ConvertSettings settings = new ConvertSettings();
settings.setFilePath("input.html");
settings.setFormat("DOC");
settings.setOutputPath("converted.doc");
- Perform JSON to HTML conversion.
ConvertDocumentRequest request = new ConvertDocumentRequest(settings);
DocumentResult response = apiInstance.convertDocument(request);
System.out.println("Conversion successful! The resultant DOC file is saved at:" + response.getFilePath());
// More examples over https://github.com/groupdocs-conversion-cloud/groupdocs-conversion-cloud-dotnet
// اطلاعات کاربری API خود را دریافت کنید
string clientId = "XXXXXX-XXXXXXXXX-4088-9ca0-55c38f4b7f22";
string clientSecret1 = "XXXXXXXXXXXXXXXXXXXX";
// یک نمونه از کلاس Configuration ایجاد کنید و آن را با Client ID و Client Secret راهاندازی کنید.
Configuration configuration = new Configuration(clientId, clientSecret);
// آدرس پایه API را برای انجام عملیات تبدیل HTML به سند ورد تعریف کنید.
configuration.setApiBaseUrl("https://api.groupdocs.cloud");
// یک نمونه از ConvertApi را با شیء Configuration راهاندازی کنید.
ConvertApi convertApi = new ConvertApi(configuration);
ConvertSettings settings = new ConvertSettings();
settings.setStorageName("internal");
settings.setFilePath("input.html");
settings.setFormat("DOC");
settings.setOutputPath("myResultant.doc");
// از روش ConvertDocument برای تبدیل HTML به سند Word استفاده کنید
ConvertDocumentRequest request = new ConvertDocumentRequest(settings);
List<StoredConvertedResult> response = convertApi.convertDocument(request);
// پاسخ را بررسی کنید و پیام موفقیت را چاپ کنید
if (response != null && response.equals("OK")) {
System.out.println("Conversion successful! Resultant Word document is saved at: " + response.getFilePath());
}

تصویر:- پیش نمایش تبدیل HTML به سند Word.
تبدیل HTML به DOCX با استفاده از cURL
اگر شما ابزارهای خط فرمان را ترجیح میدهید، میتوانید بهراحتی تبدیل HTML به DOCX را با استفاده از cURL و GroupDocs.Conversion REST API انجام دهید.
ابتدا، ما نیاز داریم یک توکن دسترسی JWT تولید کنیم و سپس، فرمان cURL زیر را اجرا کنیم تا یک صفحه وب را به سند ورد تبدیل کرده و فایل DOCX حاصل را در فضای ذخیره سازی ابری ذخیره کنیم.
curl -v "https://api.groupdocs.cloud/v2.0/conversion" \
-X POST \
-H "accept: application/json" \
-H "authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d "{ \"StorageName\": \"default\", \"FilePath\": \"{sourceFile}\", \"Format\": \"docx\",\"OutputPath\": \"{resultantFile}\"}"
لطفاً sourceFile
را با نام فایل HTML ورودی، resultantFile
را با نام سند Word حاصل و accessToken
را با توکن دسترسی JWT شخصیسازیشده جایگزین کنید.
- به منظور ذخیره سند Word حاصلشده بر روی درایو محلی، لطفاً سعی کنید از دستور cURL زیر استفاده کنید.
curl -v "https://api.groupdocs.cloud/v2.0/conversion" \
-X POST \
-H "accept: application/json" \
-H "authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d "{ \"StorageName\": \"default\", \"FilePath\": \"{sourceFile}\", \"Format\": \"docx\"}" \
-o "{resultantFile}"
سرویس تبدیل رایگان HTML به ورد آنلاین
از HTML to Word Converter رایگان ما در مرورگر وب استفاده کنید و قابلیتهای API GroupDocs.Conversion Cloud را آزمایش کنید.
لینک های مفید
تفکرات نهایی
با استفاده از GroupDocs.Conversion Cloud SDK برای جاوا، میتوانید به راحتی تبدیل HTML به سند Word را در برنامههای خود یکپارچه کنید. این فرایند زمان را صرفهجویی میکند، فرمت را حفظ میکند و روندهای اتوماسیون سند را برای توسعهدهندگان ساده میسازد.
مقالات پیشنهادی
ما به شدت بازدید از لینکهای زیر را به منظور کسب اطلاعات بیشتر توصیه میکنیم: