action

<action>要素は、リクエスト・パスから、リクエストの処理に使用される対応するアクション・クラスへのマッピングを記述します。アクション・クラスは、org.apache.struts.action.Actionクラスを実装します。

要素
icon
display-name
description
set-property
exception
forward
属性
属性
説明
必須または任意
id
要素の一意の識別子。
任意
attribute
ActionForm Beanへのアクセスに使用されるリクエスト・スコープ属性またはセッション・スコープ属性の名前が、Beanの指定したname以外の場合に指定する名前。 nameが指定されている場合のオプションで、指定されていない場合は無効です。
任意
className
このアクション・マッピング・オブジェクトに対して使用するActionMappingサブクラスの完全修飾Javaクラス名。 デフォルト値は、囲んでいる<action-mappings>要素のタイプ、または指定されていない場合はorg.apache.struts.action.ActionMappingです。
任意
forward
typeで指定されたアクション・クラスのかわりにこのリクエストを処理するサーブレットまたはその他のリソースのモジュール相対パス。 パスは、このアプリケーション・モジュールのcontroller要素に構成されているforwardPattern属性を介して処理されません。 forwardincludeまたはtypeのいずれか1つのみを指定する必要があります。
任意
include
typeで指定されたアクション・クラスのかわりにこのリクエストを処理するサーブレットまたはその他のリソースのモジュール相対パス。 パスは、このアプリケーション・モジュールのcontroller要素に構成されているPattern属性を介して処理されません。 forwardincludeまたはtypeのいずれか1つのみを指定する必要があります。
任意
input
検証エラーが発生した場合に制御が戻されるアクションまたはその他のリソースのモジュール相対パス。 nameが指定されている場合のみ有効です。 nameが指定されていて、入力Beanが検証エラーを戻す場合は必須です。 nameが指定されていて、入力Beanが検証エラーを戻さない場合はオプションです。
任意
name
このアクション・マッピングに関連付けられているフォームBean(存在する場合)の一意名。
任意
parameter
このアクション・マッピングによって選択されたActionオブジェクトに追加情報を渡すために使用される汎用構成パラメータ。
任意
path
送信されたリクエストのモジュール相対パス。スラッシュ(/)で始まります。 拡張子マッピングが使用される場合は、ファイル名拡張子を含めないでください。

注意: パス名にピリオドを含めないでください。これは、ピリオドがファイル名拡張子のように見え、アクションによる位置の特定ができないためです。
必須
prefix
リクエスト・パラメータ名がActionFormプロパティ名と照合する際に使用する接頭辞(存在する場合)。 nameが指定されている場合のオプションで、指定されていない場合は使用できません。
任意
roles
このActionMappingオブジェクトへのアクセスを許可されているセキュリティ・ロール名のカンマ区切りのリスト。 Struts 1.1以上で使用できます。
任意
scope
ActionForm Beanへのアクセスに使用されるJSP Beanスコープ(requestまたはsession)の名前(存在する場合)。 nameが指定されている場合のオプションで、指定されていない場合は無効です。
任意
suffix
リクエスト・パラメータ名がActionForm Beanプロパティ名と照合する際に使用する接尾辞(存在する場合)。 nameが指定されている場合のオプションで、指定されていない場合は無効です。
任意
type
このアクション・マッピングに対するリクエストを処理するアクション・サブクラスの完全修飾Javaクラス名(org.apache.struts.action.Action)。 forward属性またはinclude属性が指定されている場合は無効です。 forwardincludeまたはtypeのいずれか1つのみを指定する必要があります。
任意
unknown
ブール値(文字列表現)。 このオブジェクトをこのモジュールのデフォルト・アクション・マッピングとして構成する場合は、trueまたはyesに設定します。 リクエストが別のオブジェクトと一致しない場合、リクエストはunknownがtrueに設定された状態でActionMappingオブジェクトに渡されます。 モジュール内でunknownとして指定できるActionMappingは1つのみです。

デフォルト値はfalseです。
任意
validate
ブール値(文字列表現)。 このアクション・マッピングに対して、Actionオブジェクトをコールする前にActionForm Beanの検証メソッドをコールする場合は、trueまたはyesに設定します。 検証メソッドをコールしない場合は、falseまたはnoに設定します。

デフォルト値はtrueです。
任意

struts-config.xmlの詳細は、次のサイトを参照してください。
http://jakarta.apache.org/struts/userGuide/configuration.html#struts-config

完全なStruts構成の定義については、次のサイトを参照してください。
http://jakarta.apache.org/struts/dtds/struts-config_1_1.dtd

 

Copyright © 1997, 2004, Oracle. All rights reserved.