11. DMDLのコンパイル¶

11.1.1. データモデルクラスのアクセサメソッド¶

各データモデルクラスには、データモデルに定義したプロパティを操作するためのアクセサメソッドが作成されます。

• get <プロパティ名>
• set <プロパティ名>
• get <プロパティ名> Option
• set <プロパティ名> Option
• get <プロパティ名> AsString ( TEXT 型のプロパティのみ )
• set <プロパティ名> AsString ( TEXT 型のプロパティのみ )

各メソッドは、DMDLスクリプトで定義したプロパティ名を、CamelCaseの形式に変換したメソッド名で生成されます。 例えば、 sales_detail のプロパティ store_code に対しては、以下のメソッドが作成されます。

• public Text getStoreCode()
• public void setStoreCode(Text)
• public StringOption getStoreCodeOption()
• public void setStoreCodeOption(StringOption)
• public String getStoreCodeAsString()
• public void setStoreCodeAsString(String)

11.1.2. null値の扱いとOptionメソッド¶

メソッド名の末尾が ...Option となっているメソッドは、 Option クラス型のオブジェクトに対して操作を行うためのメソッドです。これは主に null 値を扱うために利用します。

例えば、値が null のプロパティに対して get <プロパティ名> で値を取得しようとすると NullPointerException が発生します。 一方、 get <プロパティ名> Option を使うとデータ型に対応した Option クラス型のオブジェクトが返却されます。このオブジェクトに対して null に対するチェックなどの操作を行うことができます。

例えば sales_detail ( データモデルクラス SalesDetail ) のプロパティ store_code に対して、StringOption を使った操作は以下のようになります。

private void example(SalesDetail salesDetail) {

    StringOption stringOption = salesDetail.getStoreCodeOption();
    // isNull メソッドを使って nullチェック
    boolean result = stringOption.isNull();

    // or メソッドを使って nullの場合に空文字を返す
    String storeCode = salesDetail.getStoreCodeOption().or("");
}

DMDLスクリプトに定義したプロパティの型と、データモデルクラスで扱うJavaのデータ型は、以下のように対応します。

11.1.3. 文字列の扱いとAsStringメソッド¶

TEXT 型のプロパティに対して、 通常の get <プロパティ名> や set <プロパティ名> で扱うJavaのデータ型はHadoopが提供する org.apache.hadoop.io.Text クラス型です。 Javaの String 型として扱う場合には、 get <プロパティ名> AsString や set <プロパティ名> AsString を使います。

private void example(SalesDetail salesDetail) {

    // 通常の getter は 内部で保持する Hadoopの org.apache.hadoop.io.Text をそのまま返す
    Text storeCodeAsText = salesDetail.getStoreCode();

    // getXXAsString は String型に変換して返す
    String storeCodeAsString = salesDetail.getStoreCodeAsString();

    // StringOptionでは get は Text型、 getAsString は String型を返す
    StringOption stringOption = salesDetail.getStoreCodeOption();
    if (stringOption.isNull() == false) {
        Text text = stringOption.get()
        String str = stringOption.getAsString();
    }
}