J2EE軟件開(kāi)發(fā)規(guī)范

北京銀都新天地科技有限公司 質(zhì)量管理體系文件密級(jí):內(nèi)部J2EE軟件開(kāi)發(fā)規(guī)范（草稿）版本：V1.0北京銀都新天地科技有限公司總頁(yè)數(shù)28正文20附錄生效日期： 年 月 日編制：魏征審核：批準(zhǔn)：文件變化記錄單版本編號(hào)*狀態(tài)簡(jiǎn)要說(shuō)明變更人變更日期批準(zhǔn)人批準(zhǔn)日期1.0A魏征2010-11-26*狀態(tài)：A增加，M修改，D刪除 目 錄1文檔介紹51.1文檔目的51.2文檔范圍52設(shè)計(jì)規(guī)范52.1Java源代碼規(guī)范52.1.1開(kāi)發(fā)環(huán)境52.1.2命名52.1.3代碼格式62.2jsp/html規(guī)范72.2.1開(kāi)發(fā)環(huán)境72.2.2命名72.2.3代碼格式72.3數(shù)據(jù)庫(kù)設(shè)計(jì)規(guī)范82.3.1數(shù)據(jù)庫(kù)建模82.3.2主要對(duì)象命名規(guī)范設(shè)計(jì)82.3.3SQL源代碼編碼規(guī)范設(shè)計(jì)102.4其他規(guī)范112.4.1IDE的使用112.4.2配置庫(kù)的使用112.4.3限制session的使用112.4.4限制外部包的使用113開(kāi)發(fā)框架113.1目錄結(jié)構(gòu)133.1.1目錄說(shuō)明133.1.2依賴庫(kù)153.2系統(tǒng)參數(shù)163.2.1說(shuō)明163.2.2使用方法173.2.3例程173.3數(shù)據(jù)庫(kù)連接183.3.1說(shuō)明183.3.2使用方法183.3.3例程183.4事務(wù)193.4.1說(shuō)明193.4.2使用方法193.4.3例程193.5緩存203.5.1說(shuō)明203.5.2包、類說(shuō)明213.5.3使用方法213.5.4例程213.6日志223.6.1說(shuō)明223.6.2包、類說(shuō)明223.6.3使用方法223.6.4例程223.7頁(yè)面233.7.1說(shuō)明234關(guān)于其他開(kāi)發(fā)框架234.1.1必要條件234.1.2評(píng)審流程235關(guān)于項(xiàng)目中不使用規(guī)范中的開(kāi)發(fā)框架241 文檔介紹1.1 文檔目的該文檔是針對(duì)J2EE項(xiàng)目軟件開(kāi)發(fā)規(guī)范，用于規(guī)范各項(xiàng)目開(kāi)發(fā)以及產(chǎn)品研發(fā)，使軟件開(kāi)發(fā)過(guò)程有章可循，保證軟件質(zhì)量，加強(qiáng)開(kāi)發(fā)管理。1.2 文檔范圍適用于：項(xiàng)目經(jīng)理，架構(gòu)設(shè)計(jì)師、開(kāi)發(fā)人員等進(jìn)行的開(kāi)發(fā)工作。2 設(shè)計(jì)規(guī)范2.1 Java源代碼規(guī)范2.1.1 開(kāi)發(fā)環(huán)境l IDE使用Myeclipse5.5以上，不建議使用最新版本IDEl 所有java源文件編碼格式為UTF-8l JDK使用1.4.2版本2.1.2 命名 Package 的命名Package 的名字應(yīng)該都是由一個(gè)小寫(xiě)單詞組成，例如：com.urp.acl。此外，對(duì)于包名我們做如下約定：1. 工具函數(shù)類包名前綴為.util2. Servlet類包名前綴為.servlet3. test case類包名前綴為.test 4. action類包名前綴為.action5. dao類包名前綴為.dao6. model類包名前綴為.model 7. service類包名前綴為.service8. webservice類包名前綴為.webservice Class 的命名Class 的名字必須由大寫(xiě)字母開(kāi)頭而其他字母都小寫(xiě)的單詞組成，例如：DataFile或InfoParser。 Class 變量的命名變量的名字必須用一個(gè)小寫(xiě)字母開(kāi)頭。后面的單詞用大寫(xiě)字母開(kāi)頭，例如：debug 或 inputFileSize。 Static Final 變量的命名Static Final 變量的名字應(yīng)該都大寫(xiě)，并且指出完整含義，例SORT_COLUMN=id。 參數(shù)的命名參數(shù)的名字必須和變量的命名規(guī)范一致。 方法的參數(shù)使用有意義的參數(shù)命名，如果可能的話，使用和要賦值的字段一樣的名字：setCounter(int size) this.size = size;2.1.3 代碼格式 文件頭聲明源文件的頭部需要一個(gè)history段，對(duì)于每次對(duì)源文件的重大改動(dòng)，都需要在history段中注明。該段定義代碼頂部，例如：/* 描述: MVC:“部門(mén)表”* / * 創(chuàng)建者: 魏征 * 創(chuàng)建日期: 2010-08-26 18:05:32 * 修改者: * 修改日期: * 修改說(shuō)明: */ 縮進(jìn)變量、函數(shù)的定義使用4個(gè)連續(xù)空格或tab縮進(jìn)。 注釋public 和 protected的成員變量和方法必須寫(xiě)javadoc注釋。超過(guò)1句以上的注釋使用中文書(shū)寫(xiě)。對(duì)于代碼多于10行的private方法也要寫(xiě)javadoc注釋。對(duì)于代碼中的邏輯分支或循環(huán)條件需要書(shū)寫(xiě)注釋，例如：if (some condition)/符合某個(gè)條件，應(yīng)該這樣處理else/否則應(yīng)該那樣處理 代碼行數(shù)每個(gè)類文件代碼行數(shù)禁止超過(guò)1000行。2.2 jsp/html規(guī)范2.2.1 開(kāi)發(fā)環(huán)境l IDE使用Myeclipse5.5以上，不建議使用最新版本IDEl 所有jsp、html、javascript、css等文件編碼格式為UTF-82.2.2 命名 文件的命名jsp與html文件名全部小寫(xiě)，并遵循如下的規(guī)范：列表頁(yè)list.jsp、新增頁(yè)add.jsp、修改頁(yè)edit.jsp、查看頁(yè)view.jsp、其他頁(yè)面遵循動(dòng)詞_下劃線，要求能說(shuō)明顯示內(nèi)容的信息，例如：list_userinfo.jsp Javascript腳本腳本函數(shù)都以xxxYyy的方式命名，函數(shù)的名字必須用一個(gè)小寫(xiě)字母開(kāi)頭。后面的單詞用大寫(xiě)字母開(kāi)頭，例如：validPwd，要求能說(shuō)明顯示內(nèi)容的信息。模塊通用的腳本函數(shù)必須集合于一個(gè)js文件中，在頁(yè)面上通過(guò)形式導(dǎo)入。如果項(xiàng)目已經(jīng)提供了公共js腳本，則優(yōu)先使用公共js腳本中提供的函數(shù)。所有自定義方法的元素定義在后。 表單屬性統(tǒng)一以該表單所需收集的信息的作用或動(dòng)作+Form命名，例如：addForm。表單element的名稱以element需收集的信息標(biāo)示命名，全部小寫(xiě)，例如：對(duì)于 text 類型的輸入域，必須根據(jù)數(shù)據(jù)庫(kù)字段的長(zhǎng)度設(shè)置相應(yīng)的maxlength，例如數(shù)據(jù)庫(kù)類型是VARCHAR(64)，那么maxlength是32。2.2.3 代碼格式 文件頭聲明%-* 描述: “部門(mén)表”頁(yè)面展示* / * 創(chuàng)建者: 魏征 * 創(chuàng)建日期: 2010-08-26 18:05:32 * 修改者: * 修改日期: * 修改說(shuō)明: -%【部門(mén)信息列表】link rel=stylesheet href=/css.css type=text/css /script type=text/javascript src=/js.js 頁(yè)面語(yǔ)法統(tǒng)一使用jsp語(yǔ)法，無(wú)其他特殊情況，禁止使用webwork以及jstl等語(yǔ)法。2.3 數(shù)據(jù)庫(kù)設(shè)計(jì)規(guī)范2.3.1 數(shù)據(jù)庫(kù)建模數(shù)據(jù)庫(kù)建模工具使用powerdesigner 主要對(duì)象命名規(guī)范設(shè)計(jì) 數(shù)據(jù)庫(kù)(Databases)數(shù)據(jù)庫(kù)的命名采用項(xiàng)目名稱簡(jiǎn)寫(xiě)，如統(tǒng)一資源管理平臺(tái)數(shù)據(jù)庫(kù)名為URP。 表空間(Tablespaces)表空間分為兩種，用來(lái)存儲(chǔ)系統(tǒng)生成的臨時(shí)數(shù)據(jù)的臨時(shí)表空間(Temporary Tablespace)和存儲(chǔ)用戶數(shù)據(jù)的永久表空間(Permanent Tablespace)。臨時(shí)表空間的命名為T(mén)EMP。永久表空間的命名分為三段：TBS_SSSS_ZZZZ。TBS表示這是一個(gè)表空間，SSSS為表空間分類號(hào)，ZZZZ為表空間類型，可以為DATA和IDX，DATA表示該表空間用來(lái)存儲(chǔ)表對(duì)象，IDX表示該表空間用來(lái)存儲(chǔ)索引對(duì)象。應(yīng)用系統(tǒng)中的表和索引分別存儲(chǔ)在兩個(gè)表空間內(nèi)，以達(dá)到提高性能的目的。系統(tǒng)表空間分類如下：TBS_URP_DATA統(tǒng)一資源管理平臺(tái)數(shù)據(jù)表空間TBS_URP_IDX統(tǒng)一資源管理平臺(tái)索引表空間 數(shù)據(jù)文件(Data files)數(shù)據(jù)庫(kù)文件的命名根據(jù)該文件所屬表空間的名字進(jìn)行，通過(guò)在表空間的名字后加下劃線加編號(hào)來(lái)實(shí)現(xiàn)，數(shù)據(jù)庫(kù)文件的名字用.dbf作為后綴，例如TBS_URP_DATA _01.dbf 表(Table)：數(shù)據(jù)表的命名分為三段：SSSS_ZZZZ_XXXX， SSSS為表類型代號(hào)，ZZZZ為業(yè)務(wù)分類號(hào)，XXXX為業(yè)務(wù)細(xì)類號(hào)，所有字母統(tǒng)一用大寫(xiě)表示。表類型分為數(shù)據(jù)表、擴(kuò)展表、接口表等。數(shù)據(jù)表存儲(chǔ)業(yè)務(wù)數(shù)據(jù)；擴(kuò)展表用于對(duì)基表擴(kuò)充可用數(shù)據(jù)列；接口表用于應(yīng)用系統(tǒng)與外部系統(tǒng)的接口。對(duì)于上述三種表，我們使用可選的表名后綴進(jìn)行標(biāo)識(shí)。(1) 業(yè)務(wù)分類號(hào)：URP統(tǒng)一資源管理平臺(tái)VEH機(jī)動(dòng)車DRV駕駛?cè)?2) 表類型代號(hào)：B業(yè)務(wù)數(shù)據(jù)表（可省略）SPARE擴(kuò)展表IF接口表TEMP臨時(shí)數(shù)據(jù)表或中間數(shù)據(jù)表RPT統(tǒng)計(jì)數(shù)據(jù)表例如：業(yè)務(wù)數(shù)據(jù)表URP_USER、擴(kuò)展表SPARE_URP_USER、統(tǒng)計(jì)表RPT_URP_USER 字段(Fields)存儲(chǔ)信息名詞(多個(gè)單詞用下劃線分隔)，全部大寫(xiě)，例如：USERNAME、LOG_ID；或同統(tǒng)一使用中文第一個(gè)字母簡(jiǎn)拼，例如XM（姓名） 約束(Constraints)主鍵(Primary Key)命名為PK_表名唯一鍵(Unique Key)只有一個(gè)時(shí)命名為UK_表名，否則命名為UK_表名_字段名外鍵(Foreign Key) 命名為FK_表名_字段名 索引(Indexes)索引命名為IDX_表名_字段名 視圖(Views)視圖的命名分為三段：V_SSSS_XXXX，V表示這是一個(gè)視圖，SSSS為業(yè)務(wù)分類號(hào)，XXXX為自定義代號(hào)，例如V_URP_ALLUSER。 同義詞(Synonyms)同義詞的命名分為三段：SYN_SSSS_XXXX，SYN表示這是一個(gè)同義詞，SSSS為業(yè)務(wù)分類號(hào)，XXXX為自定義代號(hào)。0 序列號(hào)(Sequences)序列號(hào)的命名分為三段：SQ_SSSS_XXXX，SQ表示這是一個(gè)序列號(hào)，SSSS為業(yè)務(wù)分類號(hào)，XXXX為自定義代號(hào)。1 存儲(chǔ)過(guò)程(Stored Procedures)存儲(chǔ)過(guò)程的命名分為三段：PRO_SSSS_XXXX，PRO表示這是一個(gè)存儲(chǔ)過(guò)程，SSSS為業(yè)務(wù)分類號(hào)，XXXX為自定義代號(hào)。2 函數(shù)(Functions)函數(shù)的命名分為三段：FUN_SSSS_XXXX，F(xiàn)UN表示這是一個(gè)函數(shù)，SSSS為業(yè)務(wù)分類號(hào)，XXXX為自定義代號(hào)。3 任務(wù)(Job)函數(shù)的命名分為二段：JOB_SSSS，F(xiàn)UN表示這是一個(gè)函數(shù)，SSSS為過(guò)程名稱2.3.3 數(shù)據(jù)庫(kù)建表英中簡(jiǎn)稱對(duì)照表 一般規(guī)定序號(hào)中文名英文名英文簡(jiǎn)稱備注1-1數(shù)據(jù)庫(kù)Databasedb_數(shù)據(jù)庫(kù)名稱的前綴1-2數(shù)據(jù)表Tabletbl_數(shù)據(jù)表名稱的前綴1-3報(bào)表Reportrpt_報(bào)表腳本名稱的前綴1-4編碼CodeCode編碼表的后綴。編碼，多指固定對(duì)象編碼，如車型、車種等1-5字典DictionaryDic字典表的后綴。字典，多指可變參數(shù)字典1-6流水WasteWaste流水表的后綴/流水/流水號(hào)，用于隨時(shí)間、次數(shù)遞增的對(duì)象， 1-7明細(xì)DetailDetail明細(xì)/明細(xì)表的后綴1-8匯總SumSum匯總/匯總表的后綴1-9日志LogLog日志/日志表的后綴1-10信息InformationInfo信息，多用于變長(zhǎng)字段1-11數(shù)量NumberNum數(shù)量、個(gè)數(shù)1-12次數(shù)CountCnt計(jì)數(shù)/次數(shù)1-13序列SerialSerial序列1-14序列號(hào)Serial NumberSN序列號(hào)1-15主鍵IdentificationID主鍵1-16參數(shù)ParameterPara參數(shù)1-17特征CharacteristicChar特征1-18缺省DefaultDef缺省1-19設(shè)備DeviceDev設(shè)備1-20名稱NameName名稱1-21圖片ImageImage圖片1-22自動(dòng)AutoAuto自動(dòng)識(shí)別1-23功能FunctionFunc功能1-24原因CauseCause原因描述1-25上一次LastLast上一次1-26下一次NextNext下一次1-27結(jié)果ResultResult結(jié)果1-28特殊SpecialSpEvent特殊1-29事件EventEvent事件1-30情況CaseCase情況1-31特殊事件Special EventSpEvent特殊事件1-32特殊情況Special CaseSpCase特殊情況1-33狀態(tài)StatusStatus狀態(tài)1-34版本Version Ver版本/版本號(hào)1-35校驗(yàn)VerifyVerify校驗(yàn)1-36校驗(yàn)碼Verify CodeVerifyCode校驗(yàn)碼1-37傳輸TransferTrans傳輸1-38標(biāo)志FlagFlag標(biāo)志/標(biāo)示1-39備注RemarksRemarks備注/說(shuō)明/描述1-40備用SpareSpare備用/備用字段 機(jī)構(gòu)相關(guān)序號(hào)中文名英文名英文簡(jiǎn)稱備注2-1機(jī)構(gòu)OrganizationOrg機(jī)構(gòu)2-2業(yè)主OwnerOwner業(yè)主2-3公司CorporationCorp公司2-4縣CountyCounty縣2-5所屬Belong toBL_所屬2-6網(wǎng)絡(luò)NetworkNet網(wǎng)絡(luò)2-7節(jié)點(diǎn)NodeNode節(jié)點(diǎn)2-8中心CenterCenter中心/省中心 時(shí)間相關(guān)序號(hào)中文名英文名英文簡(jiǎn)稱備注3-1時(shí)間TimeTime時(shí)間3-2發(fā)生OccurOccur發(fā)生/生成3-3操作OperationOper操作3-4啟動(dòng)StartStart啟動(dòng)程序3-5關(guān)閉CloseClose關(guān)閉程序3-6啟用UseUse啟用/使用/生效3-7失效ExpireExpire失效時(shí)間3-8登記RegisterRegister登記/注冊(cè)3-9發(fā)行IssueIssue發(fā)行/卡發(fā)行3-10開(kāi)始BeginBegin開(kāi)始/起3-11結(jié)束EndEnd結(jié)束/止3-12登錄LoginLogin登錄/上班3-13注銷LogoutLogout注銷/下班3-14交易DealDeal交易/處理/操作3-15修改ModifyModify修改3-16抓拍CatchCatch抓拍圖片 人員相關(guān)序號(hào)中文名英文名英文簡(jiǎn)稱備注4-1操作員OperatorOperator操作員4-2收費(fèi)員Toll CollectorTollCollector收費(fèi)員4-3系統(tǒng)管理員AdministratorAdmin系統(tǒng)管理員4-4用戶UserUser用戶4-5口令PasswordPassword口令/密碼4-6工作日期Work DateWorkDate工作日期/工班日4-7持有人HolderHolder持有人4-8責(zé)任人工號(hào)Responsible IDResponsibleID責(zé)任人工號(hào) 車輛相關(guān)序號(hào)中文名英文名英文簡(jiǎn)稱備注5-1車輛VehicleV車輛_信息5-2車型Vehicle ClassVC/VClass車型5-3車種Vehicle TypeVT/VType車種5-4車牌Vehicle License Plate VLP車牌號(hào)/車輛牌照號(hào)碼5-5車長(zhǎng)Vehicle LengthVLength車長(zhǎng)5-6車寬Vehicle WidthVWidth車寬5-7車高Vehicle HeightVHeight車高5-8車重（車貨總重）Vehicle WeightVWeight車重（車貨總重）/座位數(shù)5-9輪數(shù)Wheel NumberWheelNum輪數(shù)5-10車軸AxleAxle車軸5-11軸數(shù)Axle NumberAxleNum軸數(shù)5-12軸組AxisAxis軸組5-13軸型Axis TypeAxisType軸組類型5-14速度SpeedSpeed時(shí)速/速度5-15超過(guò)OverOver超過(guò)5-16限定LimitLimit限定/額定5-17最大MaximumMax最大/最高5-18最小MinimumMin最小/最低5-19超時(shí)時(shí)速Over SpeedOverSpeed超時(shí)時(shí)速5-20超載Over LoadOverLoad超載5-21最高時(shí)速M(fèi)aximum SpeedMaxSpeed最高時(shí)速5-22超時(shí)Time OutTimeOut超時(shí)/是否超時(shí)5-22超時(shí)時(shí)間Over TimeOverTime超時(shí)時(shí)間 卡相關(guān)序號(hào)中文名英文名英文簡(jiǎn)稱備注6-1支付PayPay支付/交費(fèi)6-2未付UnpayUnpay未付/欠費(fèi)6-3支付卡Pay CardPayCard支付卡/電子支付卡6-4銀聯(lián)Union PayUniPay銀聯(lián)6-5銀行BankBank銀行6-6儲(chǔ)值StoreStore儲(chǔ)值6-7記賬TallyTally記賬6-8現(xiàn)金 CashCash現(xiàn)金 6-9銀聯(lián)卡Union Pay CardUniPayCard銀聯(lián)卡6-10儲(chǔ)值卡Store CardStoreCard儲(chǔ)值卡6-11記賬卡Tally CardTallyCard記賬卡6-12通行卡Pass CardPassCard通行卡6-13身份卡ID CardIDCard身份卡6-14公務(wù)卡Official CardOfficialCard公務(wù)卡6-15標(biāo)簽卡Label CardLabelCard標(biāo)簽卡2.3.4 SQL源代碼編碼規(guī)范設(shè)計(jì) 變量命名規(guī)范為了提高SQL代碼的可維護(hù)性，我們對(duì)其制定適當(dāng)?shù)拿?guī)則。變量名用中文名拼音來(lái)表示，防止變量名與數(shù)據(jù)表的字段名重名。l 基本類型局部變量名前加前綴v_l 全局變量名前加前綴g_l 常量名前加前綴c_l 過(guò)程和函數(shù)的參數(shù)函數(shù)變量前加p_，對(duì)IN OUT類型和OUT類型的參數(shù)變量要分別加后綴_io和_o。缺省沒(méi)有前綴的參數(shù)變量都為IN類型。l Record collection類型變量前加前綴r_l %Rowtype類型變量前加前綴rt_l 游標(biāo)cursor類型變量前加前綴cur_ 代碼排版規(guī)范l 縮進(jìn)首字縮進(jìn)設(shè)置為1個(gè)Tab，Tab設(shè)置為4個(gè)空格。通過(guò)適當(dāng)?shù)目s進(jìn)把程序的條件、循環(huán)的邏輯結(jié)構(gòu)顯示出來(lái)。l 使用大小寫(xiě)l 所有的SQL關(guān)鍵字都使用大寫(xiě)字母，而所有的數(shù)據(jù)庫(kù)表、字段、變量用小寫(xiě)。 代碼注釋規(guī)范SQL程序段中的注釋?xiě)?yīng)簡(jiǎn)潔明了，其長(zhǎng)度以60字符以內(nèi)為宜；當(dāng)代碼發(fā)生變化時(shí)，相應(yīng)注釋需及時(shí)更新。對(duì)觸發(fā)器、存儲(chǔ)過(guò)程、函數(shù)和字段等數(shù)據(jù)對(duì)象作相應(yīng)的注釋說(shuō)明。對(duì)觸發(fā)器、函數(shù)或者存儲(chǔ)過(guò)程等加注其作者、功能和創(chuàng)建時(shí)間(修改時(shí)間)等信息。程序文件頭部注釋：文件頭部注釋用于表明該文件的信息及版權(quán)格式。 /*/文件名：/功能描述：/改版履歷：/作者：/描述：/日期：xxxx年xx月xx日/*/l 觸發(fā)器、過(guò)程、函數(shù)注釋：對(duì)觸發(fā)器、過(guò)程、函數(shù)添加注釋描述其主要功能。l 其他需添加注釋的地方：1、 每一個(gè)分支處，如：ifelse；2、 曾經(jīng)出現(xiàn)BUG的地方；3、 聲明變量時(shí)；4、 定義常量時(shí)，解釋常量的意義；5、 其他較難理解的地方；2.4 其他規(guī)范2.4.1 IDE的使用l J2EE項(xiàng)目使用MyEclipse5.5以上，使用UTF-8編碼 l Oracle開(kāi)發(fā)工具使用plsql developer7.0以上2.4.2 配置庫(kù)的使用統(tǒng)一使用SVN作為項(xiàng)目管理及開(kāi)發(fā)配置庫(kù)，開(kāi)發(fā)版本定義與配置庫(kù)中的版本相同。2.4.3 限制session的使用在代碼中使用session需要聽(tīng)取研發(fā)經(jīng)理的意見(jiàn)，研發(fā)經(jīng)理需要在設(shè)計(jì)文檔中登記項(xiàng)目中所有使用到的session的名字和作用。2.4.4 限制外部包的使用開(kāi)發(fā)員如果需要使用一個(gè)外部包需要聽(tīng)取研發(fā)經(jīng)理的意見(jiàn)。在研發(fā)經(jīng)理批準(zhǔn)以前，嚴(yán)禁擅自使用一個(gè)外部的包。3 開(kāi)發(fā)框架為規(guī)范J2EE項(xiàng)目的開(kāi)發(fā)，我們提供了基于JDK1.4的部分基礎(chǔ)模塊，并在此基礎(chǔ)上提供了經(jīng)過(guò)了封裝、提煉的開(kāi)發(fā)組件。通過(guò)在項(xiàng)目中對(duì)開(kāi)發(fā)組件的集成，以開(kāi)發(fā)產(chǎn)品的角度去開(kāi)發(fā)項(xiàng)目，達(dá)到降低項(xiàng)目風(fēng)險(xiǎn)，提高項(xiàng)目質(zhì)量及加快項(xiàng)目進(jìn)度。所有J2EE新項(xiàng)目必須使用該開(kāi)發(fā)框架。1）整體架構(gòu)如下：各模塊說(shuō)明如下l 數(shù)據(jù)資源層：本框架默認(rèn)支持oracle數(shù)據(jù)庫(kù)，可通過(guò)方言擴(kuò)展方式實(shí)現(xiàn)對(duì)其他關(guān)系型數(shù)據(jù)庫(kù)的支持；l 持久層：使用ibatis實(shí)現(xiàn)數(shù)據(jù)操作，通常是對(duì)單表進(jìn)行操作，達(dá)到化繁為簡(jiǎn)，便于維護(hù)的目的；l 業(yè)務(wù)層：使用spring作為持久層與MVC框架之間的橋梁，通過(guò)MVC框架webwork實(shí)現(xiàn)對(duì)于業(yè)務(wù)流程的流轉(zhuǎn)控制；l 表現(xiàn)層：體現(xiàn)“以用戶體驗(yàn)為中心”的設(shè)計(jì)思想；l 中間件：支持JDK1.4以上版本J2EE中間件環(huán)境；l 插件：使用一系列的頁(yè)面組件、控件、工具類插件，使系統(tǒng)能夠快速集成；組件：通過(guò)一系列基于開(kāi)發(fā)框架的組件應(yīng)用，實(shí)現(xiàn)對(duì)應(yīng)用系統(tǒng)的快速集成開(kāi)發(fā)，提高代碼復(fù)用率。2）框架序列圖如下：注： 所有Dao操作必須繼承BaseIbatisDao 所有Action操作必須繼承BaseWebworkAction 所有的數(shù)據(jù)建模Module必須繼承BaseEntity3.1 目錄結(jié)構(gòu)3.1.1 目錄說(shuō)明l src源目錄：-com.一級(jí)域名|-urp二級(jí)域名(統(tǒng)一資源權(quán)限)|-acl三級(jí)域名(資源權(quán)限)|-actionMVC|-service-事務(wù)控制|-dao-業(yè)務(wù)操作|-interceptor攔截器|-model數(shù)據(jù)庫(kù)建模|-translate代碼翻譯 |-Constants.java常量類|-core三級(jí)域名(核心代碼)|-ibatis持久層操作|-cache緩存操作|-dao核心操作基類|-dialect數(shù)據(jù)庫(kù)方言|-entity數(shù)據(jù)庫(kù)建?；恷-page-分頁(yè)操作|-spring-spring操作|-util工具類|-webworkwebwork基類|-servlett三級(jí)域名|-IndexAction系統(tǒng)主頁(yè)入口|-MainAction系統(tǒng)主頁(yè)主頁(yè)面入口|-projectName二級(jí)域名(業(yè)務(wù)源碼，根據(jù)業(yè)務(wù)修改projectName名稱)-i18n國(guó)際化-ibatisibatis配置文件|-aclibatis資源權(quán)限配置文件|-projectName二級(jí)域名(ibatis配置，根據(jù)業(yè)務(wù)修改projectName名稱)|-ibatisConfig.xmlibatis配置入口-springspring配置文件|-aclspring資源權(quán)限配置文件|-projectName二級(jí)域名(spring配置，根據(jù)業(yè)務(wù)修改projectName名稱)|-applicationContext.xmlspring配置入口-xworkwebwork配置文件|-aclwebwork資源權(quán)限配置文件|-projectName二級(jí)域名(webwork配置，根據(jù)業(yè)務(wù)修改projectName名稱)-pertieswebsphere緩存配置文件-ehcache.xmlehcache緩存配置文件-perties數(shù)據(jù)庫(kù)配置文件- perties日志配置文件-pertieswebwork配置文件-xwork.xmlwebwork配置入口l 文件目錄結(jié)構(gòu) -WebRoot |-images圖片 |-jsjavascript文件 |-style樣式文件 |-pages |-acl資源權(quán)限 |-tablename表名 |-add.jsp新增數(shù)據(jù)視圖 |-edit.jsp修改數(shù)據(jù)視圖 |-list.jsp列表數(shù)據(jù)視圖 |-view.jsp查看數(shù)據(jù)視圖|- projectName (根據(jù)業(yè)務(wù)修改projectName名稱) |-tools工具 |-401.jsp401 |-403.jsp403 |-404.jsp403 |-500.jsp500 |-error.jsp錯(cuò)誤提示頁(yè)面 |-noprivilege.jsp無(wú)權(quán)限提示頁(yè)面 |-success.jsp成功操作提示頁(yè)面 |-token.jsp重復(fù)提交提示頁(yè)面 |-plugins插件 |-bgjs整體視圖 |-ecside列表 |-formValidator表單校驗(yàn) |-FusionCharts統(tǒng)計(jì)圖 |-My97DatePicker日歷控件 |-WEB-INF |-lib依賴庫(kù) |-web.xmlweb.xml |-index.jsp主頁(yè) |-index0.jsp跳轉(zhuǎn)頁(yè) |-login.jsp登陸頁(yè) |-main.jsp主頁(yè)主頁(yè)面注：根據(jù)具體項(xiàng)目修改projectName名稱3.1.2 依賴庫(kù)名稱依賴庫(kù)說(shuō)明Springspring-2.0.8Webworkrife-continuations-1.0webwork-2.2.7xwork-1.2.4javassist-3.6.0ognl-1.0oscore-1.0freemarker-2.3.8dom4j-1.6.1cglib-2.1_3cglib-nodep-2.1_3javamail-1.5Apache commonscommons-beanutils-1.6commons-codec-1.3commons-collections-3.2commons-dbcp-1.2.1commons-dbutils-1.0commons-digester-1.8commons-fileupload-1.2commons-io-1.2commons-lang-2.3commons-pool-1.3commons-validator-1.3.1Log4j commons-logging-1.1log4j-1.2.9緩存ehcache-1.2.3dynacache-6.0Websphere版本6.0Ibatisibatis-77Xmldom4j-1.6.1jaxen-1.1-beta-7xercesImpl-1.2Oracle驅(qū)動(dòng)ojdbc14-.0Oracle版本.0Javascriptjquery.js版本 系統(tǒng)參數(shù)3.2.1 說(shuō)明 使用system.xml文件配置系統(tǒng)常量參數(shù)，系統(tǒng)啟動(dòng)時(shí)會(huì)加載該配置文件 使用urp_syspara表配置系統(tǒng)可變參數(shù)，系統(tǒng)啟動(dòng)時(shí)會(huì)加載該數(shù)據(jù)3.2.2 使用方法 根據(jù)項(xiàng)目具體情況修改system.xml 根據(jù)項(xiàng)目具體情況修改com.urp.acl.Constants3.2.3 例程文件 system.xml統(tǒng)一資源管理平臺(tái)北京銀都新天地科技有限公司北京銀都新天地科技有限公司 010-ehcachecache/urpCache_user_key!- 模塊權(quán)限 List -_rights_key!- 模塊功能權(quán)限Map -_rights_moduledetail_key!- 模塊功能訪問(wèn)權(quán)限Map -_rights_actionmethod_keyd0329c46663bff837d4af6e513.3 數(shù)據(jù)庫(kù)連接3.3.1 說(shuō)明使用Spring配置數(shù)據(jù)庫(kù)的連接。3.3.2 使用方法不使用中間件提供的連接池 修改jdbc-oracle.pr