Generowanie wizualnych podglądów danych arkuszy kalkulacyjnych jest częstym wymogiem przy tworzeniu pulpitów raportowych lub podsumowań e‑mailowych. Conholdate.Total for Java zapewnia solidny SDK, który upraszcza proces konwertowania Excela na obraz w aplikacjach Java. W tym przewodniku zobaczysz, jak załadować skoroszyt XLSX, skonfigurować wyjście JPEG oraz renderować strony arkusza do plików obrazu. Po zakończeniu będziesz mieć gotowy do uruchomienia przykład kodu, który możesz dostosować do własnych projektów.

Czego wymaga konwersja plików Excel do obrazu w Twojej aplikacji

Programiści często muszą zamienić zawartość arkusza kalkulacyjnego na statyczne obrazy do podglądów w sieci, raportów w formacie PDF lub miniatur mobilnych. Wymaganie zazwyczaj obejmuje zachowanie formatowania komórek, dokładne renderowanie zawartości arkusza oraz kontrolę rozdzielczości obrazu. Ręczne wykonywanie tych zadań poprzez otwieranie Excela, robienie zrzutów ekranu i ich zapisywanie nie skaluje się i może prowadzić do niejednolitych wyników.

Techniczne ograniczenia dla niezawodnego rozwiązania to: obsługa plików XLSX, dokładne renderowanie układu arkusza, konfigurowalna rozdzielczość obrazu oraz możliwość obsługi arkuszy, które rozciągają się na wiele wydrukowanych stron. Konwersja musi działać na serwerze lub w środowisku desktopowym bez wymogu posiadania Microsoft Office.

Wybór Conholdate.Total for Java do zadania

Conholdate.Total for Java oferuje prosty interfejs API, który obejmuje wszystkie niezbędne funkcje. Klasy Workbook i Worksheet zapewniają bezpośredni dostęp do zawartości arkusza kalkulacyjnego, natomiast ImageOrPrintOptions umożliwiają precyzyjną kontrolę rozdzielczości i formatu obrazu, a SheetRender obsługuje rzeczywiste renderowanie strona po stronie. SDK działa na dowolnym środowisku Java, wymaga jedynie zależności Maven i efektywnie obsługuje duże skoroszyty.

Aby uzyskać szczegółowe informacje o użyciu API, zobacz oficjalną dokumentację. Pełna referencja klas, takich jak Workbook, Worksheet, ImageOrPrintOptions i SheetRender, jest dostępna w referencji API. Najnowszą bibliotekę możesz pobrać ze strony wydania.

Implementacja konwersji Excel na obraz w Javie

Proces konwersji można podzielić na kilka jasnych kroków. Poniższe sekcje przeprowadzą Cię przez każdy element, z krótkimi fragmentami kodu pobranymi bezpośrednio z pełnego przykładu.

Zainstaluj Conholdate.Total for Java via Maven

Dodaj repozytorium Maven Conholdate oraz zależność SDK 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>

Załaduj plik Excel i uzyskaj dostęp do arkusza

Załaduj skoroszyt przy użyciu klasy Workbook, a następnie uzyskaj odwołanie do arkusza, który chcesz przekonwertować:

// Load Excel file
com.aspose.cells.Workbook book = new com.aspose.cells.Workbook("input.xlsx");

// Get the reference of the desired worksheet
com.aspose.cells.Worksheet sheet = book.getWorksheets().get(0);

Skonfiguruj opcje wyjścia obrazu dla JPEG

Ustaw żądaną rozdzielczość obrazu i format przy użyciu ImageOrPrintOptions:

// Set image options
com.aspose.cells.ImageOrPrintOptions options = new com.aspose.cells.ImageOrPrintOptions();
options.setHorizontalResolution(200);
options.setVerticalResolution(200);
options.setImageType(com.aspose.cells.ImageType.JPEG);

Renderowanie arkusza kalkulacyjnego do obrazów JPEG

Utwórz SheetRender dla arkusza i przeiteruj jego strony, zapisując każdą z nich jako osobny plik JPEG. Arkusz może rozciągać się na więcej niż jedną wydrukowaną stronę, więc getPageCount() informuje, ile obrazów należy się spodziewać:

// Convert sheet to JPG image
com.aspose.cells.SheetRender sr = new com.aspose.cells.SheetRender(sheet, options);
for (int j = 0; j < sr.getPageCount(); j++)
{
    sr.toImage(j, "excel-to-jpg" + (j + 1) + ".jpg");
}

Kroki powyżej pokazują, jak konwertować Excel na obraz przy użyciu Conholdate.Total for Java SDK, dając jednocześnie kontrolę nad rozdzielczością, formatem i arkuszami wielostronicowymi.

Pełny przykład kodu: konwersja Excela na obraz z obsługą całego arkusza

Poniższy kod przedstawia kompletną, gotową do uruchomienia implementację opisaną w powyższych krokach.

public class ExcelToImageConverter {
    public static void main(String[] args) throws Exception {
        // Load Excel file
        com.aspose.cells.Workbook book = new com.aspose.cells.Workbook("input.xlsx");

// Get the reference of the desired worksheet
        com.aspose.cells.Worksheet sheet = book.getWorksheets().get(0);

// Set image options
        com.aspose.cells.ImageOrPrintOptions options = new com.aspose.cells.ImageOrPrintOptions();
        options.setHorizontalResolution(200);
        options.setVerticalResolution(200);
        options.setImageType(com.aspose.cells.ImageType.JPEG);

// Convert sheet to JPG image
        com.aspose.cells.SheetRender sr = new com.aspose.cells.SheetRender(sheet, options);
        for (int j = 0; j < sr.getPageCount(); j++)
        {
            sr.toImage(j, "excel-to-jpg" + (j + 1) + ".jpg");
        }

System.out.println("Excel to image conversion completed successfully.");
    }
}

Uwaga: Ten przykład kodu demonstruje podstawową funkcjonalność. Przed użyciem go w swoim projekcie upewnij się, że zaktualizowałeś ścieżkę do pliku (input.xlsx), aby odpowiadała rzeczywistej lokalizacji pliku, sprawdź, czy wszystkie wymagane zależności są poprawnie 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.

Podsumowanie

Konwertowanie Excela na obraz w Javie staje się proste, gdy wykorzystujesz Conholdate.Total for Java. SDK obsługuje renderowanie arkuszy i wysokiej jakości wyjście JPEG przy minimalnym kodzie. Postępując zgodnie z przewodnikiem krok po kroku, możesz zintegrować tę funkcję z narzędziami raportowania, generatorami e‑maili lub dowolną aplikacją, która potrzebuje wizualnych reprezentacji arkuszy kalkulacyjnych. Pamiętaj, że wdrożenia produkcyjne wymagają licencji komercyjnej; możesz zapoznać się z opcjami cenowymi na stronie Conholdate.Total pricing oraz uzyskać tymczasową licencję z temporary license page podczas oceny.

FAQs

  • Jak mogę przekonwertować Excel na obraz w Javie?
    Załaduj plik przy użyciu Workbook, pobierz potrzebny arkusz z book.getWorksheets(), skonfiguruj ImageOrPrintOptions i wyrenderuj go przy pomocy SheetRender.

  • Czy mogę przekonwertować konkretny arkusz Excela na obraz?
    Tak. Użyj book.getWorksheets().get(index), aby wybrać arkusz, a następnie przekaż go do SheetRender w celu konwersji.

  • Dlaczego otrzymuję więcej niż jeden plik obrazu z jednego arkusza?
    Arkusz może rozciągać się na wiele wydrukowanych stron. SheetRender.getPageCount() zwraca liczbę stron, a pętla zapisuje jeden obraz na stronę.

  • Jakie licencjonowanie jest wymagane do użytku produkcyjnego?
    Wymagana jest licencja komercyjna. Przejrzyj koszty na stronie Cennik Conholdate.Total i uzyskaj tymczasową licencję ze strony tymczasowej licencji.

Czytaj więcej