このチュートリアルでは、snakeyamlライブラリを使用してyamlファイルのリストオブジェクトをJavaクラスにマップしてJavaで効率的かつ正確にマップする方法について説明します。これは、YAMLに複雑なオブジェクトのリストが含まれている場合に、獨(dú)立したJava Pojoクラスを定義して、データ構(gòu)造の正しい解析と変換を確保する場合に、獨(dú)立したJava Pojoクラスを定義することにより、明確なマッピング関係を構(gòu)築する方法を強(qiáng)調(diào)しています。

1。snakeyamlの紹介と基本マッピング原則

Snakeyamlは、YAML形式でデータを解析および生成するための強(qiáng)力なJavaライブラリです。 YAML構(gòu)造をJavaオブジェクトにマッピングし、その逆も同様です。単純なキー価値のペアまたはネストされたオブジェクトの場合、senakeyamlマッピングは通常、直感的で実裝が簡単です。その中心的な原則は、フィールド名とJavaクラスの種類に基づいてYAMLファイルのキーと値を一致させることです。

たとえば、単純なYAML構(gòu)造：

名前：アリス
年齢：30

名前（文字列）と年齢（int）フィールドを含むJavaクラスに簡単にマッピングできます。

2。複雑なリストオブジェクトのマッピング：課題とソリューション

YAMLファイルにカスタムオブジェクトのリストが含まれている場合、Javaクラス構(gòu)造が適切に設(shè)計(jì)されていない場合、Snakeyamlは正しく解析されないため、データ損失または型変換エラーが発生します。初心者にとって一般的な問題は、リスト內(nèi)の複雑な要素ごとに獨(dú)立したJavaクラスを定義できないことです。

課題： TEST3と呼ばれるリストを含む次のYAML構(gòu)造を検討し、リスト內(nèi)の各要素はtestT1とtestT2を含むオブジェクトです。

テスト1：123
テスト2：「WQRE」
テスト3：
  -TESTT1：1
    testT2：「ASD」
  -TESTT1：2
    testt2：「qwe」
  -TESTT1：3
    testt2：「xyz」

test3をlist

解決策： Snakeyamlは、Javaクラスの構(gòu)造に依存して、その脫介入プロセスを?qū)Г蓼埂?YAMLのリストの場合、各要素が複雑なオブジェクトである場合、対応するPOJO（プレーンオールドJavaオブジェクト）クラスもJavaで定義する必要があります。次に、これらの要素を受信するために、メインクラスでタイプリストのフィールドを宣言する必要があります。

3.サンプルコードと詳細(xì)な分析

上記のYAML構(gòu)造を正しくマッピングするには、2つのJavaクラスを定義する必要があります。1つのメインクラスのuseryamlは、すべてのトップレベルフィールドとリストを含めるために、もう1つの補(bǔ)助クラスTest3をリスト內(nèi)の各要素の構(gòu)造を表す。

3.1 Javaクラスの定義

useryaml.java

 java.util.listをインポートします。

パブリッククラスのuseryaml {
    プライベート整數(shù)テスト1;
    プライベート文字列テスト2;
    プライベートリスト<test3> test3; //キー：リスト<test3>を使用してyamlのオブジェクトリストを表す//パラメーターのないコンストラクターはPojoの基本要件であり、snakeyamlはオブジェクトpublic useryaml（）{}をインスタンス化するためにそれを必要とします

    //ゲッターとセッター
    public Integer getTest1（）{
        return test1;
    }

    public void settest1（integer test1）{
        this.test1 = test1;
    }

    public string getTest2（）{
        return test2;
    }

    public void settest2（string test2）{
        this.test2 = test2;
    }

    public list <test3> getTest3（）{
        return test3;
    }

    public void settest3（list <test3> test3）{
        this.test3 = test3;
    }

    @オーバーライド
    public string toString（）{
        return "useryaml {"  
               "test1 =" test1  
               "、test2 = '" test2' \ ''  
               "、test3 =" test3  
               '}';
    }
}</test3></test3></test3></test3>

test3.java

パブリッククラスtest3 {
    プライベート整數(shù)testt1;
    プライベート文字列testt2;

    //パラメーターコンストラクターパブリックテスト3（）{}

    //ゲッターとセッター
    public Integer getTestt1（）{
        test1を返します。
    }

    public void settestt1（integer test1）{
        this.testt1 = testt1;
    }

    public string gettestt2（）{
        test2を返します。
    }

    public void settestt2（string testt2）{
        this.testt2 = testt2;
    }

    @オーバーライド
    public string toString（）{
        return "test3 {"  
               "testt1 =" testt1  
               "、testt2 = '" testt2' \ ''  
               '}';
    }
}

3.2 YAMLデータファイル（config.yaml）

上記のYAML構(gòu)造をconfig.yamlファイルとして保存します。

テスト1：123
テスト2：「WQRE」
テスト3：
  -TESTT1：1
    testT2：「ASD」
  -TESTT1：2
    testt2：「qwe」
  -TESTT1：3
    testt2：「xyz」

3.3 Javaの読み込みと解析コード

Import org.yaml.snakeyaml.yaml;
java.io.inputStreamをインポートします。
java.io.fileinputStreamをインポートします。
java.io.filenotfoundexceptionをインポートします。
java.util.listをインポートします。

パブリッククラスYamlreader {
    public static void main（string [] args）{
        yaml yaml = new Yaml（）;
        // config.yamlファイルがyamlreader.javaと同じディレクトリにあると仮定するか、classpathで試してください（inputstream inputstream = new fileinputStream（ "config.yaml"））{
            useryaml useryaml = yaml.loadas（inputstream、useryaml.class）;

            system.out.println（ "yaml構(gòu)成が正常に読み込まれました："）;
            System.out.println（useryaml）;

            //リストコンテンツを確認(rèn)する場合（useryaml.gettest3（）！= null &&！useryaml.gettest3（）。isempty（））{
                System.out.println（ "\ ntest3リストコンテンツ："）;
                for（test3 item：useryaml.gettest3（））{
                    System.out.println（ " - " item）;
                }
            }

        } catch（filenotfoundexception e）{
            system.err.println（ "エラー：yamlファイルが見つかりません！" config.yaml 'が正しいパスに存在することを確認(rèn)してください。 "）;
            e.printstacktrace（）;
        } catch（例外e）{
            system.err.println（ "yamlのロード中にエラーが発生しました：" e.getmessage（））;
            e.printstacktrace（）;
        }
    }
}

実行結(jié)果の例：

 YAML構(gòu)成は正常にロードされました：
useryaml {test1 = 123、test2 = 'wqre'、test3 = [testt1 = 1、testt2 = 'asd'}、test3 {testt1 = 2、testt2 = 'qwe'}、test3 {testt1 = 3、testt2 = 'xyz'}}}}

test3リストコンテンツ：
  -test3 {testt1 = 1、testt2 = 'asd'}
  -test3 {testt1 = 2、testt2 = 'qwe'}
  -test3 {testt1 = 3、testt2 = 'xyz'}

出力からわかるように、SnakeyamlはYAMLファイルのリスト構(gòu)造をタイプリストのJavaオブジェクトに脫必要にします。

4.予防策とベストプラクティス

• フィールド名マッチング： Javaクラスのフィールド名は、YAMLのキー名と一致する必要があります。 Snakeyamlはデフォルトで厳格なマッチングになります。名前が一貫していない場合、対応するフィールドは入力されません（デフォルト値またはnullを保持します）。
• Pojoの仕様： Javaクラスが、パラメーターのないコンストラクター、パブリックゲッター、セッターメソッドを含む標(biāo)準(zhǔn)的なPojoであることを確認(rèn)してください。 Snakeyamlは、これらに依存してオブジェクトをインスタンス化し、プロパティを設(shè)定します。
• YAMLインデント： YAMLの構(gòu)造は、インデントに完全に依存しています。正しいインデンテーションは、Snakeyamlが階層を正しく解析することを保証するための鍵です。リスト要素は通常、短い水平線（ - ）で始まり、親に適切にインデントされたままです。誤ったインデントは、解析エラーまたは予期しない構(gòu)造につながる可能性があります。
• ジェネリックサポート： Snakeyamlはジェネリックを適切にサポートしています。 snakeyamlがジェネリック情報(bào)（list のtest3など）を使用してネストされたオブジェクトを正しくインスタンス化できるように、loadasメソッドで正しいルートタイプ（useryaml.classなど）を提供することが重要です。
• エラー処理：ファイル障害、YAML形式のエラー（構(gòu)文エラー、タイプの不一致など）などの例外を常に考慮し、適切なキャプチャと処理を?qū)g行してプログラムの堅(jiān)牢性を高めます。
• アノテーション（オプション）： YAMLキー名がJavaフィールド名と一致しない場合、またはカスタムタイプのコンバーターが必要な場合など、より複雑なマッピングシナリオの場合、Snakeyaml（@yamlpropertyなど）が提供する注釈を使用するか、代表者/構(gòu)成要素を構(gòu)成できます。

5。概要

このチュートリアルを通じて、snakeyamlを使用してJavaのYAMLファイルのリストオブジェクトを効果的に処理する方法をより深く理解しています。コアポイントは、YAMLに複雑なオブジェクトのリストが含まれている場合、リスト內(nèi)の複雑な要素ごとに獨(dú)立したJava Pojoクラスを定義する必要があり、対応するフィールドをメインクラスのリストジェネリックタイプを使用して宣言する必要があることです。標(biāo)準(zhǔn)のPOJO仕様とYAMLインデンテーションルールに従って、Snakeyamlの強(qiáng)力な脫介入機(jī)能と組み合わせて、複雑なYAML構(gòu)造のJavaオブジェクトマッピングを簡単に実裝でき、それによりコードの読みやすさとメンテナンスを改善できます。

以上がJava Snakeyamlチュートリアル：YAMLのリストオブジェクトを正しくマッピングしますの詳細(xì)內(nèi)容です。詳細(xì)については、PHP 中國語 Web サイトの他の関連記事を參照してください。