Jak wyodrębnić tekst PDF przy użyciu GroupDocs.Viewer dla Javy
Wyodrębnianie tekstu z plików PDF jest podstawowym wymogiem dla wielu aplikacji opartych na danych. W tym samouczku przeprowadzimy Cię przez jak wyodrębnić pdf treść efektywnie przy użyciu biblioteki GroupDocs Viewer Java. Niezależnie od tego, czy potrzebujesz indeksować dokumenty, przeprowadzać analizy, czy migrować archiwa legacy, poniższe kroki zapewniają kompletną, gotową do produkcji rozwiązanie.

Szybkie odpowiedzi
- Jaka biblioteka jest najlepsza do wyodrębniania tekstu PDF? GroupDocs.Viewer Java zapewnia solidne pdf text extraction api.
- Czy mogę wyodrębnić tekst z wielostronicowych plików PDF? Tak – przeglądarka iteruje automatycznie przez każdą stronę i linię.
- Czy potrzebuję licencji do produkcji? Wymagana jest licencja komercyjna; dostępna jest darmowa wersja próbna do oceny.
- Jaką wersję Javy obsługuje? JDK 1.8+ (najnowsze wydania LTS również działają).
- Czy Maven jest jedynym sposobem dodania zależności? Maven jest zalecany, ale możesz także użyć Gradle lub ręcznego dołączania pliku JAR.
Czym jest wyodrębnianie tekstu PDF i dlaczego używać GroupDocs Viewer?
API pdf text extraction odczytuje warstwę tekstową PDF bez renderowania treści wizualnej. To podejście jest znacznie szybsze niż OCR oparte na rasterze i zachowuje oryginalną strukturę dokumentu. GroupDocs Viewer Java dodaje dodatkową wartość, obsługując złożone układy, zaszyfrowane pliki i wielostronicowe dokumenty od razu po wyjęciu z pudełka.
Wymagania wstępne
Before you start, make sure you have:
- Java Development Kit (JDK) 1.8+ zainstalowany.
- Maven do zarządzania zależnościami (lub Gradle, jeśli wolisz).
- Dostęp do licencji GroupDocs Viewer for Java (darmowa wersja próbna lub zakupiona).
- Podstawowa znajomość Javy – będziesz pisać kilka bloków
try‑with‑resources.
Konfiguracja GroupDocs.Viewer dla Javy
Add the GroupDocs 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>
Uzyskanie licencji
- Free Trial – idealna do eksploracji api wyodrębniania tekstu PDF.
- Temporary License – przedłużone testowanie bez karty kredytowej.
- Full Purchase – wymagana przy wdrożeniach komercyjnych.
Przewodnik implementacji
Poniżej znajduje się zwięzły, krok po kroku przewodnik, jak wyodrębnić tekst PDF przy użyciu GroupDocs Viewer Java.
1. Inicjalizacja obiektu Viewer
try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_PDF")) {
// Initialization complete, proceed to next steps.
}
Instancja Viewer wskazuje na PDF, który chcesz przetworzyć. Użycie bloku try‑with‑resources zapewnia automatyczne zwolnienie zasobów natywnych.
2. Konfiguracja ViewInfoOptions do wyodrębniania tekstu
ViewInfoOptions viewInfoOptions = ViewInfoOptions.forHtmlView();
viewInfoOptions.setExtractText(true);
Ustawienie setExtractText(true) informuje pdf text extraction api, aby uwzględniało surowy tekst w informacji widoku.
3. Pobranie informacji o dokumencie
PdfViewInfo viewInfo = (PdfViewInfo) viewer.getViewInfo(viewInfoOptions);
PdfViewInfo zapewnia dostęp do każdej strony, linii i jej wartości tekstowej.
4. Iteracja przez strony i linie (wyodrębnianie tekstu z wielostronicowego PDF)
for (Page page : viewInfo.getPages()) {
for (Line line : page.getLines()) {
System.out.println(line.getValue());
}
}
Ta pętla wypisuje każdą linię tekstu, automatycznie obsługując scenariusze extract multi page pdf. Możesz zamienić System.out.println na kod zapisujący do pliku, bazy danych lub indeksu wyszukiwania.
Wskazówki rozwiązywania problemów
- Sprawdź dokładnie ścieżkę pliku; nieprawidłowa ścieżka powoduje
FileNotFoundException. - Upewnij się, że wywołano
setExtractText(true); w przeciwnym razie zwracane są tylko dane wizualne. - W przypadku zaszyfrowanych PDF‑ów przekaż hasło poprzez przeciążenie konstruktora
Viewer.
Praktyczne zastosowania
Możliwości extract pdf text java w GroupDocs Viewer odblokowują wiele rzeczywistych przypadków użycia:
- Data Migration – Przenieś archiwa PDF legacy do przeszukiwalnych baz danych.
- Content Analysis – Przekaż wyodrębniony tekst do potoków NLP w celu analizy sentymentu lub ekstrakcji słów kluczowych.
- Document Management Systems (DMS) – Automatycznie indeksuj dokumenty w celu szybkiego wyszukiwania.
Rozważania dotyczące wydajności
When working with large files or batch jobs:
- Memory Management – Przetwarzaj strony wewnątrz bloku
try, aby umożliwić szybkie zwolnienie pamięci przez garbage collector. - Streaming – W przypadku bardzo dużych PDF‑ów rozważ przetwarzanie stron pojedynczo, zamiast ładowania całego dokumentu.
- Threading – Równolegle wyodrębniaj z wielu plików, ale utrzymuj jedną instancję
Viewerna wątek.
Częste problemy i rozwiązania
| Problem | Rozwiązanie |
|---|---|
OutOfMemoryError przy dużych PDF‑ach | Zwiększ pamięć JVM (-Xmx2g) i przetwarzaj strony kolejno. |
| Brak zwróconego tekstu dla zeskanowanych PDF‑ów | Użyj dodatku OCR lub dedykowanej biblioteki OCR; GroupDocs Viewer wyodrębnia tylko wbudowany tekst. |
| Błąd licencji w środowisku produkcyjnym | Sprawdź, czy plik licencji jest poprawnie umieszczony i okres próbny nie wygasł. |
Najczęściej zadawane pytania
Q: Czy mogę używać GroupDocs.Viewer na serwerze produkcyjnym?
A: Tak, ale musisz posiadać ważną licencję komercyjną. Darmowa wersja próbna jest ograniczona do rozwoju i testów.
Q: Jak wyodrębnianie tekstu wpływa na metadane PDF?
A: Wyodrębnianie odczytuje tylko treść; metadane pozostają niezmienione, chyba że zmodyfikujesz je wyraźnie.
Q: Jakie inne formaty plików obsługuje GroupDocs Viewer oprócz PDF?
A: Obsługuje Word, Excel, PowerPoint, obrazy i wiele innych formatów, co czyni go wszechstronnym przeglądarką dokumentów.
Q: Czy istnieje sposób na wyodrębnienie tekstu z chronionych hasłem PDF‑ów?
A: Oczywiście – przekaż hasło przy tworzeniu instancji Viewer.
Q: Jak mogę poprawić wydajność przy przetwarzaniu wsadowym tysięcy PDF‑ów?
A: Użyj puli wątków, przetwarzaj każdy plik w własnej instancji Viewer i dokładnie monitoruj zużycie pamięci.
Zasoby
Ostatnia aktualizacja: 2026-05-06
Testowano z: GroupDocs.Viewer Java 25.2
Autor: GroupDocs