パッケージ org.springframework.core

クラス ResolvableType

java.lang.ObjectSE
org.springframework.core.ResolvableType
実装されたすべてのインターフェース:
SerializableSE
public class ResolvableType extends ObjectSE implements SerializableSE
Java TypeSE をカプセル化し、supertypes、interfaces、generic parameters へのアクセスを提供し、最終的に resolve から ClassSE への機能を提供します。

ResolvableType は、フィールド、メソッドパラメーター、メソッドの戻り型、またはクラスから取得できます。このクラスのほとんどのメソッドは、それ自体が ResolvableType を返し、簡単なナビゲーションを可能にします。例：

 private HashMap<Integer, List<String>> myMap;

 public void example() {
     ResolvableType t = ResolvableType.forField(getClass().getDeclaredField("myMap"));
     t.getSuperType(); // AbstractMap<Integer, List<String>>
     t.asMap(); // Map<Integer, List<String>>
     t.getGeneric(0).resolve(); // Integer
     t.getGeneric(1).resolve(); // List
     t.getGeneric(1); // List<String>
     t.resolveGeneric(1, 0); // String
 }
導入:
4.0
作成者:
Phillip Webb, Juergen Hoeller, Stephane Nicoll, Yanming Zhou
関連事項:

  • フィールドの詳細

    • NONE

      public static final ResolvableType NONE
      ResolvableType は、使用可能な値がない場合に返されます。NONE は null よりも優先的に使用されるため、複数のメソッド呼び出しを安全にチェーンできます。

  • メソッドの詳細

    • getType

      public TypeSE getType()
      管理されている下層の Java TypeSE を返します。

    • getRawClass

      @Nullable public ClassSE<?> getRawClass()
      管理されている基になる Java ClassSE を返します（利用可能な場合）。それ以外の場合は null。

    • getSource

      public ObjectSE getSource()
      解決可能な型の基になるソースを返します。ResolvableType の構築方法に応じて、FieldSE、MethodParameter、または TypeSE を返します。このメソッドは主に、代替 JVM 言語が提供する追加の型情報またはメタデータへのアクセスを提供することを目的としています。

    • toClass

      public ClassSE<?> toClass()
      この型を解決された Class として返し、特定のクラスを解決できない場合は ObjectSE にフォールバックします。
      戻り値:
      解決された ClassSE または Object フォールバック
      導入:
      5.1
      関連事項:

    • isInstance

      public boolean isInstance(@Nullable ObjectSE obj)
      指定されたオブジェクトがこの ResolvableType のインスタンスであるかどうかを判別します。
      パラメーター:
      obj - チェックするオブジェクト
      導入:
      4.2
      関連事項:

    • isAssignableFrom

      public boolean isAssignableFrom(ClassSE<?> other)
      この ResolvableType が指定された他の型から割り当て可能かどうかを判別します。
      パラメーター:
      other - チェックする型 (Class として)
      導入:
      4.2
      関連事項:

    • isAssignableFrom

      public boolean isAssignableFrom(ResolvableType other)
      この ResolvableType が指定された他の型から割り当て可能かどうかを判別します。

      resolved Class が指定された型の assignable fromSE であるかどうか、およびすべての generics が割り当て可能かどうかを考慮して、Java コンパイラーと同じ規則に従うことを試みます。

      パラメーター:
      other - チェックする型 (ResolvableType として)
      戻り値:
      指定された他の型をこの ResolvableType に割り当てることができる場合は true。それ以外の場合は false 

    • isAssignableFromResolvedPart

      public boolean isAssignableFromResolvedPart(ResolvableType other)
      他の型が実際に解決可能である限り、この ResolvableType が指定された他の型から割り当て可能かどうかを判断します。
      パラメーター:
      other - チェックする型 (ResolvableType として)
      戻り値:
      指定された他の型が解決可能な限りこの ResolvableType に割り当てることができる場合は true、それ以外の場合は false 
      導入:
      6.2

    • isArray

      public boolean isArray()
      この型が配列を表すクラスに解決される場合、true を返します。
      関連事項:

    • getComponentType

      public ResolvableType getComponentType()
      配列のコンポーネント型を表す ResolvableType を返します。この型が配列を表していない場合は NONE を返します。
      関連事項:

    • asCollection

      public ResolvableType asCollection()
      この型を解決可能な CollectionSE 型として返す簡易メソッド。

      この型が CollectionSE を実装または拡張しない場合、NONE を返します。

      関連事項:

    • asMap

      public ResolvableType asMap()
      この型を解決可能な MapSE 型として返す簡易メソッド。

      この型が MapSE を実装または拡張しない場合、NONE を返します。

      関連事項:

    • as

      public ResolvableType as(ClassSE<?> type)
      この型を、指定されたクラスの ResolvableType として返します。supertype および interface 階層を検索して一致するものを見つけます。この型が指定されたクラスを実装または拡張していない場合は、NONE を返します。
      パラメーター:
      type - 必要な型 (通常狭くなります)
      戻り値:
      このオブジェクトを指定された型として表す ResolvableType、またはその型として解決できない場合は NONE
      関連事項:

    • getSuperType

      public ResolvableType getSuperType()
      この型の直接のスーパー型を表す ResolvableType を返します。

      使用可能なスーパー型がない場合、このメソッドは NONE を返します。

      メモ: 結果の ResolvableType インスタンスは SerializableSE ではない可能性があります。

      関連事項:

    • getInterfaces

      public ResolvableType[] getInterfaces()
      この型によって実装された直接インターフェースを表す ResolvableType 配列を返します。この型がインターフェースを実装していない場合は、空の配列が返されます。

      メモ: 結果の ResolvableType インスタンスは SerializableSE ではない可能性があります。

      関連事項:

    • hasGenerics

      public boolean hasGenerics()
      この型にジェネリクスパラメーターが含まれている場合は true を返します。
      関連事項:

    • hasResolvableGenerics

      public boolean hasResolvableGenerics()
      この型に解決されたジェネリクス型が少なくとも 1 つ含まれている場合は、true を返します。つまり、型に解決できないジェネリクス型のみが含まれる場合、つまり宣言された型変数のいずれにも代わるものがない場合、false を返します。
      導入:
      6.2

    • hasUnresolvableGenerics

      public boolean hasUnresolvableGenerics()
      基になる型に解決できないジェネリクスがあるかどうかを判断します。型自体の解決できない型変数を使用するか、ジェネリクスインターフェースをそのままの方法で実装します。つまり、そのインターフェースの型変数を置き換えません。結果は、これらの 2 つのシナリオでのみ true になります。

    • getNested

      public ResolvableType getNested(int nestingLevel)
      指定されたネストレベルの ResolvableType を返します。

      詳細は getNested(int, Map) を参照してください。

      パラメーター:
      nestingLevel - 入れ子レベル
      戻り値:
      ResolvableType 型、または #NONE 型

    • getNested

      public ResolvableType getNested(int nestingLevel, @Nullable MapSE<IntegerSE,IntegerSE> typeIndexesPerLevel)
      指定されたネストレベルの ResolvableType を返します。

      ネストレベルは、返されるべき特定のジェネリクスパラメーターを指します。ネストレベルが 1 の場合はこの型、2 の場合は最初のネストされたジェネリクス、3 の場合は 2 番目のジェネリクスとなります。例: 与えられた List<Set<Integer>> のレベル 1 は List を、レベル 2 は Set を、レベル 3 は Integer を参照します。

      typeIndexesPerLevel マップは、特定のレベルの特定のジェネリクスを参照するために使用できます。例: インデックス 0 は Map キーを参照し、1 は値を参照します。マップに特定のレベルの値が含まれていない場合は、最後のジェネリクスが使用されます (たとえば、Map 値)。

      ネストレベルは、配列型にも適用されます。たとえば、String[] の場合、ネストレベル 2 は String を参照します。

      型が contain ジェネリクスでない場合、supertype 階層が考慮されます。

      パラメーター:
      nestingLevel - 現在の型の場合は 1、最初のネストされたジェネリクスの場合は 2、2 番目の場合は 3 というようにインデックスが付けられた、必要なネストレベル
      typeIndexesPerLevel - 指定されたネストレベルの汎用インデックスを含むマップ (null にすることができます)
      戻り値:
      ネストされたレベルの ResolvableType、または NONE

    • getGeneric

      public ResolvableType getGeneric(@Nullable int... indexes)
      指定されたインデックスのジェネリクスパラメーターを表す ResolvableType を返します。インデックスはゼロベースです。たとえば、型 Map<Integer, List<String>> の場合、getGeneric(0) は Integer にアクセスします。ネストされたジェネリクスには、複数のインデックスを指定してアクセスできます。たとえば、getGeneric(1, 0) はネストされた List から String にアクセスします。便宜上、インデックスが指定されていない場合は、最初のジェネリクスが返されます。

      指定されたインデックスで使用可能なジェネリクスがない場合、NONE が返されます。

      パラメーター:
      indexes - ジェネリクスパラメーターを参照するインデックス (最初のジェネリクスを返す場合は省略できます)
      戻り値:
      指定されたジェネリクスの ResolvableType、または NONE
      関連事項:

    • getGenerics

      public ResolvableType[] getGenerics()
      この型のジェネリクスパラメーターを表す ResolvableType ResolvableTypes の配列を返します。利用可能なジェネリクスがない場合は、空の配列が返されます。特定のジェネリクスにアクセスする必要がある場合は、ネストされたジェネリクスへのアクセスを許可し、IndexOutOfBoundsExceptions から保護するための getGeneric(int...) メソッドの使用を検討してください。
      戻り値:
      ジェネリクスパラメーターを表す ResolvableType ResolvableTypes の配列 (非 null)
      関連事項:

    • resolveGenerics

      public ClassSE<?>[] resolveGenerics()
      get および resolve ジェネリクスパラメーターになる簡易メソッド。
      戻り値:
      解決されたジェネリクスパラメーターの配列 (結果の配列が null になることはありませんが、null 要素が含まれる可能性があります。)
      関連事項:

    • resolveGenerics

      public ClassSE<?>[] resolveGenerics(ClassSE<?> fallback)
      型を解決できない場合に指定された fallback を使用して、get および resolve ジェネリクスパラメーターを処理する簡易メソッド。
      パラメーター:
      fallback - 解決が失敗した場合に使用するフォールバッククラス
      戻り値:
      解決されたジェネリクスパラメーターの配列
      関連事項:

    • resolveGeneric

      @Nullable public ClassSE<?> resolveGeneric(int... indexes)
      特定のジェネリクスパラメーターを get および resolve にする便利なメソッド。
      パラメーター:
      indexes - ジェネリクスパラメーターを参照するインデックス (最初のジェネリクスを返す場合は省略できます)
      戻り値:
      解決済みの ClassSE または null
      関連事項:

    • resolve

      @Nullable public ClassSE<?> resolve()
      この型を ClassSE に解決し、型を解決できない場合は null を返します。このメソッドは、直接解決が失敗した場合に TypeVariablesSE および WildcardTypesSE の境界を考慮します。ただし、Object.class の境界は無視されます。

      このメソッドが null 以外の Class を返し、hasGenerics() が false を返す場合、指定された型はプレーン Class を効果的にラップし、必要に応じてプレーン Class 処理を可能にします。

      戻り値:
      解決された ClassSE、または解決できない場合は null 
      関連事項:

    • resolve

      public ClassSE<?> resolve(ClassSE<?> fallback)
      この型を ClassSE に解決し、型を解決できない場合は指定された fallback を返します。このメソッドは、直接解決が失敗した場合に TypeVariablesSE および WildcardTypesSE の境界を考慮します。ただし、Object.class の境界は無視されます。
      パラメーター:
      fallback - 解決が失敗した場合に使用するフォールバッククラス
      戻り値:
      解決された ClassSE または fallback
      関連事項:

    • equals

      public boolean equals(@Nullable ObjectSE other)
      すべての型解決アーティファクト (型、TypeProvider および VariableResolver) が完全に等しいかどうかを確認します。
      オーバーライド:
      クラス ObjectSE の equalsSE 
      関連事項:

    • equalsType

      public boolean equalsType(ResolvableType otherType)
      別の ResolvableType と型レベルが等しいかどうかを確認します。

      equals(Object) や isAssignableFrom(ResolvableType) とは対照的に、これはメソッドパラメーターや戻り値の型など、異なるソース間でも機能します。

      パラメーター:
      otherType - 照合する ResolvableType 
      戻り値:
      宣言された型と型変数が一致するかどうか
      導入:
      6.1

    • hashCode

      public int hashCode()
      オーバーライド:
      クラス ObjectSE の hashCode 

    • toString

      public StringSE toString()
      この型の文字列表現を完全に解決された形式で返します（すべてのジェネリクスパラメーターを含む）。
      オーバーライド:
      クラス ObjectSE の toString 

    • forClass

      public static ResolvableType forClass(@Nullable ClassSE<?> clazz)
      割り当て可能性チェックのための完全なジェネリクス型情報を使用して、指定された ClassSE の ResolvableType を返します。

      次に例を示します: ResolvableType.forClass(MyArrayList.class).

      パラメーター:
      clazz - イントロスペクトするクラス (null は、ここでの典型的な使用例では、Object.class と意味的に同等です。)
      戻り値:
      指定されたクラスの ResolvableType 
      関連事項:

    • forRawClass

      public static ResolvableType forRawClass(@Nullable ClassSE<?> clazz)
      指定された ClassSE の ResolvableType を返し、生のクラスに対してのみ割り当て可能性チェックを実行します (これはラッパーとして機能する Class.isAssignableFrom(java.lang.Class<?>)SE に似ています)。

      次に例を示します: ResolvableType.forRawClass(List.class).

      パラメーター:
      clazz - イントロスペクトするクラス (null は、ここでの典型的な使用例では、Object.class と意味的に同等です。)
      戻り値:
      指定されたクラスの ResolvableType 
      導入:
      4.2
      関連事項:

    • forClass

      public static ResolvableType forClass(ClassSE<?> baseType, ClassSE<?> implementationClass)
      指定された実装クラスを使用して、指定された基本型 (インターフェースまたは基本クラス) の ResolvableType を返します。

      次に例を示します: ResolvableType.forClass(List.class, MyArrayList.class).

      パラメーター:
      baseType - 基本型 (null であってはなりません)
      implementationClass - 実装クラス
      戻り値:
      指定された実装クラスによってサポートされる指定された基本型の ResolvableType 
      関連事項:

    • forClassWithGenerics

      public static ResolvableType forClassWithGenerics(ClassSE<?> clazz, ClassSE<?>... generics)
      事前に宣言されたジェネリクスを使用して、指定された ClassSE の ResolvableType を返します。
      パラメーター:
      clazz - イントロスペクトするクラス（またはインターフェース）
      generics - クラスのジェネリクス
      戻り値:
      特定のクラスおよびジェネリクスの ResolvableType 
      関連事項:

    • forClassWithGenerics

      public static ResolvableType forClassWithGenerics(ClassSE<?> clazz, @Nullable ResolvableType... generics)
      事前に宣言されたジェネリクスを使用して、指定された ClassSE の ResolvableType を返します。
      パラメーター:
      clazz - イントロスペクトするクラス（またはインターフェース）
      generics - クラスのジェネリクス
      戻り値:
      特定のクラスおよびジェネリクスの ResolvableType 
      関連事項:

    • forInstance

      public static ResolvableType forInstance(@Nullable ObjectSE instance)
      指定されたインスタンスの ResolvableType を返します。このインスタンスは一般的な情報を伝えませんが、ResolvableTypeProvider を実装する場合は、Class instance に基づく単純な ResolvableType よりも正確な ResolvableType を使用できます。
      パラメーター:
      instance - インスタンス (おそらく null)
      戻り値:
      指定されたインスタンスの ResolvableType、または null の NONE 
      導入:
      4.2
      関連事項:

    • forField

      public static ResolvableType forField(FieldSE field)
      指定された FieldSE の ResolvableType を返します。
      パラメーター:
      field - ソースフィールド
      戻り値:
      指定されたフィールドの ResolvableType 
      関連事項:

    • forField

      public static ResolvableType forField(FieldSE field, ClassSE<?> implementationClass)
      指定された実装で指定された FieldSE の ResolvableType を返します。

      このバリアントは、フィールドを宣言するクラスに、実装クラスが満たすジェネリクスパラメーター変数が含まれている場合に使用します。

      パラメーター:
      field - ソースフィールド
      implementationClass - 実装クラス
      戻り値:
      指定されたフィールドの ResolvableType 
      関連事項:

    • forField

      public static ResolvableType forField(FieldSE field, @Nullable ResolvableType implementationType)
      指定された実装で指定された FieldSE の ResolvableType を返します。

      このバリアントは、フィールドを宣言するクラスに、実装型によって満たされるジェネリクスパラメーター変数が含まれている場合に使用します。

      パラメーター:
      field - ソースフィールド
      implementationType - 実装型
      戻り値:
      指定されたフィールドの ResolvableType 
      関連事項:

    • forField

      public static ResolvableType forField(FieldSE field, int nestingLevel)
      指定されたネストレベルで指定された FieldSE の ResolvableType を返します。
      パラメーター:
      field - ソースフィールド
      nestingLevel - 入れ子レベル (外部レベルの場合は 1。ネストされたジェネリクス型の場合は 2。等)
      関連事項:

    • forField

      public static ResolvableType forField(FieldSE field, int nestingLevel, @Nullable ClassSE<?> implementationClass)
      指定された実装と指定されたネストレベルで、指定された FieldSE の ResolvableType を返します。

      このバリアントは、フィールドを宣言するクラスに、実装クラスが満たすジェネリクスパラメーター変数が含まれている場合に使用します。

      パラメーター:
      field - ソースフィールド
      nestingLevel - 入れ子レベル (外部レベルの場合は 1。ネストされたジェネリクス型の場合は 2。等)
      implementationClass - 実装クラス
      戻り値:
      指定されたフィールドの ResolvableType 
      関連事項:

    • forConstructorParameter

      public static ResolvableType forConstructorParameter(ConstructorSE<?> constructor, int parameterIndex)
      指定された ConstructorSE パラメーターの ResolvableType を返します。
      パラメーター:
      constructor - ソースコンストラクター (null であってはなりません)
      parameterIndex - パラメーターインデックス
      戻り値:
      指定されたコンストラクターパラメーターの ResolvableType 
      関連事項:

    • forConstructorParameter

      public static ResolvableType forConstructorParameter(ConstructorSE<?> constructor, int parameterIndex, ClassSE<?> implementationClass)
      指定された実装で指定された ConstructorSE パラメーターの ResolvableType を返します。このバリアントは、コンストラクターを宣言するクラスに、実装クラスが満足するジェネリクスパラメーター変数が含まれている場合に使用します。
      パラメーター:
      constructor - ソースコンストラクター (null であってはなりません)
      parameterIndex - パラメーターインデックス
      implementationClass - 実装クラス
      戻り値:
      指定されたコンストラクターパラメーターの ResolvableType 
      関連事項:

    • forMethodReturnType

      public static ResolvableType forMethodReturnType(MethodSE method)
      指定された MethodSE 戻り値の型に対して ResolvableType を返します。
      パラメーター:
      method - メソッドの戻り値の型のソース
      戻り値:
      指定されたメソッドの ResolvableType を返す
      関連事項:

    • forMethodReturnType

      public static ResolvableType forMethodReturnType(MethodSE method, ClassSE<?> implementationClass)
      指定された MethodSE 戻り値の型に対して ResolvableType を返します。

      メソッドを宣言するクラスに、実装クラスが満たすジェネリクスパラメーター変数が含まれている場合は、このバリアントを使用します。

      パラメーター:
      method - メソッドの戻り値の型のソース
      implementationClass - 実装クラス
      戻り値:
      指定されたメソッドの ResolvableType を返す
      関連事項:

    • forMethodParameter

      public static ResolvableType forMethodParameter(MethodSE method, int parameterIndex)
      指定された MethodSE パラメーターの ResolvableType を返します。
      パラメーター:
      method - ソースメソッド (null であってはなりません)
      parameterIndex - パラメーターインデックス
      戻り値:
      指定されたメソッドパラメーターの ResolvableType 
      関連事項:

    • forMethodParameter

      public static ResolvableType forMethodParameter(MethodSE method, int parameterIndex, ClassSE<?> implementationClass)
      指定された実装で指定された MethodSE パラメーターの ResolvableType を返します。このバリアントは、メソッドを宣言するクラスに、実装クラスが満足するジェネリクスパラメーター変数が含まれている場合に使用します。
      パラメーター:
      method - ソースメソッド (null であってはなりません)
      parameterIndex - パラメーターインデックス
      implementationClass - 実装クラス
      戻り値:
      指定されたメソッドパラメーターの ResolvableType 
      関連事項:

    • forMethodParameter

      public static ResolvableType forMethodParameter(MethodParameter methodParameter)
      指定された MethodParameter の ResolvableType を返します。
      パラメーター:
      methodParameter - ソースメソッドパラメーター (null であってはなりません)
      戻り値:
      指定されたメソッドパラメーターの ResolvableType 
      関連事項:

    • forMethodParameter

      public static ResolvableType forMethodParameter(MethodParameter methodParameter, @Nullable ResolvableType implementationType)
      指定された実装型を持つ指定された MethodParameter の ResolvableType を返します。このバリアントは、メソッドを宣言するクラスに、実装型によって満たされるジェネリクスパラメーター変数が含まれる場合に使用します。
      パラメーター:
      methodParameter - ソースメソッドパラメーター (null であってはなりません)
      implementationType - 実装型
      戻り値:
      指定されたメソッドパラメーターの ResolvableType 
      関連事項:

    • forMethodParameter

      public static ResolvableType forMethodParameter(MethodParameter methodParameter, @Nullable TypeSE targetType)
      指定された MethodParameter の ResolvableType を返し、ターゲットの型をオーバーライドして、特定の指定された型で解決します。
      パラメーター:
      methodParameter - ソースメソッドパラメーター (null であってはなりません)
      targetType - 解決する型 (メソッドパラメーターの型の一部)
      戻り値:
      指定されたメソッドパラメーターの ResolvableType 
      関連事項:

    • forArrayComponent

      public static ResolvableType forArrayComponent(ResolvableType componentType)
      指定された componentType の配列として ResolvableType を返します。
      パラメーター:
      componentType - コンポーネント型
      戻り値:
      指定されたコンポーネント型の配列としての ResolvableType 

    • forType

      public static ResolvableType forType(@Nullable TypeSE type)
      指定された TypeSE の ResolvableType を返します。

      メモ: 結果の ResolvableType インスタンスは SerializableSE ではない可能性があります。

      パラメーター:
      type - ソース型 (潜在的に null)
      戻り値:
      指定された TypeSE の ResolvableType 
      関連事項:

    • forType

      public static ResolvableType forType(@Nullable TypeSE type, @Nullable ResolvableType owner)
      指定された所有者型に基づいて指定された TypeSE の ResolvableType を返します。

      メモ: 結果の ResolvableType インスタンスは SerializableSE ではない可能性があります。

      パラメーター:
      type - ソース型または null
      owner - 変数の解決に使用される所有者型
      戻り値:
      指定された TypeSE および所有者の ResolvableType 
      関連事項:

    • forType

      public static ResolvableType forType(ParameterizedTypeReference<?> typeReference)
      指定された ParameterizedTypeReference の ResolvableType を返します。

      メモ: 結果の ResolvableType インスタンスは SerializableSE ではない可能性があります。

      パラメーター:
      typeReference - ソース型を取得するための参照
      戻り値:
      指定された ParameterizedTypeReference の ResolvableType 
      導入:
      4.3.12
      関連事項:

    • clearCache

      public static void clearCache()
      内部 ResolvableType/SerializableTypeWrapper キャッシュをクリアします。
      導入:
      4.2