| Struts開發(fā)技巧 |
| snowsea 轉(zhuǎn)貼 (參與分：16578，專家分：1160) 發(fā)表：2006-04-17 15:22 版本：1.0 閱讀：1375次 |
模塊配置
1. Struts配置文件定義
對(duì)于系統(tǒng)中的某個(gè)模塊，需要在開發(fā)前定義該模塊的配置，該struts的配置文件命名為：
struts-config-xxx.xml
xxx為模塊的小寫英文名或縮寫，如：struts-config-sysman.xml
注意：中間為“-”，而不是“_”連接符
統(tǒng)一保存在“WEB-INF\xml”文件夾下，并需要在web.xml中添加相應(yīng)的配置文件
地址，具體如下例：
…
<init-param>
<param-name>config</param-name>
<param-value>/WEB-INF/struts-config.xml, /WEB-INF/xml/struts-config-pages.xml,/WEB-INF/xml/struts-config-sysman.xml</param-value>
</init-param>
…
注意：需要用“，”連接符隔開各個(gè)配置文件名
另外，所有的靜態(tài)jsp需要通過配置文件定義其“.do”形式的訪問，保存在
struts-config-pages.xml文件中，內(nèi)容如下例：
…
<!--主頁轉(zhuǎn)向-->
<action path="/main" type="org.apache.struts.actions.ForwardAction" parameter="/main.jsp"/>
…
2. Tiles配置文件定義
系統(tǒng)的框架配置文件為tiles-defs_zh_CN.xml（通過.properties屬性文件支持國際化應(yīng)用，默認(rèn)是tiles-defs.xml），模塊的框架結(jié)構(gòu)需要定義在里面，如下例：
…
<!-- 定義默認(rèn)首頁 -->
<definition name="default.frame" path="/layouts/defaultLayout.jsp">
<put name="title" value="歡迎進(jìn)入電信經(jīng)營分析系統(tǒng)" />
<put name="header" value="/top.jsp" />
<put name="body" value="default.body" />
<put name="footer" value="/buttom.jsp" />
</definition>
<!-- 定義默認(rèn)首頁的body -->
<definition name="default.body" path="/layouts/main.jsp" >
<put name="logon" value="/logon.jsp" />
<put name="date" value="/layouts/date.jsp" />
<put name="linkSite" value="/layouts/link.html" />
</definition>
…
框架命名規(guī)范按“系統(tǒng)（子系統(tǒng)）.功能模塊.頁面模塊”，如上面的“default.frame”
在struts-config-pages.xml文件中的設(shè)置的頁面action可以這樣寫：
<action path="/main" type="org.apache.struts.actions.ForwardAction" parameter=" default.frame "/>
這樣就不必單獨(dú)寫一個(gè)tiles:insert的頁面，如下：
<tiles:insert definition="vip.warn.day" flush="true" />
3. 模塊中的注釋
不但需要在程序中添加必要的注釋，在定義配置文件的時(shí)候也必須需要添加相應(yīng)注釋，主要是在struts-config-xxx.xml和tiles-defs_zh_CN.xml這些文件中添加注釋，要把a(bǔ)ction或配置模塊的功能解釋清楚，放在配置項(xiàng)的前面，參見上面的配置文件
4. 對(duì)于配置文件的編輯
不能使用Jbuilder里面的xml編輯功能，因?yàn)镴B會(huì)自動(dòng)地改變xml里面的編碼和內(nèi)容，因此，對(duì)xml配置文件的編輯，要使用編輯軟件，如UE等
事件定義
事件對(duì)應(yīng)的類主要有Action、ActionForm，還有jsp中提交的“.do”定義，以及頁面動(dòng)作的提交，以login登錄為例：
1． 類的命名定義（首字母需大寫）
形式為“動(dòng)作名+Action/Form”
如：LoginAction.class、LoginForm.class
2． 頁面地址定義（首字母需小寫）
如果有兩個(gè)單詞以上，第二個(gè)單詞首字母大寫，依此類推
形式為“動(dòng)作名”
如：login.do或loginSys.do
jsp文件命名也按此規(guī)范
3． 頁面動(dòng)作定義
因?yàn)閖sp頁面中的Form對(duì)應(yīng)ActionForm，其本身有action這個(gè)屬性，所以頁面動(dòng)作如果定義也為action，會(huì)引起不必要的麻煩，所以，把頁面動(dòng)作統(tǒng)一定義為“act”，
如需要編輯某條記錄，地址如下：
“/editRecord.do?act= Edit”
如需要?jiǎng)h除，地址如下：
“/editRecord.do?act=Delete”
4． 對(duì)于菜單和操作事件觸發(fā)的控制機(jī)制
由于系統(tǒng)中的菜單和操作都是由“.do”形式向服務(wù)端發(fā)請求的，因此需要一套機(jī)制來控制哪些是對(duì)菜單的事件請求，哪些是對(duì)操作的事件請求；
我們在系統(tǒng)中引入了Filter過濾器，對(duì)所有請求進(jìn)行控制，以及判斷用戶是否登錄和是否有對(duì)資源（菜單等）訪問權(quán)限等；
約定：
jsp頁面上對(duì)于系統(tǒng)中菜單的請求都是“GET”方法，對(duì)于操作的Action都是“POST”方法；
有了這樣的約定，在Filter中先判斷request的請求方法，如果是“GET”方法，則認(rèn)為是對(duì)菜單的請求，所以去“菜單表”根據(jù)請求地址讀取相應(yīng)的記錄，并讀取用戶的權(quán)限表，判斷用戶的菜單權(quán)限；
如果是“POST”的方法，則認(rèn)為是對(duì)操作的請求，并提取request中的“act”動(dòng)作，進(jìn)行對(duì)用戶的權(quán)限點(diǎn)的判定。
參數(shù)信息獲取
1. 公共參數(shù)信息通過Plugin方式在Web服務(wù)啟動(dòng)時(shí)將變量放入application中，使得在任何需要該變量的jsp中都可以調(diào)用；
方式如下：
public void setServletContext(ActionServlet actionServlet) {
try {
ServletContext sc = actionServlet.getServletContext();
//SysInitPwd
sc.setAttribute(Constants.SYS_INIT_PWD,SelectLists.getSysConfig("PWDINIT"));
…
在action等程序中的調(diào)用方式：
getServlet().getServletContext().getAttribute(“…”);
2. 對(duì)于頁面上需要展示的數(shù)據(jù)盡量存放在request這個(gè)范圍里，可以減輕服務(wù)器端內(nèi)存負(fù)載，方式如下：
//調(diào)用員工處理類
StaffDeal sd=new StaffDeal();
//根據(jù)員工狀態(tài)查詢員工
ArrayList al=sd.qryStaff(strState);
//放入request
request.setAttribute("staffInfo",al);
3. 私有的或需要根據(jù)用戶的屬性來獲取參數(shù)信息的，可以在tiles的定義中使用“controlClass=xxx”這個(gè)方式獲取，配置如下例：
<definition name="vip.welcome" path="/vip/welcome.jsp" controllerClass="viptx.logic.vip.welcomeAction" />
需implements Controller中的perform方法，代碼如下例：
public void perform(ComponentContext componentContext,
HttpServletRequest request,
HttpServletResponse response,
ServletContext servletContext) throws IOException,ServletException {
HttpSession session = request.getSession();
// Get current session.
User user = (User) session.getAttribute(Constants.USER_KEY);
if (user == null) {
return null;
}
String uid = user.getUserid();
String sql = "select userid,content from ti_salutatory where userid=‘"+uid+"‘";
try {
…
}
catch (Exception ex) {
throw new ServletException(ex.getMessage());
}
}
4. 對(duì)于后臺(tái)出錯(cuò)信息在前臺(tái)頁面顯示的技巧
首先在properties配置“message.common={0}”
然后在Action類中使用ActionErrors或ActionMessages時(shí)，方法如下：
…
ActionMessages ams = new ActionMessages(); //例外處理
Try{
…
}
catch (Exception ex) {
ex.printStackTrace();
ams.add(ActionMessages.GLOBAL_MESSAGE,
new ActionMessage("message.common", ex.getMessage()));
}
finally {
if (!ams.isEmpty()) {
saveMessages(request, ams);
}
}
…
在jsp頁面中使用方法如下：
<html:messages id="msg" message="true">
<font color="red"><bean:write name="msg"/></font>
</html:messages>
如果有后臺(tái)的messages產(chǎn)生，前臺(tái)頁面就可以出現(xiàn)報(bào)錯(cuò)信息
5. 系統(tǒng)配置文件
系統(tǒng)參數(shù)如數(shù)據(jù)庫連接等在sysConfi.xml文件中配置，存放在“WEB-INF/xml”文件夾下，請參見該文件。
開發(fā)規(guī)范和公用方法
關(guān)于java的開發(fā)規(guī)范參見《Java 編程規(guī)范.doc》，這里僅給出用struts開發(fā)中一些的規(guī)范：
1. java文件存放按業(yè)務(wù)邏輯劃分，并用模塊作為包名的形式，如：telecombi.logic.sysman.security
包名都為小寫形式
所有的Action和ActionForm都存放在同一包下，便于管理，不要跨包調(diào)用
2. 所有ActionForm中的屬性均為“首單詞小寫+第二個(gè)單詞首字母大寫+…”的形式，如：staffId、staffName，不允許使用“_”為單詞連接符
3. 需要驗(yàn)證的頁面，均需要客戶端和服務(wù)端兩次驗(yàn)證（即對(duì)jsp中的Form進(jìn)行javascript驗(yàn)證和Action中的excute方法中進(jìn)行驗(yàn)證），不能只采用其中一種方法，防止客戶繞過js直接提交；
在驗(yàn)證登錄提交的form時(shí)，必須使用staticJavascript="false"，否則就會(huì)把javascript寫到頁面里，如：
<html:javascript formName="logonForm"
dynamicJavascript="true"
staticJavascript="false"/>
<script language="Javascript1.1" src="staticJavascript.jsp"></script>
驗(yàn)證的formName必須和validation.xml中的Form的名字對(duì)應(yīng)起來，否則驗(yàn)證無效
4. ActionForm是代表html中的Form的，其中的變量需要和Form中的屬性對(duì)應(yīng)起來，如：要在jsp中使用<form:text property="userName"/>，則使用的ActionForm中就必須有userName這個(gè)變量
5. 對(duì)于Action中的邏輯，如果處理方法在一個(gè)以上，需要另外新建一個(gè)處理類，負(fù)責(zé)對(duì)Action中的邏輯集中處理，命名為xxxDeal，如：LoginDeal;
Action通過調(diào)用該處理類的方法，實(shí)現(xiàn)業(yè)務(wù)邏輯處理
6. 對(duì)數(shù)據(jù)庫的操作使用DBManager這個(gè)類，對(duì)其中的一些方法，具體介紹如下：
n 查詢結(jié)果對(duì)象化的Select操作，使用Select(String sql,String className)方法
StringBuffer sql = new StringBuffer(
"select staff_id staffId from ts_m_staff ")
.append("where staff_id=‘").append(uid).append("‘");
try {
/**
* User是一個(gè)用戶對(duì)象類，其中有staffId這個(gè)屬性，以及對(duì)應(yīng)的get/set方法，通過
* DBManager的Select方法獲得一個(gè)User的ArrayList集合
*/
ArrayList rs = DBManager.Select(sql.toString(), User.class.getName());
/**
* 如果確定返回的只有一個(gè)對(duì)象，則可以使用
*
*/
User user=(User)rs.get(0);
}
catch (Exception ex) {
throw new ServletException(ex.getMessage());
}
取出來的數(shù)據(jù)可以存放在session或page等里，供jsp頁面調(diào)用，方法為session.setAttribute(“user”,user1)
…
n Insert或Update等操作
使用DBManager里面的executeSql(String sql)方法，如果是批量處理，使用executeBatchSql(String[] sqls)方法，返回成功標(biāo)志為Constants.OPERATE_SUCCESS
失敗標(biāo)志為Constants.OPERATE_FAILED
暫無其它信息返回
n ResultSet對(duì)象向Hashtable集合對(duì)象的轉(zhuǎn)化，使用select(String sql)方法：
除了可以使用DBManager的Select把查詢結(jié)果轉(zhuǎn)為對(duì)象以外，還可以使用以前的直接使用ResultSet對(duì)象的方式，不過這里返回的數(shù)據(jù)集對(duì)象為Hashtable；
Hashtable存放的數(shù)據(jù)結(jié)構(gòu)為：
columnName1 ? ArrayList1(該字段的結(jié)果集)
columnName2 ? ArrayList2(該字段的結(jié)果集)
…
系統(tǒng)中使用該方法的比較多的是用在生成下拉框數(shù)據(jù)，從select方法返回的Hashtable取到字段值，并生成LabelValueBean，具體方法如下：
/**公用函數(shù) Hashtable 轉(zhuǎn)換成 ArrayList (LabelValueBean)*/
private static ArrayList hashToLVB(Hashtable ht, String id, String name,boolean hasBlank) {
if (ht!=null){
ArrayList al = new ArrayList();
ArrayList alId = (ArrayList) ht.get(id.toUpperCase());
ArrayList alName = (ArrayList) ht.get(name.toUpperCase());
int iLen = alId.size();
if (hasBlank)
al.add(new LabelValueBean("未知", "-1"));
for (int i = 0; i < iLen; i++) {
al.add(new LabelValueBean( (String) alName.get(i),
(String) alId.get(i)));
}
return al;
}
else{
return null;
}
}
n AutoSetForm（String sql, Object frm）方法介紹：
a) 該方法可以返回一個(gè)查詢數(shù)據(jù)庫后已對(duì)其中的屬性賦值的對(duì)象，使用方法如下：
User user=DBManager. AutoSetForm(sql,new User());
sql為查詢語句
b) 該方法還可以對(duì)頁面操作后的Form進(jìn)行賦值，比如在頁面上提交一個(gè)對(duì)某條記錄進(jìn)行編輯的操作，當(dāng)Action得到該條記錄的Id號(hào)并查詢數(shù)據(jù)庫成功后，需要把各個(gè)詳細(xì)信息set到ActionForm的屬性變量中去，這個(gè)時(shí)候就可以使用該方法，方法如下：
form= DBManager. AutoSetForm(sql,form);
form為Action的excute方法中傳入的ActionForm
7. 調(diào)用存儲(chǔ)過程
使用DBManager中的execProc(String procName,ArrayList procPrts)方法
procName為存儲(chǔ)過程名，procPrts是該存儲(chǔ)過程的入口參數(shù)集，返回的是ProcOuts的對(duì)象，其中有Result和ExceptionInfo兩個(gè)屬性，表示返回的處理標(biāo)記和異常信息（如果有的話）
8. 數(shù)據(jù)操作返回信息的處理
在對(duì)數(shù)據(jù)操作完成后，需要返回操作是否成功等信息，具體步驟如下：
n 使用屬性文件中的“messages.comm”這個(gè)key，可以對(duì)該key添加具體返回信息
n 程序中使用“ActionMessages”這個(gè)對(duì)象，java程序如下：
ActionMessages ams = new ActionMessages();
…
//執(zhí)行結(jié)果
ProcOuts pResult=null;
//是否調(diào)用成功
if (pResult.getResult() == -1) {
ams.add(ActionMessages.GLOBAL_MESSAGE,
new ActionMessage("message.common",
pResult.getExceptionInfo()));
}
if (!ams.isEmpty()) {
saveMessages(request, ams);
}
Jsp中調(diào)用方法如下：
<html:messages id="msg" message="true">
<font color="red"><bean:write name="msg"/></font>
</html:messages>
