shohaku.core.beans
クラス BeanUtilities

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

public class BeanUtilities
extends java.lang.Object

JavaBeanを制御するユーティリティを提供します。

ライブラリの依存性を最小化する方針からJakartaBeanUtils等の高機能ライブラリは使用しません。
コアライブラリには利用頻度の高い機能のみを定義し、必要に応じて他のライブラリを使用します。


コンストラクタの概要
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