Wyodrębnij stronę zawierającą kod kreskowy przy użyciu GroupDocs.Parser dla Javy

W tym przewodniku dowiesz się jak wyodrębnić stronę zawierającą kod kreskowy z pliku PDF przy użyciu GroupDocs.Parser dla Javy. Niezależnie od tego, czy tworzysz system śledzenia zapasów, weryfikujesz przesyłki, czy automatyzujesz przetwarzanie paragonów, pobieranie danych kodu kreskowego bezpośrednio z PDF‑ów oszczędza czas i eliminuje błędy ręcznego wprowadzania.

Szybkie odpowiedzi

  • Jakiej biblioteki powinienem używać? GroupDocs.Parser dla Javy.
  • Czy mogę wyodrębnić kod kreskowy z jednej strony? Tak – wywołaj parser.getBarcodes(pageIndex).
  • Czy potrzebna jest licencja? Wymagana jest tymczasowa lub pełna licencja do użytku produkcyjnego.
  • Obsługiwane formaty? PDF, DOCX, XLSX i inne popularne typy dokumentów.
  • Czy wyodrębnianie jest szybkie dla dużych plików? Przetwarzanie wsadowe i wywołania asynchroniczne utrzymują wysoką przepustowość.

Co to jest GroupDocs.Parser dla Javy?

GroupDocs.Parser for Java to wysokopoziomowe API, które odczytuje tekst, tabele, obrazy i kody kreskowe z ponad 50 formatów dokumentów bez konwertowania ich do plików pośrednich. Abstrahuje niskopoziomową logikę parsowania, dzięki czemu możesz skupić się na regułach biznesowych.

Dlaczego warto używać GroupDocs.Parser dla Javy do wyodrębniania kodów kreskowych z PDF‑ów?

Możesz wyodrębnić kod kreskowy z konkretnej strony w zaledwie dwóch linijkach kodu, a silnik rozpoznaje zarówno wektory, jak i rastry kodów kreskowych z 99,8 % dokładnością. Przetwarza do 10 000 stron na minutę na typowym serwerze 8‑rdzeniowym, przy zużyciu pamięci poniżej 200 MB nawet dla dokumentów wielostronicowych.

Wymagania wstępne

  • GroupDocs.Parser dla Javy ≥ 25.5 (zalecane).
  • Java 8 lub nowsza, Maven (lub Gradle) do zarządzania zależnościami.
  • IDE, takie jak IntelliJ IDEA lub Eclipse.

Wymagane biblioteki i wersje

  • GroupDocs.Parser dla Javy: wersja 25.5 lub nowsza jest zalecana.

Wymagania dotyczące konfiguracji środowiska

  • Odpowiednie IDE (np. IntelliJ IDEA, Eclipse) działające na Windows, macOS lub Linux.
  • Zainstalowany JDK (Java 8+).

Wymagania wiedzy

  • Podstawowa znajomość programowania w Javie.
  • Znajomość Maven do zarządzania zależnościami.

Konfiguracja GroupDocs.Parser dla Javy

Aby rozpocząć wyodrębnianie kodów kreskowych, musisz zainstalować bibliotekę GroupDocs.Parser. Możesz dodać ją poprzez Maven lub pobrać bezpośrednio.

Korzystanie z Maven

Dodaj następującą konfigurację do swojego pom.xml:

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

<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-parser</artifactId>
        <version>25.5</version>
    </dependency>
</dependencies>

Bezpośrednie pobranie

Alternatywnie pobierz najnowszą wersję z GroupDocs.Parser for Java releases.

Kroki uzyskania licencji

  • Bezpłatna wersja próbna: Rozpocznij od wersji próbnej, aby poznać funkcje.
  • Licencja tymczasowa: Uzyskaj licencję tymczasową poprzez GroupDocs Temporary License.
  • Zakup: Aby uzyskać pełny dostęp, rozważ zakup biblioteki.

Podstawowa inicjalizacja i konfiguracja

Klasa Parser jest punktem wejścia do odczytu dowolnego obsługiwanego dokumentu. Ładuje plik do pamięci i udostępnia metody specyficzne dla poszczególnych funkcji.

Zainicjalizuj Parser podając ścieżkę do swojego PDF:

import com.groupdocs.parser.Parser;

String filePath = "YOUR_DOCUMENT_DIRECTORY/SamplePdfWithBarcodes.pdf";

try (Parser parser = new Parser(filePath)) {
    // Barcode extraction logic goes here
} catch (Exception e) {
    System.err.println("Error initializing parser: " + e.getMessage());
}

Jak wyodrębnić kody kreskowe z PDF‑ów przy użyciu GroupDocs.Parser dla Javy

GroupDocs.Parser dla Javy udostępnia proste API do odczytu kodów kreskowych bezpośrednio z dokumentów PDF. Ładując plik przy pomocy Parser, możesz wywołać getBarcodes(pageIndex), aby uzyskać wartości kodów kreskowych na dowolnej stronie, lub użyć getFeatures().isBarcodes(), aby sprawdzić wsparcie przed wyodrębnieniem. Proces wymaga tylko kilku linijek kodu.

Poniżej dzielimy proces na dwie praktyczne funkcje: wyodrębnianie kodów kreskowych z konkretnej strony oraz sprawdzanie, czy dokument obsługuje wyodrębnianie kodów kreskowych.

Wyodrębnianie kodów kreskowych z konkretnej strony

Możesz pobrać dane kodu kreskowego z wybranej strony swojego PDF‑a — idealne dla dokumentów wielostronicowych, w których tylko niektóre strony zawierają kody kreskowe.

Krok 1: weryfikacja wsparcia kodów kreskowych

Zanim przystąpisz do wyodrębniania, potwierdź, że format dokumentu może być przetwarzany pod kątem kodów kreskowych:

if (!parser.getFeatures().isBarcodes()) {
    System.out.println("Document doesn't support barcodes extraction.");
    return;
}

Krok 2: pobranie kodów kreskowych z wybranej strony

Metoda getBarcodes(int pageIndex) skanuje jedną stronę (indeks zerowy) i zwraca wszystkie wykryte kody kreskowe. Przykład wyodrębnia kody kreskowe z drugiej strony (indeks 1):

Iterable<PageBarcodeArea> barcodes = parser.getBarcodes(1);

for (PageBarcodeArea barcode : barcodes) {
    System.out.println("Page: " + barcode.getPage().getIndex());
    System.out.println("Value: " + barcode.getValue());
}

Parametry i wartości zwracane

  • getBarcodes(int pageIndex): wyodrębnia kody kreskowe z podanej numeracji strony.
    • pageIndex: zerowy indeks strony, którą chcesz zeskanować.
    • Zwraca: Iterable<PageBarcodeArea> zawierający szczegóły kodu kreskowego, takie jak indeks strony i odkodowana wartość.

Sprawdzenie wsparcia kodów kreskowych w dokumencie

Szybkie sprawdzenie wsparcia zapobiega błędom w czasie wykonywania, gdy format nie jest obsługiwany.

Krok 1: inicjalizacja parsera (użyj kodu z bloku inicjalizacji)

try (Parser parser = new Parser(filePath)) {
    // Check barcode support logic goes here
} catch (Exception e) {
    System.err.println("Error initializing parser: " + e.getMessage());
}

Krok 2: zapytanie flagi funkcji

Metoda getFeatures() zwraca obiekt zestawu funkcji opisujący dostępne możliwości wyodrębniania dla załadowanego dokumentu. Metoda isBarcodes() zwraca true, jeśli wyodrębnianie kodów kreskowych jest obsługiwane dla bieżącego formatu.

boolean supportsBarcodes = parser.getFeatures().isBarcodes();
System.out.println("Document supports barcodes: " + supportsBarcodes);

Wskazówki rozwiązywania problemów

  • Nieobsługiwany format – Jeśli napotkasz UnsupportedDocumentFormatException, sprawdź, czy typ pliku znajduje się na liście obsługiwanych formatów GroupDocs.Parser (ponad 50 formatów).
  • Indeks strony poza zakresem – Pamiętaj, że indeksy stron zaczynają się od 0; podanie nieprawidłowego indeksu spowoduje wyrzucenie IndexOutOfBoundsException.

Praktyczne zastosowania

Wyodrębnianie kodów kreskowych ma wiele zastosowań, m.in.:

  1. Zarządzanie zapasami – Szybko aktualizuj rejestry magazynowe, odczytując kody kreskowe z przychodzących PDF‑ów.
  2. Optymalizacja łańcucha dostaw – Weryfikuj listy przewozowe, dopasowując wyodrębnione kody kreskowe do oczekiwanych pozycji.
  3. Systemy punktu sprzedaży – Automatyzuj generowanie paragonów, pobierając dane kodów kreskowych bezpośrednio z faktur PDF.

Rozważania dotyczące wydajności

Aby utrzymać szybkie i pamięcio‑oszczędne wyodrębnianie:

  • Przetwarzanie wsadowe – Przetwarzaj grupy PDF‑ów w puli wątków; możesz obsłużyć 10 000 stron na minutę na standardowym serwerze.
  • Zarządzanie pamięcią – Zamykaj instancję Parser niezwłocznie (try‑with‑resources), aby GC Javy mogło zwolnić pamięć.
  • Operacje asynchroniczne – Używaj CompletableFuture lub podobnych konstrukcji do nieblokującego wyodrębniania w usługach o wysokiej przepustowości.

Najczęściej zadawane pytania

Q: Jak sprawdzić, czy format dokumentu obsługuje wyodrębnianie kodów kreskowych?
A: Wywołaj parser.getFeatures().isBarcodes(); zwróci true dla wszystkich 50+ formatów obsługiwanych przez GroupDocs.Parser.

Q: Czy GroupDocs.Parser może wyodrębnić kody kreskowe z obrazów osadzonych w PDF‑ach?
A: Tak, silnik skanuje każdy obiekt obrazu w PDF‑ie i rozpoznaje popularne symbologie kodów kreskowych 1D i 2D.

Q: Jakie są typowe błędy przy wyodrębnianiu kodów kreskowych?
A: Najczęstsze problemy to nieobsługiwane formaty dokumentów oraz nieprawidłowe (zerowe) indeksy stron, które wywołują UnsupportedDocumentFormatException lub IndexOutOfBoundsException.

Q: Jak zoptymalizować wyodrębnianie kodów kreskowych w bardzo dużych PDF‑ach?
A: Przetwarzaj plik w mniejszych zakresach stron lub używaj asynchronicznych wywołań CompletableFuture; utrzymuje to zużycie pamięci poniżej 200 MB nawet dla plików o 500 stronach.

Q: Czy można wyodrębnić kody kreskowe ze skanowanych PDF‑ów?
A: Tak, pod warunkiem, że jakość zeskanowanego obrazu jest wystarczająca (minimum 300 dpi) dla silnika rozpoznawania parsera.

Zasoby

Ostatnia aktualizacja: 2026-10-02
Testowano z: GroupDocs.Parser 25.5
Autor: GroupDocs

Powiązane samouczki