インターフェース AnnotationBuilder


  • public interface AnnotationBuilder
    指定された型のアノテーションのビルダー。想定される用途は次のとおりです。
    1. of(Class) または of(ClassInfo) を使用してビルダーを作成します。
    2. value() メソッドと member() メソッドを使用してアノテーションメンバーを定義します。
    3. build() を呼び出して AnnotationInfo を作成します。
    1 つのビルダーインスタンスを使用して複数のアノテーションを作成しないでください。

    デフォルト値を宣言するアノテーションメンバーを除き、指定されたアノテーション型のすべてのメンバーの値は、build() を呼び出す前に定義する必要があることに注意してください。デフォルト値を持たないアノテーションメンバーに値が定義されていない場合、build() は例外をスローします。

    特定のアノテーション型に存在しないメンバーの値を定義することは可能であり、そのようなメンバーは結果の AnnotationInfo に保持されます。ただし、その AnnotationInfo が後でアノテーション型のインスタンスに変換されると、存在しないメンバーは消えてしまいます。

    導入:
    4.0
    • メソッドの詳細

      • of

        static AnnotationBuilder of​(ClassSE<? extends AnnotationSE> annotationType)
        指定された型のアノテーションを作成する新しい AnnotationBuilder を返します。
        パラメーター:
        annotationType - アノテーション型。null であってはなりません
        戻り値:
        新しい AnnotationBuilder、決して null ではありません
      • of

        static AnnotationBuilder of​(ClassInfo annotationType)
        指定された型のアノテーションを作成する新しい AnnotationBuilder を返します。
        パラメーター:
        annotationType - アノテーション型。null であってはなりません
        戻り値:
        新しい AnnotationBuilder
      • value

        default AnnotationBuilder value​(AnnotationMember value)
        値が value である value というアノテーションメンバーを追加します。
        パラメーター:
        value - アノテーションメンバーの値
        戻り値:
        この AnnotationBuilder
      • value

        default AnnotationBuilder value​(boolean value)
        value というブール値のアノテーションメンバーを追加します。
        パラメーター:
        value - ブール値
        戻り値:
        この AnnotationBuilder
      • value

        default AnnotationBuilder value​(boolean[] values)
        value というブール配列値のアノテーションメンバーを追加します。
        パラメーター:
        values - ブール配列。null であってはなりません
        戻り値:
        この AnnotationBuilder
      • value

        default AnnotationBuilder value​(byte value)
        value というバイト値のアノテーションメンバーを追加します。
        パラメーター:
        value - バイト値
        戻り値:
        この AnnotationBuilder
      • value

        default AnnotationBuilder value​(byte[] values)
        value というバイト配列値のアノテーションメンバーを追加します。
        パラメーター:
        values - バイト配列。null であってはなりません
        戻り値:
        この AnnotationBuilder
      • value

        default AnnotationBuilder value​(short value)
        value という短い値のアノテーションメンバーを追加します。
        パラメーター:
        value - ショートバリュー
        戻り値:
        この AnnotationBuilder
      • value

        default AnnotationBuilder value​(short[] values)
        value という短い配列値アノテーションメンバーを追加します。
        パラメーター:
        values - 短い配列は null であってはなりません
        戻り値:
        この AnnotationBuilder
      • value

        default AnnotationBuilder value​(int value)
        value という int 値のアノテーションメンバーを追加します。
        パラメーター:
        value - int 値
        戻り値:
        この AnnotationBuilder
      • value

        default AnnotationBuilder value​(int[] values)
        value という int 配列値のアノテーションメンバーを追加します。
        パラメーター:
        values - int 配列。null であってはなりません
        戻り値:
        この AnnotationBuilder
      • value

        default AnnotationBuilder value​(long value)
        value という long-valued アノテーションメンバーを追加します。
        パラメーター:
        value - 長い値
        戻り値:
        この AnnotationBuilder
      • value

        default AnnotationBuilder value​(long[] values)
        value という長い配列値のアノテーションメンバーを追加します。
        パラメーター:
        values - 長い配列は null であってはなりません
        戻り値:
        この AnnotationBuilder
      • value

        default AnnotationBuilder value​(float value)
        value という float 値のアノテーションメンバーを追加します。
        パラメーター:
        value - フロート値
        戻り値:
        この AnnotationBuilder
      • value

        default AnnotationBuilder value​(float[] values)
        value という float 配列値アノテーションメンバーを追加します。
        パラメーター:
        values - float 配列。null であってはなりません
        戻り値:
        この AnnotationBuilder
      • value

        default AnnotationBuilder value​(double value)
        value という二重値のアノテーションメンバーを追加します。
        パラメーター:
        value - ダブル値
        戻り値:
        この AnnotationBuilder
      • value

        default AnnotationBuilder value​(double[] values)
        value という double 配列値のアノテーションメンバーを追加します。
        パラメーター:
        values - double 配列は null であってはなりません
        戻り値:
        この AnnotationBuilder
      • value

        default AnnotationBuilder value​(char value)
        value という char 値のアノテーションメンバーを追加します。
        パラメーター:
        value - 文字値
        戻り値:
        この AnnotationBuilder
      • value

        default AnnotationBuilder value​(char[] values)
        value という名前の char 配列値アノテーションメンバーを追加します。
        パラメーター:
        values - char 配列。null であってはなりません
        戻り値:
        この AnnotationBuilder
      • value

        default AnnotationBuilder value​(StringSE value)
        value という文字列値のアノテーションメンバーを追加します。
        パラメーター:
        value - 文字列値は null であってはなりません
        戻り値:
        この AnnotationBuilder
      • value

        default AnnotationBuilder value​(StringSE[] values)
        value という文字列配列値のアノテーションメンバーを追加します。
        パラメーター:
        values - String 配列。null または null を含むことはできません
        戻り値:
        この AnnotationBuilder
      • value

        default AnnotationBuilder value​(EnumSE<?> value)
        value という列挙型のアノテーションメンバーを追加します。
        パラメーター:
        value - enum 値は null であってはなりません
        戻り値:
        この AnnotationBuilder
      • value

        default AnnotationBuilder value​(EnumSE<?>[] values)
        value と呼ばれる列挙配列値アノテーションメンバーを追加します。
        パラメーター:
        values - enum 配列。null または null を含むことはできません
        戻り値:
        この AnnotationBuilder
      • value

        default AnnotationBuilder value​(ClassSE<? extends EnumSE<?>> enumType,
                                        StringSE enumValue)
        value という列挙型のアノテーションメンバーを追加します。
        パラメーター:
        enumType - enum 型。null であってはなりません
        enumValue - enum 定数の名前。null であってはなりません
        戻り値:
        この AnnotationBuilder
      • value

        default AnnotationBuilder value​(ClassSE<? extends EnumSE<?>> enumType,
                                        StringSE[] enumValues)
        value と呼ばれる列挙配列値アノテーションメンバーを追加します。
        パラメーター:
        enumType - enum 型。null であってはなりません
        enumValues - enum 定数の名前は、null または null を含むことはできません。
        戻り値:
        この AnnotationBuilder
      • value

        default AnnotationBuilder value​(ClassInfo enumType,
                                        StringSE enumValue)
        value という列挙型のアノテーションメンバーを追加します。
        パラメーター:
        enumType - enum 型。null であってはなりません
        enumValue - enum 定数の名前。null であってはなりません
        戻り値:
        この AnnotationBuilder
      • value

        default AnnotationBuilder value​(ClassInfo enumType,
                                        StringSE[] enumValues)
        value と呼ばれる列挙配列値アノテーションメンバーを追加します。
        パラメーター:
        enumType - enum 型。null であってはなりません
        enumValues - enum 定数の名前は、null または null を含むことはできません。
        戻り値:
        この AnnotationBuilder
      • value

        default AnnotationBuilder value​(ClassSE<?> value)
        value というクラス値のアノテーションメンバーを追加します。
        パラメーター:
        value - クラス値は null であってはなりません
        戻り値:
        この AnnotationBuilder
      • value

        default AnnotationBuilder value​(ClassSE<?>[] values)
        value というクラス配列値アノテーションメンバーを追加します。
        パラメーター:
        values - クラス配列。null または null を含むことはできません
        戻り値:
        この AnnotationBuilder
      • value

        default AnnotationBuilder value​(ClassInfo value)
        value というクラス値のアノテーションメンバーを追加します。
        パラメーター:
        value - クラス値は null であってはなりません
        戻り値:
        この AnnotationBuilder
      • value

        default AnnotationBuilder value​(ClassInfo[] values)
        value というクラス配列値アノテーションメンバーを追加します。
        パラメーター:
        values - クラス配列。null または null を含むことはできません
        戻り値:
        この AnnotationBuilder
      • value

        default AnnotationBuilder value​(Type[] values)
        value というクラスの配列値のアノテーションメンバーを追加します。values パラメーターには次のもののみを含めることができます。
        パラメーター:
        values - クラス配列。null または null を含むことはできません
        戻り値:
        この AnnotationBuilder
        例外:
        IllegalArgumentExceptionSE - 前述のように、指定された型が無効な場合
      • value

        default AnnotationBuilder value​(AnnotationInfo value)
        value というアノテーション値のアノテーションメンバーを追加します。
        パラメーター:
        value - アノテーション値は null であってはなりません
        戻り値:
        この AnnotationBuilder
      • value

        default AnnotationBuilder value​(AnnotationInfo[] values)
        value というアノテーション配列値のアノテーションメンバーを追加します。
        パラメーター:
        values - アノテーション配列。null または null を含むことはできません
        戻り値:
        この AnnotationBuilder
      • value

        default AnnotationBuilder value​(AnnotationSE value)
        value というアノテーション値のアノテーションメンバーを追加します。
        パラメーター:
        value - アノテーション値は null であってはなりません
        戻り値:
        この AnnotationBuilder
      • value

        default AnnotationBuilder value​(AnnotationSE[] values)
        value というアノテーション配列値のアノテーションメンバーを追加します。
        パラメーター:
        values - アノテーション配列。null または null を含むことはできません
        戻り値:
        この AnnotationBuilder
      • member

        AnnotationBuilder member​(StringSE name,
                                 AnnotationMember value)
        指定された name を持つアノテーションメンバーを追加し、その値は指定された value です。
        パラメーター:
        name - アノテーションメンバーの名前。null であってはなりません
        value - アノテーションメンバーの値は null であってはなりません
        戻り値:
        この AnnotationBuilder
      • member

        AnnotationBuilder member​(StringSE name,
                                 boolean value)
        指定された name を持つブール値のアノテーションメンバーを追加します。
        パラメーター:
        name - メンバー名は null であってはなりません
        value - ブール値
        戻り値:
        この AnnotationBuilder
      • member

        AnnotationBuilder member​(StringSE name,
                                 boolean[] values)
        指定された name を持つブール配列値のアノテーションメンバーを追加します。
        パラメーター:
        name - メンバー名は null であってはなりません
        values - ブール配列。null であってはなりません
        戻り値:
        この AnnotationBuilder
      • member

        AnnotationBuilder member​(StringSE name,
                                 byte value)
        指定された name を持つバイト値のアノテーションメンバーを追加します。
        パラメーター:
        name - メンバー名は null であってはなりません
        value - バイト値
        戻り値:
        この AnnotationBuilder
      • member

        AnnotationBuilder member​(StringSE name,
                                 byte[] values)
        指定された name を持つバイト配列値のアノテーションメンバーを追加します。
        パラメーター:
        name - メンバー名は null であってはなりません
        values - バイト配列。null であってはなりません
        戻り値:
        この AnnotationBuilder
      • member

        AnnotationBuilder member​(StringSE name,
                                 short value)
        指定された name を持つ短い値のアノテーションメンバーを追加します。
        パラメーター:
        name - メンバー名は null であってはなりません
        value - ショートバリュー
        戻り値:
        この AnnotationBuilder
      • member

        AnnotationBuilder member​(StringSE name,
                                 short[] values)
        指定された name を持つ短い配列値のアノテーションメンバーを追加します。
        パラメーター:
        name - メンバー名は null であってはなりません
        values - 短い配列は null であってはなりません
        戻り値:
        この AnnotationBuilder
      • member

        AnnotationBuilder member​(StringSE name,
                                 int value)
        指定された name を持つ int 値のアノテーションメンバーを追加します。
        パラメーター:
        name - メンバー名は null であってはなりません
        value - int 値
        戻り値:
        この AnnotationBuilder
      • member

        AnnotationBuilder member​(StringSE name,
                                 int[] values)
        指定された name を持つ int 配列値のアノテーションメンバーを追加します。
        パラメーター:
        name - メンバー名は null であってはなりません
        values - int 配列。null であってはなりません
        戻り値:
        この AnnotationBuilder
      • member

        AnnotationBuilder member​(StringSE name,
                                 long value)
        指定された name を持つ long-valued アノテーションメンバーを追加します。
        パラメーター:
        name - メンバー名は null であってはなりません
        value - 長い値
        戻り値:
        この AnnotationBuilder
      • member

        AnnotationBuilder member​(StringSE name,
                                 long[] values)
        指定された name を持つ長い配列値のアノテーションメンバーを追加します。
        パラメーター:
        name - メンバー名は null であってはなりません
        values - 長い配列は null であってはなりません
        戻り値:
        この AnnotationBuilder
      • member

        AnnotationBuilder member​(StringSE name,
                                 float value)
        指定された name を持つ float 値のアノテーションメンバーを追加します。
        パラメーター:
        name - メンバー名は null であってはなりません
        value - フロート値
        戻り値:
        この AnnotationBuilder
      • member

        AnnotationBuilder member​(StringSE name,
                                 float[] values)
        指定された name を持つ float 配列値アノテーションメンバーを追加します。
        パラメーター:
        name - メンバー名は null であってはなりません
        values - float 配列。null であってはなりません
        戻り値:
        この AnnotationBuilder
      • member

        AnnotationBuilder member​(StringSE name,
                                 double value)
        指定された name を持つ double 値のアノテーションメンバーを追加します。
        パラメーター:
        name - メンバー名は null であってはなりません
        value - ダブル値
        戻り値:
        この AnnotationBuilder
      • member

        AnnotationBuilder member​(StringSE name,
                                 double[] values)
        指定された name を持つ double 配列値のアノテーションメンバーを追加します。
        パラメーター:
        name - メンバー名は null であってはなりません
        values - double 配列は null であってはなりません
        戻り値:
        この AnnotationBuilder
      • member

        AnnotationBuilder member​(StringSE name,
                                 char value)
        指定された name を持つ char 値のアノテーションメンバーを追加します。
        パラメーター:
        name - メンバー名は null であってはなりません
        value - 文字値
        戻り値:
        この AnnotationBuilder
      • member

        AnnotationBuilder member​(StringSE name,
                                 char[] values)
        指定された name を持つ char 配列値のアノテーションメンバーを追加します。
        パラメーター:
        name - メンバー名は null であってはなりません
        values - char 配列。null であってはなりません
        戻り値:
        この AnnotationBuilder
      • member

        AnnotationBuilder member​(StringSE name,
                                 StringSE value)
        指定された name を持つ文字列値のアノテーションメンバーを追加します。
        パラメーター:
        name - メンバー名は null であってはなりません
        value - 文字列値は null であってはなりません
        戻り値:
        この AnnotationBuilder
      • member

        AnnotationBuilder member​(StringSE name,
                                 StringSE[] values)
        指定された name を持つ文字列配列値のアノテーションメンバーを追加します。
        パラメーター:
        name - メンバー名は null であってはなりません
        values - String 配列。null または null を含むことはできません
        戻り値:
        この AnnotationBuilder
      • member

        AnnotationBuilder member​(StringSE name,
                                 EnumSE<?> value)
        指定された name を持つ列挙型のアノテーションメンバーを追加します。
        パラメーター:
        name - メンバー名は null であってはなりません
        value - enum 値は null であってはなりません
        戻り値:
        この AnnotationBuilder
      • member

        AnnotationBuilder member​(StringSE name,
                                 EnumSE<?>[] values)
        指定された name を持つ enum 配列値のアノテーションメンバーを追加します。
        パラメーター:
        name - メンバー名は null であってはなりません
        values - enum 配列。null または null を含むことはできません
        戻り値:
        この AnnotationBuilder
      • member

        AnnotationBuilder member​(StringSE name,
                                 ClassSE<? extends EnumSE<?>> enumType,
                                 StringSE enumValue)
        指定された name を持つ列挙型のアノテーションメンバーを追加します。
        パラメーター:
        name - メンバー名は null であってはなりません
        enumType - enum 型。null であってはなりません
        enumValue - enum 定数の名前。null であってはなりません
        戻り値:
        この AnnotationBuilder
      • member

        AnnotationBuilder member​(StringSE name,
                                 ClassSE<? extends EnumSE<?>> enumType,
                                 StringSE[] enumValues)
        指定された name を持つ enum 配列値のアノテーションメンバーを追加します。
        パラメーター:
        name - メンバー名は null であってはなりません
        enumType - enum 型。null であってはなりません
        enumValues - enum 定数の名前は、null または null を含むことはできません。
        戻り値:
        この AnnotationBuilder
      • member

        AnnotationBuilder member​(StringSE name,
                                 ClassInfo enumType,
                                 StringSE enumValue)
        指定された name を持つ列挙型のアノテーションメンバーを追加します。
        パラメーター:
        name - メンバー名は null であってはなりません
        enumType - enum 型。null であってはなりません
        enumValue - enum 定数の名前。null であってはなりません
        戻り値:
        この AnnotationBuilder
      • member

        AnnotationBuilder member​(StringSE name,
                                 ClassInfo enumType,
                                 StringSE[] enumValues)
        指定された name を持つ enum 配列値のアノテーションメンバーを追加します。
        パラメーター:
        name - メンバー名は null であってはなりません
        enumType - enum 型。null であってはなりません
        enumValues - enum 定数の名前は、null または null を含むことはできません。
        戻り値:
        この AnnotationBuilder
      • member

        AnnotationBuilder member​(StringSE name,
                                 ClassSE<?> value)
        指定された name を持つクラス値のアノテーションメンバーを追加します。
        パラメーター:
        name - メンバー名は null であってはなりません
        value - クラス値は null であってはなりません
        戻り値:
        この AnnotationBuilder
      • member

        AnnotationBuilder member​(StringSE name,
                                 ClassSE<?>[] values)
        指定された name を持つクラス配列値アノテーションメンバーを追加します。
        パラメーター:
        name - メンバー名は null であってはなりません
        values - クラス配列。null または null を含むことはできません
        戻り値:
        この AnnotationBuilder
      • member

        AnnotationBuilder member​(StringSE name,
                                 ClassInfo value)
        指定された name を持つクラス値のアノテーションメンバーを追加します。
        パラメーター:
        name - メンバー名は null であってはなりません
        value - クラス値は null であってはなりません
        戻り値:
        この AnnotationBuilder
      • member

        AnnotationBuilder member​(StringSE name,
                                 ClassInfo[] values)
        指定された name を持つクラス配列値アノテーションメンバーを追加します。
        パラメーター:
        name - メンバー名は null であってはなりません
        values - クラス配列。null または null を含むことはできません
        戻り値:
        この AnnotationBuilder
      • member

        AnnotationBuilder member​(StringSE name,
                                 Type value)
        指定された name を持つクラス値アノテーションメンバーを追加します。value パラメーターは次のもののみ可能です。その他の値を指定すると例外が発生します。
        パラメーター:
        name - メンバー名は null であってはなりません
        value - クラス値は null であってはなりません
        戻り値:
        この AnnotationBuilder
        例外:
        IllegalArgumentExceptionSE - 上で説明したように、指定された型が無効な場合
      • member

        AnnotationBuilder member​(StringSE name,
                                 Type[] values)
        指定された name を持つクラス配列値アノテーションメンバーを追加します。values パラメーターには次のもののみを含めることができます。
        パラメーター:
        name - メンバー名は null であってはなりません
        values - クラス配列。null または null を含むことはできません
        戻り値:
        この AnnotationBuilder
        例外:
        IllegalArgumentExceptionSE - 前述のように、指定された型が無効な場合
      • member

        AnnotationBuilder member​(StringSE name,
                                 AnnotationInfo value)
        指定された name を持つアノテーション値のアノテーションメンバーを追加します。
        パラメーター:
        name - メンバー名は null であってはなりません
        value - アノテーション値は null であってはなりません
        戻り値:
        この AnnotationBuilder
      • member

        AnnotationBuilder member​(StringSE name,
                                 AnnotationInfo[] values)
        指定された name を持つアノテーション配列値のアノテーションメンバーを追加します。
        パラメーター:
        name - メンバー名は null であってはなりません
        values - アノテーション配列。null または null を含むことはできません
        戻り値:
        この AnnotationBuilder
      • member

        AnnotationBuilder member​(StringSE name,
                                 AnnotationSE value)
        指定された name を持つアノテーション値のアノテーションメンバーを追加します。
        パラメーター:
        name - メンバー名は null であってはなりません
        value - アノテーション値は null であってはなりません
        戻り値:
        この AnnotationBuilder
      • member

        AnnotationBuilder member​(StringSE name,
                                 AnnotationSE[] values)
        指定された name を持つアノテーション配列値のアノテーションメンバーを追加します。
        パラメーター:
        name - メンバー名は null であってはなりません
        values - アノテーション配列。null または null を含むことはできません
        戻り値:
        この AnnotationBuilder
      • build

        AnnotationInfo build()
        このビルダーの以前のメソッド呼び出しによって定義されたすべてのアノテーションメンバーを含む AnnotationInfo を返します。build() が呼び出された後、このビルダーインスタンスは破棄される必要があります。
        戻り値:
        構築された AnnotationInfonull ではない
        例外:
        IllegalStateExceptionSE - いくつかのアノテーションメンバーの値が設定されておらず、そのメンバーがデフォルト値を宣言していない場合