terasoluna框架

去年的這個時候在terasoluna的框架下做過開發，但今年又準備重新弄的時候發現很多東西都忘了，昨天下午整理了一下，並run了一個demo。寫在這裏是爲了分享給其他人，有理解不到位的地方也請指摘。

terasoluna是日本整合的一個java框架，它整合了struts與spring。

 

terasoluna擴展了struts的控制器部分（後臺）

1.Action （struts框架的） 

 

2.ActionEx  extends  Action{

public  ActionForward  execute (ActionMapping mapping,

                                 ActionForm form,

                                 HttpServletRequest request,

                                 HttpServletResponse response){

ActionForward forward = doExecute(mapping, form, request, response);

}

public  abstract  ActionForward  doExecute(ActionMapping mapping,

                                            ActionForm form,

                                            HttpServletRequest request,

                                            HttpServletResponse response);

}

 

3.AbstractBLogicAction<P>  extends  ActionEx{

public  ActionForward  doExecute(ActionMapping mapping,

                                  ActionForm form,

                                  HttpServletRequest request,

                                   HttpServletResponse response){

preDoExecuteBLogic(request, response, params);

 

//為空，可以自己添加，也可以不管

 

BLogicResult result = doExecuteBLogic(params);

postDoExecuteBLogic(request, response, params, result);

 

//為空，可以自己添加，也可以不管

 

}

public abstract BLogicResult doExecuteBLogic(P param) throws Exception;

}

4.BLogicAction<P> extends AbstractBLogicAction<P>{

public BLogicResult doExecuteBLogic(P param){

BLogicResult result = businessLogic.execute(param);

}

}

5.interface BLogic<P> {

           BLogicResult execute(P params);

}

//自己寫的業務類

6.businessLogic<P> implements BLogic<P> {

           BLogicResult execute(P params);

}

 

注:

1.      注意一下顏色相同的方法,有助於幫助你理解整個流程

第四個類(BLogicAction)和第六個類(businessLogic)會在後面的demo中的配置文件中體現它們之間的關聯

 

demo的需求是：從一個jsp頁面中提交表單，將提交的內容顯示在另一個jsp中。

1.首先我們需要在WEB-INF中建立一個由自己命名的文件夾，我這裏命名爲“logon”，並在下面添加了3個xml配置文件，分別是blogic-logon-io.xml，logonContext.xml，struts-logon-config.xml。建立這個文件夾是爲了降低主模塊兒和附屬功能模塊兒的耦合性，如果以後需要對登錄部份進行修改，只需要修改logon目錄下著3個文件，不用修改根目錄下的配置文件WEB-INF路徑下與之相對的這3個文件如下。

 

 

在blogic-logon-io.xml中配置了相應和請求時的數據信息，需要設置如下：

[java] view plaincopy

1. <!-- ビジネスロジック入出力定義 -->  
2. <blogic-io>  
3.     <action path="/userBL/userBL">  
4.         <blogic-params bean-name="com.dto.UserMessageInput">  
5.             <set-property property="userName" blogic-property="userName" source="form" />  
6.         </blogic-params>  
7.         <blogic-result>  
8.             <set-property property="userName" blogic-property="userName" dest="form" />  
9.         </blogic-result>  
10.     </action>  
11. </blogic-io>  

其中，<action path>是從頁面jsp中發出的請求，<blogic-params>中的bean-name指定了存放請求數據的JavaBean，<set-property>中的property屬性是form裏聲明的屬性，blogic-property屬性是JavaBean裏聲明的屬性，source是說數據是從form裏得到，因爲數據和之前的struts一樣，是先存放到form裏的。<blogic-result>是所要相應的數據，在這裏可以是屬性，集合，對象。

 

在logonContext.xml中，配置了所要讓spring託管的信息，與spring.xml有些類似。

[java] view plaincopy

1. !-- ログオン業務のBean定義 -->  
2. <beans xmlns="http://www.springframework.org/schema/beans"  
3.        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
4.        xmlns:util="http://www.springframework.org/schema/util"  
5.        xsi:schemaLocation="  
6. http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd  
7. http://www.springframework.org/schema/util http://www.springframework.org/schema/util/spring-util-2.5.xsd">  
8.   
9.   
10.     <!-- ログオン処理用アクション定義 -->  
11.     <bean name="/userBL/userBL" scope="singleton"  
12.           class="jp.terasoluna.fw.web.struts.actions.BLogicAction" >  
13.           <property name="businessLogic" ref="UserMessageBLogic" />  
14.     </bean>  
15.   
16.   
17.     <!-- ログオン処理ビジネスロジック定義 -->  
18.     <bean id="UserMessageBLogic" scope="singleton"  
19.           class="com.blogic.UserMessageBLogic" />  
20.     </beans>  

 

我們需要配置第二個bean和第三個bean。第二個bean配置了我們所寫的邏輯處理類注入到BlogicAction類的信息，<property>中的ref屬性與第三個bean裏的id相一致。在第三個bean中我們配置了具體的業務邏輯類地址。

 

在struts-logon-struts.xml中，配置了form-bean的具體位置，action的請求映射路徑，以及成功跳轉的頁面。

 

[java] view plaincopy

1. <struts-config>  
2.   
3. <!-- ======================================== フォームビーン定義 -->  
4.   <form-beans>  
5.   
6.     <!-- ログオン用アクションフォーム -->  
7.     <form-bean name="_logonForm"  
8.                type="com.form.logonForm" />  
9.   
10.   </form-beans>  
11.   
12. <!-- ======================================== アクションマッピング定義 -->  
13.   <action-mappings type="jp.terasoluna.fw.web.struts.action.ActionMappingEx">     
14.     <action path="/userBL/userBL"  
15.             name="_logonForm" scope="request"  
16.             validate="false">  
17.         <forward name="success" path="/success.jsp" />  
18.     </action>  
19.    </action-mappings>  
20. </struts-config>  

 

而這三個xml文件都需要在主模塊的web.xml和struts-xml文件中聲明加載。如下所示：

web.xml:

[java] view plaincopy

1. <servlet>  
2.     <servlet-name>action</servlet-name>  
3.     <servlet-class>org.apache.struts.action.ActionServlet</servlet-class>  
4.     <init-param>  
5.         <param-name>config</param-name>  
6.         <param-value>/WEB-INF/struts-config.xml,/WEB-INF/logon/struts-logon-config.xml</param-value>  
7.     </init-param>  
8.     <init-param>  

struts-config.xml

[java] view plaincopy

1. <plug-in className="org.springframework.web.struts.ContextLoaderPlugIn">  
2.     <set-property property="contextConfigLocation" value="/WEB-INF/moduleContext.xml,/WEB-INF/logon/logonContext.xml"/>  
3. </plug-in>  
4. <plug-in className="org.apache.struts.validator.ValidatorPlugIn">  
5.     <set-property property="pathnames" value="/WEB-INF/validator-rules.xml,/WEB-INF/validator-rules-ex.xml,/WEB-INF/validation.xml"/>  
6.     <set-property property="stopOnFirstError" value="false"/>  
7. </plug-in>  
8. <plug-in className="jp.terasoluna.fw.web.struts.plugins.BLogicIOPlugIn">  
9.     <set-property property="digesterRules" value="/WEB-INF/blogic-io-rules.xml"/>  
10.     <set-property property="mapperClass" value="jp.terasoluna.fw.service.thin.BLogicMapper"/>  
11.     <set-property property="resources" value="/WEB-INF/blogic-io.xml,/WEB-INF/logon/blogic-logon-io.xml"/>  
12. </plug-in>  

配置的東西就完了。

下面是包com.blogic下的業務處理類UserMessageBLogic：

[java] view plaincopy

1. package com.blogic;  
2.   
3. import jp.terasoluna.fw.service.thin.BLogic;  
4. import jp.terasoluna.fw.service.thin.BLogicResult;  
5.   
6.   
7. import com.dto.UserMessageInput;  
8. import com.dto.UserMessageOutput;  
9.   
10.   
11. public  class UserMessageBLogic implements BLogic<UserMessageInput>{  
12.       
13.     public BLogicResult execute(UserMessageInput input){  
14.         String method = input.getUserName();  
15.         BLogicResult result = new BLogicResult();  
16.         UserMessageOutput output = new UserMessageOutput();  
17.         output.setUserName(method);  
18.         result.setResultObject(output);  
19.         result.setResultString("success");  
20.           
21.         return result;  
22.     }  
23.   
24. }  

包com.dto下的JavaBean：

[java] view plaincopy

1. package com.dto;  
2.   
3. public class UserMessageInput {  
4.       
5.     private String userName;  
6.       
7.     public String getUserName() {  
8.         return userName;  
9.     }  
10.   
11.     public void setUserName(String userName) {  
12.         this.userName = userName;  
13.     }  
14.   
15. }  

 

[java] view plaincopy

1. package com.dto;  
2.   
3.   
4. public class UserMessageOutput {  
5.     private String userName = null;  
6.       
7.     public String getUserName(){  
8.         return this.userName;  
9.     }  
10.     public void setUserName(String userName){  
11.         this.userName = userName;  
12.     }  
13.   
14. }  

包com.form裏的formbean：

[java] view plaincopy

1. package com.form;  
2.   
3. import org.apache.struts.action.ActionForm;  
4.   
5.   
6. public class logonForm extends ActionForm{  
7.       
8.       
9.     private static final long serialVersionUID = 1L;  
10.     private String userName = null;  
11.       
12.     public String getUserName(){  
13.         return (this.userName);  
14.     }  
15.       
16.     public void setUserName(String userName){  
17.         this.userName = userName;  
18.     }  
19.   
20. }  

啓動工程的初始畫面welcome.jsp：

[xhtml] view plaincopy

1. <%@ page contentType="text/html; charset=Windows-31J"%>  
2. <%@ taglib uri="/struts-html" prefix="html" %>  
3. <%@ taglib uri="/struts-bean" prefix="bean" %>  
4. <%@ taglib uri="/struts-logic" prefix="logic" %>  
5. <%@ taglib uri="/terasoluna-struts" prefix="ts" %>  
6. <%@ taglib uri="/terasoluna" prefix="t" %>  
7.   
8. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">  
9.   
10. <html:html>  
11. <head>  
12. <meta http-equiv="Content-Type" content="text/html; charset=Shift_JIS">  
13. <title>-</title>  
14. </head>  
15. <body>  
16. <div style="text-align: center" mce_style="text-align: center">  
17.   
18. -- ようこそTERASOLUNAへ --  
19. <br>  
20. <html:form action="/userBL/userBL.do" focus="useName">  
21.      <html:text property="userName" size="16" maxlength="16"/><br>  
22.      <html:submit property = "submit" value="Submit"/>  
23.      <html:reset/>  
24.   </html:form>  
25. </div>  
26.   
27. </body>  
28. </html:html>  

跳轉畫面success.jsp：

[xhtml] view plaincopy

1. <%@ page contentType="text/html; charset=Windows-31J"%>  
2. <%@ taglib uri="/struts-html" prefix="html" %>  
3. <%@ taglib uri="/struts-bean" prefix="bean" %>  
4. <%@ taglib uri="/struts-logic" prefix="logic" %>  
5. <%@ taglib uri="/terasoluna-struts" prefix="ts" %>  
6. <%@ taglib uri="/terasoluna" prefix="t" %>  
7.   
8. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">  
9.   
10. <html:html>  
11. <head>  
12. <meta http-equiv="Content-Type" content="text/html; charset=shift_jis">  
13. <title>-</title>  
14. </head>  
15. <body bgcolor="pink">  
16.     <bean:write name="_logonForm" property="userName"/>  
17. </body>  
18. </html:html>  

以上就是所有所需要的文件。

 

關於JavaBean和FomBean呢，是這樣，多個請求可能用到1個FormBean，但是可以用多個JavaBean，所以在FormBean中必須聲明所有的JavaBean中所需要的屬性，因爲在blogic-logon-io.xml中配置的請求和響應的數據都是從FormBean中得到的。

然後說說業務處理類，該類實現了BLogic<P>接口，P是請求的JavaBean對象，重寫execute方法，在該方法體內寫我們的業務處理，通過input請求數據的JavaBean得到數據，實例1個result對象，output是響應數據的JavaBean，把要響應的數據存放到該JavaBean裏，把output對象用result.setResultObject存放在result對象裏，這一步就是在blogic-logon-io.xml文件<blogic-result>標籤體裏配置的信息相關聯，最後通過result對象的setResultString(“success”); 方法請求跳轉到呈現頁面，”success”是指struts-logon-config.xml文件裏該action請求信息裏配置的forword的name屬性值，根據該信息跳轉到了success.jsp頁面。