jp.terasoluna.fw.web.struts.actions
クラス ForwardAction

java.lang.Object
  上位を拡張 org.apache.struts.action.Action
      上位を拡張 jp.terasoluna.fw.web.struts.actions.ActionEx
          上位を拡張 jp.terasoluna.fw.web.struts.actions.ForwardAction

public class ForwardAction
extends ActionEx

単純フォワードアクション。

ActionExの機能(遷移ログ出力・トランザクショントークンチェック)を継承し、 JSPなどへフォワードするアクションである。 Strutsが提供しているForwardActionと同様に struts-config.xmlで<action>要素の parameter属性に指定した先にフォワードする。 parameter属性が設定されていない場合、 固定の論理フォワード名「success」でアクションフォワードを取得する。 フォワード先が設定されていない場合、 SC_NOT_FOUND(404)エラーを返す。 *.jspファイルへの直接アクセスが禁止されている場合に、 JSPを業務処理を経ず単純に表示するには このアクションを用いてstruts-config.xml にエントリを作成する必要がある。 ActionEx#execute()で行われている処理は、 ここでも継承される。


Bean定義ファイル及びstruts-config.xmlの記述例を以下に示す。

例:

Bean定義ファイルの設定
  <bean name="/foo" scope="prototype"
      class="jp.terasoluna.fw.web.struts.actions.ForwardAction">
  </bean>
  

struts-config.xmlの設定
  <action path="/foo"
          parameter="/foo.jsp">
  </action>
    
または
  <action path="/foo"
          parameter="/foo.jsp">
    <forward name="success" path="/foo.jsp" module="/sub1" redirect="true">
  </action>
    


contextRelativeフィールド parameter属性のパスの指定方法を変更する。
contextRelativeの設定値によるパスの指定方法の違い
trueの場合 parameter属性では、コンテキストルートからの絶対パスの指定となる。
基本的に同一モジュール内の遷移に使用する。
  <action path="/pagelinkForward"
          parameter="/pagelink/sc2401.jsp"/>
    
falseの場合 parameter属性では、モジュール相対パスの指定しか行なえない。
モジュールを跨る遷移やリダイレクトを行ないたい場合は、 原則として<forward>要素を使用すること。
  <action path="/pagelinkForward"
          parameter="/sc2401.jsp"/>
    
contextRelativeの設定方法 system.propertiesに設定を記述する。
設定自体を省略した場合は false として扱われる。
system.properties
 forwardAction.contextRelative=true
    


フィールドの概要
private static java.lang.String FORWARD_ACTION_CONTEXT_RELATIVE_KEY
          contextRelative設定値のプロパティキー
private static java.lang.String FORWARD_ERRORPAGE_ERROR
          エラーページ(404)遷移失敗を示すエラーコード。
private static java.lang.String FORWARD_SUCCESS
          固定の論理フォワード名。
private static org.apache.commons.logging.Log log
          ログクラス。
 
クラス jp.terasoluna.fw.web.struts.actions.ActionEx から継承されたフィールド
FORWARD_TXTOKEN_ERROR
 
クラス org.apache.struts.action.Action から継承されたフィールド
defaultLocale, servlet
 
コンストラクタの概要
ForwardAction()
           
 
メソッドの概要
 org.apache.struts.action.ActionForward doExecute(org.apache.struts.action.ActionMapping mapping, org.apache.struts.action.ActionForm form, javax.servlet.http.HttpServletRequest req, javax.servlet.http.HttpServletResponse res)
          parameter属性に設定された遷移先を アクションフォワードにセットして返す。
 
クラス jp.terasoluna.fw.web.struts.actions.ActionEx から継承されたメソッド
addErrors, addMessages, execute, isSaveToken, isTokenCheck, processTokenCheck, setSaveToken, setTokenCheck
 
クラス org.apache.struts.action.Action から継承されたメソッド
addErrors, addMessages, execute, generateToken, getDataSource, getDataSource, getErrors, getLocale, getMessages, getResources, getResources, getServlet, isCancelled, isTokenValid, isTokenValid, resetToken, saveErrors, saveErrors, saveErrors, saveMessages, saveMessages, saveToken, setLocale, setServlet
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

フィールドの詳細

log

private static org.apache.commons.logging.Log log
ログクラス。


FORWARD_ERRORPAGE_ERROR

private static final java.lang.String FORWARD_ERRORPAGE_ERROR
エラーページ(404)遷移失敗を示すエラーコード。

関連項目:
定数フィールド値

FORWARD_SUCCESS

private static final java.lang.String FORWARD_SUCCESS
固定の論理フォワード名。

関連項目:
定数フィールド値

FORWARD_ACTION_CONTEXT_RELATIVE_KEY

private static final java.lang.String FORWARD_ACTION_CONTEXT_RELATIVE_KEY
contextRelative設定値のプロパティキー

関連項目:
定数フィールド値
コンストラクタの詳細

ForwardAction

public ForwardAction()
メソッドの詳細

doExecute

public org.apache.struts.action.ActionForward doExecute(org.apache.struts.action.ActionMapping mapping,
                                                        org.apache.struts.action.ActionForm form,
                                                        javax.servlet.http.HttpServletRequest req,
                                                        javax.servlet.http.HttpServletResponse res)
parameter属性に設定された遷移先を アクションフォワードにセットして返す。 parameter属性が設定されていない場合、 遷移先論理フォワード名"success"で アクションフォワードを取得して返す。 どちらも設定されていない場合は、(404)エラーを返す。

定義:
クラス ActionEx 内の doExecute
パラメータ:
mapping - アクションマッピング
form - アクションフォーム
req - HTTPリクエスト
res - HTTPレスポンス
戻り値:
遷移先のアクションフォワード