We’re pleased to announce the release of GroupDocs.Metadata for Java 26.11, available as of November 2026. This release reads metadata from eight more formats — five archive formats, OGG Vorbis audio and FB2 and MOBI e‑books — and can load a document straight from a URI. Email support grows considerably: MSG files expose about 30 more MAPI properties, several existing ones become editable, and EML attachments can be edited. Metadata.sanitize() now removes much more from PDF documents, and a set of fixes improves CAD previews and file type detection.
このリリースの新機能
| キー | 概要 | カテゴリ |
|---|---|---|
| METADATANET-4251 | GZIP、BZ2、XZ、Zstandard アーカイブ形式をサポート | 機能 |
| — | Apple Archive(AAR)形式をサポート | 機能 |
| METADATANET-4083 | OGG(Vorbis)オーディオ形式をサポート | 機能 |
| METADATANET-4077 | FictionBook 2(FB2)電子書籍形式をサポート(読み取り専用) | 機能 |
| — | MOBI 電子書籍形式をサポート | 機能 |
| METADATANET-4094 | 新しい Metadata(URI) コンストラクタでウェブリソースからドキュメントをロード |
機能 |
| METADATANET-4121 | MSG: インターネットメッセージID、請求、HTML および RTF 本文; EML: 編集可能な添付ファイル | 機能 |
| METADATANET-4123, METADATANET-4124 | MSG: 会話トピック、表示名、暗号化・署名フラグ、送信者および「送信代理」アドレス、返信先、開封確認その他の MAPI プロパティ | 機能 |
| METADATANET-4110, METADATANET-4111 | Email: getSenderEmailAddress()、編集可能な MSG 送信者名、本文、カテゴリ |
強化 |
| METADATANET-4099 | MSG: 編集可能な配信時間、クライアント送信時間、ヘッダー | 強化 |
| — | EmailHeaderPackage.set(String, PropertyValue) はメールヘッダーを追加または更新 |
強化 |
| — | WordProcessing: HyperlinksChanged、ScaleCrop、SharedDoc プロパティ |
強化 |
| METADATANET-4139 | Metadata.sanitize() は PDF の添付ファイル、ブックマーク、フォームフィールド、デジタル署名を削除 |
強化 |
| METADATANET-4140 | 新しいタグ Tags.getTime().getDelivery() と Tags.getTool().getCompression() を追加; さらに多くのプロパティにタグ付け |
強化 |
| METADATAJAVA-718 | Aspose ライブラリを更新 | 強化 |
| — | CAD 図面のプレビューが空でした | 修正 |
| — | RAR、7z、TAR アーカイブが MP3 ファイルとして認識されることがありました | 修正 |
| — | AVIF 画像が MP3、MOV、HEIF ファイルとして認識されることがありました | 修正 |
| — | 小規模な修正: 生タグの equals/hashCode の一貫性、null 安全な JSON インポート、サイズ演算のオーバーフロー、ZIP 圧縮後のストリームクローズ | 修正 |
アップグレード前に確認すべき動作変更
- PDF のサニタイズがより多く削除します。
Metadata.sanitize()は現在、PDF ドキュメントから注釈だけでなく、添付ファイル、ブックマーク、フォームフィールド、デジタル署名も削除します。26.11 以前は注釈のみが削除されていました。サニタイズされた PDF でこれらの項目を保持する必要がある場合は、sanitize()を呼び出さずに必要なプロパティだけを削除してください。 - アーカイブは拡張子で認識されます。 RAR、7z、TAR および新しいアーカイブ形式はファイル拡張子で検出されるため、
InputStreamや URI からロードするアーカイブは形式を明示的に設定する必要があります(下記 を参照)。 - メール送信者プロパティの名称変更。 プロパティ一覧では、送信者プロパティの名前が
SenderからSenderEmailAddressに変更されました。名前でプロパティを取得するコードは新しい名前を使用してください。EmailPackage.getSender()は非推奨となり、getSenderEmailAddress()が推奨されます。 - MPEG オーディオヘッダーは読み取り専用です。
MpegAudioPackageはオーディオストリームを記述するため、MPEG バージョン、チャンネルモード、ビットレート、周波数といったプロパティはプロパティ API から変更できなくなりました。
新しいフォーマット
アーカイブ: AAR、GZIP、BZ2、XZ、Zstandard
新しい FileType 定数は AAR、GZIP(.gz)、BZ2、XZ、ZSTD(.zst)です。各フォーマットは読み取り専用のルートパッケージを持ちます。
| フォーマット | ルートパッケージ | 公開内容 |
|---|---|---|
| AAR | AarRootPackage |
AarPackage: 総エントリ数、solid フラグ、そして名前、長さ、ディレクトリフラグを持つ AarFile エントリ |
| GZIP | GzipRootPackage |
GzipPackage: 名前、総エントリ数、圧縮サイズ、非圧縮サイズ |
| BZ2 | Bz2RootPackage |
Bz2Package: 名前、総エントリ数、サイズ |
| XZ | XzRootPackage |
XzPackage: 名前、総エントリ数、サイズ |
| Zstandard | ZstdRootPackage |
ZstdPackage: 名前、総エントリ数、サイズ |
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());
}
OGG Vorbis オーディオ
FileType.OGG と OggRootPackage.getOggPackage() が追加されました。OggPackage は Vorbis コメントフィールドを読み取ります。
- タイトル、アルバム、トラック番号、アーティスト、パフォーマー、ジャンル、日付;
- 著作権、ライセンス、組織、説明、場所、連絡先、ISRC;
- ベンダー文字列とバージョン;
- 残りのコメントは
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());
}
}
電子書籍: FB2 と MOBI
- FictionBook 2 (FB2) —
FileType.FB2とFb2RootPackage.getFb2Package()が追加されました。フォーマットは読み取り専用です。Fb2Packageには 4 つのセクションがあります: タイトル情報とソースタイトル情報(Fb2TitleInfo: 書名、著者、ジャンル、キーワード、言語、シリーズ)、文書情報(Fb2DocumentInfo)および出版情報(Fb2PublishInfo)。 - MOBI —
FileType.MOBIとMobiRootPackage.getMobiPackage()が追加されました。MobiPackageは PDB ヘッダー(PDBHeader)と MOBI ヘッダー(MobiHeader)を公開します。書籍のフルネームはMobiHeader.setFullName(String)で編集可能です。
URI からのロード
新しい 2 つのコンストラクタは java.net.URI から直接ドキュメントをロードするため、ファイルを自分でダウンロードする必要がなくなります。
public Metadata(java.net.URI uri)
public Metadata(java.net.URI uri, LoadOptions loadOptions)
ドキュメントはメモリにダウンロードされ、ストリームからロードするのと同じ方法で読み込まれます。アーカイブは拡張子で認識されるようになったため、ストリームまたは URI からアーカイブをロードする際は形式を明示的に設定してください。
try (Metadata metadata = new Metadata(inputStream, new LoadOptions(FileFormat.Rar))) {
// ...
}
電子メールメッセージ
EmailPackage.getSenderEmailAddress()が追加され、EmailPackage.getSender()は非推奨となり同じ値を返します。EmailPackage.setHeaders(EmailHeaderPackage)とEmailHeaderPackage.set(String, PropertyValue)はメールヘッダーを追加または更新します。EmlPackage.getAttachments()とEmlPackage.setAttachments(EmailAttachmentPackage[])により、EML の添付ファイルが編集可能になります。
MsgPackage には多数の新プロパティが追加されました。
- 編集可能:
Body,Categories,SenderName,DeliveryTime,ClientSubmitTime,Billing,BodyHtml,BodyRtf,ReplyTo,ReadReceiptRequested,SenderSmtpAddress,SentRepresentingEmailAddress,SentRepresentingName,Mileage,Attachments; - 読み取り専用:
InternetMessageId,ConversationTopic,DisplayBcc,DisplayCc,DisplayName,DisplayNamePrefix,DisplayTo,NormalizedSubject,SubjectPrefix,SenderAddressType,SentRepresentingAddressType,SentRepresentingSmtpAddress,TransportMessageHeaders, およびフラグisEncrypted(),isSigned()と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");
}
その他の強化
PDF ドキュメントのサニタイズ
Metadata.sanitize() は現在、PDF の添付ファイル、ブックマーク、フォームフィールド、デジタル署名も削除します。これにより、組織外へ共有する前に PDF をより徹底的にクリーンアップできます。
WordProcessing ドキュメント
WordProcessingPackage に 3 つのプロパティが追加され、読み取り・編集が可能になりました: HyperlinksChanged, ScaleCrop, SharedDoc.
タグ
Tags.getTime().getDelivery()はメッセージの配信時間を示します。Tags.getTool().getCompression()は ZIP、PNG、PSD ファイルの圧縮設定を示します。
これらのタグは Metadata.findProperties の ContainsTagSpecification と併用でき、既存のプロパティにもタグ付けが拡大されました。
修正
- CAD 図面のプレビューが空でした。
- RAR、7z、TAR アーカイブが MP3 ファイルとして認識されることがありました。
- AVIF 画像が MP3、MOV、HEIF ファイルとして認識されることがありました。
- 小規模な修正: 生タグの equals/hashCode の一貫性、null 安全な JSON インポート、サイズ演算のオーバーフロー、ZIP 圧縮後のストリームクローズ。
Aspose ライブラリを更新
バンドルされた Aspose ライブラリは以下に更新されました: 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、Aspose.ZIP 26.7。
アップデートの取得方法
Maven
pom.xml に GroupDocs リポジトリと依存関係を追加します。
<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>
直接ダウンロード
GroupDocs.Metadata for Java 26.11 ダウンロードページ から JAR をダウンロードしてください。