jp.co.intra_mart.jssp.util

クラス JavaScriptUtility

java.lang.Object

jp.co.intra_mart.jssp.util.JavaScriptUtility

public class JavaScriptUtility
extends Object

JavaScriptとJava間のオブジェクト変換や関数実行などを行なうユーティリティクラスです。

バージョン:

8.0.20

フィールドのサマリー

フィールド

修飾子とタイプ	フィールドと説明
static ThreadLocal<Boolean>	NO_CACHE 内部においてJavaBeansに関するメタデータのキャッシュを行いたくない場合には、このフラグを設定して下さい.
static String	NON_CONVERT_CHARSET 文字コード変換を行わずに、バイト配列を扱う為の文字コード
static int	SAMPLE_DATA_ARRAY_LENGTH_DEFAULT newInstanceFilledSampleData(Class, String)メソッドで利用される、 サンプルデータが配列の場合の要素数。
static boolean	SAMPLE_DATA_FOR_BOOLEAN_DEFAULT newInstanceFilledSampleData(Class, String)メソッドで利用される、 java.lang.Boolean用のサンプルデータ初期値。
static long	SAMPLE_DATA_FOR_DATE_MILLIS_DEFAULT newInstanceFilledSampleData(Class, String)メソッドで利用される、 java.util.Date用のサンプルデータ初期値（ミリ秒）。
static double	SAMPLE_DATA_FOR_NUMBER_DEFAULT newInstanceFilledSampleData(Class, String)メソッドで利用される、 java.lang.Number用のサンプルデータ初期値。
static String	SAMPLE_DATA_FOR_STRING_DEFAULT newInstanceFilledSampleData(Class, String)メソッドで利用される、 java.lang.String用のサンプルデータ初期値。

メソッドのサマリー

修飾子とタイプ	メソッドと説明
static void	addExcludeClass4newInstanceFilledSampleData(Class<?> excludeConvertClass) newInstanceFilledSampleData(Class, String)等のメソッドで、 サンプルデータ設定済みインスタンスの生成を行わないようするクラスを追加します。
static Object	executeFunction(String pagePath, String functionName, Class<?> returnType, Object... args) JavaScript関数を実行します。
static void	executeVoidFunction(String pagePath, String functionName, Object... args) JavaScript関数を実行します。
static Map<String,PropertyDescriptor>	getBeanPropertyMap(Class<?> beanClass) JavaBeanクラスのプロパティ情報を取得します。
static Map<String,Field>	getPublicFieldMap(Class<?> clazz) 引数で指定されたクラスのPublicフィールドに関する情報を格納したMapを返却します。
static void	initializeSampleData(String str, Number num, Boolean bool, Date date, int arrayLength) newInstanceFilledSampleData(Class, String)メソッドで利用されるサンプルデータを初期化します。
static Object	javaBeanToJS(Object bean) JavaオブジェクトをJavaScriptオブジェクトに変換します。
static Object	jsToJavaBean(Object jsObject, Class<?> beanType) JavaScriptオブジェクトをJavaオブジェクトに変換します。
static Object	jsToJavaBean(Object jsObject, String beanClassName) JavaScriptオブジェクトをJavaオブジェクトに変換します。
static Object	jsToJavaBean(Object jsObject, String beanClassName, ClassLoader classLoader) JavaScriptオブジェクトをJavaオブジェクトに変換します。
static Object	newInstanceFilledSampleData(Class<?> beanType, String sampleValue) 指定されたクラスの サンプルデータ設定済みインスタンスを生成します。
static Object	newInstanceFilledSampleData(String beanClassName, ClassLoader classLoader, String sampleValue) 指定されたクラスの サンプルデータ設定済みインスタンスを生成します。
static Object	newInstanceFilledSampleData(String beanClassName, String sampleValue) 指定されたクラスの サンプルデータ設定済みインスタンスを生成します。

クラスから継承されたメソッド java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

フィールドの詳細

NON_CONVERT_CHARSET

public static final String NON_CONVERT_CHARSET

文字コード変換を行わずに、バイト配列を扱う為の文字コード

関連項目:

定数フィールド値

NO_CACHE

public static final ThreadLocal<Boolean> NO_CACHE

内部においてJavaBeansに関するメタデータのキャッシュを行いたくない場合には、このフラグを設定して下さい.
これは、独自にクラスローダを作成し、ロードしたクラスを利用した変換等を行った場合、メタデータがキャッシュされロードしたクラスローダが破棄されなくなる場合等に利用することを想定しています.

SAMPLE_DATA_FOR_STRING_DEFAULT

public static final String SAMPLE_DATA_FOR_STRING_DEFAULT

newInstanceFilledSampleData(Class, String)メソッドで利用される、 java.lang.String用のサンプルデータ初期値。

関連項目:

定数フィールド値

SAMPLE_DATA_FOR_NUMBER_DEFAULT

public static final double SAMPLE_DATA_FOR_NUMBER_DEFAULT

newInstanceFilledSampleData(Class, String)メソッドで利用される、 java.lang.Number用のサンプルデータ初期値。

関連項目:

定数フィールド値

SAMPLE_DATA_FOR_BOOLEAN_DEFAULT

public static final boolean SAMPLE_DATA_FOR_BOOLEAN_DEFAULT

newInstanceFilledSampleData(Class, String)メソッドで利用される、 java.lang.Boolean用のサンプルデータ初期値。

関連項目:

定数フィールド値

SAMPLE_DATA_FOR_DATE_MILLIS_DEFAULT

public static final long SAMPLE_DATA_FOR_DATE_MILLIS_DEFAULT

newInstanceFilledSampleData(Class, String)メソッドで利用される、 java.util.Date用のサンプルデータ初期値（ミリ秒）。
"Mon June 19 2008 12:34:56 GMT+0900 (JST)"をあらわします。

関連項目:

定数フィールド値

SAMPLE_DATA_ARRAY_LENGTH_DEFAULT

public static final int SAMPLE_DATA_ARRAY_LENGTH_DEFAULT

newInstanceFilledSampleData(Class, String)メソッドで利用される、 サンプルデータが配列の場合の要素数。

関連項目:

定数フィールド値

メソッドの詳細

addExcludeClass4newInstanceFilledSampleData

public static void addExcludeClass4newInstanceFilledSampleData(Class<?> excludeConvertClass)

newInstanceFilledSampleData(Class, String)等のメソッドで、 サンプルデータ設定済みインスタンスの生成を行わないようするクラスを追加します。

パラメータ:

excludeClassList4newInstanceFilledSampleData - サンプルデータ設定済みインスタンスの生成を行わないようするクラス

関連項目:

JavaScriptUtility#newInstanceFilledSampleData(Class, String)}, JavaScriptUtility#newInstanceFilledSampleData(String, String)}, JavaScriptUtility#newInstanceFilledSampleData(String, ClassLoader, String)}

executeFunction

public static Object executeFunction(String pagePath,
                                     String functionName,
                                     Class<?> returnType,
                                     Object... args)
                              throws IllegalConversionException,
                                     Exception

JavaScript関数を実行します。
指定されたページのファンクションコンテナ内に定義されている関数を実行します。

このメソッドを利用することで、関数のパラメータがJava形式からJavaScript形式へ自動的に変換されます。
同様に、関数の実行結果も、JavaScript形式からJava形式へ自動的に変換されます。

Java形式 から JavaScript形式への変換は、javaBeanToJS(Object)を利用しています。
JavaScript形式 から Java形式への変換は、jsToJavaBean(Object, Class)を利用しています。

型変換の対応表は、javaBeanToJS(Object)、および、 jsToJavaBean(Object, Class)の説明を参照してください。 変換後のJavaクラスを配列で指定する場合、 例えば、Memberクラスの配列を変換後のクラスに指定する場合は以下のようになります。

 (Member[]) JavaScriptUtility.executeFunction(pagePath, functionName, Member[].class, args);
 

パラメータ:

pagePath - ページパス（拡張子なし）

functionName - 実行関数名

returnType - 関数返却値の変換後のJavaクラス

args - 関数の引数

戻り値:

関数の実行結果（引数 returnType で指定されたクラスに変換されています）

例外:

IllegalConversionException - Java形式 から JavaScript形式への変換、または、 JavaScript形式 から Java形式への変換に失敗した場合。

Exception - JavaScript関数の実行時にエラーが発生した場合。

executeVoidFunction

public static void executeVoidFunction(String pagePath,
                                       String functionName,
                                       Object... args)
                                throws IllegalConversionException,
                                       Exception

JavaScript関数を実行します。
指定されたページのファンクションコンテナ内に定義されている関数を実行します。
このメソッドは、返却値の無い関数を実行する場合に利用します。

このメソッドを呼び出すことは、 executeFunction(pagePath, functionName, void.class, args) を呼び出すことに相当します。

パラメータ:

pagePath - ページパス（拡張子なし）

functionName - 実行関数名

args - 関数の引数

例外:

IllegalConversionException - Java形式からJavaScript形式への変換に失敗した場合。

Exception - JavaScript関数の実行時にエラーが発生した場合。

関連項目:

executeFunction(String, String, Class, Object...)

getBeanPropertyMap

public static Map<String,PropertyDescriptor> getBeanPropertyMap(Class<?> beanClass)
                                                         throws IntrospectionException

JavaBeanクラスのプロパティ情報を取得します。
引数で指定されたクラスのプロパティに関する情報を格納したMapを返却します。 返却されるMapの形式は、キーが「プロパティ名」、値が「PropertyDescriptor」 の形式です。
指定されたクラスに、GetterとSetterが両方あるプロパティが一つも無かった場合、nullを返却します。

パラメータ:

beanClass - JavaBeanクラス

戻り値:

プロパティ情報を格納したMap。（Mapの形式は、キーが「プロパティ名」、値が「PropertyDescriptor」の形式）

例外:

IntrospectionException - イントロスペクション中に例外が発生した場合

getPublicFieldMap

public static Map<String,Field> getPublicFieldMap(Class<?> clazz)

引数で指定されたクラスのPublicフィールドに関する情報を格納したMapを返却します。 返却されるMapの形式は、キーにPublicフィールド名、値にField です。
Publicフィールドが存在しないクラスの場合、nullを返却します。

パラメータ:

clazz - 対象クラス

戻り値:

Publicフィールドに関する情報を格納したMap。（Mapの形式は、キーが「Publicフィールド名」、値が「Field」の形式）
Publicフィールドが存在しないクラスの場合、nullを返却します。

initializeSampleData

public static void initializeSampleData(String str,
                                        Number num,
                                        Boolean bool,
                                        Date date,
                                        int arrayLength)

newInstanceFilledSampleData(Class, String)メソッドで利用されるサンプルデータを初期化します。

パラメータ:

str - java.lang.String用のサンプルデータ。空文字設定不可。
nullが指定された場合は、SAMPLE_DATA_FOR_STRING_DEFAULTが設定されます。

num - java.lang.Number用のサンプルデータ。
nullが指定された場合は、new Double(SAMPLE_DATA_FOR_NUMBER_DEFAULT)が設定されます。

bool - java.lang.Boolean用のサンプルデータ。
nullが指定された場合は、Boolean.valueOf(SAMPLE_DATA_FOR_BOOLEAN_DEFAULT)が設定されます。

date - java.util.Dateの用のサンプルデータ。
nullが指定された場合は、new Date(SAMPLE_DATA_FOR_DATE_MILLIS_DEFAULT)が設定されます。

arrayLength - サンプルデータが配列の場合の要素数。
負数が指定された場合は、SAMPLE_DATA_ARRAY_LENGTH_DEFAULTが設定されます。

javaBeanToJS

public static Object javaBeanToJS(Object bean)
                           throws IntrospectionException,
                                  IOException,
                                  IllegalAccessException,
                                  InvocationTargetException

JavaオブジェクトをJavaScriptオブジェクトに変換します。

Javaのインスタンスを対応表に基づいて JavaScriptオブジェクトに変換します。

引数にJavaBean 形式のインスタンスが渡された場合、そのプロパティを対応表に基づいて変換します。
（Publicフィールドも変換されます。その際のJavaScriptプロパティ名は、Publicフィールド名です。）
プロパティの値がJavaBean形式のインスタンスである場合、さらにそのプロパティの変換を試みます。
これを繰りかえし、最終的に、null, String, Number, Boolean, Array で構成されるJavaScriptオブジェクトに変換します。

型変換対応表（Java→JavaScript）

Java		JavaScript
null	→	null
java.lang.String	→	String
java.lang.Number	→	Number
java.lang.Boolean	→	Boolean
java.util.Date	→	Date
java.util.Calendar
byte[]	→	String （バイナリ）
javax.activation.DataHandler
配列	→	Array

上記以外のクラスは変換対象外です。（例えば、List, Map, Setを変換することはできません。）
変換対象外のインスタンスが指定された場合は、プロパティを一つも持たないJavaScriptオブジェクトが返却されます。

引数にJavaBean形式のインスタンスが渡された場合、GetterとSetterが両方存在するプロパティを変換します。
GetterとSetterのどちらか一方しかないプロパティは変換されません。
また、プロパティの存在しないJavaBeanが渡された場合は、プロパティを一つも持たないJavaScriptオブジェクトを返却します。
同様に、GetterとSetterのどちらか一方しかないプロパティだけで構成されるJavaBeanの場合も、 プロパティを一つも持たないJavaScriptオブジェクトを返却します。

パラメータ:

bean - 変換対象のJavaオブジェクト

戻り値:

変換後のJavaScriptオブジェクト

例外:

IntrospectionException - イントロスペクション中に例外が発生した場合

IllegalAccessException - 引数に渡されたJavaBeanのGetterにアクセスできない場合

InvocationTargetException - 引数に渡されたJavaBeanのGetterが例外をスローする場合

IOException - バイナリデータの変換に失敗した場合

jsToJavaBean

public static Object jsToJavaBean(Object jsObject,
                                  Class<?> beanType)
                           throws IllegalConversionException,
                                  IOException,
                                  InstantiationException,
                                  IllegalAccessException,
                                  IntrospectionException

JavaScriptオブジェクトをJavaオブジェクトに変換します。

JavaScriptオブジェクトを、対応表に基づいて 指定された変換後のJavaクラス(=引数「beanType」)のインスタンスに変換します。

変換後のJavaクラスにJavaBean 形式のクラスを指定した場合、
JavaBeanのインスタンスを新たに生成後、対応表に基づいて JavaScriptオブジェクトのプロパティを、JavaBeanの同名プロパティに設定します。
（JavaBeanの同名プロパティが無い場合、JavaScriptオブジェクトのプロパティは変換されません）

同様に、変換後のJavaクラス内にPublicフィールドが定義されている場合、 JavaScriptオブジェクトのプロパティを、同名のPublicフィールドに設定します。
（同名のPublicフィールドがない場合、JavaScriptオブジェクトのプロパティは変換されません）

JavaBeanの同名プロパティの型がJavaBean形式クラスの場合、さらにそのプロパティの変換を試みます。
これを繰り返し、最終的にラッパークラス、または、JavaBean形式のインスタンスに変換します。

型変換対応表（JavaScript→Java）

JavaScript		Java	備考
null	→	null	-
undefined
String	→	java.lang.String	-
		java.lang.Character	先頭１文字をCharacterに変換します。
String （バイナリ）	→	byte[]	「String （バイナリ）」とは、 JavaScriptAPIの「Fileオブジェクト」や「VirtualFileオブジェクト」の「load()関数」などで 取得できるファイルデータ（バイナリ）の事を意味します。
		javax.activation.DataHandler
Number	→	java.lang.Number	java.lang.Numberのサブクラスが指定された場合は、 その型に変換されます。 変換可能なjava.lang.Numberのサブクラスは以下の6クラスです。 Double Float Long Integer Short Byte
Boolean	→	java.lang.Boolean	-
Date	→	java.util.Date	-
		java.util.Calendar
Array	→	配列	JavaScriptのArray要素の型がすべて同じであり、 かつ、その型がJavaの配列要素の型に変換可能でなければなりません。
任意のJavaScriptオブジェクト	→	java.lang.String	JavaScriptオブジェクトの文字列表現が変換可能な場合に限る。
		java.lang.Number
		java.lang.Boolean

上記以外は変換対象外です。（List, Map, Setには変換できません）
変換対象外のクラスが指定された場合は、 JavaScriptオブジェクトのプロパティは変換されません。

なお、このメソッドは、GetterとSetterが両方存在するJavaBeanのプロパティに対して、 JavaScriptオブジェクトのプロパティをマッピングします。
GetterとSetterのどちらか一方しかないJavaBeanのプロパティへのマッピングはおこないません。
また、プロパティの存在しないJavaBean形式のクラスを指定した場合は、JavaScriptオブジェクトのプロパティは変換されません。
同様に、GetterとSetterのどちらか一方しかないプロパティだけで構成されるJavaBeanの場合も、 JavaScriptオブジェクトのプロパティは変換されません。

パラメータ:

jsObject - 変換対象のJavaScriptオブジェクト

beanType - 変換後のJavaクラス

戻り値:

変換後のJavaオブジェクト

例外:

IllegalConversionException - 変換処理に失敗した場合

InstantiationException - 指定された変換後のJavaクラスが、抽象クラス、インタフェース、配列クラス、プリミティブ型、または void を表す場合。または、指定された変換後のJavaクラスが無引数コンストラクタを保持しない場合、あるいはインスタンスの生成がほかの理由で失敗した場合

IllegalAccessException - 指定された変換後のJavaクラス、またはその無引数コンストラクタにアクセスできない場合。または、JavaBeanプロパティのSetterメソッドにアクセスできない場合。

IntrospectionException - イントロスペクション中に例外が発生した場合

IOException - バイナリデータの変換に失敗した場合

jsToJavaBean

public static Object jsToJavaBean(Object jsObject,
                                  String beanClassName)
                           throws IllegalConversionException,
                                  IOException,
                                  InstantiationException,
                                  IllegalAccessException,
                                  IntrospectionException,
                                  ClassNotFoundException

JavaScriptオブジェクトをJavaオブジェクトに変換します。

このメソッドを呼び出すことは、 jsToJavaBean(jsObject, beanClassName, java.lang.Thread.currentThread().getContextClassLoader()) を呼び出すことに相当します。

パラメータ:

jsObject - 変換対象のJavaScriptオブジェクト

beanClassName - 変換後のJavaクラス名
生成するインスタンスを配列としたい場合は、「"[L" + クラス名 + ";"」形式で指定してください。
（この形式に関しては、JDKのJavadoc「java.lang.Calss#getName()」等を参照のこと）

戻り値:

変換後のJavaオブジェクト

例外:

IllegalConversionException - 変換処理に失敗した場合

InstantiationException - 指定された変換後のJavaクラスが、抽象クラス、インタフェース、配列クラス、プリミティブ型、または void を表す場合。または、指定された変換後のJavaクラスが無引数コンストラクタを保持しない場合、あるいはインスタンスの生成がほかの理由で失敗した場合

IllegalAccessException - 指定された変換後のJavaクラス、またはその無引数コンストラクタにアクセスできない場合。または、JavaBeanプロパティのSetterメソッドにアクセスできない場合。

IntrospectionException - イントロスペクション中に例外が発生した場合

ClassNotFoundException - 指定された変換後のJavaクラスが見つからなかった場合

IOException - バイナリデータの変換に失敗した場合

関連項目:

jsToJavaBean(Object, String, ClassLoader), jsToJavaBean(Object, Class), Class#getName()}

jsToJavaBean

public static Object jsToJavaBean(Object jsObject,
                                  String beanClassName,
                                  ClassLoader classLoader)
                           throws IllegalConversionException,
                                  IOException,
                                  InstantiationException,
                                  IllegalAccessException,
                                  IntrospectionException,
                                  ClassNotFoundException

JavaScriptオブジェクトをJavaオブジェクトに変換します。

パラメータ:

jsObject - 変換対象のJavaScriptオブジェクト

beanClassName - 変換後のJavaクラス名
生成するインスタンスを配列としたい場合は、「"[L" + クラス名 + ";"」形式で指定してください。
（この形式に関しては、JDKのJavadoc「java.lang.Calss#getName()」等を参照のこと）

classLoader - 変換後のJavaクラスをロードする為のクラスローダ

戻り値:

変換後のJavaオブジェクト

例外:

IllegalConversionException - 変換処理に失敗した場合

InstantiationException - 指定された変換後のJavaクラスが、抽象クラス、インタフェース、配列クラス、プリミティブ型、または void を表す場合。または、指定された変換後のJavaクラスが無引数コンストラクタを保持しない場合、あるいはインスタンスの生成がほかの理由で失敗した場合

IllegalAccessException - 指定された変換後のJavaクラス、またはその無引数コンストラクタにアクセスできない場合。または、JavaBeanプロパティのSetterメソッドにアクセスできない場合。

IntrospectionException - イントロスペクション中に例外が発生した場合

ClassNotFoundException - 指定された変換後のJavaクラスが見つからなかった場合

IOException - バイナリデータの変換に失敗した場合

関連項目:

jsToJavaBean(Object, Class), Class#getName()}

newInstanceFilledSampleData

public static Object newInstanceFilledSampleData(Class<?> beanType,
                                                 String sampleValue)
                                          throws IntrospectionException,
                                                 IllegalAccessException,
                                                 InvocationTargetException

指定されたクラスの サンプルデータ設定済みインスタンスを生成します。

表：サンプルデータとクラスの関係に基づいて 引数「beanType」で指定されたクラスのサンプルデータ設定済みインスタンスを生成します。

生成するインスタンスのクラス(=引数「beanType」)に、JavaBean 形式のクラスが指定された場合、
JavaBeanのインスタンスを新たに生成後、 表：サンプルデータとクラスの関係に基づいて各プロパティの値を設定します。

プロパティの型がJavaBean形式のクラスである場合、さらにサンプルデータの設定を行ないます。
なお、プロパティの型が既に走査されたクラス、または、自身と同じクラスの場合、そのプロパティにはnullが設定されます。
これを繰り返し、サンプルデータ設定済みインスタンスを生成します。

表：サンプルデータとクラスの関係

指定されたクラスが配列の場合の要素数は「1」です。 なお、以下のサンプルデータの値、および、配列要素数は、 initializeSampleData(String, Number, Boolean, Date, int)で設定可能です。

Javaクラス	サンプルデータ	備考
java.lang.String	SAMPLE_DATA_FOR_STRING_DEFAULT	引数「sampleValue」が指定されている場合は、その値が設定されます。 JavaBeanプロパティの場合は「prop_プロパティ名」形式で設定されます。
java.lang.Character	java.lang.Stringのサンプルデータ１文字目を元に生成	-
java.lang.Number	new Double(SAMPLE_DATA_FOR_NUMBER_DEFAULT)	-
java.lang.Boolean	Boolean.valueOf(SAMPLE_DATA_FOR_BOOLEAN_DEFAULT)	-
java.util.Date	new Date(SAMPLE_DATA_FOR_DATE_MILLIS_DEFAULT)	「Mon June 19 2008 12:34:56 GMT+0900 (JST)」をあらわします。
java.util.Calendar	java.util.Dateのサンプルデータを元に生成	-

上記以外のクラスはサンプルデータ生成対象外です。（例えば、List, Map, Setは対象外です。）
サンプルデータ生成対象外のクラスが指定された場合は、サンプルデータの設定を行いません。

例

以下の3つのクラスが存在するとします。（<>の中はクラス名をあらわしています）

 
 クラスA
   ├─プロパティ a    : <A>
   ├─プロパティ b    : <B>
   ├─プロパティ wrap : <String>
   ├─プロパティ a'   : <A[]>
   └─プロパティ b'   : <B[]>
 
 クラスB
   ├─プロパティ a    : <A>
   ├─プロパティ b    : <B>
   ├─プロパティ c    : <C>
   ├─プロパティ wrap : <String>
   ├─プロパティ a'   : <A[]>
   ├─プロパティ b'   : <B[]>
   └─プロパティ c'   : <C[]>
 
 クラスC
   ├─プロパティ a    : <A>
   ├─プロパティ b    : <B>
   ├─プロパティ c    : <C>
   ├─プロパティ wrap : <String>
   ├─プロパティ a'   : <A[]>
   ├─プロパティ b'   : <B[]>
   └─プロパティ c'   : <C[]>
 
 

 newInstanceFilledSampleData(クラスA, "サンプル");
 

を実行した場合の返却値は以下のようになります。

 
 返却値 ・・・①
   ├─ a = null (∵自身と同じクラス)
   ├─ b ・・・②
   │  ├─ a = null (∵①で走査済み)
   │  ├─ b = null (∵自身と同じクラス)
   │  ├─ c ・・・③
   │  │  ├─ a = null (∵①で走査済み)
   │  │  ├─ b = null (∵②で走査済み)
   │  │  ├─ c = null (∵自身と同じクラス)
   │  │  ├─ wrap = "prop_wrap"
   │  │  ├─ a' = 空の配列 (∵①で走査済み)
   │  │  ├─ b' = 空の配列 (∵②で走査済み)
   │  │  └─ c' = 空の配列 (∵③で走査済み)
   │  ├─ wrap = "prop_wrap"
   │  ├─ a' = 空の配列 (∵①で走査済み)
   │  ├─ b' = 空の配列 (∵②で走査済み)
   │  └─ c' = 空の配列 (∵③で走査済み)
   ├─ wrap = "prop_wrap"
   ├─ a' = 空の配列 (∵①で走査済み)
   └─ b' = 空の配列 (∵②で走査済み)
 
 

パラメータ:

beanType - 生成するインスタンスのクラス

sampleValue - 指定されたクラスがjava.lang.String、または、java.lang.Characterだった場合のサンプルデータの値。

戻り値:

指定されたクラスのサンプルデータ設定済みインスタンス

例外:

IntrospectionException - イントロスペクション中に例外が発生した場合

IllegalAccessException - 指定されたクラス、またはその無引数コンストラクタにアクセスできない場合。または、JavaBeanプロパティのSetterメソッドにアクセスできない場合

InvocationTargetException - JavaBeanのSetterが例外をスローする場合

関連項目:

initializeSampleData(String, Number, Boolean, Date, int)

newInstanceFilledSampleData

public static Object newInstanceFilledSampleData(String beanClassName,
                                                 ClassLoader classLoader,
                                                 String sampleValue)
                                          throws IntrospectionException,
                                                 IllegalAccessException,
                                                 InvocationTargetException,
                                                 ClassNotFoundException

指定されたクラスの サンプルデータ設定済みインスタンスを生成します。

パラメータ:

beanClassName - 生成するインスタンスのクラス名。
生成するインスタンスを配列としたい場合は、「"[L" + クラス名 + ";"」形式で指定してください。
（この形式に関しては、JDKのJavadoc「java.lang.Calss#getName()」等を参照のこと）

classLoader - beanClassNameで指定されるクラスをロードする為のクラスローダ

sampleValue - 指定されたクラスがjava.lang.String、または、java.lang.Characterだった場合のサンプルデータの値。

戻り値:

指定されたクラスのサンプルデータ設定済みインスタンス

例外:

IntrospectionException - イントロスペクション中に例外が発生した場合

IllegalAccessException - 指定されたクラス、またはその無引数コンストラクタにアクセスできない場合。または、JavaBeanプロパティのSetterメソッドにアクセスできない場合

InvocationTargetException - JavaBeanのSetterが例外をスローする場合

ClassNotFoundException - 指定されたクラスが見つからなかった場合

関連項目:

newInstanceFilledSampleData(Class, String), Class#getName()}

newInstanceFilledSampleData

public static Object newInstanceFilledSampleData(String beanClassName,
                                                 String sampleValue)
                                          throws IntrospectionException,
                                                 IllegalAccessException,
                                                 InvocationTargetException,
                                                 ClassNotFoundException

指定されたクラスの サンプルデータ設定済みインスタンスを生成します。

このメソッドを呼び出すことは、 newInstanceFilledSampleData(beanClassName, Thread.currentThread().getContextClassLoader(), sampleValue) を呼び出すことに相当します。

パラメータ:

beanClassName - 生成するインスタンスのクラス名。
生成するインスタンスを配列としたい場合は、「"[L" + クラス名 + ";"」形式で指定してください。
（この形式に関しては、JDKのJavadoc「java.lang.Calss#getName()」等を参照のこと）

sampleValue - 指定されたクラスがjava.lang.String、または、java.lang.Characterだった場合のサンプルデータの値。

戻り値:

指定されたクラスのサンプルデータ設定済みインスタンス

例外:

IntrospectionException - イントロスペクション中に例外が発生した場合

IllegalAccessException - 指定されたクラス、またはその無引数コンストラクタにアクセスできない場合。または、JavaBeanプロパティのSetterメソッドにアクセスできない場合

InvocationTargetException - JavaBeanのSetterが例外をスローする場合

ClassNotFoundException - 指定されたクラスが見つからなかった場合

関連項目:

newInstanceFilledSampleData(String, ClassLoader, String), Class#getName()}