このたび、GroupDocs.Parser for Java 26.10 を 2026年10月 にリリースいたしました。これは正確性に重点を置いたメンテナンスリリースです。テキスト検索がすべてのオーバーロードで再び機能し、ドキュメント構造の抽出がより多くの Word 文書に対応し、ファイル情報が暗号化状態を正確に報告し、PDF 画像座標が API の他の部分と一致するようになりました。ライセンスは GroupDocs.Foundation が処理し、同梱の Aspose コンポーネントも更新されました。
このリリースの新機能
| キー | 概要 | カテゴリ |
|---|---|---|
| PARSERJAVA-491 | Parser.search がページにスコープされていない検索で NullPointerException をスローしなくなりました |
修正 |
| PARSERJAVA-513 | Parser.getStructure() がヘッダーまたはフッターにテーブルを含む Word 文書でも動作し、整形式の XML を返すようになりました |
修正 |
| — | Parser.getFileInfo(String) がパスワード保護された DOCX、XLSX、PPTX ファイルを暗号化済みとして報告します |
修正 |
| — | FileInfo.isEncrypted() が暗号化された PDF 文書に対してのみ true を返します |
修正 |
| — | PDF 画像の矩形がページ上部から測定され、他のページ領域と同様になります | 修正 |
| PARSERJAVA-154 | ライセンスは GroupDocs.Foundation によって実行され、GroupDocs 製品で共有されているライセンスコアです | 更新 |
| PARSERJAVA-512 | 同梱の Aspose コンポーネントが更新されました | 更新 |
| PARSERJAVA-509 | 公開された POM: 製品名、短い説明、<url>、<organization> と <scm> が含まれます |
更新 |
アップグレード前に確認すべき動作変更
既存コードの挙動に影響する変更が 2 つあります。
- PDF 画像座標。 PDF 画像矩形の上座標がページ上部から測定されるようになりました。コードでページ下部から変換している場合は、その変換を削除してください。
- Word 文書の構造 XML。 Word 改行文字で区切られた単語が、構造 XML ではスペースで区切られるようになりました。
修正
ページにスコープされていないテキスト検索
バージョン 25.5 以降、ページにスコープされていないすべての Parser.search 呼び出しが NullPointerException をスローしていました。これは search(String keyword) のオーバーロード、search(String keyword, SearchOptions options) で searchByPages が false(デフォルト)に設定されている場合、ハイライトを要求する検索に影響しました。searchByPages が true に設定された検索は影響を受けませんでした。
26.10 ではこれらの呼び出しが再び検索結果を返すようになりました:
try (Parser parser = new Parser("sample.pdf")) {
Iterable<SearchResult> results = parser.search("lorem");
if (results == null) {
return; // Search isn't supported for this document
}
for (SearchResult result : results) {
System.out.println(result.getPosition() + ": " + result.getText());
}
}
Word 文書の構造
Parser.getStructure() は、ヘッダーまたはフッターにテーブルを含むワードプロセッシング文書で例外をスローし、文書テキストに制御文字が含まれると解析できない XML を返すことがありました。これらの問題は修正されました:
- ヘッダーとフッターのテーブルは論理グリッドで記述されます:テーブル内の行インデックス、行内のセルインデックス、そして 1 のスパンです;
- Word 改行文字(セル終了、垂直タブ、改ページ、列区切り)はスペースに変換され、区切られた単語が結合しなくなります;
- XML 1.0 が許可しない文字は除去されます;
- 属性値はテキストと同様にエスケープされます。
パスワード保護された文書のファイル情報
Parser.getFileInfo(String filePath) のオーバーロードは、パスワード保護された DOCX、XLSX、PPTX ファイルを認識できませんでした:DOCX と XLSX ではサイズが 0 で isEncrypted() が false、PPTX ではファイルタイプが返りませんでした。現在は InputStream のオーバーロードと同じ結果を返します:実際のファイルサイズ、isEncrypted() が true、そして FileType.Unknown(暗号化された文書の形式はパスワードなしでは読み取れません)。
これにより、保護されたファイルを検出し、パスワードで開くことが容易になります:
FileInfo info = Parser.getFileInfo("protected.docx");
if (info.isEncrypted()) {
LoadOptions options = new LoadOptions("password");
try (Parser parser = new Parser("protected.docx", options);
TextReader reader = parser.getText()) {
System.out.println(reader.readToEnd());
}
}
PDF 文書の暗号化
FileInfo.isEncrypted() は以前はすべての PDF 文書で true を返していましたが、現在は実際に暗号化されている PDF 文書に対してのみ true を返します。
PDF 画像の位置
Parser.getImages() が返す PDF 画像の矩形はページ下部から測定されていましたが、テキスト、テーブル、その他のページ領域は上部から測定されます。画像は現在、同じ上部基準の座標を使用するため、getImages(PageAreaOptions) は指定された矩形内の画像を取得します:
try (Parser parser = new Parser("images.pdf")) {
// Images in the top-left 400 x 400 points of each page
PageAreaOptions options = new PageAreaOptions(new Rectangle(new Point(0, 0), new Size(400, 400)));
for (PageImageArea image : parser.getImages(options)) {
System.out.println(image.getPage().getIndex() + ": " + image.getRectangle());
}
}
更新
GroupDocs.Foundation のライセンス
ライセンスの検証、従量課金ライセンス、および同梱の Aspose コンポーネントのライセンスは、GroupDocs.Foundation によって実行され、他の GroupDocs 製品と同じライセンスコアが使用されます。ライセンス API は変更されておらず、License.setLicense、Metered.setMeteredKey、Metered.getConsumptionQuantity、Metered.getConsumptionCredit は従来通り呼び出されます。
License license = new License();
license.setLicense("GroupDocs.Parser.Java.lic");
try (Parser parser = new Parser("document.docx");
TextReader reader = parser.getText()) {
System.out.println(reader.readToEnd());
}
同梱の Aspose コンポーネント
| コンポーネント | 26.9 | 26.10 |
|---|---|---|
| Aspose.Cells | 26.3 | 26.9 |
| Aspose.Email | 26.1 | 26.8 |
| Aspose.PDF | 26.2 | 26.8.1 |
| Aspose.Slides | 26.2 | 26.9 |
| Aspose.Words | 26.3 | 26.8 |
| Aspose.BarCode | 26.4 | 26.6 |
| Aspose.Imaging | 25.12 | 25.12 |
| Aspose.ZIP | 25.10 | 25.10 |
| Aspose.Note | 23.3 | 23.3 |
この製品は引き続き Java 8 上で動作します。
公開アーティファクトのメタデータ
公開された POM には、名前 GroupDocs.Parser for Java、ライブラリが抽出する内容と対応フォーマットの短い説明、製品ページとしての <url>、そして <organization> と <scm> が含まれます。これは MVNRepository などの依存関係インデックスが表示する情報です。コード、動作、API に変更はありません。
アップデートの取得方法
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-parser</artifactId>
<version>26.10</version>
</dependency>
</dependencies>
直接ダウンロード
GroupDocs.Parser for Java 26.10 ダウンロードページ から JAR をダウンロードしてください。