クラスの全てのコードを個々に持つ事無しに、
* 開発者が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.
指定されたフォーム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.
新たなBeanインスタンスを生成するために使用するDynaActionFormの実装Class。
The DynaActionForm implementation Class
* which we will use to create new bean instances.
このクラスのフォームBeanの設定情報。
* {@primaryThe form bean configuration information for this class.
} */ protected FormBeanConfig config = null; /** *このDynaClassの"動的なクラス名称"。
The "dynamic class name" for this DynaClass.
このDynaClassの一部分である動的なプロパティのセット。
* {@primaryThe set of dynamic properties that are part of this DynaClass.
} */ protected DynaProperty properties[] = null; /** *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.}
*/
protected HashMap propertiesMap = new HashMap();
// ------------------------------------------------------ DynaClass Methods
/**
*
この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.}
*/
public String getName() {
return (this.name);
}
/**
*
指定されたプロパティが存在する場合は、
* そのプロパティ記述子を返します。;
* それ以外の場合はnullを返します。
Return a property descriptor for the specified property, if it exists;
* otherwise, return null.
この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.
このDynaActionFormClassに関連付けられた、
* 新たな{@link DynaActionForm}のインスタンスを生成して返します。
* 返された{@link 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.
このオブジェクトを表すStringを書き出します。
Render a String representation of this object.
DynaActionFormClassインスタンスのキャッシュをクリアーすることは不要です。
* {@primary @deprecated No longer need to Clear our cache of DynaActionFormClass instances.}
*/
public static void clear() {
}
/**
* フォームBeanの設定でインスタンスとして指定されたDynaActionFormClassのインスタンスを返します。
DynaActionFormClass instance for the specified form bean
* configuration instance.}
*/
public static DynaActionFormClass
createDynaActionFormClass(FormBeanConfig config) {
return config.getDynaActionFormClass();
}
// ------------------------------------------------------ Protected Methods
/**
* 必要に応じて新たなインスタンスを生成するために使用する{@link 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).
対応したプロパティを確認するためフォームBeanの設定を参照します。
* {@primaryIntrospect our form bean configuration to identify the supported * properties.
} * * @param config 生成するBeanのプロパティを記したFormBeanConfigのインスタンス * {@primary @param config The FormBeanConfig instance describing the properties * of the bean to be created} * * @exception IllegalArgumentException 設定で指定されたBeanの実装クラスが、 * DynaActionForm(またはDynaActionFormのサブクラス)で無い場合 * {@primary @exception IllegalArgumentException if the bean implementation class * specified in the configuration is not DynaActionForm (or a subclass * of DynaActionForm)} */ protected void introspect(FormBeanConfig config) { this.config = config; // Validate the ActionFormBean implementation class try { beanClass = RequestUtils.applicationClass(config.getType()); } catch (Throwable t) { throw new IllegalArgumentException ("Cannot instantiate ActionFormBean class '" + config.getType() + "': " + t); } if (!DynaActionForm.class.isAssignableFrom(beanClass)) { throw new IllegalArgumentException ("Class '" + config.getType() + "' is not a subclass of " + "'org.apache.struts.action.DynaActionForm'"); } // Set the name we will know ourselves by from the form bean name this.name = config.getName(); // Look up the property descriptors for this bean class FormPropertyConfig descriptors[] = config.findFormPropertyConfigs(); if (descriptors == null) { descriptors = new FormPropertyConfig[0]; } // Create corresponding dynamic property definitions properties = new DynaProperty[descriptors.length]; for (int i = 0; i < descriptors.length; i++) { properties[i] = new DynaProperty(descriptors[i].getName(), descriptors[i].getTypeClass()); propertiesMap.put(properties[i].getName(), properties[i]); } } }