GroupDocs.Conversion for Javaでフォーマットを一覧表示し、すべての可能な変換を取得する方法

多くのドキュメント処理プロジェクトでは、最初のステップとして変換エンジンがサポートする list formats の方法を把握することが重要です。このチュートリアルでは、ステップバイステップで GroupDocs.Conversion for Java をクエリし、すべてのソース‑ターゲット ペアを取得し、その知識をクラウドストレージのファイル変換パイプラインに適用する方法を示します。最後まで読むと、完全な変換マトリックスを返す再利用可能なメソッドと、パフォーマンスやエラーハンドリングに関する実用的なヒントが得られます。

クイック回答

• “list formats”とは何ですか？ ライブラリが処理できるすべてのソース‑ターゲット変換ペアを返します。
• ライセンスは必要ですか？ 無料トライアルでテスト可能です。実稼働環境では有料ライセンスが必要です。
• クラウドストレージのファイル変換に役立ちますか？ はい。サポートされているフォーマットを把握することで、クラウドストレージパイプラインでの変換を自動化できます。
• 必要な Java バージョンは？ JDK 8 以降。
• この機能はスレッドセーフですか？ Converter インスタンスはスレッド間で再利用できますが、使用後はリソースを解放してください。

GroupDocs.Conversionにおける“list formats”とは何か

list formats 操作は、各ソースフォーマットとそれが変換可能なターゲットフォーマットの組み合わせを記述したコレクションを返します。このマトリックスはライブラリ内部の変換ルールから生成され、実行時に GroupDocs.Conversion の実際の機能に合わせて動的なワークフローを構築する際に不可欠です。

なぜ GroupDocs.Conversion for Java を使用するのか

GroupDocs.Conversion for Java は 200 以上の入力フォーマット と 200 以上の出力フォーマット をサポートし、DOCX や PPTX から PDF/A、画像形式まで網羅しています。サーバー上だけで完結するため、Microsoft Office や Adobe 製品は不要です。API はスレッドセーフで、数百ページのドキュメントも全体をメモリに読み込まずに処理でき、AWS S3、Azure Blob、Google Cloud Storage などのクラウドストレージサービスとシームレスに統合できます。

前提条件

• Java Development Kit (JDK): バージョン8以上。
• Maven: IDE（IntelliJ IDEA、Eclipse、NetBeans 等）で適切に設定してください。
• GroupDocs.Conversion for Java: Maven 依存関係として追加（下記参照）。

GroupDocs.Conversion for Java の設定

pom.xml に GroupDocs リポジトリと依存関係を追加します：

<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>

ライセンス取得

まずは無料トライアルで API を試してください。実稼働環境ではライセンスを購入するか、一時的な評価ライセンスをリクエストしてください。

基本的な初期化と設定

import com.groupdocs.conversion.Converter;

public class ConversionSetup {
    public static void main(String[] args) {
        // Initialize the Converter object
        Converter converter = new Converter();
        
        System.out.println("GroupDocs.Conversion for Java has been initialized successfully.");
    }
}

GroupDocs.Conversion for Java でフォーマットを一覧表示する方法

Converter は変換を実行し、フォーマット情報を提供するコアクラスです。getAllPossibleConversions() はサポートされているすべてのソース‑ターゲット変換ペアのリストを返します。ConversionInfo はソースとターゲットフォーマット間の単一変換マッピングを表します。

Converter エンジンをロードし、getAllPossibleConversions() を呼び出すだけで、許可されたすべてのソース‑ターゲットペアを記述した ConversionInfo オブジェクトのリストが取得できます。この単一呼び出しで、エクスポートオプションのドロップダウン構築、受信ファイルの検証、バッチマイグレーションスクリプトの設計が可能です。

初期化と変換取得

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.contracts.PossibleConversions;

public class GetAllPossibleConversionsFeature {
    public static void run() {
        // Initialize the Converter object
        Converter converter = new Converter();

可能な変換を列挙

// Retrieve all possible conversions supported by the library
for (PossibleConversions conversions : converter.getAllPossibleConversions()) {
    // Print source format description
    System.out.print(String.format("Source format: %s \n", conversions.getSource().getDescription()));

変換タイプの判定

// Iterate through each target conversion available for the source format
for (TargetConversion conversion : conversions.getAll()) {
    // Determine if it's a primary or secondary conversion and print details
    System.out.print(String.format("\t...can be converted to %s format as %s conversion.\n",
            conversion.getFormat(),
            conversion.isPrimary() ? "primary" : "secondary"));
}

完全な関数

import com.groupdocs.conversion.Converter;
import com.groupdocs.conversion.contracts.PossibleConversions;
import com.groupdocs.conversion.contracts.TargetConversion;

public class GetAllPossibleConversionsFeature {
    public static void run() {
        // Initialize the Converter object
        Converter converter = new Converter();

        // Retrieve all possible conversions supported by the library
        for (PossibleConversions conversions : converter.getAllPossibleConversions()) {
            // Print source format description
            System.out.print(String.format("Source format: %s \n", conversions.getSource().getDescription()));

            // Iterate through each target conversion available for the source format
            for (TargetConversion conversion : conversions.getAll()) {
                // Determine if it's a primary or secondary conversion and print details
                System.out.print(String.format("\t...can be converted to %s format as %s conversion.\n",
                        conversion.getFormat(),
                        conversion.isPrimary() ? "primary" : "secondary"));
            }
        }
    }
}

クラウドストレージファイル変換のユースケース

完全な変換マトリックスを把握しておくことは、クラウドストレージファイル変換 サービスを構築する際に特に有用です：

1. 動的フォーマット検出: ファイルがクラウドストレージにアップロードされた瞬間に、目的のターゲットフォーマットがサポートされているか即座に問い合わせ可能。
2. バッチマイグレーション: 大規模なドキュメントライブラリを統一フォーマット（例: PDF/A）に変換する際、サポートされているソースタイプを順に処理。
3. ユーザー主導のエクスポート: 現在のドキュメントがエクスポート可能なフォーマットだけをドロップダウンで提示し、エラーを減らし UX を向上。

パフォーマンス考慮事項

• リソース管理: 多数の短命コンバータを作成する場合は Converter インスタンスを破棄するか、try‑with‑resources を使用してください。
• バッチ処理: 複数ファイルを単一ジョブにまとめてオーバーヘッドを削減。
• キャッシュ: getAllPossibleConversions() の結果は実行時にほとんど変わらないため、頻繁に問い合わせる場合はキャッシュすると効果的です。

共通の問題と解決策

よくある質問

Q: GroupDocs.Conversion for Java とは何ですか？
A: 200 以上の入力フォーマットと 200 以上の出力フォーマットをサポートするサーバーサイドライブラリで、外部ソフトウェアなしで高速かつライセンスフリーなドキュメント変換を実現します。

Q: GroupDocs.Conversion の始め方は？
A: Maven プロジェクトを設定し、前述の依存関係を追加、ライセンスファイルをロードし、初期化セクションで示したように Converter クラスをインスタンス化してください。

Q: カスタムファイルタイプを変換できますか？
A: はい。API の拡張ポイントを利用してカスタムコンバータを登録したり、サードパーティハンドラをプラグインして独自フォーマットに対応できます。

Q: 変換実装時の一般的な落とし穴は？
A: Converter を閉じ忘れる、古い JAR を使用する、非常に大きな PDF のメモリ使用量を見落とす、などです。上記のリソース管理のヒントに従ってください。

Q: さらにサポートが必要な場合は？
A: 公式の documentation を参照するか、GroupDocs コミュニティフォーラムで質問してください。

Last Updated: 2026-07-29
Tested With: GroupDocs.Conversion 25.2 for Java
Author: GroupDocs

関連チュートリアル

• GroupDocs.Conversion for JavaでWordをPDFやその他のファイル形式に変換
• Word to PDF Java – 変更履歴の非表示と変換オプション
• GroupDocs を使用した Java の変換進行状況の追跡 – 完全ガイド