Blanco2g_Annotation_BlancoStrutsLogic - blanco Framework Wiki - blanco Framework

@BlancoStrutsLogic アノテーション

Apache Struts Action のためのソースコードおよび設定ファイルを自動生成します。

仕様

適用箇所

• クラス

アノテーション要素

要素名	型	デフォルト	説明
path	String		Apache Struts の struts-config.xml ファイルの action 記述の path 属性の値
scope	String	(なし)	Apache Struts の struts-config.xml ファイルの action 記述の scope 属性の値

詳細

• ほんの少しの記述で、Struts を利用するために必要になる各種ファイルを自動生成します。
• @BlancoStrutsLogic は、@BlancoStrutsForward や @BlancoInject java.sql.Connection と併用することが多いです。
• Struts の struts-config.xml の一部を自動生成することができます。
• メソッド呼び出し直前に、データベース・コネクションの取得、トランザクションの開始をおこないます。
• メソッド呼び出し直後に、トランザクションのロールバックおよび終了、データベース・コネクションの開放をおこないます。
• BlancoStruts の Blanco2g 実装にあたります。

利用の例

入力ソースコード: AbstractSampleLogic.java

 package sample.struts;
 
 import java.sql.Connection;
 
 import javax.servlet.http.HttpServletRequest;
 import javax.servlet.http.HttpServletResponse;
 
 import org.apache.struts.action.ActionMapping;
 
 import blanco.fw.BlancoInject;
 import blanco.struts.BlancoStrutsForward;
 import blanco.struts.BlancoStrutsLogic;
 
 /**
  * サンプル・ロジック。
  */
 @BlancoStrutsLogic(path = "/run")
 public abstract class AbstractSampleLogic {
     /**
      * 正常系の次画面。
      */
     @BlancoStrutsForward(path = "/next.jsp")
     private static final String FORWARD_SUCCESS = "success";
 
     /**
      * 異常系画面。
      */
     @BlancoStrutsForward(path = "/error.jsp")
     private static final String FORWARD_ERROR = "error";
 
     /**
      * ビジネスロジック
      * 
      * @param mapping
      * @param form
      * @param request
      * @param response
      * @param conn
      *            メソッド・パラメータによるデータベース接続インジェクション。
      *            このメソッドの呼び出し直前にデータベース・トランザクションが開始され
      *            、このメソッドの終了直後にロールバックとトランザクション終了が実施されます。
      * @return
      * @throws Exception
      */
     public String execute(final ActionMapping mapping, final SampleForm form, final HttpServletRequest request,
             final HttpServletResponse response, @BlancoInject final Connection conn) throws Exception {
         if (true) {
             return FORWARD_SUCCESS;
         } else {
             return FORWARD_ERROR;
         }
     }
 }

出力ソースコード: SampleLogic.java ★以下のソースコードは Blanco2g によって自動生成されたものです。

 /*
  * このクラスは 'AbstractSampleLogic' の具象クラスとして blanco Framework によって自動生成されました。
  */
 package sample.struts;
 
 import java.sql.Connection;
 
 import javax.servlet.http.HttpServletRequest;
 import javax.servlet.http.HttpServletResponse;
 
 import org.apache.struts.action.ActionMapping;
 
 import blanco.fw.BlancoGeneratedBy;
 
 /**
  * サンプル・ロジック。
  */
 @BlancoGeneratedBy(name = "Blanco2g")
 public class SampleLogic extends AbstractSampleLogic {
     /**
      * ビジネスロジック
      *
      * @param mapping
      * @param form
      * @param request
      * @param response
      * @return
      * @throws Exception
      */
     public String execute(ActionMapping mapping, SampleForm form, HttpServletRequest request, HttpServletResponse response) throws Exception {
         java.lang.String autoValMethodResult;
         final Connection conn = blanco.db.BlancoDbConnectionUtil.getConnection();
         try {
             autoValMethodResult = super.execute(mapping, form, request, response, conn);
         } finally {
             blanco.db.BlancoDbConnectionUtil.releaseConnection(conn);
         }
         return autoValMethodResult;
     }
 }

出力ソースコード: SampleAction.java ★以下のソースコードは Blanco2g によって自動生成されたものです。

 /*
  * このクラスは 'AbstractSampleLogic' の具象クラスとして blanco Framework によって自動生成されました。
  */
 package sample.struts;
 
 import javax.servlet.http.HttpServletRequest;
 import javax.servlet.http.HttpServletResponse;
 
 import org.apache.struts.action.Action;
 import org.apache.struts.action.ActionForm;
 import org.apache.struts.action.ActionForward;
 import org.apache.struts.action.ActionMapping;
 
 import blanco.fw.BlancoGeneratedBy;
 
 /**
  * サンプル・ロジック。
  */
 @BlancoGeneratedBy(name = "Blanco2g")
 public class SampleAction extends Action {
     /**
      * アクション
      *
      * @param mapping action mapping.
      * @param form action form.
      * @param request request.
      * @param response response.
      * @return 戻り値。
      * @throws Exception 例外
      */
     @Override
     public ActionForward execute(final ActionMapping mapping, final ActionForm form, final HttpServletRequest request, final HttpServletResponse response) throws Exception {
         final SampleLogic logic = new SampleLogic();
         return mapping.findForward(logic.execute(mapping, (sample.struts.SampleForm) form, request, response));
     }
 }

出力ファイル: struts-config-action-blanco.xml ★以下の内容は Blanco2g によって自動生成されたものです。

 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE struts-config PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 1.3//EN" "http://struts.apache.org/dtds/struts-config_1_3.dtd">
 <struts-config>
   <action-mappings>
     <!-- サンプル・ロジック。 -->
     <action type="sample.struts.SampleAction" name="SampleForm" path="/run">
       <!-- 正常系の次画面。 -->
       <forward name="success" path="/next.jsp"/>
       <!-- 異常系画面。 -->
       <forward name="error" path="/error.jsp"/>
     </action>
 
   </action-mappings>
 </struts-config>

リンク

• Blanco2g アノテーション一覧
• Blanco2g トップページ