تولید محتوای وب پویا یک نیاز مکرر برای توسعهدهندگان جاوا است که گزارشها، بدنههای ایمیل یا مستندات توکار را میسازند. Conholdate.Total for Java یک SDK قدرتمند فراهم میکند که ایجاد فایلهای HTML در جاوا را بدون نیاز به پردازش دستی رشتهها ساده میسازد. در این راهنما خواهید آموخت که چگونه فایلهای HTML را در جاوا ایجاد کنید، کتابخانه را تنظیم کنید، گزینههای تبدیل را پیکربندی کنید و یک مثال کامل را اجرا کنید که یک فایل HTML تک با منابع خارجی تولید میکند. در پایان، آماده خواهید شد تا فایلهای HTML را در جاوا برای هر سند منبع پشتیبانیشده تولید کنید.
مثال کامل کارآمد برای تولید فایلهای HTML در جاوا
این مثال نشان میدهد که چگونه یک DOCX، PDF، PPTX، یا هر سند پشتیبانیشدهای را به یک فایل HTML تک با منابع خارجی تبدیل کنید.
import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.HtmlConvertOptions;
import java.io.File;
public class HtmlConversionDemo {
public static void main(String[] args) {
// Input document (any supported format: .docx, .pdf, .pptx, etc.)
String inputPath = "input.docx";
// Output HTML file
String outputPath = "output.html";
// Folder where images and other resources will be stored
String resourcesFolder = "output_resources";
// Ensure the resources folder exists
File resFolder = new File(resourcesFolder);
if (!resFolder.exists()) {
resFolder.mkdirs();
}
Converter converter = null;
try {
// Initialize the converter with the source document
converter = new Converter(inputPath);
// Configure HTML conversion options
HtmlConvertOptions htmlOptions = new HtmlConvertOptions();
// Store images and CSS in a separate folder
htmlOptions.setResourcesFolder(resourcesFolder);
htmlOptions.setResourcesFolderName("resources");
// Do not embed images directly into HTML (keeps file size lower)
htmlOptions.setEmbedImages(false);
// Convert the whole document (0 means all pages)
htmlOptions.setPageNumber(0);
// Produce a single HTML file (all pages merged)
htmlOptions.setRenderToSinglePage(true);
// Image quality for extracted pictures (0‑100)
htmlOptions.setQuality(90);
// Performance tweaks for large documents
htmlOptions.setMaxPages(0); // 0 = no limit
htmlOptions.setUsePdfRender(true); // use PDF renderer when possible
// Perform the conversion
converter.convert(outputPath, htmlOptions);
System.out.println("HTML file created successfully at: " + outputPath);
} catch (Exception ex) {
System.err.println("Conversion failed: " + ex.getMessage());
ex.printStackTrace();
} finally {
// Release native resources
if (converter != null) {
try {
converter.close();
} catch (Exception ignored) {
}
}
}
}
}
توجه: این مثال کد عملکرد اصلی را نشان میدهد. قبل از استفاده از آن در پروژه خود، اطمینان حاصل کنید که مسیرهای فایل و مقادیر پیکربندی را بهگونهای بهروزرسانی کنید که با محیط واقعی شما مطابقت داشته باشد، بررسی کنید که تمام وابستگیهای مورد نیاز بهدرستی نصب شدهاند و بهطور کامل در محیط توسعه خود تست کنید. اگر با مشکلی مواجه شدید، لطفاً به مستندات رسمی مراجعه کنید یا برای دریافت کمک به تیم پشتیبانی مراجعه نمایید.
نحوه ایجاد فایلهای HTML در جاوا
فرآیند تبدیل توسط سه مؤلفه اصلی هدایت میشود: Converter، HtmlConvertOptions و منطق مدیریت منابع. در ادامه تجزیه و تحلیل گام‑به‑گام کد نشان دادهشده در بالا آورده شده است.
- Initialize the Converter - کلاس
Converterسند منبع را بارگذاری میکند.
converter = new Converter(inputPath);
این کلاس در مرجع API مستند شده است.
- پیکربندی گزینههای HTML -
HtmlConvertOptionsبه شما امکان میدهد که کنترل کنید تصاویر و CSS در کجا ذخیره شوند، آیا تصاویر جاسازی شوند یا نه، و آیا خروجی باید یک صفحه واحد باشد.
HtmlConvertOptions htmlOptions = new HtmlConvertOptions();
htmlOptions.setResourcesFolder(resourcesFolder);
htmlOptions.setResourcesFolderName("resources");
htmlOptions.setEmbedImages(false);
htmlOptions.setRenderToSinglePage(true);
- تنظیم بهینهسازیهای عملکرد - برای اسناد بزرگ میتوانید محدودیتهای صفحه را تنظیم کنید و رندرکننده PDF را برای سرعت بهتر انتخاب کنید.
htmlOptions.setMaxPages(0);
htmlOptions.setUsePdfRender(true);
- اجرای تبدیل - متد
convertفایل HTML را مینویسد و پوشه منابع را ایجاد میکند.
converter.convert(outputPath, htmlOptions);
- پاکسازی - همیشه
Converterرا برای آزاد کردن منابع بومی ببندید.
if (converter != null) {
converter.close();
}
ادغام فایلهای HTML در جاوا
تنظیم htmlOptions.setRenderToSinglePage(true) تمام صفحات سند منبع را در یک فایل HTML واحد ادغام میکند، که وقتی نیاز دارید چندین بخش را در یک خروجی منسجم ترکیب کنید، مفید است.
تولید فایلهای HTML در جاوا
اگر صفحات جداگانه را ترجیح میدهید، htmlOptions.setRenderToSinglePage(false) را تنظیم کنید. سپس SDK یک فایل HTML برای هر صفحه منبع تولید میکند و همچنان تصاویر و CSS را در پوشه منابع تعیینشده مدیریت میکند.
آمادهسازی محیط
قبل از اینکه بتوانید کد را اجرا کنید، مخزن Maven و وابستگی Conholdate.Total را به فایل pom.xml پروژه خود اضافه کنید.
<repositories>
<repository>
<id>conholdate-repo</id>
<name>Conholdate Maven Repository</name>
<url>https://repository.conholdate.com/repo/</url>
</repository>
</repositories>
<dependency>
<groupId>com.conholdate</groupId>
<artifactId>conholdate-total</artifactId>
<version>24.9</version>
<type>pom</type>
</dependency>
شما همچنین میتوانید آخرین فایلهای JAR را مستقیماً از صفحه دانلود دریافت کنید. SDK به Java 8 یا بالاتر نیاز دارد و بر روی هر JVM استانداردی اجرا میشود.
نتیجهگیری
ایجاد فایلهای HTML در جاوا بهسادگی با Conholdate.Total for Java میشود. این کتابخانه تشخیص قالب، استخراج منابع و ترکیب صفحات را مدیریت میکند، بنابراین میتوانید بهجای دستکاری سطح پایین رشتهها، بر منطق کسبوکار تمرکز کنید. بهخاطر داشته باشید که برای استفاده در محیط تولید، باید یک لایسنس معتبر دریافت کنید؛ یک صفحه لایسنس موقت برای ارزیابی در دسترس است و اطلاعات دقیق قیمتگذاری را میتوانید در صفحه قیمتگذاری پیدا کنید. با گامهای بیانشده در بالا، آمادهاید تا گزارشهای HTML، ایمیلها یا هر محتوای وب دیگری را مستقیماً از برنامههای جاوا خود تولید کنید.
سوالات متداول
چگونه میتوانم فایلهای HTML را در جاوا با استفاده از Conholdate.Total ایجاد کنم؟
از کلاسConverterهمراه باHtmlConvertOptionsهمانطور که در مثال کامل کد نشان داده شده است استفاده کنید. SDK استخراج تصاویر، CSS و ادغام صفحات را بر عهده میگیرد.آیا میتوانم فایلهای HTML را در جاوا با این SDK ترکیب کنم؟
بله. با فعالسازیhtmlOptions.setRenderToSinglePage(true)میتوانید تمام صفحات را در یک خروجی HTML واحد ترکیب کنید.کدام فرمتهای منبع برای تبدیل به HTML پشتیبانی میشوند؟
SDK از فرمتهای DOCX، PDF، PPTX، XLSX، و بسیاری فرمتهای دیگر پشتیبانی میکند. برای فهرست کامل، به مستندات رسمی مراجعه کنید.از کجا میتوانم جزئیات مجوز و قیمتگذاری را دریافت کنم؟
برای دریافت مجوز آزمایشی به صفحه صفحه مجوز موقت مراجعه کنید و برای گزینههای تجاری به صفحه صفحه قیمتگذاری سر بزنید.