コンストラクターの詳細

• BeanUtils

  public BeanUtils()

メソッドの詳細

• instantiate

  @Deprecated
  public static <T> T instantiate(java.lang.Class<T> clazz)
                                       throws BeanInstantiationException

  非推奨。JDK 9 での Class.newInstance() の廃止に伴い、Spring 5.0 以降
  引数なしのコンストラクターを使用してクラスをインスタンス化する便利なメソッド。

  パラメーター:

  clazz - インスタンス化するクラス

  戻り値:

  新しいインスタンス

  例外:

  BeanInstantiationException - Bean をインスタンス化できない場合

  関連事項:

  Class.newInstance()

• instantiateClass

  public static <T> T instantiateClass(java.lang.Class<T> clazz)
                                throws BeanInstantiationException

  "primary" コンストラクター（Kotlin クラスの場合、デフォルト引数が宣言されている可能性がある）またはデフォルトコンストラクター（通常の Java クラスの場合、標準の引数なしのセットアップが必要）を使用してクラスをインスタンス化します。

  このメソッドは、アクセスできない（つまり、非パブリック）コンストラクターが指定された場合、コンストラクターをアクセス可能に設定しようとすることに注意してください。

  パラメーター:

  clazz - インスタンス化するクラス

  戻り値:

  新しいインスタンス

  例外:

  BeanInstantiationException - Bean をインスタンス化できない場合。原因は、プライマリ / デフォルトコンストラクターが見つからなかった場合の NoSuchMethodException、解決できないクラス定義の場合の NoClassDefFoundError または他の LinkageError （たとえば、実行時の依存関係の欠落による）、コンストラクターの呼び出し自体からスローされた例外を顕著に示す可能性があります。

  関連事項:

  Constructor.newInstance(java.lang.Object...)

• instantiateClass

  public static <T> T instantiateClass(java.lang.Class<?> clazz,
                                       java.lang.Class<T> assignableTo)
                                throws BeanInstantiationException

  引数なしのコンストラクターを使用してクラスをインスタンス化し、指定された割り当て可能な型として新しいインスタンスを返します。

  インスタンス化するクラスの型 (clazz) が利用できないが、必要な型 (assignableTo) がわかっている場合に便利です。

  このメソッドは、アクセスできない（つまり、非パブリック）コンストラクターが指定された場合、コンストラクターをアクセス可能に設定しようとすることに注意してください。

  パラメーター:

  clazz - インスタンス化するクラス

  assignableTo - clazz は assignableTo でなければならないと入力してください

  戻り値:

  新しいインスタンス

  例外:

  BeanInstantiationException - Bean をインスタンス化できない場合

  関連事項:

  Constructor.newInstance(java.lang.Object...)

• instantiateClass

  public static <T> T instantiateClass(java.lang.reflect.Constructor<T> ctor,
                                       java.lang.Object... args)
                                throws BeanInstantiationException

  指定されたコンストラクターを使用してクラスをインスタンス化する便利なメソッド。

  このメソッドは、アクセスできない（つまり、非パブリック）コンストラクターが指定された場合、コンストラクターをアクセス可能に設定しようとし、オプションのパラメーターとデフォルト値を持つ Kotlin クラスをサポートすることに注意してください。

  パラメーター:

  ctor - インスタンス化するコンストラクター

  args - 適用するコンストラクター引数 (オプションのパラメーターとデフォルト値を持つ Kotlin クラスに必要な場合、指定されていないパラメーターに null を使用します)

  戻り値:

  新しいインスタンス

  例外:

  BeanInstantiationException - Bean をインスタンス化できない場合

  関連事項:

  Constructor.newInstance(java.lang.Object...)

• findPrimaryConstructor

  @Nullable
  public static <T> java.lang.reflect.Constructor<T> findPrimaryConstructor(java.lang.Class<T> clazz)

  指定されたクラスのプライマリコンストラクターを返します。Kotlin クラスの場合、これは Kotlin プライマリコンストラクター（Kotlin 仕様で定義されている）に対応する Java コンストラクターを返します。それ以外の場合、特に非 Kotlin クラスの場合、これは単に null を返します。

  パラメーター:

  clazz - チェックするクラス

  導入:

  5.0

  関連事項:

  Kotlin ドキュメント

• findMethod

  @Nullable
  public static java.lang.reflect.Method findMethod(java.lang.Class<?> clazz,
                                                              java.lang.String methodName,
                                                              java.lang.Class<?>... paramTypes)

  指定されたクラスまたはそのスーパークラスの 1 つで宣言された、指定されたメソッド名と指定されたパラメーター型を持つメソッドを検索します。public メソッドを優先しますが、保護された、パッケージアクセス、プライベートメソッドも返します。

  Class.getMethod を最初にチェックし、findDeclaredMethod にフォールバックします。これにより、Java セキュリティ設定が制限されている環境でも課題なく public メソッドを見つけることができます。

  パラメーター:

  clazz - チェックするクラス

  methodName - 検索するメソッドの名前

  paramTypes - 検索するメソッドのパラメーター型

  戻り値:

  Method オブジェクト。見つからない場合は null 

  関連事項:

  Class.getMethod(java.lang.String, java.lang.Class<?>...), findDeclaredMethod(java.lang.Class<?>, java.lang.String, java.lang.Class<?>...)

• findDeclaredMethod

  @Nullable
  public static java.lang.reflect.Method findDeclaredMethod(java.lang.Class<?> clazz,
                                                                      java.lang.String methodName,
                                                                      java.lang.Class<?>... paramTypes)

  指定されたクラスまたはそのスーパークラスの 1 つで宣言された、指定されたメソッド名と指定されたパラメーター型を持つメソッドを検索します。パブリック、保護、パッケージアクセス、プライベートメソッドを返します。

  Class.getDeclaredMethod をチェックし、すべてのスーパークラスに上向きにカスケードします。

  パラメーター:

  clazz - チェックするクラス

  methodName - 検索するメソッドの名前

  paramTypes - 検索するメソッドのパラメーター型

  戻り値:

  Method オブジェクト。見つからない場合は null 

  関連事項:

  Class.getDeclaredMethod(java.lang.String, java.lang.Class<?>...)

• findMethodWithMinimalParameters

  @Nullable
  public static java.lang.reflect.Method findMethodWithMinimalParameters(java.lang.Class<?> clazz,
                                                                                   java.lang.String methodName)
                                                                            throws java.lang.IllegalArgumentException

  指定されたクラスまたはそのスーパークラスの 1 つで宣言された、指定されたメソッド名と最小パラメーター（最良の場合: なし）を持つメソッドを見つけます。public メソッドを優先しますが、保護された、パッケージアクセス、プライベートメソッドも返します。

  Class.getMethods を最初にチェックし、findDeclaredMethodWithMinimalParameters にフォールバックします。これにより、Java セキュリティ設定が制限されている環境でも、課題なく public メソッドを見つけることができます。

  パラメーター:

  clazz - チェックするクラス

  methodName - 検索するメソッドの名前

  戻り値:

  Method オブジェクト。見つからない場合は null 

  例外:

  java.lang.IllegalArgumentException - 指定された名前のメソッドは見つかったが、最小限のパラメーターで一意のメソッドに解決できなかった場合

  関連事項:

  Class.getMethods(), findDeclaredMethodWithMinimalParameters(java.lang.Class<?>, java.lang.String)

• findDeclaredMethodWithMinimalParameters

  @Nullable
  public static java.lang.reflect.Method findDeclaredMethodWithMinimalParameters(java.lang.Class<?> clazz,
                                                                                           java.lang.String methodName)
                                                                                    throws java.lang.IllegalArgumentException

  指定されたクラスまたはそのスーパークラスの 1 つで宣言された、指定されたメソッド名と最小パラメーター（最良の場合: なし）を持つメソッドを見つけます。パブリック、保護、パッケージアクセス、プライベートメソッドを返します。

  Class.getDeclaredMethods をチェックし、すべてのスーパークラスに上向きにカスケードします。

  パラメーター:

  clazz - チェックするクラス

  methodName - 検索するメソッドの名前

  戻り値:

  Method オブジェクト。見つからない場合は null 

  例外:

  java.lang.IllegalArgumentException - 指定された名前のメソッドは見つかったが、最小限のパラメーターで一意のメソッドに解決できなかった場合

  関連事項:

  Class.getDeclaredMethods()

• findMethodWithMinimalParameters

  @Nullable
  public static java.lang.reflect.Method findMethodWithMinimalParameters(java.lang.reflect.Method[] methods,
                                                                                   java.lang.String methodName)
                                                                            throws java.lang.IllegalArgumentException

  指定されたメソッドのリストで、指定されたメソッド名と最小パラメーター（最良の場合: なし）を持つメソッドを見つけます。

  パラメーター:

  methods - チェックするメソッド

  methodName - 検索するメソッドの名前

  戻り値:

  Method オブジェクト。見つからない場合は null 

  例外:

  java.lang.IllegalArgumentException - 指定された名前のメソッドは見つかったが、最小限のパラメーターで一意のメソッドに解決できなかった場合

• resolveSignature

  @Nullable
  public static java.lang.reflect.Method resolveSignature(java.lang.String signature,
                                                                    java.lang.Class<?> clazz)

  methodName[([arg_list])] の形式でメソッドシグネチャーを解析します。arg_list はオプションの完全修飾型名のコンマ区切りリストで、指定された Class に対してそのシグネチャーを解決しようとします。

  引数リスト（methodName）を指定しない場合、名前が一致し、パラメーターの数が最も少ないメソッドが返されます。引数の型のリストを指定すると、名前と引数の型が一致するメソッドのみが返されます。

  methodName と methodName() は同じ方法で解決されないことに注意してください。署名 methodName は、引数の数が最も少ない methodName と呼ばれるメソッドを意味しますが、methodName() は、引数が正確に 0 の methodName と呼ばれるメソッドを意味します。

  メソッドが見つからない場合、null が返されます。

  パラメーター:

  signature - 文字列表現としてのメソッドシグネチャー

  clazz - メソッドシグネチャーを解決するクラス

  戻り値:

  解決されたメソッド

  関連事項:

  findMethod(java.lang.Class<?>, java.lang.String, java.lang.Class<?>...), findMethodWithMinimalParameters(java.lang.Class<?>, java.lang.String)

• getPropertyDescriptors

  public static java.beans.PropertyDescriptor[] getPropertyDescriptors(java.lang.Class<?> clazz)
                                                                throws BeansException

  指定されたクラスの JavaBeans PropertyDescriptor を取得します。

  パラメーター:

  clazz - PropertyDescriptors を取得するクラス

  戻り値:

  指定されたクラスの PropertyDescriptors の配列

  例外:

  BeansException - PropertyDescriptor の外観が失敗した場合

• getPropertyDescriptor

  @Nullable
  public static java.beans.PropertyDescriptor getPropertyDescriptor(java.lang.Class<?> clazz,
                                                                              java.lang.String propertyName)
                                                                       throws BeansException

  指定されたプロパティの JavaBeans PropertyDescriptors を取得します。

  パラメーター:

  clazz - PropertyDescriptor を取得するクラス

  propertyName - プロパティの名前

  戻り値:

  対応する PropertyDescriptor、または存在しない場合は null 

  例外:

  BeansException - PropertyDescriptor ルックアップが失敗した場合

• findPropertyForMethod

  @Nullable
  public static java.beans.PropertyDescriptor findPropertyForMethod(java.lang.reflect.Method method)
                                                                       throws BeansException

  指定されたメソッドの JavaBeans PropertyDescriptor を検索します。メソッドは、その Bean プロパティの読み取りメソッドまたは書き込みメソッドのいずれかです。

  パラメーター:

  method - 対応する PropertyDescriptor を見つけるメソッド、その宣言クラスをイントロスペクトする

  戻り値:

  対応する PropertyDescriptor、または存在しない場合は null 

  例外:

  BeansException - PropertyDescriptor ルックアップが失敗した場合

• findPropertyForMethod

  @Nullable
  public static java.beans.PropertyDescriptor findPropertyForMethod(java.lang.reflect.Method method,
                                                                              java.lang.Class<?> clazz)
                                                                       throws BeansException

  指定されたメソッドの JavaBeans PropertyDescriptor を検索します。メソッドは、その Bean プロパティの読み取りメソッドまたは書き込みメソッドのいずれかです。

  パラメーター:

  method - 対応する PropertyDescriptor を見つける方法

  clazz - 記述子をイントロスペクトする（最も具体的な）クラス

  戻り値:

  対応する PropertyDescriptor、または存在しない場合は null 

  例外:

  BeansException - PropertyDescriptor ルックアップが失敗した場合

  導入:

  3.2.13

• findEditorByConvention

  @Nullable
  public static java.beans.PropertyEditor findEditorByConvention(@Nullable
                                                                           java.lang.Class<?> targetType)

  'Editor' サフィックス規則に従って JavaBeans PropertyEditor を見つけます（例: "mypackage.MyDomainClass" -> "mypackage.MyDomainClassEditor" ）。

  PropertyEditorManager によって実装される標準 JavaBeans 規則と互換性がありますが、プリミティブ型の後者の登録済みデフォルトエディターからは分離されています。

  パラメーター:

  targetType - エディターを見つけるための型

  戻り値:

  対応するエディター。見つからない場合は null 

• findPropertyType

  public static java.lang.Class<?> findPropertyType(java.lang.String propertyName,
                                                    @Nullable
                                                    java.lang.Class<?>... beanClasses)

  可能な場合、指定されたクラス / インターフェースから指定されたプロパティの Bean プロパティ型を決定します。

  パラメーター:

  propertyName - Bean プロパティの名前

  beanClasses - チェックするクラス

  戻り値:

  プロパティ型、またはフォールバックとしての Object.class 

• getWriteMethodParameter

  public static MethodParameter getWriteMethodParameter(java.beans.PropertyDescriptor pd)

  指定されたプロパティの書き込みメソッドの新しい MethodParameter オブジェクトを取得します。

  パラメーター:

  pd - プロパティの PropertyDescriptor

  戻り値:

  対応する MethodParameter オブジェクト

• isSimpleProperty

  public static boolean isSimpleProperty(java.lang.Class<?> clazz)

  指定された型が「単純な」プロパティを表すかどうかを確認します: プリミティブ、ストリングまたは他の CharSequence、数値、日付、URI、URL、ロケール、クラス、対応する配列。

  「単純な」依存関係チェックをチェックするためのプロパティを決定するために使用されます。

  パラメーター:

  clazz - チェックする型

  戻り値:

  指定された型が「単純な」プロパティを表すかどうか

  関連事項:

  AbstractBeanDefinition.DEPENDENCY_CHECK_SIMPLE, AbstractAutowireCapableBeanFactory.checkDependencies(java.lang.String, org.springframework.beans.factory.support.AbstractBeanDefinition, java.beans.PropertyDescriptor[], org.springframework.beans.PropertyValues)

• isSimpleValueType

  public static boolean isSimpleValueType(java.lang.Class<?> clazz)

  指定された型が「単純な」値型を表すかどうかを確認します: プリミティブ、enum、String または他の CharSequence、Number、Date、URI、URL、Locale または Class。

  パラメーター:

  clazz - チェックする型

  戻り値:

  指定された型が「単純な」値型を表すかどうか

• copyProperties

  public static void copyProperties(java.lang.Object source,
                                    java.lang.Object target)
                             throws BeansException

  指定されたソース Bean のプロパティ値をターゲット Bean にコピーします。

  メモ: プロパティが一致する限り、ソースクラスとターゲットクラスは一致する必要はなく、相互に派生する必要もありません。ソース Bean が公開するが、ターゲット Bean は公開しない Bean プロパティは、確認なしで無視されます。

  これは単なる便利なメソッドです。より複雑な転送が必要な場合は、完全な BeanWrapper の使用を検討してください。

  パラメーター:

  source - ソース Bean

  target - ターゲット Bean

  例外:

  BeansException - コピーが失敗した場合

  関連事項:

  BeanWrapper

• copyProperties

  public static void copyProperties(java.lang.Object source,
                                    java.lang.Object target,
                                    java.lang.Class<?> editable)
                             throws BeansException

  特定のソース Bean のプロパティ値を特定のターゲット Bean にコピーし、特定の「編集可能な」クラス（またはインターフェース）で定義されたプロパティのみを設定します。

  メモ: プロパティが一致する限り、ソースクラスとターゲットクラスは一致する必要はなく、相互に派生する必要もありません。ソース Bean が公開するが、ターゲット Bean は公開しない Bean プロパティは、確認なしで無視されます。

  これは単なる便利なメソッドです。より複雑な転送が必要な場合は、完全な BeanWrapper の使用を検討してください。

  パラメーター:

  source - ソース Bean

  target - ターゲット Bean

  editable - プロパティ設定を制限するクラス（またはインターフェース）

  例外:

  BeansException - コピーが失敗した場合

  関連事項:

  BeanWrapper

• copyProperties

  public static void copyProperties(java.lang.Object source,
                                    java.lang.Object target,
                                    java.lang.String... ignoreProperties)
                             throws BeansException

  指定された "ignoreProperties" を無視して、指定されたソース Bean のプロパティ値を指定されたターゲット Bean にコピーします。

  メモ: プロパティが一致する限り、ソースクラスとターゲットクラスは一致する必要はなく、相互に派生する必要もありません。ソース Bean が公開するが、ターゲット Bean は公開しない Bean プロパティは、確認なしで無視されます。

  これは単なる便利なメソッドです。より複雑な転送が必要な場合は、完全な BeanWrapper の使用を検討してください。

  パラメーター:

  source - ソース Bean

  target - ターゲット Bean

  ignoreProperties - 無視するプロパティ名の配列

  例外:

  BeansException - コピーが失敗した場合

  関連事項:

  BeanWrapper