<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 属性を介して処理されません。 forward 、include またはtype のいずれか1つのみを指定する必要があります。 |
任意 |
include
|
type で指定されたアクション・クラスのかわりにこのリクエストを処理するサーブレットまたはその他のリソースのモジュール相対パス。 パスは、このアプリケーション・モジュールのcontroller 要素に構成されているPattern 属性を介して処理されません。 forward 、include または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 属性が指定されている場合は無効です。 forward 、include または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.