مثال کامل کارآمد برای تولید فایل‌های 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 و منطق مدیریت منابع. در ادامه تجزیه و تحلیل گام‑به‑گام کد نشان داده‌شده در بالا آورده شده است.

1. Initialize the Converter - کلاس Converter سند منبع را بارگذاری می‌کند.

converter = new Converter(inputPath);

این کلاس در مرجع API مستند شده است.

2. پیکربندی گزینه‌های HTML - HtmlConvertOptions به شما امکان می‌دهد که کنترل کنید تصاویر و CSS در کجا ذخیره شوند، آیا تصاویر جاسازی شوند یا نه، و آیا خروجی باید یک صفحه واحد باشد.

HtmlConvertOptions htmlOptions = new HtmlConvertOptions();
htmlOptions.setResourcesFolder(resourcesFolder);
htmlOptions.setResourcesFolderName("resources");
htmlOptions.setEmbedImages(false);
htmlOptions.setRenderToSinglePage(true);

3. تنظیم بهینه‌سازی‌های عملکرد - برای اسناد بزرگ می‌توانید محدودیت‌های صفحه را تنظیم کنید و رندرکننده PDF را برای سرعت بهتر انتخاب کنید.

htmlOptions.setMaxPages(0);
htmlOptions.setUsePdfRender(true);

4. اجرای تبدیل - متد convert فایل HTML را می‌نویسد و پوشه منابع را ایجاد می‌کند.

converter.convert(outputPath, htmlOptions);

5. پاک‌سازی - همیشه 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، و بسیاری فرمت‌های دیگر پشتیبانی می‌کند. برای فهرست کامل، به مستندات رسمی مراجعه کنید.

• از کجا می‌توانم جزئیات مجوز و قیمت‌گذاری را دریافت کنم؟
  برای دریافت مجوز آزمایشی به صفحه صفحه مجوز موقت مراجعه کنید و برای گزینه‌های تجاری به صفحه صفحه قیمت‌گذاری سر بزنید.

بیشتر بخوانید

• ایجاد نمودارها در اسناد Word با استفاده از Java
• تبدیل HTML به XPS با Java
• تبدیل HTML به BMP با Java