概要 | パッケージ | クラス | 使用 | 階層ツリー | 非推奨 API | 索引 | ヘルプ
前のクラス 次のクラス | フレームあり フレームなし
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド

## shohaku.core.beans
クラス BeanUtilities

    java.lang.Object
      shohaku.core.beans.BeanUtilities

public class BeanUtilities
extends java.lang.Object

`JavaBean`を制御するユーティリティを提供します。
ライブラリの依存性を最小化する方針から`Jakarta`の`BeanUtils`等の高機能ライブラリは使用しません。
コアライブラリには利用頻度の高い機能のみを定義し、必要に応じて他のライブラリを使用します。

コンストラクタの概要
`BeanUtilities()`

メソッドの概要
`static java.lang.reflect.Field` | `getAccessibleField(java.lang.Class c, java.lang.String fieldName)` アクセス可能なフィールドを検索して返却します。
`static java.lang.Object` | `getCELNestedProperty(java.lang.Object bean, java.lang.String pattern)` 指定された参照パターンに基づき引数をCEL式で解析するメソッドとプロパティ・マップ・配列・リストの要素に再起的にアクセスして値を返却します。
`static java.lang.Object` | `getFieldValue(java.lang.Class c, java.lang.Object obj, java.lang.String fieldName)` オブジェクトからフィールド名の示すフィールド値を取得して返却します。
`static java.lang.Object` | `getFieldValue(java.lang.Object obj, java.lang.String fieldName)` オブジェクトからフィールド名の示すフィールド値を取得して返却します。
`static java.lang.reflect.Constructor` | `getMatchingAccessibleConstructor(java.lang.Class c)` パラメータが空のアクセス可能なコンストラクタを検索して返却します。
`static java.lang.reflect.Constructor` | `getMatchingAccessibleConstructor(java.lang.Class c, java.lang.Class[] parameterTypes)` パラメータを割り当てられるアクセス可能なコンストラクタを検索して返却します。
`static java.lang.reflect.Method` | `getMatchingAccessibleGetProperty(java.lang.Class c, java.lang.String propertyName, java.lang.Class parameterType)` パラメータを割り当てられるアクセス可能なプロパティの取得メソッドを検索して返却します。
`static java.lang.reflect.Method` | `getMatchingAccessibleGetProperty(java.lang.Class c, java.lang.String propertyName, java.lang.Class[] parameterTypes)` パラメータを割り当てられるアクセス可能なプロパティの取得メソッドを検索して返却します。
`static java.lang.reflect.Method` | `getMatchingAccessibleMethod(java.lang.Class c, java.lang.String methodName)` パラメータを持たないアクセス可能なメソッドを検索して返却します。
`static java.lang.reflect.Method` | `getMatchingAccessibleMethod(java.lang.Class c, java.lang.String methodName, java.lang.Class parameterType)` パラメータを割り当てられるアクセス可能なメソッドを検索して返却します。
`static java.lang.reflect.Method` | `getMatchingAccessibleMethod(java.lang.Class c, java.lang.String methodName, java.lang.Class[] parameterTypes)` パラメータを割り当てられるアクセス可能なメソッドを検索して返却します。
`static java.lang.reflect.Method` | `getMatchingAccessibleSetProperty(java.lang.Class c, java.lang.String propertyName, java.lang.Class parameterType)` パラメータを割り当てられるアクセス可能なプロパティの設定メソッドを検索して返却します。
`static java.lang.reflect.Method` | `getMatchingAccessibleSetProperty(java.lang.Class c, java.lang.String propertyName, java.lang.Class[] parameterTypes)` パラメータを割り当てられるアクセス可能なプロパティの設定メソッドを検索して返却します。
`static java.lang.reflect.Method` | `getMethod(java.lang.Class c, java.lang.String methodName, java.lang.Class[] parameterTypes)` 指定されたクラスから処理の対象となるメソッドを返却します。
`static java.lang.Object` | `getNestedProperty(java.lang.Object bean, java.lang.String pattern)` 指定された参照パターンに基づきプロパティ・マップ・配列・リストの要素に再起的にアクセスして値を返却します。
`static java.util.Map` | `getProperties(java.lang.Object bean)` ビーンのプロパティをマップに格納して返却します。
`static java.lang.Object` | `getProperty(java.lang.Object bean, java.lang.String propertyName)` ビーンからプロパティ名の示すプロパティを取得して返却します。
`static java.beans.PropertyDescriptor[]` | `getPropertyDescriptors(java.lang.Class beanClass)` ビーンの`java.beans.PropertyDescriptor`を返却します。
`static java.beans.PropertyDescriptor[]` | `getPropertyDescriptors(java.lang.Object bean)` ビーンの`java.beans.PropertyDescriptor`を返却します。
`static java.lang.Object` | `invokeMethod(java.lang.Class c, java.lang.Object obj, java.lang.reflect.Method method, java.lang.Object[] parameterValues)` 指定されたインスタンスとクラスからメソッドを呼び出し結果を返却します。
`static java.lang.Object` | `invokeMethod(java.lang.Class c, java.lang.Object obj, java.lang.String methodName)` 指定されたインスタンスとクラスからメソッドを呼び出し結果を返却します。
`static java.lang.Object` | `invokeMethod(java.lang.Class c, java.lang.Object obj, java.lang.String methodName, java.lang.Class[] parameterTypes, java.lang.Object[] parameterValues)` 指定されたインスタンスとクラスからメソッドを呼び出し結果を返却します。
`static java.lang.Object` | `invokeMethod(java.lang.Class c, java.lang.Object obj, java.lang.String methodName, java.lang.Object[] parameterValues)` 指定されたインスタンスとクラスからメソッドを呼び出し結果を返却します。
`static java.lang.Object` | `newInstance(java.lang.Class c)` パラメータを指定したコンストラクタからインスタンスを生成して返却します。
`static java.lang.Object` | `newInstance(java.lang.Class c, java.lang.Class[] parameterTypes, java.lang.Object[] parameterValues)` パラメータを指定したコンストラクタからインスタンスを生成して返却します。
`static java.lang.Object` | `newInstance(java.lang.Class c, java.lang.Object[] parameterValues)` パラメータを指定したコンストラクタからインスタンスを生成して返却します。
`static java.lang.Object` | `setFieldValue(java.lang.Class c, java.lang.Object obj, java.lang.String fieldName, java.lang.Object newValue)` オブジェクトからフィールド名の示すフィールド値を設定して元の値を返却します。
`static java.lang.Object` | `setFieldValue(java.lang.Object obj, java.lang.String fieldName, java.lang.Object newValue)` オブジェクトからフィールド名の示すフィールド値を設定して元の値を返却します。
`static java.lang.Object` | `setProperties(java.lang.Object bean, java.util.Map props)` ビーンのプロパティをマップに格納して返却します。
`static java.lang.String` | `toBeanString(java.lang.Object bean)` ビーンのプロパティを文字列に変換して返却します。

クラス java.lang.Object から継承したメソッド
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

コンストラクタの詳細

### BeanUtilities

    public BeanUtilities()

メソッドの詳細

### getPropertyDescriptors

    public static java.beans.PropertyDescriptor[] getPropertyDescriptors(java.lang.Object bean)

  ビーンの`java.beans.PropertyDescriptor`を返却します。

  パラメータ:
    `bean` - ビーンのインスタンス
  戻り値:
    ビーンの`java.beans.PropertyDescriptor`

### getPropertyDescriptors

    public static java.beans.PropertyDescriptor[] getPropertyDescriptors(java.lang.Class beanClass)

  ビーンの`java.beans.PropertyDescriptor`を返却します。

  パラメータ:
    `beanClass` - ビーンのクラス
  戻り値:
    ビーンの`java.beans.PropertyDescriptor`

### getProperties

    public static java.util.Map getProperties(java.lang.Object bean)
                                       throws InvocationBeansException

  ビーンのプロパティをマップに格納して返却します。

  パラメータ:
    `bean` - ビーンのインスタンス
  戻り値:
    全てのプロパティを格納するマップ
  例外:
    `InvocationBeansException` - プロパティの呼出に失敗した場合

### setProperties

    public static java.lang.Object setProperties(java.lang.Object bean,
                                                 java.util.Map props)
                                          throws InvocationBeansException

  ビーンのプロパティをマップに格納して返却します。

  パラメータ:
    `bean` - ビーンのインスタンス
    `props` - プロパティを格納するマップ
  戻り値:
    引数のビーンのインスタンスの参照
  例外:
    `InvocationBeansException` - プロパティの呼出に失敗した場合

### toBeanString

    public static java.lang.String toBeanString(java.lang.Object bean)
                                         throws InvocationBeansException

  ビーンのプロパティを文字列に変換して返却します。

  パラメータ:
    `bean` - ビーンのインスタンス
  戻り値:
    ビーンのプロパティの文字列表現
  例外:
    `InvocationBeansException` - プロパティの呼出に失敗した場合

### getNestedProperty

    public static java.lang.Object getNestedProperty(java.lang.Object bean,
                                                     java.lang.String pattern)
                                              throws InvocationBeansException

  指定された参照パターンに基づきプロパティ・マップ・配列・リストの要素に再起的にアクセスして値を返却します。

  パラメータ:
    `bean` - ビーンのインスタンス
    `pattern` - 参照パターン
  戻り値:
    参照パターンの示すネストされたプロパティ
  例外:
    `InvocationBeansException` - プロパティの呼出に失敗した場合

### getCELNestedProperty

    public static java.lang.Object getCELNestedProperty(java.lang.Object bean,
                                                        java.lang.String pattern)
                                                 throws InvocationBeansException

  指定された参照パターンに基づき引数をCEL式で解析するメソッドとプロパティ・マップ・配列・リストの要素に再起的にアクセスして値を返却します。

  パラメータ:
    `bean` - ビーンのインスタンス
    `pattern` - 参照パターン
  戻り値:
    参照パターンの示すネストされたプロパティ
  例外:
    `InvocationBeansException` - プロパティの呼出に失敗した場合

### getProperty

    public static java.lang.Object getProperty(java.lang.Object bean,
                                               java.lang.String propertyName)
                                        throws InvocationBeansException

  ビーンからプロパティ名の示すプロパティを取得して返却します。

  パラメータ:
    `bean` - ビーンのインスタンス
    `propertyName` - プロパティ名
  戻り値:
    プロパティ
  例外:
    `InvocationBeansException` - プロパティの呼出に失敗した場合

### newInstance

    public static java.lang.Object newInstance(java.lang.Class c)
                                        throws InvocationBeansException

  パラメータを指定したコンストラクタからインスタンスを生成して返却します。

  パラメータ:
    `c` - クラス
  戻り値:
    生成されたインスタンス
  例外:
    `InvocationBeansException` - インスタンスの生成に失敗した場合

### newInstance

    public static java.lang.Object newInstance(java.lang.Class c,
                                               java.lang.Object[] parameterValues)
                                        throws InvocationBeansException

  パラメータを指定したコンストラクタからインスタンスを生成して返却します。

  パラメータ:
    `c` - クラス
    `parameterValues` - パラメータ値
  戻り値:
    生成されたインスタンス
  例外:
    `InvocationBeansException` - インスタンスの生成に失敗した場合

### newInstance

    public static java.lang.Object newInstance(java.lang.Class c,
                                               java.lang.Class[] parameterTypes,
                                               java.lang.Object[] parameterValues)
                                        throws InvocationBeansException

  パラメータを指定したコンストラクタからインスタンスを生成して返却します。

  パラメータ:
    `c` - クラス
    `parameterTypes` - パラメータ型
    `parameterValues` - パラメータ値
  戻り値:
    生成されたインスタンス
  例外:
    `InvocationBeansException` - インスタンスの生成に失敗した場合

### invokeMethod

    public static java.lang.Object invokeMethod(java.lang.Class c,
                                                java.lang.Object obj,
                                                java.lang.String methodName)
                                         throws InvocationBeansException

  指定されたインスタンスとクラスからメソッドを呼び出し結果を返却します。

  パラメータ:
    `c` - 実行するクラス
    `obj` - 実行するインスタンス
    `methodName` - メソッド名
  戻り値:
    メソッドの返却値
  例外:
    `InvocationBeansException` - 処理の呼出に失敗した場合

### invokeMethod

    public static java.lang.Object invokeMethod(java.lang.Class c,
                                                java.lang.Object obj,
                                                java.lang.String methodName,
                                                java.lang.Object[] parameterValues)
                                         throws InvocationBeansException

  指定されたインスタンスとクラスからメソッドを呼び出し結果を返却します。

  パラメータ:
    `c` - 実行するクラス
    `obj` - 実行するインスタンス
    `methodName` - メソッド名
    `parameterValues` - パラメータ値
  戻り値:
    メソッドの返却値
  例外:
    `InvocationBeansException` - メソッドの呼出に失敗した場合

### invokeMethod

    public static java.lang.Object invokeMethod(java.lang.Class c,
                                                java.lang.Object obj,
                                                java.lang.String methodName,
                                                java.lang.Class[] parameterTypes,
                                                java.lang.Object[] parameterValues)
                                         throws InvocationBeansException

  指定されたインスタンスとクラスからメソッドを呼び出し結果を返却します。

  パラメータ:
    `c` - 実行するクラス
    `obj` - 実行するインスタンス
    `methodName` - メソッド名
    `parameterTypes` - パラメータ型
    `parameterValues` - パラメータ値
  戻り値:
    メソッドの返却値
  例外:
    `InvocationBeansException` - メソッドの呼出に失敗した場合

### invokeMethod

    public static java.lang.Object invokeMethod(java.lang.Class c,
                                                java.lang.Object obj,
                                                java.lang.reflect.Method method,
                                                java.lang.Object[] parameterValues)
                                         throws InvocationBeansException

  指定されたインスタンスとクラスからメソッドを呼び出し結果を返却します。

  パラメータ:
    `c` - 実行するクラス
    `obj` - 実行するインスタンス
    `method` - メソッド
    `parameterValues` - パラメータ値
  戻り値:
    メソッドの返却値
  例外:
    `InvocationBeansException` - メソッドの呼出に失敗した場合

### getFieldValue

    public static java.lang.Object getFieldValue(java.lang.Object obj,
                                                 java.lang.String fieldName)
                                          throws InvocationBeansException

  オブジェクトからフィールド名の示すフィールド値を取得して返却します。

  パラメータ:
    `obj` - フィールドを保有するオブジェクト
    `fieldName` - フィールド名
  戻り値:
    フィールドの値
  例外:
    `InvocationBeansException` - フィールドの呼出に失敗した場合

### getFieldValue

    public static java.lang.Object getFieldValue(java.lang.Class c,
                                                 java.lang.Object obj,
                                                 java.lang.String fieldName)
                                          throws InvocationBeansException

  オブジェクトからフィールド名の示すフィールド値を取得して返却します。

  パラメータ:
    `c` - フィールドを保有するクラス
    `obj` - フィールドを保有するオブジェクト
    `fieldName` - フィールド名
  戻り値:
    フィールドの値
  例外:
    `InvocationBeansException` - フィールドの呼出に失敗した場合

### setFieldValue

    public static java.lang.Object setFieldValue(java.lang.Object obj,
                                                 java.lang.String fieldName,
                                                 java.lang.Object newValue)
                                          throws InvocationBeansException

  オブジェクトからフィールド名の示すフィールド値を設定して元の値を返却します。

  パラメータ:
    `obj` - フィールドを保有するオブジェクト
    `fieldName` - フィールド名
    `newValue` - 格納するフィールド値
  戻り値:
    元のフィールド値
  例外:
    `InvocationBeansException` - フィールドの呼出に失敗した場合

### setFieldValue

    public static java.lang.Object setFieldValue(java.lang.Class c,
                                                 java.lang.Object obj,
                                                 java.lang.String fieldName,
                                                 java.lang.Object newValue)
                                          throws InvocationBeansException

  オブジェクトからフィールド名の示すフィールド値を設定して元の値を返却します。

  パラメータ:
    `c` - フィールドを保有するクラス
    `obj` - フィールドを保有するオブジェクト
    `fieldName` - フィールド名
    `newValue` - 格納するフィールド値
  戻り値:
    元のフィールド値
  例外:
    `InvocationBeansException` - フィールドの呼出に失敗した場合

### getAccessibleField

    public static java.lang.reflect.Field getAccessibleField(java.lang.Class c,
                                                             java.lang.String fieldName)

  アクセス可能なフィールドを検索して返却します。
  フィールドが発見できない場合`null`を返却します。

  パラメータ:
    `c` - 検索するクラス
    `fieldName` - フィールド名
  戻り値:
    アクセス可能なフィールド、発見できない場合`null`

### getMatchingAccessibleConstructor

    public static java.lang.reflect.Constructor getMatchingAccessibleConstructor(java.lang.Class c)

  パラメータが空のアクセス可能なコンストラクタを検索して返却します。
  コンストラクタが発見できない場合`null`を返却します。

  パラメータ:
    `c` - 検索するクラス
  戻り値:
    アクセス可能なコンストラクタ、発見できない場合`null`

### getMatchingAccessibleConstructor

    public static java.lang.reflect.Constructor getMatchingAccessibleConstructor(java.lang.Class c,
                                                                                 java.lang.Class[] parameterTypes)

  パラメータを割り当てられるアクセス可能なコンストラクタを検索して返却します。
  コンストラクタが発見できない場合`null`を返却します。

  パラメータ:
    `c` - 検索するクラス
    `parameterTypes` - 引数のパラメータ型
  戻り値:
    アクセス可能なコンストラクタ、発見できない場合`null`

### getMethod

    public static java.lang.reflect.Method getMethod(java.lang.Class c,
                                                     java.lang.String methodName,
                                                     java.lang.Class[] parameterTypes)
                                              throws java.lang.NoSuchMethodException

  指定されたクラスから処理の対象となるメソッドを返却します。

  パラメータ:
    `c` - クラス
    `methodName` - メソッド名
    `parameterTypes` - パラメータ型
  戻り値:
    指定のメソッド
  例外:
    `java.lang.NoSuchMethodException` - 指定のメソッドが発見出来ない場合

### getMatchingAccessibleMethod

    public static java.lang.reflect.Method getMatchingAccessibleMethod(java.lang.Class c,
                                                                       java.lang.String methodName)

  パラメータを持たないアクセス可能なメソッドを検索して返却します。
  メソッドが発見できない場合`null`を返却します。

  パラメータ:
    `c` - 検索するクラス
    `methodName` - 検索するメソッド名
  戻り値:
    アクセス可能なメソッド、発見できない場合`null`

### getMatchingAccessibleMethod

    public static java.lang.reflect.Method getMatchingAccessibleMethod(java.lang.Class c,
                                                                       java.lang.String methodName,
                                                                       java.lang.Class parameterType)

  パラメータを割り当てられるアクセス可能なメソッドを検索して返却します。
  メソッドが発見できない場合`null`を返却します。

  パラメータ:
    `c` - 検索するクラス
    `methodName` - 検索するメソッド名
    `parameterType` - 引数のパラメータ型
  戻り値:
    アクセス可能なメソッド、発見できない場合`null`

### getMatchingAccessibleMethod

    public static java.lang.reflect.Method getMatchingAccessibleMethod(java.lang.Class c,
                                                                       java.lang.String methodName,
                                                                       java.lang.Class[] parameterTypes)

  パラメータを割り当てられるアクセス可能なメソッドを検索して返却します。
  メソッドが発見できない場合`null`を返却します。

  パラメータ:
    `c` - 検索するクラス
    `methodName` - 検索するメソッド名
    `parameterTypes` - 引数のパラメータ型
  戻り値:
    アクセス可能なメソッド、発見できない場合`null`

### getMatchingAccessibleSetProperty

    public static java.lang.reflect.Method getMatchingAccessibleSetProperty(java.lang.Class c,
                                                                            java.lang.String propertyName,
                                                                            java.lang.Class parameterType)

  パラメータを割り当てられるアクセス可能なプロパティの設定メソッドを検索して返却します。
  プロパティの設定メソッドが発見できない場合`null`を返却します。

  パラメータ:
    `c` - 検索するクラス
    `propertyName` - 検索するプロパティ名
    `parameterType` - 引数のプロパティ型
  戻り値:
    アクセス可能なプロパティの設定メソッド、発見できない場合`null`

### getMatchingAccessibleSetProperty

    public static java.lang.reflect.Method getMatchingAccessibleSetProperty(java.lang.Class c,
                                                                            java.lang.String propertyName,
                                                                            java.lang.Class[] parameterTypes)

  パラメータを割り当てられるアクセス可能なプロパティの設定メソッドを検索して返却します。
  プロパティの設定メソッドが発見できない場合`null`を返却します。

  パラメータ:
    `c` - 検索するクラス
    `propertyName` - 検索するプロパティ名
    `parameterTypes` - 引数のプロパティ型
  戻り値:
    アクセス可能なプロパティの設定メソッド、発見できない場合`null`

### getMatchingAccessibleGetProperty

    public static java.lang.reflect.Method getMatchingAccessibleGetProperty(java.lang.Class c,
                                                                            java.lang.String propertyName,
                                                                            java.lang.Class parameterType)

  パラメータを割り当てられるアクセス可能なプロパティの取得メソッドを検索して返却します。
  プロパティの取得メソッドが発見できない場合`null`を返却します。

  パラメータ:
    `c` - 検索するクラス
    `propertyName` - 検索するプロパティ名
    `parameterType` - 引数のプロパティ型
  戻り値:
    アクセス可能なプロパティの取得メソッド、発見できない場合`null`

### getMatchingAccessibleGetProperty

    public static java.lang.reflect.Method getMatchingAccessibleGetProperty(java.lang.Class c,
                                                                            java.lang.String propertyName,
                                                                            java.lang.Class[] parameterTypes)

  パラメータを割り当てられるアクセス可能なプロパティの取得メソッドを検索して返却します。
  プロパティの取得メソッドが発見できない場合`null`を返却します。

  パラメータ:
    `c` - 検索するクラス
    `propertyName` - 検索するプロパティ名
    `parameterTypes` - 引数のプロパティ型
  戻り値:
    アクセス可能なプロパティの取得メソッド、発見できない場合`null`

概要 | パッケージ | クラス | 使用 | 階層ツリー | 非推奨 API | 索引 | ヘルプ
前のクラス 次のクラス | フレームあり フレームなし
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド