Java’da HTML Dosyaları Oluşturmak için Tam Çalışan Örnek

Bu örnek, bir DOCX, PDF, PPTX veya desteklenen herhangi bir belgeyi harici kaynaklarla tek bir HTML dosyasına dönüştürmeyi gösterir.

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) {
                }
            }
        }
    }
}

Not: Bu kod örneği temel işlevselliği gösterir. Projenizde kullanmadan önce, dosya yollarını ve yapılandırma değerlerini gerçek ortamınıza uygun şekilde güncellediğinizden, tüm gerekli bağımlılıkların doğru şekilde yüklendiğinden emin olun ve geliştirme ortamınızda kapsamlı bir şekilde test edin. Herhangi bir sorunla karşılaşırsanız, lütfen resmi belgeler adresine bakın veya destek ekibi ile iletişime geçin.

Java’da HTML Dosyaları Oluşturma Nasıl Çalışır

Dönüştürme süreci üç ana bileşen tarafından yönlendirilir: Converter, HtmlConvertOptions ve kaynak işleme mantığı. Aşağıda yukarıda gösterilen kodun adım adım bir açıklaması bulunmaktadır.

1. Dönüştürücüyü Başlat - Converter sınıfı kaynak belgeyi yükler.

converter = new Converter(inputPath);

Bu sınıf, API referansı içinde belgelenmiştir.

2. HTML Seçeneklerini Yapılandırın - HtmlConvertOptions, görüntülerin ve CSS’in nerede saklanacağını, görüntülerin gömülü olup olmayacağını ve çıktının tek bir sayfa olup olmayacağını kontrol etmenizi sağlar.

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

3. Performans Ayarlarını Belirle - Büyük belgeler için sayfa limitlerini ayarlayabilir ve daha iyi hız için PDF renderlayıcısını seçebilirsiniz.

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

4. Dönüştürmeyi Gerçekleştir - convert yöntemi HTML dosyasını yazar ve kaynaklar klasörünü oluşturur.

converter.convert(outputPath, htmlOptions);

5. Temizleme - Yerel kaynakları serbest bırakmak için her zaman Converter‘ı kapatın.

if (converter != null) {
    converter.close();
}

Java’da HTML Dosyalarını Birleştirme

Setting htmlOptions.setRenderToSinglePage(true) kaynağın tüm sayfalarını tek bir HTML dosyasına birleştirir; bu, birden fazla bölümü tek tutarlı bir çıktıda birleştirmeniz gerektiğinde faydalıdır.

Java’da HTML Dosyaları Oluşturma

Ayrı sayfaları tercih ediyorsanız, htmlOptions.setRenderToSinglePage(false) ayarlayın. SDK daha sonra her kaynak sayfa için bir HTML dosyası oluşturacak ve yine belirlenen kaynaklar klasöründe görüntüleri ve CSS’i işleyecektir.

Ortamı Hazırlama

Kodu çalıştırmadan önce, Conholdate.Total Maven deposunu ve bağımlılığını projenizin pom.xml dosyasına ekleyin.

<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>

En son JAR dosyalarını doğrudan indirme sayfasından da indirebilirsiniz. SDK, Java 8 veya daha yenisini gerektirir ve herhangi bir standart JVM’de çalışır.

Sonuç

Java’da HTML dosyaları oluşturmak, Conholdate.Total for Java ile oldukça basit hale gelir. Kütüphane, format algılamayı, kaynak çıkarımını ve sayfa birleştirmeyi yönetir, böylece düşük seviyeli dize manipülasyonlarıyla uğraşmak yerine iş mantığına odaklanabilirsiniz. Üretim kullanımı için geçerli bir lisans almayı unutmayın; değerlendirme için bir geçici lisans sayfası mevcuttur ve ayrıntılı fiyatlandırma bilgileri fiyatlandırma sayfasında bulunabilir. Yukarıda belirtilen adımlarla, Java uygulamalarınızdan doğrudan HTML raporları, e‑postalar veya herhangi bir web içeriği oluşturabilirsiniz.

SSS

• Java kullanarak Conholdate.Total ile HTML dosyaları nasıl oluşturulur?
  Tam kod örneğinde gösterildiği gibi Converter sınıfını HtmlConvertOptions ile birlikte kullanın. SDK, görüntüleri, CSS’i ve sayfaları birleştirmeyi otomatik olarak halleder.

• Bu SDK ile Java’da HTML dosyalarını birleştirebilir miyim?
  Evet. Tüm sayfaları tek bir HTML çıktısına birleştirmek için htmlOptions.setRenderToSinglePage(true)‘ı etkinleştirin.

• HTML dönüşümü için hangi kaynak formatları destekleniyor?
  SDK, DOCX, PDF, PPTX, XLSX ve birçok diğer formatı destekler. Tam liste için resmi belgeler adresine bakın.

• Lisanslama ve fiyatlandırma detaylarını nereden alabilirim?
  Deneme lisansı için geçici lisans sayfasını ve ticari seçenekler için fiyatlandırma sayfasını ziyaret edin.

Read More

• Java kullanarak Word belgelerinde grafik oluşturma
• Java’da HTML’yi XPS’ye dönüştürme
• Java’da HTML’yi BMP’ye dönüştürme