groupdocs viewer maven: Konwertuj pliki TXT do HTML, JPG, PNG i PDF przy użyciu GroupDocs.Viewer dla Javy
W nowoczesnych aplikacjach Java, groupdocs viewer maven umożliwia łatwe przekształcanie dokumentów tekstowych (TXT) w gotowe do wyświetlenia w przeglądarce HTML, obrazy wysokiej rozdzielczości lub przenośne pliki PDF. Niezależnie od tego, czy tworzysz portal dokumentów, usługę archiwizacji czy funkcję podglądu, konwersja plików TXT przy użyciu GroupDocs.Viewer oszczędza czas i eliminuje potrzebę tworzenia własnych parserów. W tym przewodniku przeprowadzimy Cię przez pełną konfigurację i pokażemy, jak convert txt files java do HTML (jednostronicowego i wielostronicowego), JPG, PNG i PDF.

Szybkie odpowiedzi
- Jaki artefakt Maven jest potrzebny?
com.groupdocs:groupdocs-viewer(see Maven snippet below). - Czy mogę renderować wielostronicowy HTML? Tak – use
HtmlViewOptions.forEmbeddedResourceswithout the single‑page flag. - Czy wymagana jest licencja do produkcji? Wersja trial działa do oceny; stała licencja jest wymagana do użytku komercyjnego.
- Jaką wersję Java obsługuje? Java 8 lub nowsza (zalecane Java 11+).
- Czy potrzebuję dodatkowych bibliotek do wyjścia obrazu? Nie, biblioteka Viewer zawiera wsparcie dla JPG i PNG od razu.
Co to jest groupdocs viewer maven?
groupdocs viewer maven to dystrybucja oparta na Maven biblioteki GroupDocs.Viewer dla Java. Zapewnia prosty interfejs API do renderowania ponad 100 formatów dokumentów — w tym tekstowych — do HTML, obrazów lub PDF bez konieczności posiadania Microsoft Office lub innych narzędzi firm trzecich.
Dlaczego konwertować pliki txt w Javie?
- Podgląd wieloplatformowy – HTML i obrazy mogą być wyświetlane w przeglądarkach lub aplikacjach mobilnych.
- Standaryzowane archiwizowanie – PDF zachowuje formatowanie i jest uniwersalnie czytelny.
- Przyjazny automatyzacji – Integruj konwersję w zadaniach wsadowych, usługach chmurowych lub pipeline’ach CI.
Wymagania wstępne
- GroupDocs.Viewer for Java wersja 25.2 lub nowsza (dostarczana przez Maven).
- JDK 8 + (zalecane Java 11 +).
- IDE, takie jak IntelliJ IDEA, Eclipse lub NetBeans.
- Podstawowa znajomość Java i Maven.
Konfiguracja GroupDocs.Viewer dla Java
Add the repository and dependency to your 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>
Kroki uzyskania licencji
- Rozpocznij od bezpłatnej wersji próbnej lub uzyskaj tymczasową licencję, aby przetestować pełne możliwości.
- Do produkcji zakup licencję poprzez oficjalną strona zakupu.
Podstawowa inicjalizacja i konfiguracja
- Dodaj zależność Maven przedstawioną powyżej.
- Upewnij się, że Twój JDK i IDE są poprawnie skonfigurowane.
Teraz przejdźmy do konkretnych scenariuszy konwersji.
Przewodnik implementacji
Funkcja 1: Renderowanie TXT do wielostronicowego HTML (multi page html java)
Przegląd
Ten przykład konwertuje dokument TXT do wielostronicowego HTML zachowując podziały wierszy na oddzielnych stronach internetowych.
Import wymaganych bibliotek
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
Ustaw ścieżki i Viewer
Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
Path pageFileFullPath = outputDirectory.resolve("Txt_result.html");
try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_TXT")) {
// Configure options for rendering with embedded resources
HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFileFullPath);
// Render the document to HTML using these options
viewer.view(options);
}
Wyjaśnienie: HtmlViewOptions.forEmbeddedResources łączy CSS, czcionki i obrazy bezpośrednio w wyjściowym HTML, co czyni go przenośnym.
Funkcja 2: Renderowanie TXT do jednopostaciowego HTML (convert txt to html java)
Przegląd
Zbierz cały plik tekstowy w jedną stronę HTML — idealne do szybkich podglądów.
Import wymaganych bibliotek
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
Ustaw ścieżki i Viewer
Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
Path pageFileFullPath = outputDirectory.resolve("Txt_result_single_page.html");
try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_2_TXT")) {
// Configure options for rendering with embedded resources
HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFileFullPath);
// Set the option to render as a single page HTML
options.setRenderToSinglePage(true);
// Render the document using these options
viewer.view(options);
}
Wyjaśnienie: setRenderToSinglePage(true) łączy wszystkie strony w jeden plik HTML.
Funkcja 3: Renderowanie TXT do JPG
Przegląd
Konwertuj plik TXT do wysokiej jakości obrazu JPEG, przydatny do udostępniania na platformach akceptujących jedynie obrazy.
Import wymaganych bibliotek
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.JpgViewOptions;
Ustaw ścieżki i Viewer
Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
Path pageFileFullPath = outputDirectory.resolve("Txt_result.jpg");
try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_TXT")) {
// Configure options for rendering to a JPEG image
JpgViewOptions options = new JpgViewOptions(pageFileFullPath);
// Render the document as a JPG using these options
viewer.view(options);
}
Wyjaśnienie: JpgViewOptions umożliwia kontrolowanie jakości obrazu, DPI oraz ścieżki wyjściowej.
Funkcja 4: Renderowanie TXT do PNG
Przegląd
Generuj obrazy PNG bezstratne z plików tekstowych — idealne, gdy potrzebne są ostre, skalowalne grafiki.
Import wymaganych bibliotek
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PngViewOptions;
Ustaw ścieżki i Viewer
Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
Path pageFileFullPath = outputDirectory.resolve("Txt_result.png");
try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_TXT")) {
// Configure options for rendering to a PNG image
PngViewOptions options = new PngViewOptions(pageFileFullPath);
// Render the document as a PNG using these options
viewer.view(options);
}
Wyjaśnienie: PNG zapewnia kompresję bezstratną, zachowując dokładny wygląd oryginalnego tekstu.
Funkcja 5: Renderowanie TXT do PDF (txt to pdf java / convert txt to pdf java)
Przegląd
Utwórz plik PDF z dokumentu TXT — doskonały do archiwizacji, drukowania lub wysyłania do klientów.
Import wymaganych bibliotek
import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;
Ustaw ścieżki i Viewer
Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
Path pageFileFullPath = outputDirectory.resolve("Txt_result.pdf");
try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_TXT")) {
// Configure options for rendering to a PDF
PdfViewOptions options = new PdfViewOptions(pageFileFullPath);
// Render the document as a PDF using these options
viewer.view(options);
}
Wyjaśnienie: PdfViewOptions automatycznie obsługuje układ stron, czcionki i osadzanie zasobów.
Praktyczne zastosowania
- Systemy zarządzania dokumentami: Automatyzuj konwersję starszych dokumentów TXT do HTML dla portali intranetowych.
- Platformy wydawnicze: Przekształcaj rękopisy TXT dostarczane przez autorów w HTML dla płynnej integracji z CMS.
- Rozwiązania archiwizacyjne: Zachowuj stare pliki tekstowe jako PDF lub PNG do długoterminowego przechowywania.
- Integracja z chmurą: Konwertuj w locie i przechowuj wygenerowane pliki w AWS S3, Azure Blob lub Google Cloud.
Typowe problemy i rozwiązania
| Problem | Przyczyna | Rozwiązanie |
|---|---|---|
| Wyjście jest puste | Nieprawidłowa ścieżka pliku lub brak uprawnień do odczytu. | Sprawdź, czy YOUR_DOCUMENT_DIRECTORY wskazuje na rzeczywisty plik TXT i czy proces ma prawa odczytu. |
| Obrazy mają niską jakość | Domyślne DPI jest niskie. | Użyj JpgViewOptions.setResolution(int dpi) lub PngViewOptions.setResolution(int dpi), aby zwiększyć DPI (np. 300). |
| HTML zawiera zepsute linki | Zasoby nie są osadzone. | Użyj HtmlViewOptions.forEmbeddedResources lub podaj własny folder zasobów. |
| Wyjątek licencyjny | Nie ustawiono ważnej licencji. | Załaduj plik licencji przy pomocy License license = new License(); license.setLicense("path/to/license.file"); przed utworzeniem obiektu Viewer. |
Najczęściej zadawane pytania
Q: Czy mogę konwertować duże pliki TXT (setki MB) przy użyciu GroupDocs.Viewer?
A: Tak. Biblioteka strumieniuje plik źródłowy, ale dla bardzo dużych dokumentów warto zwiększyć rozmiar sterty JVM.
Q: Czy potrzebuję dodatkowych zależności do generowania JPG lub PNG?
A: Nie. Pakiet Viewer zawiera wszystkie niezbędne biblioteki przetwarzania obrazów.
Q: Czy można dostosować rozmiar strony PDF?
A: Oczywiście. Użyj PdfViewOptions.setPageSize(PageSize.A4) lub dowolnego innego PageSize przed renderowaniem.
Q: Jak obsłużyć pliki TXT chronione hasłem?
A: Pliki TXT nie obsługują haseł. Jeśli plik jest zaszyfrowany, najpierw go odszyfruj przed przekazaniem do Viewer.
Q: Czy mogę uruchomić tę konwersję w kontenerze Docker?
A: Tak. Wystarczy dołączyć JDK, skopiować swój pom.xml z zależnością GroupDocs i uruchomić aplikację Java wewnątrz kontenera.
Ostatnia aktualizacja: 2026-02-21
Testowano z: GroupDocs.Viewer 25.2 for Java
Autor: GroupDocs