|
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.ObjectAction
jp.terasoluna.fw.web.struts.actions.ActionEx
jp.terasoluna.fw.web.struts.actions.AbstractBLogicAction<P>
P
- ビジネスロジックへの入力値となるJavaBeanを指定するpublic abstract class AbstractBLogicAction<P>
ビジネスロジック起動抽象クラス。
ビジネスロジックの起動を行うアクションクラスに共通する機能を 集約した抽象クラスである。全てのビジネスロジック起動アクションクラスは このクラスを継承して実装する。 BLogicActionもこのクラスを継承している。 提供する機能一覧は下記のとおりである。
ビジネスロジック起動アクションクラスは、 Bean定義ファイルにて起動するビジネスロジックを設定した上で、 実行する。 下記の例は、ビジネスロジックであるSampleBLogicをSampleActionから 起動するための設定である。 あわせてstruts-config.xmlの設定例も以下に示す。
Bean定義ファイルの設定
<bean name="/SampleAction" singleton="false"
class="jp.terasoluna.sample1.actions.SampleAction">
<property name="sampleBLogic">
<ref bean="SampleBLogic"></ref>
</property>
</bean>
<bean id="SampleBLogic"
class="jp.terasoluna.sample1.blogic.SampleBLogic">
</bean>
struts-config.xmlの設定
<action path="/SampleAction"
name="_sampleForm"
validate="true"
scope="session"
input="/sample.jsp">
<forward name="success" path="/sampleSCR.do"/>
<forward name="failure" path="/errorSCR.do"/>
</action>
また、ビジネスロジックの実行に失敗した場合などで、 メッセージを設定したい際は、次のようにBLogicResultにメッセージを格納する。
public BLogicResult doExecuteBLogic(ParamsBean params) {
// BLogicResultを生成する。
BLogicResult result = new BLogicResult();
・・・
//ビジネスロジック
・・・
//エラー判定
if (// エラー判定処理 ) {
// Web層にに反映すべき情報を設定する。
・・・
return result;
} else {
// ビジネスロジック内のエラーが発生
// BLogicMessagesを生成
BLogicMessages messages = new BLogicMessages();
// GROUP_ERRORグループのメッセージとして、BLogicMessageを格納
messages.add("GROUP_ERROR", new BLogicMessage("message.error.sample", "sample"));
// エラー用BLogicMessagesをBLogicResultに設定
result.setErrors(messages);
// 実行結果に"failure"を指定
result.setResultString("failure");
return result;
}
}
BLogicAction
,
BLogicIOPlugIn
,
BLogicResult
,
AbstractBLogicMapper
,
BLogicMapper
,
BLogicMessage
,
BLogicMessages
フィールドの概要 | |
---|---|
protected static java.lang.String |
BLOGIC_FORM_ILLEGAL_ERROR
拡張アクションフォーム設定エラー時のエラーコード。 |
protected static java.lang.String |
BLOGIC_MAPPING_ILLEGAL_ERROR
拡張アクションマッピング設定エラー時のエラーコード。 |
protected static java.lang.String |
BLOGIC_RESOURCES_ILLEGAL_ERROR
拡張アクションリソース設定エラー時のエラーコード。 |
protected static java.lang.String |
BLOGIC_RESULT_NULL_ERROR
BLogicResultがnullで返却された時のエラーコード。 |
private static Log |
log
ログクラス。 |
protected static java.lang.String |
NULL_MAPPER_KEY
AbstractBLogicMapperがnullだった場合のエラーコード。 |
private java.lang.String |
saveMessageScope
メッセージ保存先スコープ。 |
クラス jp.terasoluna.fw.web.struts.actions.ActionEx から継承されたフィールド |
---|
FORWARD_TXTOKEN_ERROR |
コンストラクタの概要 | |
---|---|
AbstractBLogicAction()
|
メソッドの概要 | |
---|---|
protected ActionMessages |
convertMessages(BLogicMessages blogicMessages)
BLogicMessagesの内容をActionMessagesに格納しなおす。 |
ActionForward |
doExecute(ActionMapping mapping,
ActionForm form,
javax.servlet.http.HttpServletRequest request,
javax.servlet.http.HttpServletResponse response)
ビジネスロジックを実行する。 |
abstract BLogicResult |
doExecuteBLogic(P param)
ビジネスロジック実行抽象メソッド。 |
protected void |
evaluateBLogicResult(BLogicResult result,
javax.servlet.http.HttpServletRequest request,
javax.servlet.http.HttpServletResponse response,
ActionMappingEx mappingEx)
BLogicResultの評価、Web層のオブジェクトへの結果反映を行う。 |
protected BLogicIO |
getBLogicIO(ActionMapping mapping,
javax.servlet.http.HttpServletRequest request)
BLogicIOを取得する。 |
protected AbstractBLogicMapper |
getBLogicMapper(javax.servlet.http.HttpServletRequest req)
BLogicMapperインスタンスを取得する。 |
protected P |
getBLogicParams(ActionMappingEx mapping,
javax.servlet.http.HttpServletRequest request,
javax.servlet.http.HttpServletResponse response)
paramsを生成し、返却する。 |
protected boolean |
isErrorsEmpty(BLogicResult result)
BLogicResultに格納されているエラー情報が nullであるか空であるとき、trueを返却する。 |
protected void |
postDoExecuteBLogic(javax.servlet.http.HttpServletRequest request,
javax.servlet.http.HttpServletResponse response,
P params,
BLogicResult result)
ビジネスロジックの実行後処理。 |
protected void |
preDoExecuteBLogic(javax.servlet.http.HttpServletRequest request,
javax.servlet.http.HttpServletResponse response,
P params)
ビジネスロジックの実行前処理。 |
void |
setSaveMessageScope(java.lang.String saveMessageScope)
メッセージ保存先スコープを設定する。 |
クラス jp.terasoluna.fw.web.struts.actions.ActionEx から継承されたメソッド |
---|
addErrors, addMessages, execute, isSaveToken, isTokenCheck, processTokenCheck, setSaveToken, setTokenCheck |
クラス java.lang.Object から継承されたメソッド |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
フィールドの詳細 |
---|
private static Log log
protected static final java.lang.String BLOGIC_FORM_ILLEGAL_ERROR
protected static final java.lang.String BLOGIC_MAPPING_ILLEGAL_ERROR
protected static final java.lang.String BLOGIC_RESOURCES_ILLEGAL_ERROR
protected static final java.lang.String BLOGIC_RESULT_NULL_ERROR
protected static final java.lang.String NULL_MAPPER_KEY
private java.lang.String saveMessageScope
コンストラクタの詳細 |
---|
public AbstractBLogicAction()
メソッドの詳細 |
---|
public void setSaveMessageScope(java.lang.String saveMessageScope)
saveMessageScope
- メッセージ保存先スコープpublic ActionForward doExecute(ActionMapping mapping, ActionForm form, javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response) throws java.lang.Exception
ビジネスロジックの実行に必要な下記の共通処理を行う。
ActionEx
内の doExecute
mapping
- アクションマッピングform
- フォームrequest
- リクエストresponse
- レスポンス
java.lang.Exception
- サブクラスからスローされた、予期しない例外protected void preDoExecuteBLogic(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, P params) throws java.lang.Exception
request
- リクエストresponse
- レスポンスparams
- パラメータ(JavaBean)
java.lang.Exception
- 予期しない例外protected void postDoExecuteBLogic(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, P params, BLogicResult result) throws java.lang.Exception
ビジネスロジックで例外が発生しなかった場合のみ、実行される。
request
- リクエストresponse
- レスポンスparams
- パラメータ(JavaBean)result
- ビジネスロジック実行結果
java.lang.Exception
- 予期しない例外protected void evaluateBLogicResult(BLogicResult result, javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, ActionMappingEx mappingEx)
result
- BLogicResultインスタンスrequest
- HTTPリクエストresponse
- HTTPレスポンスmappingEx
- 拡張アクションマッピングprotected ActionMessages convertMessages(BLogicMessages blogicMessages)
blogicMessages
- BLogicMessagesインスタンス
public abstract BLogicResult doExecuteBLogic(P param) throws java.lang.Exception
param
- ビジネスロジック入力情報
java.lang.Exception
- 予期しない例外protected boolean isErrorsEmpty(BLogicResult result)
result
- ビジネスロジック実行結果
protected AbstractBLogicMapper getBLogicMapper(javax.servlet.http.HttpServletRequest req)
req
- HTTPリクエスト
protected P getBLogicParams(ActionMappingEx mapping, javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response) throws java.lang.Exception
mapping
- アクションマッピングrequest
- HTTPリクエストresponse
- HTTPレスポンス
java.lang.Exception
- 予期しない例外protected BLogicIO getBLogicIO(ActionMapping mapping, javax.servlet.http.HttpServletRequest request)
mapping
- アクションマッピングrequest
- HTTPリクエスト
|
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |