Uzyskaj liczbę stron PDF i wyodrębnij metadane PDF przy użyciu GroupDocs.Conversion Java

Wyodrębnianie metadanych takich jak autor, data utworzenia i szczególnie liczba stron pliku PDF jest powszechnym wymogiem w aplikacjach skoncentrowanych na dokumentach. W tym samouczku nauczysz się, jak uzyskać liczbę stron PDF i pobrać inne przydatne szczegóły przy użyciu GroupDocs.Conversion dla Javy. Przejdziemy przez konfigurację, kod i scenariusze rzeczywiste, abyś mógł od razu wykorzystać tę funkcję.

Szybkie odpowiedzi

  • Co oznacza „get PDF page count”? Zwraca całkowitą liczbę stron w pliku PDF.
  • Która biblioteka pomaga w tym w Javie? GroupDocs.Conversion dla Javy zapewnia prosty interfejs API.
  • Czy potrzebna jest licencja? Dostępna jest darmowa wersja próbna; licencja komercyjna jest wymagana w środowisku produkcyjnym.
  • Czy mogę odczytać także inne metadane? Tak — autor, tytuł, data utworzenia, status szyfrowania i inne.
  • Czy jest kompatybilna z Java 8+? Absolutnie, biblioteka obsługuje JDK 8 i nowsze.

Co to jest „get PDF page count”?

Uzyskanie liczby stron PDF oznacza zapytanie struktury dokumentu w celu określenia, ile stron zawiera. Informacja ta jest przydatna do paginacji, generowania podglądów i kontroli zgodności.

Dlaczego wyodrębniać metadane PDF w Javie?

Wyodrębnianie metadanych PDF pozwala automatyzować klasyfikację dokumentów, egzekwować polityki bezpieczeństwa i generować raporty bez otwierania pełnego pliku. To lekka operacja w porównaniu do pełnego wyodrębniania treści, co czyni ją idealną dla dużych przepływów przetwarzania dokumentów.

Wymagania wstępne

  • Java Development Kit (JDK) 8+ zainstalowany.
  • Maven do zarządzania zależnościami.
  • IDE, takie jak IntelliJ IDEA lub Eclipse.
  • Podstawowa znajomość Javy.

Konfiguracja GroupDocs.Conversion 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/conversion/java/</url>
   </repository>
</repositories>
<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-conversion</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

Uzyskanie licencji

GroupDocs oferuje darmową wersję próbną, tymczasowe licencje ewaluacyjne oraz pełne opcje zakupu. Możesz rozpocząć od ich darmowej wersji próbnej, aby zapoznać się z funkcjami.

Podstawowa inicjalizacja

Once Maven resolves the library, initialize the Converter with the path to your PDF:

import com.groupdocs.conversion.Converter;

public class PDFInfoRetriever {
    public static void main(String[] args) {
        // Initialize the Converter with the path to your PDF document.
        Converter converter = new Converter("YOUR_DOCUMENT_DIRECTORY/SAMPLE_PDF");
        
        // Proceed to retrieve and utilize document information...
    }
}

Przewodnik implementacji

Pobierz podstawowe informacje o dokumencie

Poniżej znajduje się krok po kroku przewodnik, który pokazuje jak uzyskać liczbę stron PDF i inne metadane.

Krok 1: Inicjalizacja konwertera

Create a Converter instance pointing to your PDF file.

Converter converter = new Converter("YOUR_DOCUMENT_DIRECTORY/SAMPLE_PDF");
  • Cel: Przygotowuje dokument do wyodrębniania informacji.

Krok 2: Pobranie ogólnych informacji o dokumencie

Call getDocumentInfo() to obtain a format‑agnostic info object.

import com.groupdocs.conversion.contracts.documentinfo.IDocumentInfo;

IDocumentInfo info = converter.getDocumentInfo();
  • Cel: Daje dostęp do wspólnych atrybutów, takich jak rozmiar i format.

Krok 3: Rzutowanie informacji na PdfDocumentInfo

To reach PDF‑specific fields, cast the generic info object.

import com.groupdocs.conversion.contracts.documentinfo.PdfDocumentInfo;

PdfDocumentInfo pdfInfo = (PdfDocumentInfo) info;
  • Cel: Umożliwia użycie właściwości specyficznych dla PDF, takich jak liczba stron i status szyfrowania.

Krok 4: Dostęp i wykorzystanie właściwości dokumentu

Extract the metadata you need, including the page count.

String author = pdfInfo.getAuthor(); // Get the author's name
String creationDate = pdfInfo.getCreationDate(); // Retrieve the document's creation date
double width = pdfInfo.getWidth(); // Width of the first page in points
double height = pdfInfo.getHeight(); // Height of the first page in points
boolean isLandscape = pdfInfo.isLandscape(); // Check if the first page is in landscape mode
int pagesCount = pdfInfo.getPagesCount(); // Total number of pages in the document
String title = pdfInfo.getTitle(); // Document's title
String version = pdfInfo.getVersion(); // PDF version information
boolean isEncrypted = pdfInfo.isPasswordProtected(); // Check if the document is password protected

// Use these properties as needed, such as logging or displaying in a UI.
  • Cel: Dostarcza pełny podgląd metadanych PDF, umożliwiając uzyskanie liczby stron PDF oraz innych szczegółów w jednym wywołaniu.

Wskazówki rozwiązywania problemów

  • Zweryfikuj, czy ścieżka do PDF jest poprawna i plik jest czytelny.
  • Upewnij się, że wszystkie zależności Maven są poprawnie zadeklarowane.
  • W przypadku plików zabezpieczonych hasłem, obsłuż flagę isPasswordProtected przed dostępem do innych właściwości.

Praktyczne zastosowania

  1. Systemy zarządzania dokumentami: Automatyczne tagowanie PDF-ów autorem, tytułem i liczbą stron w celu szybkiego wyszukiwania.
  2. Audyt zgodności: Potwierdź, że PDF-y zawierają wymagane metadane (np. datę utworzenia).
  3. Bramy bezpieczeństwa: Odrzuć lub oznacz niezaszyfrowane PDF-y przed ich wprowadzeniem do bezpiecznego repozytorium.
  4. Pulpity analityczne: Agreguj statystyki liczby stron w całej bibliotece dokumentów.

Rozważania dotyczące wydajności

  • Zwolnij obiekty Converter niezwłocznie, aby zwolnić zasoby natywne.
  • Przy przetwarzaniu wsadowym, w miarę możliwości ponownie używaj jednej instancji Converter.
  • Monitoruj zużycie pamięci sterty JVM; duże PDF-y mogą wymagać zwiększonych ustawień pamięci.

Zakończenie

Teraz wiesz, jak uzyskać liczbę stron PDF i wyodrębnić mnóstwo metadanych z plików PDF przy użyciu GroupDocs.Conversion dla Javy. Ta wiedza umożliwia budowanie inteligentniejszych przepływów dokumentów, poprawę możliwości wyszukiwania oraz egzekwowanie polityk bezpieczeństwa.

Kolejne kroki

Zbadaj dodatkowe funkcje GroupDocs.Conversion, takie jak konwersja formatów, znaki wodne i łączenie dokumentów, aby jeszcze bardziej wzbogacić swoją aplikację.

Najczęściej zadawane pytania

Q: Czy mogę również wyodrębnić pełną treść tekstową PDF?
A: Tak. GroupDocs.Conversion obsługuje wyodrębnianie tekstu; odwołaj się do oficjalnej dokumentacji, aby uzyskać odpowiednie API.

Q: Co zrobić, jeśli PDF jest zabezpieczony hasłem?
A: Najpierw użyj sprawdzenia isPasswordProtected. Jeśli zwróci true, podaj hasło podczas inicjalizacji Converter.

Q: Jak konwertować inne typy dokumentów przy użyciu GroupDocs.Conversion?
A: Biblioteka udostępnia zunifikowane API konwersji. Zobacz API Reference, aby poznać obsługiwane formaty.

Q: Czy istnieje limit rozmiaru PDF, który mogę przetworzyć?
A: Limity zależą od pamięci serwera. Przydziel wystarczającą ilość pamięci sterty dla dużych plików.

Q: Jak obsłużyć błędy konwersji w sposób elegancki?
A: Otocz wywołania konwersji blokami try‑catch i loguj szczegóły ConversionException, aby poinformować użytkowników.

Zasoby

Ostatnia aktualizacja: 2026-04-14
Testowano z: GroupDocs.Conversion 25.2 for Java
Autor: GroupDocs