com.asakusafw.vocabulary.operator

Annotation Type Extract

@Target(value=METHOD)
 @Retention(value=RUNTIME)
 @Documented
public @interface Extract

抽出演算子を表すメソッドに付与する注釈。

この演算子は、入力されたデータから任意のデータを抽出し、それぞれ出力に流す。

一つのモデルオブジェクト型の引数と、 複数の結果オブジェクト型の引数を取り、 引数から抽出した任意のモデルオブジェクトを結果オブジェクトに出力を行うプログラムを記述する。

また、引数には同メソッドで宣言した型変数を利用できるが、 全ての結果オブジェクト型の出力に型変数を含める場合には、 入力に同様の型変数を指定してある必要がある。

この注釈を付与するメソッドは、一般的な演算子メソッドの要件の他に、 下記の要件をすべて満たす必要がある。

• 返戻型にvoidを指定する
• 以下の引数を宣言する
  • モデルオブジェクト型の引数
  • 一つ以上の結果型の引数
• 以下の修飾子を付与する
  • (特になし)
• 以下の修飾子は付与しない
  • abstract

例:

// スレッド安全なので抽出結果のオブジェクトは再利用可能
private final A a = new A();
private final B b = new B();

/**
 * レコードに含まれるそれぞれのフィールドを抽出し、出力する。
 * @param hoge 抽出対象のデータモデル
 * @param aResult aの抽出結果
 * @param bResult bの抽出結果
 */
@Extract
public void extractFields(
        Hoge hoge,
        Result<A> aResult,
        Result<B> bResult) {
    a.setValue(hoge.getA());
    aResult.add(a);
    b.setValue(hoge.getB0());
    bResult.add(b);
    b.setValue(hoge.getB1());
    bResult.add(b);
}

Since:

0.2.1

Field Detail

ID_INPUT

public static final int ID_INPUT

The input port number.