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ą
- 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łujsanitize()— usuń tylko potrzebne właściwości. - Archiwa rozpoznawane są po rozszerzeniu. Archiwa RAR, 7z, TAR oraz nowe formaty są wykrywane na podstawie rozszerzenia pliku, więc archiwum wczytane z
InputStreamlub URI musi mieć explicite ustawiony format (zobacz poniżej). - Właściwość nadawcy e‑mail została przemianowana. W liście właściwości właściwość nadawcy nosi teraz nazwę
SenderEmailAddresszamiastSender. 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 rzeczgetSenderEmailAddress(). - Nagłówki audio MPEG są tylko do odczytu.
MpegAudioPackageopisuje 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.FB2iFb2RootPackage.getFb2Package(); format jest tylko do odczytu.Fb2Packageposiada 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.MOBIiMobiRootPackage.getMobiPackage().MobiPackageudostę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)orazEmailHeaderPackage.set(String, PropertyValue)dodają lub aktualizują nagłówki e‑mail.EmlPackage.getAttachments()iEmlPackage.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,TransportMessageHeadersoraz flagiisEncrypted(),isSigned()iisTemplate().
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.