org.apache.struts.action
クラス DynaActionFormClass

java.lang.Object
  org.apache.struts.action.DynaActionFormClass

すべての実装インタフェース:

org.apache.commons.beanutils.DynaClass, java.io.Serializable

public class DynaActionFormClass

extends java.lang.Object

implements org.apache.commons.beanutils.DynaClass, java.io.Serializable

クラスの全てのコードを個々に持つ事無しに、 開発者がActionFormを定義することを許すDynaActionFormクラスのためのDynaClassの実装です。 注意 - このクラスは動的なアクションフォームBeanの内部実装だけに使用すべきです。 アプリケーション開発者はこのドキュメントを調べる必要は全くありません。

Implementation of DynaClass for DynaActionForm classes that allow developers to define ActionForms without having to individually code all of the classes. NOTE - This class is only used in the internal implementation of dynamic action form beans. Application developers never need to consult this documentation.

導入されたバージョン:

Struts 1.1

バージョン:

$Revision: 1.5 $ $Date: 2005/05/09 13:23:57 $

関連項目:

直列化された形式

翻訳者:

棚澤 昌幸

翻訳状況:

初稿(校正者募集中)

フィールドの概要

protected java.lang.Class	beanClass 新たなBeanインスタンスを生成するために使用するDynaActionFormの実装Class。
protected FormBeanConfig	config このクラスのフォームBeanの設定情報。
protected java.lang.String	name このDynaClassの"動的なクラス名称"。
protected org.apache.commons.beanutils.DynaProperty[]	properties このDynaClassの一部分である動的なプロパティのセット。
protected java.util.HashMap	propertiesMap DynaClassの一部である動的なプロパティのセット。

コンストラクタの概要

DynaActionFormClass(FormBeanConfig config)
指定されたフォームBeanの設定に対し、 新たなDynaActionFormClassを生成します。

メソッドの概要

static void	clear() 推奨されていません。 DynaActionFormClassインスタンスのキャッシュをクリアーすることは不要です。 @deprecated No longer need to Clear our cache of DynaActionFormClass instances.
static DynaActionFormClass	createDynaActionFormClass(FormBeanConfig config) フォームBeanの設定でインスタンスとして指定されたDynaActionFormClassのインスタンスを返します。
protected java.lang.Class	getBeanClass() 必要に応じて新たなインスタンスを生成するために使用するFormBeanConfigを再参照し、 実装クラスを返します。
org.apache.commons.beanutils.DynaProperty[]	getDynaProperties() このDynaClassで現在定義されたプロパティに対するDynaPropertyの配列を返します。
org.apache.commons.beanutils.DynaProperty	getDynaProperty(java.lang.String name) 指定されたプロパティが存在する場合は、 そのプロパティ記述子を返します。
java.lang.String	getName() このDynaClassの名前を返します。
protected void	introspect(FormBeanConfig config) 対応したプロパティを確認するためフォームBeanの設定を参照します。
org.apache.commons.beanutils.DynaBean	newInstance() このDynaActionFormClassに関連付けられた、 新たなDynaActionFormのインスタンスを生成して返します。
java.lang.String	toString() このオブジェクトを表すStringを書き出します。

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

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

フィールドの詳細

beanClass

protected transient java.lang.Class beanClass

新たなBeanインスタンスを生成するために使用するDynaActionFormの実装Class。

The DynaActionForm implementation Class which we will use to create new bean instances.

config

protected FormBeanConfig config

このクラスのフォームBeanの設定情報。

The form bean configuration information for this class.

name

protected java.lang.String name

このDynaClassの"動的なクラス名称"。

The "dynamic class name" for this DynaClass.

properties

protected org.apache.commons.beanutils.DynaProperty[] properties

このDynaClassの一部分である動的なプロパティのセット。

The set of dynamic properties that are part of this DynaClass.

propertiesMap

protected java.util.HashMap propertiesMap

DynaClassの一部である動的なプロパティのセット。 プロパティ名によって結びつけられています。 propertiesリストにある様に、 各記述子インスタンスは同じインスタンスとなります。

The set of dynamic properties that are part of this DynaClass, keyed by the property name. Individual descriptor instances will be the same instances as those in the properties list.

コンストラクタの詳細

DynaActionFormClass

public DynaActionFormClass(FormBeanConfig config)

指定されたフォームBeanの設定に対し、 新たなDynaActionFormClassを生成します。 このコンストラクタはprivateです。; staticcreateDynaActionFormClass()メソッドが呼ばれた時に、 必要に応じてDynaActionFormClassインスタンスは生成されます。

Construct a new DynaActionFormClass for the specified form bean configuration. This constructor is private; DynaActionFormClass instances will be created as needed via calls to the static createDynaActionFormClass() method.

パラメータ:

config - 生成するBeanのプロパティを記したFormBeanConfigのインスタンス

@param config The FormBeanConfig instance describing the properties of the bean to be created

例外:

java.lang.IllegalArgumentException - 設定で指定されたBeanの実装クラスが、 DynaActionForm(またはDynaActionFormのサブクラス)で無い場合

@exception IllegalArgumentException if the bean implementation class specified in the configuration is not DynaActionForm (or a subclass of DynaActionForm)

メソッドの詳細

getName

public java.lang.String getName()

このDynaClassの名前を返します。 (java.lang.ClassgetName()メソッドと似ています。) 同じDynaClassの実装クラスとして異なったプロパティのセットを持つ、 異なった動的クラスを維持することを認めています。

Return the name of this DynaClass (analogous to the getName() method of java.lang.ClassDynaClass implementation class to support different dynamic classes, with different sets of properties.

定義:

インタフェース org.apache.commons.beanutils.DynaClass 内の getName

getDynaProperty

public org.apache.commons.beanutils.DynaProperty getDynaProperty(java.lang.String name)

指定されたプロパティが存在する場合は、 そのプロパティ記述子を返します。; それ以外の場合はnullを返します。

[訳者コメント: propertiesMapがHashMapのインスタンスであることを考えた場合、 if it existsを指定したプロパティ名に対応する値がnull以外に設定されている場合と nullまたは指定したプロパティ名が無い場合と捉えた方が良いかも知れません。]

Return a property descriptor for the specified property, if it exists; otherwise, return null.

定義:

インタフェース org.apache.commons.beanutils.DynaClass 内の getDynaProperty

パラメータ:

name - 要求する記述子の動的なプロパティの名前

@param name Name of the dynamic property for which a descriptor is requested

例外:

java.lang.IllegalArgumentException - プロパティ名の指定が無い場合

[訳者コメント: プロパティ名にnullを指定した場合と捉えた方が良いかも知れません。]

@exception IllegalArgumentException if no property name is specified

getDynaProperties

public org.apache.commons.beanutils.DynaProperty[] getDynaProperties()

このDynaClassで現在定義されたプロパティに対するDynaPropertyの配列を返します。 プロパティが定義されていない場合、 要素数ゼロの配列を返します。

Return an array of DynaPropertys for the properties currently defined in this DynaClass. If no properties are defined, a zero-length array will be returned.

定義:

インタフェース org.apache.commons.beanutils.DynaClass 内の getDynaProperties

newInstance

public org.apache.commons.beanutils.DynaBean newInstance()
                                                  throws java.lang.IllegalAccessException,
                                                         java.lang.InstantiationException

このDynaActionFormClassに関連付けられた、 新たなDynaActionFormのインスタンスを生成して返します。 返されたDynaActionFormのプロパティはフォームBeanの設定情報で指定されたデフォルト値に初期化されます。

Instantiate and return a new {@link DynaActionForm} instance, associated with this DynaActionFormClass. The properties of the returned {@link DynaActionForm} will have been initialized to the default values specified in the form bean configuration information.

定義:

インタフェース org.apache.commons.beanutils.DynaClass 内の newInstance

例外:

java.lang.IllegalAccessException - クラスまたはプロパティのコンストラクターがアクセス不能な場合

@exception IllegalAccessException if the Class or the appropriate constructor is not accessible

java.lang.InstantiationException - このクラスが抽象クラス、配列クラス、 プリミティブタイプ、またはvoidの場合; または他の理由でインスタンス化に失敗した場合

@exception InstantiationException if this Class represents an abstract class, an array class, a primitive type, or void; or if instantiation fails for some other reason

toString

public java.lang.String toString()

このオブジェクトを表すStringを書き出します。

Render a String representation of this object.

clear

public static void clear()

推奨されていません。 DynaActionFormClassインスタンスのキャッシュをクリアーすることは不要です。

@deprecated No longer need to Clear our cache of DynaActionFormClass instances.

createDynaActionFormClass

public static DynaActionFormClass createDynaActionFormClass(FormBeanConfig config)

フォームBeanの設定でインスタンスとして指定されたDynaActionFormClassのインスタンスを返します。

Return the DynaActionFormClass instance for the specified form bean configuration instance.

getBeanClass

protected java.lang.Class getBeanClass()

必要に応じて新たなインスタンスを生成するために使用するFormBeanConfigを再参照し、 実装クラスを返します。 (beanClassは一時的に、 シリアライズ解除状態になることが見込まれるためです。)

Return the implementation class we are using to construct new instances, re-introspecting our {@link FormBeanConfig} if necessary (that is, after being deserialized, since beanClass is marked transient).

introspect

protected void introspect(FormBeanConfig config)

対応したプロパティを確認するためフォームBeanの設定を参照します。

Introspect our form bean configuration to identify the supported properties.

パラメータ:

config - 生成するBeanのプロパティを記したFormBeanConfigのインスタンス

@param config The FormBeanConfig instance describing the properties of the bean to be created

例外:

java.lang.IllegalArgumentException - 設定で指定されたBeanの実装クラスが、 DynaActionForm(またはDynaActionFormのサブクラス)で無い場合

@exception IllegalArgumentException if the bean implementation class specified in the configuration is not DynaActionForm (or a subclass of DynaActionForm)