【正文】 h”塊合并到一起。由于這些塊將代碼分割成小的、各自獨立的片斷，所以會妨礙編譯器進行優(yōu)化。但是，若過份熱衷于刪除異常處理模塊，也可能造成代碼健壯程度的下降，所以在合并的同時需要考慮程序的穩(wěn)定性。. 類名的唯一性請保證在自己類路徑指到的任何地方，每個名字都僅對應(yīng)一個類。否則，編譯器可能先找到同名的另一個類，并報告出錯消息。若懷疑自己碰到了類路徑問題，請試試在類路徑的每一個起點。2. web應(yīng)用開發(fā)規(guī)范. 用公司生成器生成代碼，并參照該規(guī)范生成單表結(jié)構(gòu)的代碼，注意其中entity層和dao層一般情況下是不允許修改的，業(yè)務(wù)對象（Business層）可以根據(jù)需要擴展，業(yè)務(wù)邏輯（proxy）層用來寫絕大多數(shù)的業(yè)務(wù)邏輯，不允許將大段的業(yè)務(wù)代碼寫在action(controller層)中。. 命名規(guī)范 Class 的名字大寫字母開頭，英文單詞也可為縮略詞(全部大寫)，如：，； 方法名、變量名小寫字母開頭，如：showName(),username； Action中的方法名要與相對應(yīng)的配置和頁面對應(yīng)，若Action類中的方法名是”abcDe”，那么 xml文件中的action名應(yīng)是””，所對應(yīng)的jsp文件名是” ”。 布爾類型的名字要直觀，布爾類型的方法、屬性或者Field，is通常是一個不錯的前綴。例如：public bool isEmpty、public bool isEmpty(object o). 日志. Controller層的操作必須記系統(tǒng)日志無論是controller類，還是action類，每個頁面操作都必須記錄系統(tǒng)日志，即調(diào)用saveLog()方法。需注意參數(shù)，最多參數(shù)為三個：日志信息（logInfo）：日志信息需規(guī)范化，重要信息用半角中括號（”[]”）擴起來，如：訪問欄目[重要文件]成功日志類型（logType）：日志類型需按要求傳參。操作對象ID（caseInfo）：記錄相關(guān)操作項的唯一標(biāo)識，如欄目ID、信息ID、資源ID。. Portlet中日志除了需記portlet類型之外，還需根據(jù)實際內(nèi)容，記其他類型的日志，如：欄目相關(guān)的portlet需記欄目類型的日志。. 數(shù)據(jù)庫. 數(shù)據(jù)庫連接必須關(guān)閉Connection、PreparedStatement、ResultSet都要關(guān)閉，注意在異常情況相關(guān)對象的關(guān)閉。其中Connection的獲得和關(guān)閉如下：try{Connection conn = ().getConnection()。} catch(SQLException e){ ()。 return ERROR。}finally{ try{ ().closeConnection(conn)。 }catch(SQLException e){ ()。}. 異常拋出需盡量在controller層中進行try catch，代理proxy層中只做throw. 一個業(yè)務(wù)需對數(shù)據(jù)庫進行多操作，需根據(jù)情況，按事務(wù)提交。將事務(wù)自動提交設(shè)置為false，事務(wù)全處理完后進行提交，提交后需將事務(wù)的自動提交置回true。如：(false)。…………。()。(true)。. 禁止從jsp頁面直接訪問數(shù)據(jù)庫. 沒有明確的理由，不允許使用拼裝SQL的方式使用拼裝SQL的方式，容易存在安全漏洞，產(chǎn)生sql注入漏洞，而且對SQL翻譯引擎造成較大的負(fù)擔(dān)。沒有明確的理由，不允許使用拼裝SQL的寫法，采用參數(shù)化的SQL。如：String sql =”select * from tableName where id=?”。 //參數(shù)化sqlPreparedStatement pstmt = (sql)。(1,”001”)。 //參數(shù)化sql()。()。. 注釋1. 注釋要簡單明了。String userName = null。 //用戶名2. 邊寫代碼邊注釋，修改代碼同時修改相應(yīng)的注釋，以保證注釋與代碼的一致性。3. 在必要的地方注釋，注釋量要適中。注釋的內(nèi)容要清楚、明了，含義準(zhǔn)確，防止注釋二義性。保持注釋與其描述的代碼相鄰，即注釋的就近原則。4. 對代碼的注釋應(yīng)放在其上方相鄰位置，不可放在下面。對數(shù)據(jù)結(jié)構(gòu)的注釋應(yīng)放在其上方相鄰位置，不可放在下面；對結(jié)構(gòu)中的每個域的注釋應(yīng)放在此域的右方；同一結(jié)構(gòu)中不同域的注釋要對齊。5. 變量、常量的注釋應(yīng)放在其上方相鄰位置或右方。 6. 全局變量要有較詳細的注釋，包括對其功能、取值范圍、哪些函數(shù)或過程存取它以及存取時注意事項等的說明。7. 每個程序文件頭需有注釋，需注明作者、創(chuàng)建時間、模塊名、版本號、詳細功能說明、修改時間、修改的說明等；例如：/** 模塊名：xxxx xxx xxx* 版本號：V* 創(chuàng)建時間：xxxx年x月xx日* 作 者：xxxx xxx xxx* 詳細功能說明：xxxx xxx xxx* 更新紀(jì)錄：xxxx年x月xx日，修改人xxx，增加功能包括：xxxxx*/8. 每個方法頭須有注釋，包括：功能描述、輸入、輸出、返回值說明等；修改或增加別人的類文件中的方法，需在該方法頭和修改處注明修改的時間、修改人、修改說明等相關(guān)信息/** * @Description 功能描述 * @Author 方法創(chuàng)建者 * @CreatDate 創(chuàng)建日期 * @UpdateUser 方法更新者 * @UpdateDate 更新日期* @param 參數(shù) * @return 返回值 */9. javadoc注釋標(biāo)簽語法@author 對類的說明 標(biāo)明開發(fā)該類模塊的作者 @version 對類的說明 標(biāo)明該類模塊的版本 @see 對類、屬性、方法的說明 參考轉(zhuǎn)向，也就是相關(guān)主題 @param 對方法的說明 對方法中某參數(shù)的說明 @return 對方法的說明 對方法返回值的說明 @exception 對方法的說明 對方法可能拋出的異常進行說明. 頁面. jsp文件頭必須有!DOCTYPE html PUBLIC //W3C//DTD XHTML Transitional//EN html xmlns=. 每個頁面，input及其html元素需以”/”結(jié)尾，如input name=”aaa” type=”text” value=”” /、br/等；. Jsp及html頁面緩存的清除（1）禁用客戶端緩存，head中需包含以下語句以防止頁面緩存發(fā)生：meta equiv=Pragma content=nocache/meta equiv=cachecontrol content=nocache meta equiv=expires content=0（2）在服務(wù)器的動態(tài)網(wǎng)頁中禁止緩存，要加入類似如下腳本，加入后的頁面form提交后，瀏覽器后退，會提示“網(wǎng)頁過期”。(Pragma,Nocache)。 (CacheControl,nocache)。 (Expires, 0)。. 換膚功能需要注意的地方為了新開發(fā)的系統(tǒng)都能夠?qū)崿F(xiàn)換膚功能，每個新開發(fā)的頁面都必須遵循15B的樣式規(guī)范，如：%@ include file=../ %，樣式表的引用路徑里調(diào)用變量“wafstyle”，如：link href=css/%=wafstyle%/ rel=stylesheet type=text/css. 錯誤信息通過變量errorInfo，傳給error頁面. 成功返回地址通過變量returnURL傳遞. 頁面跳轉(zhuǎn)中，需注意為returnURL賦值表單提交，一般情況是先跳轉(zhuǎn)到成功或失敗頁，再根據(jù)returnURL返回到相應(yīng)頁面。尤其要注意returnURL中所應(yīng)帶的參數(shù)，要包括翻頁參數(shù)、列表上的查詢條件參數(shù)等，如列表翻到第5頁后進行其他操作之后要仍能返回第5頁，輸入查詢條件之后，得到列表，操作后仍能返回該結(jié)果列表。. 數(shù)據(jù)校驗. 表單數(shù)據(jù)提交在前臺頁面要進行js校驗. 在后臺類里要進行java代碼的校驗后臺校驗使用struts2的校驗框架（生成器中待完善此部分）. 調(diào)試代碼. () 輸出調(diào)試信息() 輸出錯誤信息() 輸出一般信息，來設(shè)置調(diào)試信息的輸出方式和輸出級別在系統(tǒng)正式上線之后，保證輸出級別不是debug模式。. 代碼交付時，(“”)語句，重要的記錄用log代替29