EKPFORJAVA開發(fā)樣例V4

1、藍(lán)凌JAVA產(chǎn)品EKP FOR JAVA 開發(fā)樣例 文檔控制/Document Control 修改記錄日期作者版本備注2007-09-24易榮烽V1.0初稿2007-11-09易榮烽V1.0初稿完成2008-03-10李明輝V2.0升級core2.0文稿修改2009-05-05周超V3.0升級core3.0文檔修改2009-09-07易榮烽V3.1合并修改2011-07-14曹映輝V3.2升級ModelsTry修改2011-08-16繆貴榮V4.0文檔升級更新 審閱人日期審閱人版本備注 分發(fā)日期分發(fā)人分發(fā)對象備注 目 錄第一章、概述41.1.目的41.2.范圍41.3.文檔約定4第二章、開發(fā)

2、規(guī)范5第三章、開發(fā)環(huán)境準(zhǔn)備6第四章、簡單樣例開發(fā)71.1需求分析71.2頁面原形的制作71.3檢出項目71.4啟動項目8創(chuàng)建數(shù)據(jù)庫8修改數(shù)據(jù)庫連接的配置9啟動內(nèi)存溢出的解決9數(shù)據(jù)初始化11登陸首頁驗證環(huán)境121.5數(shù)據(jù)庫設(shè)計12新建存放代碼的項目12新建ModelsTry數(shù)據(jù)模型文件15表設(shè)計181.6生成代碼20設(shè)置模型屬性20生成代碼241.7拷貝代碼文件27拷貝java文件27拷貝jsp文件28拷貝XMl配置文件29模塊目錄樹tree.jsp291.8修改業(yè)務(wù)代碼30修改model代碼30修改form代碼30修改dao代碼30修改service代碼31修改action代碼31修改list

3、頁面代碼33修改edit頁面代碼34修改view頁面代碼361.9啟動項目測試功能39第五章、常用組件使用411.1.枚舉類型411.1.1.數(shù)據(jù)庫設(shè)計411.1.2.枚舉類型配置文件451.2.RTF文本域461.2.1.數(shù)據(jù)庫設(shè)計461.2.2.修改edit頁面代碼491.2.3.修改view頁面代碼501.3.樹511.3.1.數(shù)據(jù)庫設(shè)計511.3.2.修改model代碼531.3.3.修改form代碼561.3.4.修改service代碼581.3.5.修改dao代碼601.3.6.修改list頁面601.3.7.修改edit頁面601.3.8.修改view頁面621.4.分類631.

4、4.1.數(shù)據(jù)庫設(shè)計631.4.2.修改action代碼661.4.3.修改list頁面代碼671.4.4.修改edit頁面代碼671.4.5.修改view頁面代碼681.5.綜合應(yīng)用681.5.1.數(shù)據(jù)庫設(shè)計681.5.2.修改ModelsTry屬性691.5.3.修改model文件751.5.4.修改form文件751.5.5.修改dao代碼751.5.6.修改action代碼761.5.7.修改list頁面代碼761.5.8.修改edit頁面代碼791.5.9.修改view頁面代碼83第六章、機(jī)制部署87第七章、附錄881.1登陸系統(tǒng)881.2轉(zhuǎn)入系統(tǒng)頁面881.3導(dǎo)入系統(tǒng)初始化891.4

5、導(dǎo)航樹配置901.5主頁設(shè)置92文檔授權(quán)95 第一章、概述1.1. 目的本文檔的目的是使Java產(chǎn)品開發(fā)能以標(biāo)準(zhǔn)的、規(guī)范的方式設(shè)計和編碼，通過該指引可以使新開發(fā)人員快速進(jìn)入開發(fā)、查找樣例代碼，提高開發(fā)質(zhì)量和速度。.1.2. 范圍1、項目組成員；2、藍(lán)凌公司相關(guān)技術(shù)開發(fā)人員；3、其他經(jīng)公司認(rèn)可的必要知情的人員。1.3. 文檔約定本文檔采用MS Word2003軟件編寫，采用統(tǒng)一風(fēng)格排版，正文風(fēng)格為：五號中文宋體、五號英文Arial字體、行距1.5行； 針對需要重點注意的段落，采用紅色描色。一般來說，各章內(nèi)容相對獨立，構(gòu)成全文的有效組成部分。 第二章、開發(fā)規(guī)范開發(fā)規(guī)范請查閱藍(lán)凌JAVA產(chǎn)品開發(fā)規(guī)范

6、查看的時候請注意選擇最新的版本：文檔標(biāo)題下面帶有“舊”字的圖標(biāo)，表示該文檔已有更新版本，可以在文檔的最后面“版本列表”中選擇版本號最大的文檔，也就是最新的文檔。 第三章、開發(fā)環(huán)境準(zhǔn)備開發(fā)環(huán)境配置請查閱藍(lán)凌JAVA項目開發(fā)環(huán)境搭建指南藍(lán)凌JAVA產(chǎn)品開發(fā)環(huán)境搭建指南 第四章、簡單樣例開發(fā)我們只做一個一張表的例子，如簡單樣例，我們這張表里面就只有（標(biāo)題、內(nèi)容、創(chuàng)建日期）。這里只是為了讓大家能快速的熟悉我們的一個開發(fā)流程。1.1 需求分析首先根據(jù)需求調(diào)研做初始的需求分析，理解業(yè)務(wù)。此處業(yè)務(wù)簡單就不做分析了。1.2 頁面原形的制作根據(jù)理解的業(yè)務(wù)，做出頁面原型，此處業(yè)務(wù)簡單就不做頁面原型。1.3 檢出項

7、目入職開通了SVN服務(wù)器賬號后，到SVN資源庫(/EKP_EXAMPLE)里檢出EKP_EXAMPLE注意：僅檢出EKP_EXAMPLE下的trunk。檢出的項目名稱修改為ekp1.4 啟動項目1.4.1 創(chuàng)建數(shù)據(jù)庫l 創(chuàng)建數(shù)據(jù)庫 可以采用MySQL，SQLServer，或Oracle數(shù)據(jù)庫。.2 修改數(shù)據(jù)庫連接的配置l 在WebContentWEB-INFKmssConfig下的perties文件，根據(jù)數(shù)據(jù)庫位置修改數(shù)據(jù)庫連接配置l 啟動項目，hibernate會自動為數(shù)據(jù)庫創(chuàng)建表。1.4.3 啟動內(nèi)存溢出的解決l 若是在eclipse內(nèi)部啟動to

8、mcat，報內(nèi)存太小或內(nèi)存溢出，請在eclipse中進(jìn)行jvm內(nèi)存設(shè)置。window-preferences-java-installed jres 選擇JDK的版本edit:default vm arguments 填寫： -Xms256m Xmx1024m注意：這個參數(shù)可根據(jù)本機(jī)的內(nèi)存大小進(jìn)行調(diào)整。l 若是在外部tomcat啟動，報內(nèi)存太小或內(nèi)存溢出，請進(jìn)行tomcat內(nèi)存設(shè)置。D:javaTomcatbin 里的catalina.bat文件rem - Execute The Requested Command 下 加入set JAVA_OPTS= -Xms256m -Xmx1024ml

9、如下圖顯示 即為啟動成功1.4.4 數(shù)據(jù)初始化l 暫停啟動的WEB服務(wù)l 從檢出項目的sql目錄中獲取對應(yīng)的數(shù)據(jù)初始化腳本l 將對應(yīng)腳本在數(shù)據(jù)庫中執(zhí)行一次，完成數(shù)據(jù)初始化。（注意：初始化腳本只能執(zhí)行一次）1.4.5 登陸首頁驗證環(huán)境l 若Web根路徑為ekp可以參考上圖路徑進(jìn)行訪問（http:/localhost:8080/ekp/login.jsp），管理員用戶名為：“admin” 默認(rèn)密碼為：“1”登陸成功說明環(huán)境搭建正常1.5 數(shù)據(jù)庫設(shè)計1.5.1 新建存放代碼的項目l 使用ModelsTry之前，請確認(rèn)ModelsTry版本為2011-8-25或者之后的版本。在目錄下找到“更新說明.t

10、xt”，如下圖。如果沒有更新說明.txt或者里面沒有2011-8-25的更新記錄，請先更新該插件。更新方法：到3software產(chǎn)品插件modelstrymodelstry新版本（用戶名：prod、密碼：prod）下拷貝com.sunbor.modelstry_3.1.0這個目錄，替換本地這個目錄即可。l 數(shù)據(jù)模型設(shè)計之前，最好先學(xué)習(xí)ModelsTry的使用，可參考文檔 藍(lán)凌JAVA產(chǎn)品XModel使用指南，說明ModelsTry也稱為XModell 由于代碼生成出來會有一些不用的代碼，所以最好新建一個項目來存放生成的代碼和ModelsTry模板l 點擊file菜單，點擊

11、new，選擇project，在彈出的對話中選擇General下面的Project，如下圖：l 然后點擊Next（下一步），填寫項目名稱，隨便填寫一個，我們這里就填寫example，點擊Finish完成。1.5.2 新建ModelsTry數(shù)據(jù)模型文件l 在example項目上單擊右鍵，在菜單中選擇new，然后點擊other，在出來的對話框中選擇ModelsTry代碼生成工具下的ModelsTry數(shù)據(jù)庫模型文件，如下圖：l 然后點擊Next（下一步），然后點擊Finish，會自動打開新建的ModelsTry數(shù)據(jù)庫模型文件，如下圖：1.5.3 表設(shè)計l 新建表點擊選中左邊導(dǎo)航的新建 新建表，移動鼠標(biāo)

12、到右邊空白處點擊，即可新建一個類（如下圖），雙擊該類，修改名稱：簡單樣例、代碼：example_sample_singlel 新增、編輯屬性如上圖，可以手動添加、修改各個屬性。注意勾選標(biāo)題的“顯示”，一般勾選標(biāo)題或者名稱屬性的顯示。用于聲明對象的顯示屬性。對特殊屬性ModelsTry提供了快捷添加方式，例如，添加創(chuàng)建時間屬性，點擊選中常用 創(chuàng)建時間，移動鼠標(biāo)到“簡單樣例”表的屬性區(qū)域空白處點擊，即可添加創(chuàng)建時間屬性，參看下圖：l 添加外鍵屬性例如添加創(chuàng)建者屬性，先添加“組織架構(gòu)元素”，然后點擊選中常用 創(chuàng)建人，移動鼠標(biāo)到“簡單樣例”表的屬性區(qū)域空白處點擊（拖動出現(xiàn)連接線），在移動鼠標(biāo)到“組織架

13、構(gòu)元素”表的屬性區(qū)域空白處點擊，即可添加創(chuàng)建者屬性，并設(shè)置外鍵關(guān)聯(lián)關(guān)系。如下圖。特殊組件的用法請參考第五章，更多ModelsTry的使用方法詳細(xì)參考藍(lán)凌JAVA產(chǎn)品XModel使用指南。1.6 生成代碼1.6.1 設(shè)置模型屬性........ 編輯模塊屬性l 點擊設(shè)置模型屬性按鈕l 點擊模塊編輯選項卡，點擊+按鈕添加新模塊，填寫模塊名稱：簡單樣例，代碼：example.sample，如下圖：l 由于簡單樣例是關(guān)聯(lián)到組織架構(gòu)的，所以要再添加

14、組織架構(gòu)模塊，名稱：組織架構(gòu)，代碼：anization,如下圖：l 將簡單樣例表添加到簡單樣例模塊，將組織架構(gòu)表添加到組織架構(gòu)模塊中去，如下圖：l 點擊確定就可以了 編輯表屬性l 雙擊“組織架構(gòu)元素”表，由于組織架構(gòu)在ekp中屬于系統(tǒng)表，這里僅是為簡單樣例表中的創(chuàng)建者與之建立外鍵關(guān)聯(lián)，其代碼在ekp中本已生成，故此將“是否生成代碼”，選為“否”，如下圖所示.............1.6

15、..1.6.2 生成代碼l 代碼生成之前，先設(shè)置代碼的作者（Window Preferences ModelsTry），效果如下圖，用戶名填寫自己的姓名。l 點擊生成所有代碼生成圖標(biāo)，如下圖：l 生成代碼后，如下圖：1.7 拷貝代碼文件生成的代碼分三次拷貝，分別為： src下的java文件 jsp下的jsp文件 config下的xml配置文件詳解如下：1.7.1 拷貝java文件l 在example項目的src目錄下，將example.sample相關(guān)的代碼復(fù)制，然后拷貝到ekp項目下src的com.landray.kmss包下面，如下圖：1.7.2 拷貝jsp文件l 在exam

16、ple項目的jsp目錄下，將example目錄復(fù)制，然后拷貝到ekp項目下的WebContent下面，如下圖：1.7.3 拷貝XMl配置文件l 在example項目的config目錄下，將example目錄復(fù)制，然后拷貝到ekp項目下的WebContent的WEB-INF/kmssconfig對應(yīng)的自己模塊的目錄下面。...1.7.4 模塊目錄樹tree.jspl 在example項目的WebContentexamplesample目錄下tree.jsp（模塊樹），頁面效果圖如下1.8 修改業(yè)務(wù)代碼注意：l 頁面table寬度修改一般情況

17、下 table 中一行四列的寬度width比率為15%,35%,15%,35%一行兩列的寬度width比率為15%,85% 對于寬度為85%的注意添加跨列屬性colspan=31.8.1 修改model代碼.........1.l 不需要修改1.8.2 修改form代碼l 不需要修改1.8.3 修改dao代碼l 由于創(chuàng)建者和創(chuàng)建時間是在保存的時候后臺去處理，所以需要在dao里面重載add方法，具體代碼如下：package com.landray.kmss.example

18、.sample.dao.hibernate;import java.util.Date;import mon.dao.BaseDaoImp;import mon.model.IBaseModel;import com.landray.kmss.example.sample.dao.IExampleSampleSingleDao;import com.landray.kmss.example.sample.model.ExampleSampleSingle;import com.landray.kmss.util.UserUtil;/* * 簡單樣例數(shù)據(jù)訪問接口實現(xiàn) * * author 張三

19、* version 1.0 2011-08-16 */public class ExampleSampleSingleDaoImp extends BaseDaoImp implementsIExampleSampleSingleDao public String add(IBaseModel modelObj) throws Exception ExampleSampleSingle createInfoModel = (ExampleSampleSingle) modelObj;if (createInfoModel.getDocCreator() = null) / 創(chuàng)建者createI

20、nfoModel.setDocCreator(UserUtil.getUser();if (createInfoModel.getDocCreateTime() = null) / 創(chuàng)建時間createInfoModel.setDocCreateTime(new Date();return super.add(modelObj);1.8.4 修改service代碼l 由于沒有復(fù)雜業(yè)務(wù)，所以不需要修改service代碼。1.8.5 修改action代碼l Action里添加初始化方法，設(shè)置創(chuàng)建時間為當(dāng)前時間、創(chuàng)建者為當(dāng)前用戶。/* * 新建時 初始化默認(rèn)創(chuàng)建時間，創(chuàng)建者 */Overridepr

21、otected ActionForm createNewForm(ActionMapping mapping, ActionForm form,HttpServletRequest request, HttpServletResponse response)throws Exception ExampleSampleSingleForm mainForm = (ExampleSampleSingleForm) super.createNewForm(mapping, form, request, response); / 默認(rèn)創(chuàng)建時間mainForm.setDocCreateTime(Date

22、Util.convertDateToString(new Date(),DateUtil.TYPE_DATETIME, request.getLocale(); /默認(rèn)創(chuàng)建者mainForm.setDocCreatorName(UserUtil.getUser().getFdName();return mainForm;l 完整的Action代碼如下：package com.landray.kmss.example.sample.actions;import java.util.Date;import javax.servlet.http.HttpServletRequest;import j

23、avax.servlet.http.HttpServletResponse;import org.apache.struts.action.ActionForm;import org.apache.struts.action.ActionMapping;import mon.actions.ExtendAction;import mon.service.IBaseService;import com.landray.kmss.example.sample.forms.ExampleSampleSingleForm;import com.landray.kmss.example.sample.s

24、ervice.IExampleSampleSingleService;import com.landray.kmss.util.DateUtil;import com.landray.kmss.util.UserUtil;/* * 簡單樣例 Action * * author 張三 * version 1.0 2011-08-16 */public class ExampleSampleSingleAction extends ExtendAction protected IExampleSampleSingleService exampleSampleSingleService;protec

25、ted IBaseService getServiceImp(HttpServletRequest request) if (exampleSampleSingleService = null)exampleSampleSingleService = (IExampleSampleSingleService) getBean(exampleSampleSingleService);return exampleSampleSingleService;Overrideprotected ActionForm createNewForm(ActionMapping mapping, ActionFo

26、rm form,HttpServletRequest request, HttpServletResponse response)throws Exception ExampleSampleSingleForm mainForm = (ExampleSampleSingleForm) super.createNewForm(mapping, form, request, response);/ 默認(rèn)創(chuàng)建時間mainForm.setDocCreateTime(DateUtil.convertDateToString(new Date(),DateUtil.TYPE_DATETIME, reque

27、st.getLocale();/ 默認(rèn)創(chuàng)建者mainForm.setDocCreatorName(UserUtil.getUser().getFdName();return mainForm;1.8.6 修改list頁面代碼.1.51.6l 可根據(jù)需求調(diào)整字段顯示順序或者是否顯示l 頁面效果圖如下：1.8.7 修改edit頁面代碼l 由于生成的代碼按照一行顯示2個屬性，依次展現(xiàn)，所以顯示不太美觀，這里需要調(diào)整排版。原代碼：修改后代碼：1.7l 完整edit頁面代碼如下：input type=button value=onclick=Com_Subm

28、it(document.exampleSampleSingleForm, update);input type=button value=onclick=Com_Submit(document.exampleSampleSingleForm, save);input type=button value=onclick=Com_Submit(document.exampleSampleSingleForm, saveadd);input type=button value= onclick=Com_CloseWindow();$KMSSValidation();l 頁面效果圖如下：1.8.8 修

29、改view頁面代碼.l view頁面的修改跟edit頁面修改類似，也只是調(diào)整頁面的排版。原代碼：修改后代碼：l 完整view頁面代碼如下：function confirmDelete(msg)var del = confirm();return del;input type=buttonvalue=onclick=Com_OpenWindow(exampleSampleSingle.do?method=edit&fdId=$param.fdId,_self);input type=buttonvalue=onclick=if(!confirmDelete()return;Com_OpenWindow(exampleSampleSingle.do?method=delete&fdId=$param.fdId,_self);input type=buttonvalue=onclick=Com_CloseWindow();l 頁面效果圖如下：1.9 啟動項目測試功能l 到此為止,簡單樣例的開發(fā)就結(jié)束了，最后訪問http:/localhos