Pełny działający przykład generowania plików HTML w Javie

Ten przykład demonstruje, jak przekonwertować DOCX, PDF, PPTX, lub dowolny obsługiwany dokument do jednego pliku HTML z zasobami zewnętrznymi.

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

Uwaga: Ten przykład kodu demonstruje podstawową funkcjonalność. Przed użyciem go w swoim projekcie upewnij się, że zaktualizowałeś wszystkie ścieżki plików i wartości konfiguracyjne, aby pasowały do rzeczywistego środowiska, sprawdź, czy wszystkie wymagane zależności są prawidłowo zainstalowane, oraz dokładnie przetestuj w środowisku deweloperskim. Jeśli napotkasz jakiekolwiek problemy, odwołaj się do oficjalnej dokumentacji lub skontaktuj się z zespołem wsparcia w celu uzyskania pomocy.

Jak działa tworzenie plików HTML w Javie

Proces konwersji jest napędzany przez trzy główne komponenty: Converter, HtmlConvertOptions oraz logikę obsługi zasobów. Poniżej znajduje się szczegółowy opis krok po kroku kodu przedstawionego powyżej.

1. Zainicjalizuj konwerter - Klasa Converter ładuje dokument źródłowy.

converter = new Converter(inputPath);

Ta klasa jest udokumentowana w referencji API.

2. Skonfiguruj opcje HTML - HtmlConvertOptions pozwala kontrolować, gdzie przechowywane są obrazy i CSS, czy obrazy są osadzone oraz czy wynik ma być jedną stroną.

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

3. Ustaw poprawki wydajności - Dla dużych dokumentów możesz dostosować limity stron i wybrać renderer PDF, aby uzyskać lepszą prędkość.

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

4. Wykonaj konwersję - Metoda convert zapisuje plik HTML i tworzy folder zasobów.

converter.convert(outputPath, htmlOptions);

5. Czyszczenie - Zawsze zamykaj Converter, aby zwolnić zasoby natywne.

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

Scalanie plików HTML w Javie

Ustawienie htmlOptions.setRenderToSinglePage(true) scala wszystkie strony dokumentu źródłowego w jeden plik HTML, co jest przydatne, gdy trzeba połączyć wiele sekcji w spójny wynik.

Generowanie plików HTML w Javie

Jeśli wolisz osobne strony, ustaw htmlOptions.setRenderToSinglePage(false). SDK wtedy wygeneruje jeden plik HTML na każdą stronę źródłową, nadal obsługując obrazy i CSS w wyznaczonym folderze zasobów.

Przygotowanie środowiska

Zanim będziesz mógł uruchomić kod, dodaj repozytorium Maven Conholdate.Total oraz zależność do pliku pom.xml swojego projektu.

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

Możesz również pobrać najnowsze pliki JAR bezpośrednio ze strony pobierania. SDK wymaga Java 8 lub nowszej i działa na dowolnej standardowej maszynie JVM.

Podsumowanie

Tworzenie plików HTML w Javie staje się proste dzięki Conholdate.Total for Java. Biblioteka obsługuje wykrywanie formatu, wyodrębnianie zasobów i łączenie stron, dzięki czemu możesz skupić się na logice biznesowej zamiast na niskopoziomowej manipulacji ciągami znaków. Pamiętaj, aby uzyskać ważną licencję do użytku produkcyjnego; strona tymczasowej licencji jest dostępna do oceny, a szczegółowe informacje o cenach można znaleźć na stronie cenowej. Dzięki opisanym powyżej krokom jesteś gotowy generować raporty HTML, e‑maile lub dowolną treść internetową bezpośrednio z aplikacji Java.

FAQs

• Jak utworzyć pliki HTML w Javie przy użyciu Conholdate.Total?
  Użyj klasy Converter wraz z HtmlConvertOptions, jak pokazano w pełnym przykładzie kodu. SDK zajmuje się wyodrębnianiem obrazów, CSS i łączeniem stron.

• Czy mogę scalać pliki HTML w Javie przy użyciu tego SDK?
  Tak. Włącz htmlOptions.setRenderToSinglePage(true), aby scalić wszystkie strony w jeden plik HTML.

• Jakie formaty źródłowe są obsługiwane przy konwersji do HTML?
  SDK obsługuje DOCX, PDF, PPTX, XLSX, oraz wiele innych formatów. Zobacz oficjalną dokumentację po pełną listę.

• Gdzie mogę uzyskać informacje o licencjonowaniu i cenach?
  Odwiedź stronę tymczasowej licencji aby uzyskać licencję próbną oraz stronę cenową dla opcji komercyjnych.

Read More

• Tworzenie wykresów w dokumentach Word przy użyciu Javy
• Konwertowanie HTML do XPS w Javie
• Konwertowanie HTML do BMP w Javie