Pełny działający przykład konwersji PDF do PNG w Javie przy użyciu Conholdate.Total

Ten przykład demonstruje, jak przekonwertować PDF na PNG w języku Java przy użyciu API konwersji Conholdate.Total.

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.PngConvertOptions;

import java.io.FileInputStream;
import java.io.InputStream;
import java.util.ArrayList;
import java.util.List;
import java.util.concurrent.*;

public class PdfToPngDemo {
    private static final String INPUT_PDF = "input.pdf";
    private static final String OUTPUT_PATTERN = "output_page_%d.png";

public static void main(String[] args) throws Exception {
        long start = System.nanoTime();

// Determine page count without loading whole document into memory
        int totalPages;
        try (InputStream is = new FileInputStream(INPUT_PDF)) {
            Converter tempConverter = new Converter(is);
            totalPages = tempConverter.getPageCount();
        }

// Thread pool sized to available processors
        ExecutorService executor = Executors.newFixedThreadPool(Runtime.getRuntime().availableProcessors());
        List<Future<?>> tasks = new ArrayList<>();

for (int page = 1; page <= totalPages; page++) {
            final int pageNumber = page;
            tasks.add(executor.submit(() -> {
                // Each thread creates its own Converter instance – ensures thread safety
                try (InputStream pdfStream = new FileInputStream(INPUT_PDF)) {
                    Converter converter = new Converter(pdfStream);

PngConvertOptions options = new PngConvertOptions();
                    options.setPageNumber(pageNumber);          // convert single page
                    options.setResolution(150);                 // memory‑friendly DPI
                    options.setQuality(90);                     // PNG compression quality (0‑100)

String outputPath = String.format(OUTPUT_PATTERN, pageNumber);
                    converter.convert(outputPath, options);
                } catch (Exception e) {
                    throw new RuntimeException("Failed to convert page " + pageNumber, e);
                }
            }));
        }

// Wait for all conversions to finish
        for (Future<?> f : tasks) {
            f.get(); // re‑throws any exception from the task
        }

executor.shutdown();

long end = System.nanoTime();
        System.out.printf("PDF to PNG conversion completed in %.2f seconds.%n",
                (end - start) / 1_000_000_000.0);
    }
}

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 odpowiadały rzeczywistemu środowisku, sprawdź, czy wszystkie wymagane zależności są poprawnie zainstalowane, oraz dokładnie przetestuj w swoim środowisku deweloperskim. Jeśli napotkasz jakiekolwiek problemy, odwołaj się do oficjalnej dokumentacji lub skontaktuj się z zespołem wsparcia w celu uzyskania pomocy.

Zrozumienie konwersji PDF do PNG w kodzie Java

Poniższe punkty opisują przebieg działania przykładowego programu:

1. Załaduj PDF i określ liczbę stron - Klasa Converter jest tworzona z InputStream wskazującym na źródłowy PDF. Wywołanie getPageCount() zwraca całkowitą liczbę stron bez ładowania całego dokumentu do pamięci.

try (InputStream is = new FileInputStream(INPUT_PDF)) {
    Converter tempConverter = new Converter(is);
    totalPages = tempConverter.getPageCount();
}

2. Utwórz pulę wątków do przetwarzania równoległego – ExecutorService o rozmiarze równym liczbie dostępnych procesorów uruchamia zadania konwersji jednocześnie, poprawiając ogólną przepustowość.

ExecutorService executor = Executors.newFixedThreadPool(Runtime.getRuntime().availableProcessors());

3. Konfiguruj opcje konwersji specyficzne dla strony - W ramach każdego zadania tworzona jest nowa instancja Converter (zapewniając bezpieczeństwo wątków). PngConvertOptions umożliwia ustawienie docelowej strony, rozdzielczości i jakości PNG.

   PngConvertOptions options = new PngConvertOptions();
   options.setPageNumber(pageNumber);
   options.setResolution(150);
   options.setQuality(90);
   

4. Wykonaj konwersję i zapisz plik PNG - Metoda convert zapisuje wyjściowy plik PNG, używając sformatowanej nazwy pliku, która zawiera numer strony.

   String outputPath = String.format(OUTPUT_PATTERN, pageNumber);
   converter.convert(outputPath, options);
   

5. Synchronizacja zakończenia i sprzątanie - Główny wątek czeka, aż wszystkie future zakończą się, następnie zamyka executor i wypisuje upłynięty czas. Ten wzorzec zapewnia, że każda strona zostanie przetworzona przed zakończeniem programu.

Aby uzyskać bardziej szczegółowe informacje o API, zapoznaj się z Conholdate.Total Java API Reference.

Przygotowanie środowiska

Dodaj repozytorium Maven Conholdate.Total i zależność do swojego 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>

Pobierz najnowszy pakiet SDK ze strony oficjalnego pobierania. Biblioteka wymaga Java 8 lub nowszej i działa na dowolnej standardowej maszynie JVM.

Konfigurowanie ustawień konwersji

Przykładowy kod demonstruje trzy kluczowe opcje, które możesz dostosować:

• Numer strony - options.setPageNumber(pageNumber); wybiera konkretną stronę do renderowania.
• Rozdzielczość - options.setResolution(150); kontroluje DPI. Wyższe wartości poprawiają szczegóły, ale zwiększają zużycie pamięci.
• Jakość - options.setQuality(90); ustawia kompresję PNG (0‑100). Dostosuj tę wartość, aby zrównoważyć rozmiar pliku i jakość wizualną.

Jeśli potrzebujesz dodatkowej kontroli, w dokumentacji API wymienione są inne właściwości, takie jak setColorMode i setBackgroundColor.

Najlepsze praktyki efektywnej konwersji PDF do PNG

• Strumieniowanie stron indywidualnie - Przetwarzaj każdą stronę z InputStream, aby uniknąć wczytywania całego pliku PDF do pamięci.
• Użyj puli wątków o stałym rozmiarze - Dopasowanie rozmiaru puli do Runtime.getRuntime().availableProcessors() zapobiega nadmiernemu przełączaniu wątków, jednocześnie maksymalizując wykorzystanie CPU.
• Ustaw umiarkowaną rozdzielczość DPI - W większości scenariuszy podglądu 150 DPI zapewnia dobry kompromis między jakością a wydajnością.
• Oszczędnie ponownie używaj instancji konwertera - Tworzenie nowego Converter dla każdego wątku zapewnia bezpieczeństwo wątkowe; udostępnianie jednej instancji może powodować warunki wyścigu.
• Mierz czas wykonania - Przykład wypisuje upłynięte sekundy; użyj tych danych, aby precyzyjnie dostroić rozdzielczość lub liczbę wątków do konkretnego obciążenia.

Wnioski

Konwertowanie PDF do PNG w Javie to rutynowa, ale wrażliwa na wydajność operacja. Z Conholdate.Total for Java otrzymujesz w pełni funkcjonalny SDK, który obsługuje strumieniowanie strona po stronie, wielowątkowe wykonywanie oraz szczegółowe opcje obrazu. Powyższy przykład pokazuje, jak zbudować skalowalne narzędzie do konwersji PDF na PNG, skonfigurować rozdzielczość i jakość oraz utrzymać niskie zużycie pamięci. Pamiętaj, aby uzyskać ważną licencję do użytku produkcyjnego; możesz zamówić tymczasową licencję pod adresem https://purchase.conholdate.com/temporary-license/ i zapoznać się z opcjami cenowymi pod adresem https://purchase.conholdate.com/pricing/total/family/. Zintegruj kod, dostosuj ustawienia do swoich potrzeb i dostarczaj szybkie, niezawodne podglądy obrazów z dowolnego dokumentu PDF.

Częste pytania

• Jak przekonwertować PDF na PNG w Javie bez użycia zewnętrznych narzędzi?
  SDK wykonuje konwersję w całości w kodzie, więc nie potrzebujesz żadnych zewnętrznych narzędzi wiersza poleceń. Po prostu dodaj zależność Maven i użyj klasy Converter jak pokazano.

• Jaką wydajność mogę oczekiwać od narzędzia konwersji PDF do PNG w Javie?
  Przetwarzając strony równolegle i używając umiarkowanej rozdzielczości DPI (np. 150), przykładowy kod zazwyczaj konwertuje 50‑stronicowy PDF w mniej niż kilka sekund na nowoczesnym procesorze. Możesz zmierzyć wydajność własnych plików, mierząc czas wykonania wyświetlany przez program.

• Czy mogę konwertować pliki PDF zawierające wiele obrazów wysokiej rozdzielczości bez wyczerpania pamięci?
  Tak. Kod strumieniuje każdą stronę osobno i zwalnia InputStream po konwersji, co utrzymuje mały rozmiar sterty. Dostosuj rozdzielczość lub uruchom mniej wątków, jeśli napotkasz presję pamięciową.

• Czy można dalej dostosować wyjście PNG, na przykład zmieniając kolor tła?
  Dodatkowe opcje są dostępne w PngConvertOptions. Odwołaj się do referencji API w celu uzyskania informacji o właściwościach takich jak setBackgroundColor i setColorMode.

Powiązane artykuły

• Konwertuj JPG na PNG w Javie
• Konwertuj CDR na PNG w Javie
• Konwertuj PDF na odcienie szarości w Javie