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

org.apache.struts.action
クラス DynaActionForm

java.lang.Object
  拡張org.apache.struts.action.ActionForm
      拡張org.apache.struts.action.DynaActionForm
すべての実装インタフェース:
org.apache.commons.beanutils.DynaBean, java.io.Serializable
直系の既知のサブクラス:
DynaValidatorForm
public class DynaActionForm
extends ActionForm
implements org.apache.commons.beanutils.DynaBean

開発者がフォームBean毎にJavaクラスを作ること無しに、 プロパティの動的なセットを持ったフォームBeanの生成を可能にするActionFormの特殊なサブクラスです。

使用上の注意 - Struts 1.1以降、 resetメソッドは、 Struts設定ファイルの<form-property>要素で指定された値にプロパティを初期化するメソッドではありません。 もしこのような初期化を行いたいならば、 DynaActionFormをサブクラス化してその中でinitializeメソッドを使用することが最もシンプルな解決策となります。

導入されたバージョン:
Struts 1.1
バージョン:
$Revision: 1.6 $ $Date: 2005/05/09 13:23:57 $
関連項目:
直列化された形式
翻訳者:
棚澤 昌幸

フィールドの概要
protected  DynaActionFormClass dynaClass
          関連付けられたDynaActionFormClass。
protected  java.util.HashMap dynaValues
          プロパティ名をキーとした、 このDynaActionFormに対するプロパティ値のセット。
 
クラス org.apache.struts.action.ActionForm から継承したフィールド
multipartRequestHandler, servlet
 
コンストラクタの概要
DynaActionForm()
           
 
メソッドの概要
 boolean contains(java.lang.String name, java.lang.String key)
          指定されたマップであるプロパティが指定されたキー値を保持しているか知らせます。
 java.lang.Object get(java.lang.String name)
          指定された名前を持ったシンプルなプロパティの値を返します。
 java.lang.Object get(java.lang.String name, int index)
          指定された名前のインデックス付きプロパティの値を返します。
 java.lang.Object get(java.lang.String name, java.lang.String key)
          指定された名前のマップであるプロパティの値を返します。
 org.apache.commons.beanutils.DynaClass getDynaClass()
          このDynaBeanで利用できるプロパティのセットである DynaClassインスタンスを返します。
protected  org.apache.commons.beanutils.DynaProperty getDynaProperty(java.lang.String name)
          指定されたプロパティのプロパティ記述子を返します。
 java.util.Map getMap()
          プロパティの値をもつMapを返します。
 java.lang.String getString(java.lang.String name)
          指定された名前のString型プロパティの値を返します。
 java.lang.String[] getStrings(java.lang.String name)
          指定された名前のString[]型プロパティの値を返します。
 void initialize(ActionMapping mapping)
          このDynaActionFormの定義に関連付けられたFormPropertyConfig要素の中で指定された初期値に、 全てのBeanプロパティの値を初期化します。
 void initialize(FormBeanConfig config)
           
protected  boolean isDynaAssignable(java.lang.Class dest, java.lang.Class source)
          ソースクラスのオブジェクトに目的のクラスが割り当てられているか示します。
 void remove(java.lang.String name, java.lang.String key)
          指定されたマップであるプロパティの指定されたキーに対して存在する値を削除します。
 void reset(ActionMapping mapping, javax.servlet.http.HttpServletRequest request)
          必要に応じて、 デフォルト状態にbeanのプロパティをリセットします。
 void reset(ActionMapping mapping, javax.servlet.ServletRequest request)
          必要に応じて、 デフォルト状態にBeanのプロパティをリセットします。
 void set(java.lang.String name, int index, java.lang.Object value)
          指定された名前のインデックス付きプロパティの値を設定します。
 void set(java.lang.String name, java.lang.Object value)
          指定された名前のシンプルなプロパティの値を設定します。
 void set(java.lang.String name, java.lang.String key, java.lang.Object value)
          指定された名前のマップであるプロパティの値を設定します。
(パッケージプライベート)  void setDynaActionFormClass(DynaActionFormClass dynaClass)
          関連付けられたDynaActionFormClassインスタンスを設定します。
 java.lang.String toString()
          このオブジェクトの内容を文字列として書き出します。
 
クラス org.apache.struts.action.ActionForm から継承したメソッド
getMultipartRequestHandler, getServlet, getServletWrapper, setMultipartRequestHandler, setServlet, validate, validate
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

フィールドの詳細

dynaClass

protected DynaActionFormClass dynaClass

関連付けられたDynaActionFormClass。

dynaValues

protected java.util.HashMap dynaValues

プロパティ名をキーとした、 このDynaActionFormに対するプロパティ値のセット。

コンストラクタの詳細

DynaActionForm

public DynaActionForm()
メソッドの詳細

initialize

public void initialize(ActionMapping mapping)

このDynaActionFormの定義に関連付けられたFormPropertyConfig要素の中で指定された初期値に、 全てのBeanプロパティの値を初期化します。

パラメータ:
mapping - このインスタンスを選択するために用いられたマッピング

initialize

public void initialize(FormBeanConfig config)

reset

public void reset(ActionMapping mapping,
                  javax.servlet.ServletRequest request)

必要に応じて、 デフォルト状態にBeanのプロパティをリセットします。 このメソッドはコントローラがプロパティを再設定される前に呼ばれます。

デフォルトの実装はこのメソッドのHTTPバージョンにフォワードを試みます。

オーバーライド:
クラス ActionForm 内の reset
パラメータ:
mapping - このインスタンスを選択するために用いられたマッピング
request - 処理しているServletリクエスト

reset

public void reset(ActionMapping mapping,
                  javax.servlet.http.HttpServletRequest request)

必要に応じて、 デフォルト状態にbeanのプロパティをリセットします。 このメソッドはコントローラがプロパティを再設定される前に呼ばれます。

デフォルトの実装は何もしません(Struts 1.1以降)。 サブクラスはデフォルト値にbeanプロパティをリセットするため、 このメソッドをオーバライドするかも知れません。 または、initializeメソッドが、 フォームプロパティの設定情報で与えられた値にプロパティの値を初期化するために使用されるかも知れません (このメソッドの動作はリリースによります）。

オーバーライド:
クラス ActionForm 内の reset
パラメータ:
mapping - このインスタンスを選択するために用いられたマッピング
request - 処理しているServletリクエスト

contains

public boolean contains(java.lang.String name,
                        java.lang.String key)

指定されたマップであるプロパティが指定されたキー値を保持しているか知らせます。

定義:
インタフェース org.apache.commons.beanutils.DynaBean 内の contains
パラメータ:
name - チェックするプロパティ名
key - チェックするキーの名前
例外:
java.lang.IllegalArgumentException - 指定された名前のマッププロパティがない場合

get

public java.lang.Object get(java.lang.String name)

指定された名前を持ったシンプルなプロパティの値を返します。

定義:
インタフェース org.apache.commons.beanutils.DynaBean 内の get
パラメータ:
name - 値を取得するプロパティ名
例外:
java.lang.IllegalArgumentException - 指定された名前のプロパティがない場合
java.lang.NullPointerException - 指定されたプロパティの型が妥当でない場合

get

public java.lang.Object get(java.lang.String name,
                            int index)

指定された名前のインデックス付きプロパティの値を返します。

定義:
インタフェース org.apache.commons.beanutils.DynaBean 内の get
パラメータ:
name - 値を取得するプロパティ名
index - 取得する値のインデックス値
例外:
java.lang.IllegalArgumentException - 指定された名前のプロパティがない場合
java.lang.IllegalArgumentException - 指定されたプロパティは存在しますが、 インデックス付きプロパティでない場合
java.lang.IndexOutOfBoundsException - 指定されたインデックス値がプロパティの範囲外である場合
java.lang.NullPointerException - このプロパティに対する初期化された配列またはリストがない場合

get

public java.lang.Object get(java.lang.String name,
                            java.lang.String key)

指定された名前のマップであるプロパティの値を返します。 また、指定されたキーの値がない場合はnullを返します。

定義:
インタフェース org.apache.commons.beanutils.DynaBean 内の get
パラメータ:
name - 値を取得するプロパティ名
key - 取得する値のキー
例外:
java.lang.IllegalArgumentException - 指定された名前のプロパティがない場合
java.lang.IllegalArgumentException - 指定されたプロパティは存在しますが、 マップであるプロパティでない場合

getString

public java.lang.String getString(java.lang.String name)

指定された名前のString型プロパティの値を返します。 これは、(String) dynaForm.get(name)を呼ぶことに相当します。

パラメータ:
name - 値を取得するプロパティ名
例外:
java.lang.IllegalArgumentException - 指定された名前のプロパティがない場合
java.lang.NullPointerException - 指定されたプロパティの型が妥当でない場合
java.lang.ClassCastException - プロパティがString型でない場合
導入されたバージョン:
Struts 1.2

getStrings

public java.lang.String[] getStrings(java.lang.String name)

指定された名前のString[]型プロパティの値を返します。 これは、(String[]) dynaForm.get(name)を呼ぶことに相当します。

パラメータ:
name - 値を取得するプロパティ名
例外:
java.lang.IllegalArgumentException - 指定された名前のプロパティがない場合
java.lang.NullPointerException - 指定されたプロパティの型が妥当でない場合
java.lang.ClassCastException - プロパティがString[]型でない場合
導入されたバージョン:
Struts 1.2

getDynaClass

public org.apache.commons.beanutils.DynaClass getDynaClass()

このDynaBeanで利用できるプロパティのセットである DynaClassインスタンスを返します。

定義:
インタフェース org.apache.commons.beanutils.DynaBean 内の getDynaClass

getMap

public java.util.Map getMap()

プロパティの値をもつMapを返します。 JavaBeansのアクセッサを通してDynaActionFormにアクセスすることを楽にします。 これは、主にJavaサーバページのスタンダードタグライブラリ(JSTL)を使用するためです。

例えば、 ActionFormにアクセスするための一般的なJSTL ELシンタックスは次のようになります。: 

 ${formbean.prop}
DynaActionFormにアクセスするためのJSTL ELシンタックスは次のようになります。 (getMap()メソッドのためです。): 
  ${dynabean.map.prop}

The JSTL EL syntax for accessing a DynaActionForm looks something like this (because of the presence of this getMap() method): 
  ${dynabean.map.prop}

}

remove

public void remove(java.lang.String name,
                   java.lang.String key)

指定されたマップであるプロパティの指定されたキーに対して存在する値を削除します。

定義:
インタフェース org.apache.commons.beanutils.DynaBean 内の remove
パラメータ:
name - 値を削除するプロパティの名前
key - 削除する値のキー
例外:
java.lang.IllegalArgumentException - 指定された名前のプロパティがない場合

set

public void set(java.lang.String name,
                java.lang.Object value)

指定された名前のシンプルなプロパティの値を設定します。

定義:
インタフェース org.apache.commons.beanutils.DynaBean 内の set
パラメータ:
name - 値を設定するプロパティの名前
value - プロパティに設定する値
例外:
org.apache.commons.beanutils.ConversionException - 指定された値がプロパティに要求される型に変換できない場合
java.lang.IllegalArgumentException - 指定された名前のプロパティがない場合
java.lang.NullPointerException - 指定されたプロパティの型が妥当でない場合
java.lang.NullPointerException - プリミティブ型にnullを設定しようと試みた場合

set

public void set(java.lang.String name,
                int index,
                java.lang.Object value)

指定された名前のインデックス付きプロパティの値を設定します。

定義:
インタフェース org.apache.commons.beanutils.DynaBean 内の set
パラメータ:
name - 値を設定するプロパティの名前
index - 設定するプロパティのインデックス
value - 設定するプロパティの値
例外:
org.apache.commons.beanutils.ConversionException - 指定された値がプロパティに要求される型に変換できない場合
java.lang.IllegalArgumentException - 指定された名前のプロパティがない場合
java.lang.IllegalArgumentException - 指定されたプロパティは存在しますが、 インデックス付きプロパティでない場合
java.lang.IndexOutOfBoundsException - 指定されたインデックス値がプロパティの範囲外である場合

set

public void set(java.lang.String name,
                java.lang.String key,
                java.lang.Object value)

指定された名前のマップであるプロパティの値を設定します。

定義:
インタフェース org.apache.commons.beanutils.DynaBean 内の set
パラメータ:
name - 値を設定するプロパティの名前
key - 設定するプロパティのキー
value - 設定するプロパティの値
例外:
org.apache.commons.beanutils.ConversionException - 指定された値がプロパティに要求される型に変換できない場合
java.lang.IllegalArgumentException - 指定された名前のプロパティがない場合
java.lang.IllegalArgumentException - 指定されたプロパティは存在しますが、 マップであるプロパティでない場合

toString

public java.lang.String toString()

このオブジェクトの内容を文字列として書き出します。

setDynaActionFormClass

void setDynaActionFormClass(DynaActionFormClass dynaClass)

関連付けられたDynaActionFormClassインスタンスを設定します。

パラメータ:
dynaClass - このbeanに対するDynaActionFormClassインスタンス

getDynaProperty

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

指定されたプロパティのプロパティ記述子を返します。

パラメータ:
name - 記述子を取得するプロパティの名前
例外:
java.lang.IllegalArgumentException - DynaClassに対するプロパティの名前が妥当でない場合

isDynaAssignable

protected boolean isDynaAssignable(java.lang.Class dest,
                                   java.lang.Class source)

ソースクラスのオブジェクトに目的のクラスが割り当てられているか示します。

パラメータ:
dest - 目的のクラス
source - ソースクラス
概要  パッケージ   クラス  階層ツリー  非推奨 API  索引  ヘルプ 
 前のクラス   次のクラス フレームあり    フレームなし    
概要:  入れ子 | フィールド | コンストラクタ | メソッド 詳細:  フィールド | コンストラクタ | メソッド
このドキュメントは、Ja-Jakartaにより訳されました。コメントがある場合は、report@jajakarta.orgまでお願いします。
Copyright (C) 2000-2004 - Apache Software Foundation