HTTPリダイレクトをレンダリングします。
anchor
forward
ActionForward
の論理名。このURIは、タグの記述どおりに、問合せパラメータのインクルードによって動的に変更される場合があります。 forward
属性、href
属性、linkName
属性またはpage
属性のどれか1つを指定する必要があります。
href
forward
属性、href
属性、linkName
属性またはpage
属性のどれか1つを指定する必要があります。
name
property
を指定しない場合)、またはMapを返すためにコールされるプロパティgetterを含むJSP Beanの名前(propertyを指定した場合)。
page
forward
属性、href
属性、linkName
属性またはpage
属性のどれか1つを指定する必要があります。
paramId
paramName
属性と(オプションの)paramProperty
属性によって定義され、オプションとしてparamScope
属性で範囲指定されます。
paramName
paramProperty
を指定しない場合)。または文字列を返すためにコールされるプロパティgetterを含むJSP Beanの名前(paramProperty
を指定した場合)。JSP Beanは、paramScope
プロパティを指定した場合はそのBeanスコープに制限されます。
paramProperty
paramName
属性によって指定されるBeanのプロパティ名。その戻り値は、このハイパーリンクに動的に追加されるリクエスト・パラメータ(paramId
属性によって指定される)の値を含む文字列となります。
paramScope
paramName
属性によって指定されるBeanを検索するスコープ。指定しない場合、すべてのスコープが検索されます。
property
name
属性によって指定されるBeanのプロパティ名。その戻り値は、ハイパーリンクに追加される問合せパラメータを含むjava.util.Map
となります。 この属性を指定する場合は、name
属性を指定する必要があります。
scope
name
属性によって指定されるBeanを検索するスコープ。指定しない場合、すべてのスコープが検索されます。
transaction
このタグの属性で指定したハイパーリンクへのHttpServletResponse.sendRedirect()
コールを実行します。Cookieがない場合にセッション状態を保持するため、URLリライティングが自動的に適用されます。
このリダイレクトのベースURLは、指定を行う次の属性に基づいて求められます(どれか1つを指定する必要があります)。
forward
: 検索対象のグローバルActionForward
の名前としてこの属性の値を使用し、そこで検出されるアプリケーション相対URIまたはコンテキスト相対URIを使用します。
href
: この属性の値を変更せずに使用します。
page
: アプリケーション相対URIとしてこの属性の値を使用し、コンテキスト・パスをインクルードしてサーバー相対URIを生成します。
通常、前述の属性のいずれかを使用して指定したリダイレクトは、変更されません(URLリライティングが必要な場合以外)。 ただし、動的に定義した1つ以上の問合せパラメータをハイパーリンクに追加する方法が2つあります。paramId
属性(とその値を選択するための関連する属性)を含む1つのパラメータを指定する方法と、1つ以上のパラメータIDと対応する値を含むjava.util.Map
Beanを選択するためのname
属性(とオプションのproperty属性)を指定する方法です。
1つのパラメータを指定する場合は、paramId
属性を使用して、送信するリクエスト・パラメータの名前を定義します。対応する値を指定するには、次のいずれかの方法を使用します。
paramName
属性のみの指定: 名前付きJSP Bean(オプションでparamScope
属性の値により範囲指定)は、文字列に変換できる値を識別する必要があります。
paramName
属性とparamProperty
属性の指定: 指定されるプロパティgetterメソッドは、文字列に変換できる値を選択するために、paramName
属性(とオプションのparamScope
属性)で識別されるJSP Beanでコールされます。
ハイパーリンクに追加するすべてのリクエスト・パラメータを含むjava.util.Map
を指定する場合は、次のいずれかの方法を使用します。
name
属性のみの指定: 名前付きJSP Bean(オプションでscope属性の値により範囲指定)は、パラメータを含むjava.util.Map
を識別する必要があります。
name
属性とproperty
属性の指定: 指定されるプロパティgetterメソッドは、パラメータを含むjava.util.Map
を返すために、name
属性(とオプションのscope
属性)で識別されるBeanでコールされます。
Mapが処理されると、キーは、ハイパーリンクに追加される問合せパラメータの名前であるとみなされます。各キーに関連付けられている値は、パラメータ値を表す文字列または文字列配列のいずれかになります。 文字列配列が指定された場合、同じ問合せパラメータ名で複数の値が作成されます。
JDeveloperのStrutsカスタム・タグ・ライブラリについて
Copyright © 1997, 2004, Oracle. All rights reserved.