Konwertuj zip do html i ustaw liczbę elementów na stronę przy użyciu GroupDocs.Viewer Java

W wielu aplikacjach internetowych trzeba wyświetlać zawartość archiwum ZIP lub RAR bezpośrednio w przeglądarce. Jak konwertować zip na HTML przy użyciu GroupDocs.Viewer dla Java jest powszechnym wymaganiem, a biblioteka umożliwia osadzanie obrazów, CSS i czcionek, dzięki czemu wynik to pojedyncza, przenośna strona. Ten samouczek przeprowadzi Cię przez wszystko — od konfiguracji Maven po renderowanie wielostronicowe — wyjaśniając, dlaczego każda opcja ma znaczenie dla wydajności i użyteczności.

Konwertuj archiwa do HTML przy użyciu GroupDocs.Viewer dla Java

Szybkie odpowiedzi

  • Co kontroluje „set items per page”? Określa, ile plików lub folderów z archiwum ma się pojawić na każdej wygenerowanej stronie HTML.
  • Czy mogę osadzić obrazy i CSS bezpośrednio w HTML? Tak – użyj opcji forEmbeddedResources, aby osadzić zasoby w HTML.
  • Czy konwersja wsadowa jest możliwa? Absolutnie; możesz iterować po kolekcji archiwów i renderować każde z tymi samymi ustawieniami.
  • Czy potrzebuję Maven, aby używać GroupDocs.Viewer? Tak, dodaj zależność groupdocs-viewer Maven, jak pokazano poniżej.
  • Jakie formaty wyjściowe są obsługiwane? Dostępne są HTML jednostronicowy i wielostronicowy, a biblioteka obsługuje ponad 50 typów archiwów wejściowych.

Co oznacza „set items per page” w GroupDocs.Viewer?

Określa, ile wpisów archiwum (plików lub folderów) powinno być wyświetlanych na każdej stronie HTML przy generowaniu dokumentu wielostronicowego. Dostosowanie tej wartości pomaga zbalansować rozmiar strony i szybkość nawigacji, szczególnie w przypadku dużych archiwów, ograniczając ilość danych ładowanych na jedną stronę i skracając czas renderowania dla użytkowników końcowych.

Dlaczego osadzać zasoby html?

Osadzanie zasobów (obrazów, CSS, czcionek) bezpośrednio w pliku HTML tworzy pojedynczy, przenośny dokument, który można otworzyć bez plików zewnętrznych. Jest to idealne rozwiązanie dla załączników e‑mail, przeglądania offline lub wstawiania wyniku do innych stron internetowych. Eliminuje także konieczność zarządzania zewnętrznymi ścieżkami zasobów.

Wymagania wstępne

  • Wymagane biblioteki: Dołącz GroupDocs.Viewer w wersji 25.2 lub nowszej.
  • Środowisko: Zainstalowany i skonfigurowany Java Development Kit (JDK).
  • Wiedza: Podstawowa znajomość Javy i zarządzania zależnościami Maven.

Konfiguracja Maven dla GroupDocs Viewer

Dodaj repozytorium GroupDocs oraz zależność viewer do swojego pom.xml:

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/viewer/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-viewer</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

Uzyskanie licencji

GroupDocs.Viewer oferuje free trial link, tymczasową licencję lub pełną opcję zakupu. Wybierz tę, która pasuje do harmonogramu Twojego projektu.

Podstawowa inicjalizacja

Klasa Viewer jest punktem wejścia do renderowania dokumentów i archiwów. Po konfiguracji Maven wprowadź viewer do swojego kodu:

import com.groupdocs.viewer.Viewer;
// Your initialization code here

Jak renderować archiwa do jednostronicowego html

Klasa HtmlViewOptions definiuje ustawienia wyjścia HTML, takie jak osadzanie zasobów. Załaduj archiwum, skonfiguruj opcje HTML, aby osadzić zasoby, i renderuj wszystko do jednej samodzielnej strony. Powoduje to utworzenie jednego pliku HTML zawierającego wszystkie pliki, obrazy, CSS i czcionki, gotowego do użycia offline lub jako załącznik e‑mail.

Direct answer: Utwórz instancję Viewer dla pliku ZIP, wywołaj HtmlViewOptions.forEmbeddedResources(), a następnie viewer.view(documentPath, options). To generuje pojedynczy plik HTML zawierający wszystkie pliki, obrazy, CSS i czcionki, gotowy do użycia offline lub jako załącznik e‑mail.

Krok 1: Zdefiniuj katalog wyjściowy

Path outputDirectory = Utils.getOutputDirectoryPath("YOUR_OUTPUT_DIRECTORY");

Krok 2: Ustaw nazwę pliku dla jednostronicowego wyjścia

Path pageFilePathFormat = outputDirectory.resolve("RAR_result.html");

Krok 3: Zainicjalizuj viewer

try (Viewer viewer = new Viewer(TestFiles.SAMPLE_RAR_WITH_FOLDERS)) {
    // Further configuration steps follow
}

Krok 4: Skonfiguruj opcje renderowania (osadzanie zasobów html)

Klasa HtmlViewOptions definiuje ustawienia wyjścia HTML, takie jak osadzanie zasobów. Użyj forEmbeddedResources(), aby spakować wszystko w jeden plik.

HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);

Krok 5: Renderuj jako jedną stronę

options.setRenderToSinglePage(true);
viewer.view(options);

Jak renderować archiwa do wielostronicowego html i ustawić liczbę elementów na stronę

Klasa HtmlViewOptions obsługuje także paginację. Wywołując options.setItemsPerPage(N), instruujesz viewer, aby podzielił archiwum na kilka plików HTML, z których każdy wyświetla maksymalnie N wpisów. To podejście przyspiesza nawigację w dużych archiwach, jednocześnie utrzymując każdą stronę lekką.

Direct answer: Użyj HtmlViewOptions.forEmbeddedResources(), wywołaj options.setItemsPerPage(N), i renderuj archiwum. Viewer wygeneruje osobne pliki HTML — po jednym na stronę — każdy zawierający do N wpisów, co przyspiesza nawigację w dużych archiwach.

Krok 1: Ponownie użyj katalogu wyjściowego

Path outputDirectory = Utils.getOutputDirectoryPath("YOUR_OUTPUT_DIRECTORY");

Krok 2: Zdefiniuj format nazwy pliku dla wielu stron

Path pageFilePathFormat = outputDirectory.resolve("RAR_result_page_{0}.html");

Krok 3: Ponownie zainicjalizuj viewer

try (Viewer viewer = new Viewer(TestFiles.SAMPLE_RAR_WITH_FOLDERS)) {
    // Continue with multi‑page configuration
}

Krok 4: Skonfiguruj opcje wielostronicowe (osadzanie zasobów html)

HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);

Krok 5: Ustaw liczbę elementów na stronę (główne słowo kluczowe w akcji)

options.setItemsPerPage(20); // how to convert zip archives with 20 entries per page

options.getArchiveOptions().setItemsPerPage(10); // Default is 16
viewer.view(options);

Praktyczne zastosowania

  • Systemy zarządzania dokumentami: Dodaj podgląd archiwów bez instalowania dodatkowych przeglądarek.
  • Portale internetowe: Oferuj użytkownikom szybki, bezpobieralny sposób przeglądania zgrupowanych dokumentów.
  • Narzędzia współpracy: Pozwól zespołom przeglądać udostępnione archiwa bezpośrednio w przeglądarce.

Rozważania dotyczące wydajności

  • Zarządzanie zasobami: Utrzymuj niskie zużycie pamięci, przetwarzając archiwa w strumieniach; viewer radzi sobie z archiwami do 500 MB bez ładowania całego pliku do pamięci.
  • Konwersja wsadowa archiwów: Przejdź przez listę plików archiwów i wywołaj tę samą logikę renderowania, aby maksymalizować przepustowość.
  • Strategia buforowania: Przechowuj wygenerowany HTML w pamięci podręcznej, jeśli to samo archiwum jest często wywoływane, skracając czas ponownego przetwarzania nawet o 70 %.

Najczęściej zadawane pytania

Q: What is GroupDocs.Viewer Java?
A: GroupDocs.Viewer Java to biblioteka po stronie serwera, która renderuje ponad 50 formatów dokumentów i archiwów — w tym ZIP i RAR — do HTML, PDF lub plików graficznych, bez potrzeby zewnętrznych aplikacji.

Q: How can I obtain a free trial of GroupDocs.Viewer?
A: Odwiedź free trial link, aby pobrać i przetestować.

Q: Can I convert other document types besides archives?
A: Tak, viewer obsługuje PDF‑y, Word, Excel, PowerPoint oraz ponad 35 dodatkowych formatów.

Q: What should I do if rendering is slow?
A: Zmniejsz liczbę elementów na stronę, włącz strumieniowanie lub przetwarzaj archiwa w mniejszych partiach, aby zwiększyć szybkość.

Q: Where can I get help or support?
A: Skontaktuj się poprzez support forum.

Q: Is it possible to embed CSS and images directly in the HTML?
A: Absolutnie — użyj HtmlViewOptions.forEmbeddedResources, jak pokazano w przykładach.

Q: How do I batch convert a folder of archives?
A: Iteruj po każdym pliku w pętli for, stosując tę samą konfigurację Viewer i HtmlViewOptions dla każdej iteracji.

Q: Where can I discuss issues with other users?
A: Odwiedź GroupDocs forum w celu dyskusji społecznościowych.

Zasoby

Ostatnia aktualizacja: 2026-10-10
Testowano z: GroupDocs.Viewer 25.2
Autor: GroupDocs

Powiązane samouczki