Konwertuj OneNote na obraz w Javie

Thu, 03 Sep 2026 19:34:37 +0000

Programowe przekształcanie stron OneNote w pliki graficzne jest powszechną potrzebą przy tworzeniu generatorów podglądu lub aplikacji mobilnych. SDK Conholdate.Total for Java ułatwia konwersję Onenote na obraz w Javie bez konieczności instalowania Microsoft Office na serwerze. W tym przewodniku zobaczysz kompletną, thread‑safe implementację, opcje wyjścia w formacie PNG i JPEG, oraz wskazówki dotyczące przetwarzania w pamięci.

Konwertowanie OneNote na obraz w Javie – przewodnik krok po kroku

Zainicjuj przepływ konwersji: Załaduj plik OneNote do InputStream i utwórz instancję Converter — rdzeń konwersji OneNote do obrazu w Javie.

InputStream fileStream = new BufferedInputStream(new FileInputStream("sample.one"));
Converter converter = new Converter(fileStream);

Określ, ile stron wymaga konwersji: Pobierz całkowitą liczbę stron z Converter.

int pageCount = converter.getPageCount();

Skonfiguruj opcje obrazu dla każdej strony: Ustaw format wyjściowy, jakość oraz indeks strony zaczynający się od zera, używając ImageConvertOptions.

ImageConvertOptions options = new ImageConvertOptions();
options.setFormat(ImageSaveOptions.ImageFormat.PNG);
options.setQuality(90);
options.setPageNumber(pageIndex);

Konwertuj strony równolegle: Użyj ExecutorService, aby uruchamiać konwersje równocześnie, zapisując każdą stronę do osobnego pliku PNG.

ExecutorService executor = Executors.newFixedThreadPool(
        Runtime.getRuntime().availableProcessors());
executor.submit(() -> {
    // conversion logic per page
});

Opcjonalna konwersja w pamięci: W scenariuszach, w których potrzebujesz bezpośrednio bajtów obrazu (np. wysyłając je przez sieć), przekonwertuj pierwszą stronę do ByteArrayOutputStream.

ImageConvertOptions memOptions = new ImageConvertOptions();
memOptions.setFormat(ImageSaveOptions.ImageFormat.JPEG);
memOptions.setPageNumber(0);
ByteArrayOutputStream memoryStream = new ByteArrayOutputStream();
converter.convert(memoryStream, memOptions);

Aby uzyskać więcej informacji na temat klasy Converter i jej metod, zobacz oficjalną dokumentację API.

Pełny działający przykład konwersji OneNote na obraz w Javie – równoległe przetwarzanie stron

Poniższy kod przedstawia pełną implementację konwersji OneNote na obraz w języku Java przy użyciu Conholdate.Total.

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.options.convert.ImageConvertOptions;
import com.groupdocs.conversion.options.convert.ImageSaveOptions;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.InputStream;
import java.io.OutputStream;
import java.io.ByteArrayOutputStream;
import java.io.IOException;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
import java.util.concurrent.TimeUnit;

public class ConvertOneNoteToImage {
    public static void main(String[] args) {
        String inputPath = "sample.one";
        String outputPattern = "output_page_%d.png";
        int imageQuality = 90; // 0-100

// Thread pool for parallel page conversion
        ExecutorService executor = Executors.newFixedThreadPool(Runtime.getRuntime().availableProcessors());

try (InputStream fileStream = new BufferedInputStream(new FileInputStream(inputPath));
             Converter converter = new Converter(fileStream)) {

int pageCount = converter.getPageCount();

for (int i = 0; i < pageCount; i++) {
                final int pageIndex = i;
                executor.submit(() -> {
                    ImageConvertOptions options = new ImageConvertOptions();
                    options.setFormat(ImageSaveOptions.ImageFormat.PNG);
                    options.setQuality(imageQuality);
                    options.setPageNumber(pageIndex); // zero‑based page index

String outputPath = String.format(outputPattern, pageIndex + 1);
                    try (OutputStream outStream = new BufferedOutputStream(new FileOutputStream(outputPath))) {
                        converter.convert(outStream, options);
                        System.out.println("Page " + (pageIndex + 1) + " saved to " + outputPath);
                    } catch (Exception e) {
                        System.err.println("Failed to convert page " + (pageIndex + 1) + ": " + e.getMessage());
                    }
                });
            }

// Example of in‑memory conversion for the first page
            ImageConvertOptions memOptions = new ImageConvertOptions();
            memOptions.setFormat(ImageSaveOptions.ImageFormat.JPEG);
            memOptions.setQuality(imageQuality);
            memOptions.setPageNumber(0);
            try (ByteArrayOutputStream memoryStream = new ByteArrayOutputStream()) {
                converter.convert(memoryStream, memOptions);
                byte[] imageBytes = memoryStream.toByteArray();
                System.out.println("In‑memory conversion produced " + imageBytes.length + " bytes for page 1.");
                // imageBytes can now be sent over network, stored in DB, etc.
            } catch (Exception e) {
                System.err.println("In‑memory conversion error: " + e.getMessage());
            }

} catch (IOException e) {
            System.err.println("File access error: " + e.getMessage());
        } catch (Exception e) {
            System.err.println("Conversion initialization error: " + e.getMessage());
        } finally {
            executor.shutdown();
            try {
                if (!executor.awaitTermination(60, TimeUnit.SECONDS)) {
                    executor.shutdownNow();
                }
            } catch (InterruptedException ie) {
                executor.shutdownNow();
                Thread.currentThread().interrupt();
            }
        }
    }
}

Uwaga: Ten przykład kodu demonstruje podstawową funkcjonalność. Przed użyciem go w swoim projekcie upewnij się, że zaktualizowałeś ścieżki do plików (sample.one, output_page_%d.png itp.), aby odpowiadały rzeczywistym lokalizacjom, sprawdź, czy wszystkie wymagane zależności są poprawnie zainstalowane, oraz dokładnie przetestuj w środowisku programistycznym. Jeśli napotkasz jakiekolwiek problemy, odwołaj się do oficjalnej dokumentacji lub skontaktuj się z zespołem wsparcia w celu uzyskania pomocy.

Instalowanie i konfigurowanie Conholdate.Total dla Java

Dodaj repozytorium Maven Conholdate oraz zależność SDK do swojego pom.xml:


    
        conholdate-repo
        Conholdate Maven Repository
        https://repository.conholdate.com/repo/
    



    com.conholdate
    conholdate-total
    24.9
    pom

Pobierz najnowszy pakiet binarny ze strony pobierania. SDK wymaga Java 8 lub nowszej i działa na dowolnej standardowej maszynie JVM. Do użytku produkcyjnego uzyskaj licencję ze strony cenowej i aktywuj ją przy użyciu tymczasowego klucza ze strony tymczasowej licencji.

Podsumowanie

Postępując zgodnie z tym przewodnikiem, masz teraz solidną podstawę do konwertowania OneNote na obrazy w Javie przy użyciu Conholdate.Total for Java. Przykład demonstruje wyjście PNG strona po stronie, przetwarzanie równoległe dla zwiększenia szybkości oraz opcję w pamięci dla elastycznej integracji. Pamiętaj, aby skonfigurować ImageConvertOptions tak, aby odpowiadały wymaganemu formatowi obrazu i jakości, oraz obsługiwać zasoby za pomocą bloków try‑with‑resources, jak pokazano. Dla projektów komercyjnych zapewnij odpowiednią licencję poprzez stronę cennika i przetestuj konwersję na rzeczywistych plikach OneNote, aby upewnić się, że cała zawartość jest renderowana poprawnie. Rozbudowane API i dokumentacja SDK sprawiają, że łatwo rozszerzyć to rozwiązanie o przetwarzanie wsadowe lub usługi w chmurze.

FAQs

Czy mogę konwertować Onenote na obraz w Javie bez instalowania Microsoft Office?
Tak. SDK Conholdate.Total wykonuje całe renderowanie wewnętrznie, więc instalacja Office nie jest wymagana na serwerze.
Jakie formaty obrazu obsługuje konwersja?
Możesz wyeksportować do PNG, JPEG, BMP, GIF, oraz TIFF ustawiając właściwość ImageSaveOptions.ImageFormat.
Jak mogę poprawić wydajność przy dużych notatnikach?
Użyj wbudowanej puli wątków, jak pokazano, i preferuj konwersję w pamięci, gdy potrzebujesz tylko bajtów obrazu, unikając operacji I/O na dysku.
Gdzie mogę znaleźć więcej przykładów i szczegóły API?
Oficjalna dokumentacja zapewnia obszerne przewodniki, a referencja API wymienia wszystkie klasy i metody.