Generuj HTML z DOCX i renderuj śledzone zmiany w Javie
W tym przewodniku dowiesz się, jak generować HTML z DOCX, zachowując wszystkie śledzone wersje, które pojawiają się w źródłowym pliku Word. Niezależnie od tego, czy tworzysz portal do przeglądu umów, system zarządzania sprawami prawnymi, czy interfejs współpracy przy edycji, renderowanie śledzonych zmian jako HTML pozwala użytkownikom zobaczyć dokładnie, co zostało dodane, usunięte lub skomentowane — bez konieczności instalacji Microsoft Word. Samouczek przeprowadzi Cię przez konfigurację Maven, licencjonowanie oraz kompletny kod Java potrzebny do wygenerowania czystych, nawigowalnych stron HTML.
Renderowanie śledzonych zmian w dokumentach Word przy użyciu GroupDocs.Viewer dla Java
Szybkie odpowiedzi
- Co oznacza „render word tracked changes”? Konwertuje oznaczenia rewizji w pliku Word na wizualną reprezentację HTML z podświetleniami wstawień, usunięć i komentarzy.
- Która biblioteka to obsługuje? GroupDocs.Viewer for Java udostępnia jedną API do renderowania HTML, PDF lub obrazów oraz do uwzględniania znaczników śledzonych zmian.
- Czy potrzebna jest licencja? Darmowa wersja próbna działa w celach oceny; pełna licencja usuwa wszystkie ograniczenia wersji próbnej i umożliwia renderowanie dużych wolumenów.
- Jaka wersja Javy jest wymagana? Obsługiwane jest Java 8 lub nowsze; biblioteka jest kompatybilna z Java 11, 17 i późniejszymi wydaniami LTS.
- Czy mogę wyłączyć renderowanie śledzonych zmian? Tak — ustaw
setRenderTrackedChanges(false)w opcjach widoku, aby uzyskać czysty dokument bez podświetleń rewizji.
Co to jest renderowanie śledzonych zmian w Wordzie?
Renderowanie śledzonych zmian w Wordzie polega na pobraniu danych rewizji przechowywanych w pliku .docx (wstawienia, usunięcia, komentarze itp.) i wygenerowaniu formatu wyświetlanego — zazwyczaj HTML — w którym te zmiany są wizualnie podświetlone. Dzięki temu użytkownicy końcowi mogą dokładnie zobaczyć, co zostało zmodyfikowane, bez otwierania Microsoft Word.
Dlaczego używać GroupDocs.Viewer do przeglądania rewizji dokumentów Word?
GroupDocs.Viewer for Java abstrahuje niskopoziomową obsługę OpenXML i zapewnia jedną metodę API do generowania HTML, PDF lub obrazów. Obsługuje ponad 120 formatów i potrafi renderować dokumenty do 2 GB bez ładowania całego pliku do pamięci, co przyspiesza odpowiedź i zmniejsza obciążenie serwera. Biblioteka zachowuje także stylizację, osadzone zasoby oraz informacje o śledzeniu zmian „out‑of‑the‑box”.
Wymagania wstępne
- GroupDocs.Viewer for Java w wersji 25.2 lub nowszej.
- Maven do zarządzania zależnościami.
- Środowisko programistyczne Java (IDE, JDK 8+).
- Klucz licencyjny do oceny lub produkcji (dostępna wersja próbna).
Konfiguracja GroupDocs.Viewer dla Java
Konfiguracja Maven
Dodaj repozytorium GroupDocs i zależność 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>
Uzyskiwanie licencji
Rozpocznij od darmowej wersji próbnej lub poproś o tymczasową licencję ewaluacyjną. Gdy będziesz gotowy do produkcji, zakup pełną licencję, aby odblokować wszystkie funkcje i usunąć znaki wodne wersji próbnej.
Podstawowa inicjalizacja
Klasa Viewer ładuje dokument i zapewnia możliwości renderowania. Klasa ViewOptions pozwala dostosować sposób renderowania dokumentu, w tym czy wyświetlać śledzone zmiany.
Jak generować HTML z DOCX i renderować śledzone zmiany
Załaduj plik DOCX przy użyciu klasy Viewer, skonfiguruj ViewOptions, aby włączyć renderowanie śledzonych zmian, i wywołaj render, aby uzyskać serię stron HTML. Cały proces wymaga tylko kilku linii kodu i automatycznie obsługuje osadzone obrazy, tabele oraz złożone układy.
Krok 1: określ ścieżkę katalogu wyjściowego
Utwórz folder, w którym zostaną zapisane wygenerowane strony HTML.
Path outputDirectory = YOUR_OUTPUT_DIRECTORY.resolve("RenderTrackedChanges");
Krok 2: określ format zapisu każdej strony
Ustaw wzorzec nazewnictwa dla każdego wygenerowanego pliku HTML.
Path pageFilePathFormat = outputDirectory.resolve("page_{0}.html");
Krok 3: skonfiguruj opcje widoku
Włącz osadzone zasoby i włącz renderowanie śledzonych zmian.
ViewOptions pozwala precyzyjnie dostroić potok renderowania; klasa udostępnia właściwości takie jak setRenderTrackedChanges i setRenderEmbeddedResources. Domyślnie osadzone obrazy są zapisywane obok plików HTML, zapewniając w pełni funkcjonalny widok w przeglądarce.
HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);
viewOptions.getWordProcessingOptions().setRenderTrackedChanges(true);
Krok 4: utwórz instancję viewer i renderuj
Klasa Viewer jest podstawowym komponentem GroupDocs.Viewer, który ładuje dokument i renderuje go do wybranego formatu.
try (Viewer viewer = new Viewer(YOUR_DOCUMENT_DIRECTORY.resolve("SAMPLE_DOCX_WITH_TRACKED_CHANGES"))) {
viewer.view(viewOptions);
}
Jak renderować zmiany w dokumentach Word – typowe pułapki
Jeśli pominiesz kluczowe kroki, wynik może nie zawierać rewizji lub nie załadować zasobów. Najczęstsze problemy to nieprawidłowe ścieżki plików, nieobsługiwane formaty dokumentów oraz brak licencji. Upewnij się, że wskazujesz istniejące katalogi, używasz obsługiwanych plików .docx/.doc i podajesz prawidłowy klucz licencyjny przed wywołaniem render.
- Nieprawidłowe ścieżki plików – Sprawdź, czy
YOUR_OUTPUT_DIRECTORYiYOUR_DOCUMENT_DIRECTORYwskazują istniejące foldery. - Nieobsługiwany format dokumentu – Upewnij się, że plik jest
.docxlub.doc, które obsługuje GroupDocs.Viewer. - Brak licencji – Bez ważnej licencji biblioteka może ograniczyć możliwości renderowania lub dodać znaki wodne wersji próbnej.
Praktyczne zastosowania
- Systemy przeglądu dokumentów – Pokaż recenzentom dokładnie, co zostało dodane lub usunięte, z podświetleniami w miejscu.
- Zarządzanie sprawami prawnymi – Podświetl zmiany w umowach lub pozewach, aby ułatwić audyt ścieżki zmian.
- Współpraca akademicka – Zwizualizuj wkład wielu autorów w jednym, przeszukiwalnym widoku HTML.
Rozważania dotyczące wydajności
- Przetwarzaj ograniczoną liczbę dokumentów jednocześnie, aby utrzymać niskie zużycie pamięci.
- Używaj efektywnych struktur katalogów, aby zmniejszyć obciążenie I/O.
- Aktualizuj bibliotekę; nowsze wydania zawierają optymalizacje wydajności, które mogą renderować 500‑stronicowy dokument w mniej niż 5 sekund na typowym serwerze.
Zakończenie
Masz teraz kompletną, gotową do produkcji metodę generowania HTML z DOCX i renderowania śledzonych zmian w Wordzie przy użyciu GroupDocs.Viewer for Java. Zintegruj te kroki w swojej aplikacji, a zapewnisz użytkownikom potężne, interaktywne doświadczenie przeglądu dokumentów, działające we wszystkich przeglądarkach i na urządzeniach bez potrzeby posiadania Microsoft Office.
Najczęściej zadawane pytania
Q: Jaka jest minimalna wymagana wersja Javy?
A: Zalecane jest Java 8 lub nowsze; biblioteka jest również kompatybilna z Java 11, 17 i nowszymi wydaniami LTS.
Q: Czy mogę renderować dokumenty bez śledzonych zmian?
A: Tak, ustaw setRenderTrackedChanges(false) w ViewOptions, aby uzyskać czysty HTML bez podświetleń rewizji.
Q: Jak efektywnie obsługiwać duże dokumenty?
A: Podziel duże pliki na sekcje, użyj opcji paginacji i utrzymuj bibliotekę w najnowszej wersji — wersja 25.2 przetwarza dokumenty 500‑stronicowe w mniej niż 5 sekund na standardowym sprzęcie.
Q: Jakie są opcje licencjonowania GroupDocs.Viewer?
A: Rozpocznij od darmowej wersji próbnej, uzyskaj tymczasową licencję ewaluacyjną lub zakup pełną licencję komercyjną, która usuwa wszystkie ograniczenia i zapewnia priorytetowe wsparcie.
Q: Czy dostępne jest wsparcie w razie problemów?
A: Tak, pomoc można uzyskać na forum GroupDocs, w oficjalnej dokumentacji oraz poprzez zgłoszenia wsparcia dla klientów posiadających licencję.
Last Updated: 2026-09-25
Tested With: GroupDocs.Viewer for Java 25.2
Author: GroupDocs
