Jesteśmy zadowoleni, że możemy ogłosić wydanie GroupDocs.Metadata for Java 26.11, dostępne od listopada 2026. To wydanie odczytuje metadane z ośmiu dodatkowych formatów — pięciu formatów archiwów, audio OGG Vorbis oraz e‑booków FB2 i MOBI — i może wczytać dokument bezpośrednio z URI. Obsługa poczty e‑mail znacznie się rozbudowuje: pliki MSG udostępniają około 30 dodatkowych właściwości MAPI, kilka istniejących staje się edytowalnych, a załączniki EML można edytować. Metadata.sanitize() usuwa teraz znacznie więcej z dokumentów PDF, a zestaw poprawek usprawnia podglądy CAD oraz wykrywanie typów plików.

Co nowego w tej wersji

Klucz Podsumowanie Kategoria
METADATANET-4251 Obsługa formatów archiwów GZIP, BZ2, XZ i Zstandard Funkcja
— Obsługa formatu Apple Archive (AAR) Funkcja
METADATANET-4083 Obsługa formatu audio OGG (Vorbis) Funkcja
METADATANET-4077 Obsługa formatu e‑booków FictionBook 2 (FB2) (tylko do odczytu) Funkcja
— Obsługa formatu e‑booków MOBI Funkcja
METADATANET-4094 Ładowanie dokumentów z zasobów internetowych przy użyciu nowych konstruktorów Metadata(URI) Funkcja
METADATANET-4121 MSG: Internet Message ID, billing, ciało HTML i RTF; EML: edytowalne załączniki Funkcja
METADATANET-4123, METADATANET-4124 MSG: temat konwersacji, nazwy wyświetlane, flagi szyfrowania i podpisu, adresy nadawcy i „sent representing”, reply‑to, żądanie potwierdzenia odczytu oraz inne właściwości MAPI Funkcja
METADATANET-4110, METADATANET-4111 Email: getSenderEmailAddress(), edytowalna nazwa nadawcy MSG, ciało i kategorie Ulepszenie
METADATANET-4099 MSG: edytowalny czas dostarczenia, czas wysłania przez klienta i nagłówki Ulepszenie
— EmailHeaderPackage.set(String, PropertyValue) dodaje lub aktualizuje nagłówek e‑mail Ulepszenie
— WordProcessing: właściwości HyperlinksChanged, ScaleCrop i SharedDoc Ulepszenie
METADATANET-4139 Metadata.sanitize() usuwa z PDF załączniki, zakładki, pola formularzy i podpisy cyfrowe Ulepszenie
METADATANET-4140 Nowe tagi Tags.getTime().getDelivery() i Tags.getTool().getCompression(); więcej właściwości jest tagowanych Ulepszenie
METADATAJAVA-718 Zaktualizowano biblioteki Aspose Ulepszenie
— Podglądy rysunków CAD były puste Poprawka
— Archiwa RAR, 7z i TAR mogły być rozpoznawane jako pliki MP3 Poprawka
— Obrazy AVIF mogły być rozpoznawane jako pliki MP3, MOV lub HEIF Poprawka
— Mniejsze poprawki: spójność equals/hashCode surowych tagów, bezpieczny import JSON, przepełnienie w arytmetyce rozmiaru, zamknięte strumienie po pakowaniu ZIP Poprawka

Zmiany zachowania do sprawdzenia przed aktualizacją

  1. Czyszczenie PDF usuwa więcej. Metadata.sanitize() usuwa teraz adnotacje, załączniki, zakładki, pola formularzy i podpisy cyfrowe z dokumentów PDF; przed wersją 26.11 usuwało jedynie adnotacje. Jeśli oczyszczany PDF ma zachować te elementy, nie wywołuj sanitize() — usuń tylko potrzebne właściwości.
  2. Archiwa rozpoznawane są po rozszerzeniu. Archiwa RAR, 7z, TAR oraz nowe formaty są wykrywane na podstawie rozszerzenia pliku, więc archiwum wczytane z InputStream lub URI musi mieć explicite ustawiony format (zobacz poniżej).
  3. Właściwość nadawcy e‑mail została przemianowana. W liście właściwości właściwość nadawcy nosi teraz nazwę SenderEmailAddress zamiast Sender. Kod, który odwołuje się do tej właściwości po nazwie, musi używać nowej nazwy. EmailPackage.getSender() jest przestarzałe na rzecz getSenderEmailAddress().
  4. Nagłówki audio MPEG są tylko do odczytu. MpegAudioPackage opisuje strumień audio, więc jego właściwości — takie jak wersja MPEG, tryb kanału, bitrate i częstotliwość — nie mogą już być zmieniane przez API właściwości.

Nowe formaty

Archiwa: AAR, GZIP, BZ2, XZ i Zstandard

Nowe stałe FileType to AAR, GZIP (.gz), BZ2, XZ oraz ZSTD (.zst). Każdy format posiada pakiet główny tylko do odczytu:

Format Pakiet główny Co udostępnia
AAR AarRootPackage AarPackage: łączna liczba wpisów, flaga solid oraz wpisy AarFile z nazwą, długością i flagą katalogu
GZIP GzipRootPackage GzipPackage: nazwa, łączna liczba wpisów, rozmiar skompresowany i nieskompresowany
BZ2 Bz2RootPackage Bz2Package: nazwa, łączna liczba wpisów, rozmiar
XZ XzRootPackage XzPackage: nazwa, łączna liczba wpisów, rozmiar
Zstandard ZstdRootPackage ZstdPackage: nazwa, łączna liczba wpisów, rozmiar
try (Metadata metadata = new Metadata("backup.gz")) {
    GzipRootPackage root = metadata.getRootPackageGeneric();
    GzipPackage gzip = root.getGzipPackage();

    System.out.println(gzip.getName());
    System.out.println(gzip.getSize());
    System.out.println(gzip.getUncompressedSize());
}

Audio OGG Vorbis

Dodano FileType.OGG oraz OggRootPackage.getOggPackage(). OggPackage odczytuje pola komentarzy Vorbis:

  • tytuł, album, numer ścieżki, artysta, wykonawca, gatunek i data;
  • prawa autorskie, licencja, organizacja, opis, lokalizacja, kontakt i ISRC;
  • ciąg dostawcy i wersję;
  • wszystkie pozostałe komentarze, dostępne przez getOggUserComments().
try (Metadata metadata = new Metadata("track.ogg")) {
    OggRootPackage root = metadata.getRootPackageGeneric();
    OggPackage ogg = root.getOggPackage();

    System.out.println(ogg.getArtist() + " - " + ogg.getTitle());
    for (OggUserComment comment : ogg.getOggUserComments()) {
        System.out.println(comment.getHeader() + " = " + comment.getValue());
    }
}

E‑booki: FB2 i MOBI

  • FictionBook 2 (FB2) — dodano FileType.FB2 i Fb2RootPackage.getFb2Package(); format jest tylko do odczytu. Fb2Package posiada cztery sekcje: informacje o tytule i źródłowym tytule (Fb2TitleInfo: tytuł książki, autorzy, gatunki, słowa kluczowe, język i seria), informacje o dokumencie (Fb2DocumentInfo) oraz informacje o publikacji (Fb2PublishInfo).
  • MOBI — dodano FileType.MOBI i MobiRootPackage.getMobiPackage(). MobiPackage udostępnia nagłówek PDB (PDBHeader) oraz nagłówek MOBI (MobiHeader). Pełną nazwę książki można edytować metodą MobiHeader.setFullName(String).

Ładowanie z URI

Dwa nowe konstruktory ładują dokument bezpośrednio z java.net.URI, więc nie musisz już samodzielnie pobierać pliku:

public Metadata(java.net.URI uri)
public Metadata(java.net.URI uri, LoadOptions loadOptions)

Dokument jest pobierany do pamięci, a następnie wczytywany tak samo jak ze strumienia. Ponieważ archiwa są teraz rozpoznawane po rozszerzeniu, ustaw format explicite przy wczytywaniu archiwum ze strumienia lub URI:

try (Metadata metadata = new Metadata(inputStream, new LoadOptions(FileFormat.Rar))) {
    // ...
}

Wiadomości e‑mail

  • Dodano EmailPackage.getSenderEmailAddress(); EmailPackage.getSender() jest przestarzałe i zwraca tę samą wartość.
  • EmailPackage.setHeaders(EmailHeaderPackage) oraz EmailHeaderPackage.set(String, PropertyValue) dodają lub aktualizują nagłówki e‑mail.
  • EmlPackage.getAttachments() i EmlPackage.setAttachments(EmailAttachmentPackage[]) umożliwiają edycję załączników EML.

MsgPackage zyskał wiele nowych właściwości:

  • edytowalne: Body, Categories, SenderName, DeliveryTime, ClientSubmitTime, Billing, BodyHtml, BodyRtf, ReplyTo, ReadReceiptRequested, SenderSmtpAddress, SentRepresentingEmailAddress, SentRepresentingName, Mileage, Attachments;
  • tylko do odczytu: InternetMessageId, ConversationTopic, DisplayBcc, DisplayCc, DisplayName, DisplayNamePrefix, DisplayTo, NormalizedSubject, SubjectPrefix, SenderAddressType, SentRepresentingAddressType, SentRepresentingSmtpAddress, TransportMessageHeaders oraz flagi isEncrypted(), isSigned() i isTemplate().
try (Metadata metadata = new Metadata("message.msg")) {
    MsgRootPackage root = metadata.getRootPackageGeneric();
    MsgPackage msg = root.getMsgPackage();

    System.out.println(msg.getInternetMessageId());
    msg.setSenderName("Support Team");
    msg.setCategories(new String[] { "Reviewed" });

    metadata.save("message-updated.msg");
}

Inne ulepszenia

Czyszczenie dokumentów PDF

Metadata.sanitize() usuwa teraz z dokumentów PDF załączniki, zakładki, pola formularzy i podpisy cyfrowe, nie tylko adnotacje. Dzięki temu jest to bardziej kompleksowy sposób na oczyszczenie PDF przed udostępnieniem go poza organizacją.

Dokumenty WordProcessing

WordProcessingPackage zyskał trzy właściwości, które można odczytywać i edytować: HyperlinksChanged, ScaleCrop i SharedDoc.

Tagi

  • Tags.getTime().getDelivery() oznacza czas dostarczenia wiadomości.
  • Tags.getTool().getCompression() oznacza ustawienia kompresji plików ZIP, PNG i PSD.

Oba tagi mogą być używane z ContainsTagSpecification w Metadata.findProperties, a więcej istniejących właściwości jest teraz tagowanych.

Poprawki

  • Podglądy rysunków CAD były puste.
  • Archiwa RAR, 7z i TAR mogły być rozpoznawane jako pliki MP3.
  • Obrazy AVIF mogły być rozpoznawane jako pliki MP3, MOV lub HEIF.
  • Mniejsze poprawki: spójność equals/hashCode surowych tagów, bezpieczny import JSON, przepełnienie w arytmetyce rozmiaru oraz zamknięte strumienie po pakowaniu ZIP.

Zaktualizowano biblioteki Aspose

Dołączone biblioteki Aspose zostały zaktualizowane do: Aspose.Words 26.8, Aspose.Cells 26.9, Aspose.Slides 26.9, Aspose.PDF 26.8.1, Aspose.Email 26.8, Aspose.CAD 26.8, Aspose.PSD 26.8, Aspose.Diagram 26.9, Aspose.BarCode 26.6, Aspose.Imaging 25.12 i Aspose.ZIP 26.7.

Jak uzyskać aktualizację

Maven

Dodaj repozytorium GroupDocs i zależność do swojego pom.xml:

<repositories>
    <repository>
        <id>groupdocs-artifacts-repository</id>
        <name>GroupDocs Artifacts Repository</name>
        <url>https://releases.groupdocs.com/java/repo/</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-metadata</artifactId>
        <version>26.11</version>
    </dependency>
</dependencies>

Bezpośrednie pobranie

Pobierz plik JAR ze strony pobierania GroupDocs.Metadata for Java 26.11.

Zasoby