Struts構成エディタ - 「アクション・マッピング」ページ

struts-config.xmlファイル内に<action-mappings>要素を作成する際に使用します。この要素は、フォーム・アクションの記述に使用する2つの重要な要素の1つです(もう1つは<form-beans>要素)。アクション・マッピングでは、アプリケーションで実行される可能性のあるアクションを記述します。 このページでは、定義する各アクションに<action>要素を作成します。

アクション・マッピング
struts-config.xmlファイルの既存<action>定義のリスト。 新規アクション定義を作成する場合は「追加」を、リストから既存の定義を削除する場合は「削除」をクリックします。
一般
struts-config.xmlファイルの<action>定義のプロパティを変更する際に使用します。
パス
リクエストURIパス。Strutsサーブレット・アクション・コントローラがこのパスを受け取ると、アクション・マッピングが起動します。パス名は相対パスで、スラッシュ(/)を含める必要があります。たとえば、logon.jspページに対してアクションを起動するには、パス/logonを指定します。Strutsプロジェクトから既存の .jspを選択するには、「参照」をクリックします。
パラメータ
汎用構成パラメータ。アクション・マッピングによって選択されたアクション・インスタンスに情報を渡すときに使用できます。
クラス名
(オプション)アクション・マッピング・クラスの完全修飾Javaクラス名。
Unknown
(オプション)このアクションをこのアプリケーションのデフォルトとして構成して、別のアクションで処理されないすべてのリクエストを処理する場合は、trueに設定します。 1つのアプリケーション内でデフォルトとして定義できるアクションは1つのみです。
Type
リクエストの処理に使用するアクション・ハンドラの完全修飾Javaクラス名。かわりに、「Forward」または「Include」による処理を選択することもできます。Strutsプロジェクトから既存のアクション・ハンドラを選択するには、「参照」をクリックします。
Forward
リクエストの処理に使用するサーブレットまたはJSPのパス(「Type」で指定されたアクション・ハンドラや「Include」による処理を使用しない場合)。 パスはアプリケーションを基準とした相対パスで、スラッシュ(/)を含める必要があります。
Include
リクエストの処理に使用するサーブレットまたはJSPのパス(「Type」で指定されたアクション・ハンドラや「Forward」による処理を使用しない場合)。 パスはアプリケーションを基準とした相対パスで、スラッシュ(/)を含める必要があります。
Form Bean
struts-config.xmlファイルの<action>定義のフォームBeanプロパティを変更する際に使用します。これで、このアクション・マッピングが起動するフォームBeanを、Strutsアクション・サーブレット・コントローラでどのように使用するかを定義できます。ドロップダウン・リストからフォームBeanを選択します。
名前
struts-config.xmlファイルの<action>要素の既存<form-bean>定義のリストを表示するドロップダウン・メニュー。
検証
(オプション)このマッピングに関連付けられているフォームBeanのvalidate()メソッドを、フォームBeanのプロパティに対してコールする必要がある場合に選択します。デフォルトはtrueです。
入力
フォームBeanで検証エラーが発生した場合に制御を渡すURIパス。パス名はアプリケーションを基準とする相対パスで、スラッシュ(/)を含める必要があります。たとえば、logon.jspページに制御を渡すには、パス/logonを指定します。フォワード制御定義と同じページを指定して、ユーザーが検証エラー・メッセージを表示し、問題を解決できるようにすることもできます。
スコープ
フォームBeanのスコープ(リクエストまたはセッション)を選択します。
属性
フォームBeanが使用するリクエスト・スコープまたはセッション・スコープの属性名を入力します。
接頭辞
リクエスト・パラメータ名をフォームBeanプロパティ名と照合する際に使用する接頭辞。
接尾辞
リクエスト・パラメータ名をフォームBeanプロパティ名と照合する際に使用する接尾辞。
Forwards
struts-config.xmlファイルの<action>定義のフォワード・プロパティを変更する際に使用します。これで、このアクション・マッピングが起動するローカル・フォワードを定義できます。新規ローカル・フォワード定義を作成する場合は「追加」を、既存のローカル・フォワード定義を削除する場合は「削除」をクリックします。
名前
グローバル・フォワードの論理名。 フォームのアクション・ハンドラ・クラスは、execute()メソッドがアクション・マッピング・インスタンスでfindFoward()をコールした場合に、グローバル・フォワードで論理名を使用します。

actionMappingInstance.findForward("logicalName")

パス
指定されたローカル・フォワードに対してアクション・マッピングが起動された場合に制御を渡すリクエストURIパス。 パス名はアプリケーションを基準とする相対パスで、スラッシュ(/)を含める必要があります。たとえば、logon.jspページに制御を渡すには、パス/logonを指定します。
リダイレクトする
(オプション)フォワードでリダイレクト・アクション・クラスを使用する場合に選択します。 注意: このオプションは、JDeveloperで作成するビジネス・コンポーネントJSPアプリケーションではサポートされていません。
コンテキスト相対
(オプション)モジュール・アプリケーションで、パス属性がスラッシュ(/)で始まり、モジュールではなくWebアプリケーション全体に対する相対パスとみなす必要がある場合に選択します。 デフォルトでは選択されていません。
クラス名
(オプション)このオブジェクトに対して使用するActionForwardサブクラスの完全修飾Javaクラス名(org.apache.struts.action.ActionForward)。
Exceptions
struts-config.xmlファイル内の<action>要素の既存の<exceptions>定義を変更する際に使用します。これで、このアクション・マッピングに存在するローカル例外を定義できます。新規例外定義を作成する場合は「追加」を、リストから選択した定義を削除する場合は「削除」をクリックします。
タイプ
struts-config.xmlファイルの<action>要素の既存<exceptions>定義のリストを表示するドロップダウン・メニュー。
タイプ
処理する例外の完全修飾クラス名。このクラス名で例外を識別します。
ハンドラ
(オプション)例外情報を保持する構成Beanの実装クラス(org.apache.struts.config.ExceptionConfigのサブクラス)。
パス
(オプション)「タイプ」で指定した例外が発生した場合に制御を渡すリソースへのパス。パス名はアプリケーションを基準とする相対パスで、スラッシュ(/)を含める必要があります。Strutsプロジェクトから既存のリソースを選択するには、「参照」をクリックします。
キー
(オプション)アプリケーションのリソース・バンドルで指定されたメッセージ・キー。値は、ActionErrorによって使用されます。
スコープ
(オプション)識別子リクエストまたはセッション。ActionErrorを格納するスコープ・レベルを識別します。デフォルトはリクエスト・スコープです。
プロパティ
struts-config.xmlファイルの既存<action>定義の<set-property>定義を変更する際に使用します。これで、アクションの特定のプロパティを初期化できます。新規プロパティ定義を作成する場合は「追加」を、既存のプロパティ定義を削除する場合は「削除」をクリックします。
プロパティ
アクションで定義するプロパティ名。
アクションに指定されたプロパティに対して設定する値。

詳細は、JakartaプロジェクトのWebサイトの『Struts User's Guide』を参照してください。

 

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