項目規(guī)范和基礎(chǔ)配置

1.項目規(guī)范說明

1.1名詞解釋

<!）駝峰命名法：就是當(dāng)變量名或函數(shù)名是由一個或多個單字連結(jié)在一

起，而構(gòu)成的唯一識別字時，第一個單字以小寫字母開始：第二個單字的

首字母大寫或每一個單字的首字母都采用大寫字母，例如：myFirstName,

myLastName,這樣的變量名看上去就像駱駝峰一樣此起彼伏，故得名。

（2）首字母大寫的駝峰命名法：在駝峰命名法基礎(chǔ)上首字母大寫。

1.2數(shù)據(jù)庫中表、視圖、字段的命名

a）數(shù)據(jù)庫表命名需以T開頭，后接表的英文簡寫（首字母大寫的駝峰

命名法），如TUscr表。

視圖命名需以V開頭，后接表的英文簡寫或視圖的目的（首字母大寫

駝峰命名法）。

b）字段的命名需以有意義的英文單詞組合（首字母大寫的駝峰命名法）。

13項目java代碼包含義：嚴(yán)格遵照MVC模式

M模型層包括JavaBcan和其他數(shù)據(jù)操作，

C控制器層即通過Servlet負(fù)責(zé)頁面的跳轉(zhuǎn)。

所以src文件夾分為如下三部分：

bean包——內(nèi)含與數(shù)據(jù)庫表相對應(yīng)的JavaBean對象，

JavaBeanOP還有對應(yīng)JavaBean與數(shù)據(jù)庫的操作。

servlet包包括所有與頁面交互的Servlet操作：

util包——包括公用的或特殊用途的函數(shù)。

具體如下圖：

019

tn.；￡1b?3

I4[Jjtp?r?onj■v

UftJ[,t]tp?rconop.jav<

i=[B

bR,|T)Li?tS?rvl?tjwvw

(s出util

Uti㈤ConstJ<v<

i*i|HD<t?Fun.j<v?

fL4JDBConnect.J<v?

GD[T)MORJ-

w；/]P?C?1B*tJ<V<

UtiIDStrFun.J*v*

1.4項目中java包的命名規(guī)則：

a)bean包的名稱命名規(guī)則為bean.編程人的拼音縮寫.編寫模塊的英文單詞；

b)sendet包的名稱命名規(guī)則為servht.編程人的拼音縮寫.編寫模塊的英文單

詞：

c)util包的名稱命名規(guī)則為uiil.編程人的拼音縮寫。

d)注意：命名規(guī)則的前兩項應(yīng)為小寫(即XX包.編程人的拼音縮寫)，最后

一項(即編寫模塊的英文單詞或是util包的第二項)應(yīng)為大寫。具體格式如圖：

一刀STC

田jbean.cy.Person：

ffjxervlot.cyPerson

由util,cy

1.5Bean包中JavaBean文件的名稱

bean中的JavaBean文件能和數(shù)據(jù)庫中的表對應(yīng)起來，以數(shù)據(jù)庫中

的表來命名JavaBean文件，如TUser表對象bean包的TUser.java。如有不

與數(shù)據(jù)庫表對應(yīng)JavaBean可自行詵擇有意義的英文單詞或組合來命名，但應(yīng)

首字母大寫的駝峰命名法。

1.6Bean包中JavaBean對象的數(shù)據(jù)庫操作文件名稱

所有JavaBean與數(shù)據(jù)庫的操作，一律命名為JavaBcanOP的形式。如

TUser對象的數(shù)據(jù)庫操作命名為TUserOP.java,其中包括所有與數(shù)據(jù)庫的操作。

同時每個0P文件必須含有函數(shù)insert()、update()和delete()分別表

示新建、修改和刪除的含義。具體代碼可參照src.bean.tpersonop.java來寫。

1.7Servlet包中文件的名稱

servlet文件命名格式為JavaBean對象名+對JavaBean的操作（如新增

Add,修改Modify,刪除Delete,列表List,搜索Search等動詞）+Servlet?

如對TUser表的操作TUserAddServlet為新建TUser對象的servlet、

TUserModifyServlet為修改TUser對象的servlet、TUserDeleteSeivlet

為刪除TUser對象的servlet、TUserListServlet為顯示TUser對象列表的

servlet等等。

1.8Util包中文件的名稱

首字母的大寫的駝峰命名法，保證文件名有意義的英文單詞。目前系統(tǒng)中

的公用java文件都在util包下，如圖：

3田util

囹［JJConst.java

（2）@DAteFun.java

囹［JjDBConnect.java

@ND5.java

囹J￡lPQgolidjw

囹①StrFunjava

其中Const.java表示系統(tǒng)用到的通用常量。

DateFun.java為系統(tǒng)對Dale類型的操作函數(shù)。

DBConnect.java為系統(tǒng)通過的數(shù)據(jù)庫連接方法。

MD5.java為MD5加密算法，用于用戶登錄密碼的加密處理。

Pagelist.java為通用的分頁顯示。

Strbun.java類為servlet文件去request對象中對象attribute屬性時

的轉(zhuǎn)碼方法。

1.9Java文件中函數(shù)的寫法

java文件中函數(shù)命名最好以動詞.名詞的形式。如想根據(jù)ID獲得某個對象,

可以命名為getXXBylD,苜字母小寫，其余單詞為大寫。函數(shù)中局部變量的命

名為全部小寫，常量為全部大寫。

l.io.JSP文件的寫法

首頁和登錄頁的JSP文件放在根目錄下，其余文件按照英文含義放入響應(yīng)

的文件夾下，每個文件夾下包括了該模塊的全部操作頁面。

如圖：

土AccountTyp?

紀(jì)&

*Arr?y?R?cord

*CotwFintnct

?kyConFinane?Account

t,.yCuston*rProbitfl*

?FrontQu?ztionD?tl

t與FTA&nn

建議文件夾的命名為首字母大寫的駝峰命名法。

1.1KEXT2的JS文件放置

與每個頁面對應(yīng)的JS文件放到/inc/編程人的拼音縮寫（全部小寫）文件夾

下。如圖：

0己inc

dLext

a我型〃

pjkcltntftrji

QImcBeiitctrj?

stud?ntN?nec?r.

￡31x1jx

J*iy.jxp

建議命名為有意義的英文單詞或組合，首字母小寫的駝峰命名法。如有大家?起

用到的通過JS函數(shù)，建議新建一個通過的JS文件，大家一起調(diào)用其中的函數(shù)，

1.12數(shù)據(jù)庫的連接的寫法

詳細(xì)參照sre下bean.tpersonop.java文件。簡單說明insert函數(shù)寫法，代碼

如下：

*作用：向tperson表中添譏I新紀(jì)錄

?*?/

publicvoidinsert(Objectbean)

Stringsql="insertinto(person

(TPcrs<)nID.TPcrM)nNamc,TPcrx()rTypc,TPcrx<)nNum)values(?,?,?,?)";

DBConncctdhc=null;

try

]

dbc=newDBConncct(sql);

dbc.sctStnng(1X(tp^rson)bean).gctIPersonIDO);

dbc.sctString(2,((tpcrson)bean),gctTPcrsonNamc());

dbc.setString(3.((tpe!,son>beanJ.getTPersonTypeO):

dbc.jveiSlring(4.((iperson)beanhgeiTPersonNunU));

dbc.cxccutcUpdatci);

I

catch(Exceptionc)

I

Systein.out.println(e.gelMessage());

Anally{

dbc.closeO;

I

I

注意：

I、建議所有insert、update和dclclc函數(shù)參數(shù)都有Object對象；

2、連接數(shù)據(jù)庫調(diào)用DBConneci中的newDBConncci()方法，函數(shù)sql參數(shù)，調(diào)用

對應(yīng)的seiXXX方法替換相應(yīng)類型的?，最后執(zhí)行操作：

3、調(diào)用try-catch-finally的格式，finally用來關(guān)閉數(shù)據(jù)庫的連接。DBconnect初

始化在iry代碼塊之外。

1.13List的寫法

詳細(xì)參照scrFservlet!.istServlet.java文件,分頁顯示時?傳入rotakql和

sql兩個查詢語句，total語句為查詢所有的表中對象，sql為調(diào)用對應(yīng)頁面的

sql語句，二者作為參數(shù)傳入JavaBean的OP文件中，調(diào)用gelresull()方

法返回List列表。

1.14代碼注釋

每一個函數(shù)的上方必須要寫注解。格式如下：

/8**

余作用：向tperson表中添加新紀(jì)錄

**/

其中作用內(nèi)寫明該函數(shù)的主要用同時可選擇寫下傳入?yún)?shù)含義和返回參

數(shù)的含義。當(dāng)存在自認(rèn)為不容易理解的代碼時，需及時寫下該代碼的含義。通常

應(yīng)保證每5行代碼內(nèi)含有一行注稱。

1.15Session和forward

只有在一個對象變量需在多個頁面共享時，才使用session的方式，其

余都使用請求轉(zhuǎn)發(fā)方式。請求轉(zhuǎn)發(fā)代碼如下：

ServletContextsc=this.getServletContext（）;

RequestDispatcher

rd=sc.getRequestDispatcheit"/sample/index.jsp"）;

rd.fbrward（request,response）;

2.數(shù)據(jù)庫匯總規(guī)范

2.1首先每個人要做的是先記錄下數(shù)據(jù)庫中你負(fù)去哪些表。

2.2每天某個時間（商討定），匯總?cè)酥性冊X每個人（QQ群中，注意關(guān)注）是否有數(shù)據(jù)庫

表的結(jié)構(gòu)增刪改，有的人員及時響應(yīng)。否則，等待下次詢問?。ňo急修改問題可聯(lián)系匯

總?cè)耍?/p>

2.3如果你有數(shù)據(jù)表的增加，修改，刪除操作（必須注意修改自己的EA文件，為了以后形

成完整的開發(fā)數(shù)據(jù)字典）,及時響應(yīng)（報好在你項目相應(yīng)文件更新服務(wù)器前）負(fù)由匯總

人詢問。（以mysql為例，把庫中你有變動的表選中，然后備份出來發(fā)給負(fù)貨匯總?cè)耍?/p>

2.4負(fù)責(zé)匯總?cè)私拥綆讉€變動表每份后，將總庫中對應(yīng)榭去，然后還原變動表進(jìn)庫。步向其

他開發(fā)人員通知，表有改動，需要的提出申請?。?！

2.5其他人員申請時，如果自己負(fù)責(zé)的眾多表中有也要測試數(shù)據(jù)，可以把這些表備份，并附

文字說明發(fā)給匯總?cè)恕?/p>

2.6負(fù)責(zé)匯總?cè)耍瑢⑸暾堈?，備份的這些表從自己舊庫中出除，并還原。并把總體數(shù)據(jù)庫備

份給申請者。

2.7申請者，刪除整個庫（安全考慮最好也備份下），然后把匯總?cè)藛T發(fā)的庫備份還原。

附加說明：

1、申請人，這里特指匯總?cè)藛T通知了有了哪些變動后，其他那些索取最新總庫的人員。

2、第4步，第5步這里，匯總?cè)巳圆恍枰人猩暾埲朔从?，而是接受一個處理并發(fā)送一

個。

3、為了減輕匯總?cè)藛T負(fù)荷，申請人注意.你確定距離上次申請時間較短，你的最新測試數(shù)

據(jù)很少，就不要因為這一點(diǎn)，再去備份變動的表給匯總?cè)藛T索取鼓新”（同樣如果數(shù)

據(jù)表結(jié)構(gòu)增刪改了，但項目文件提交后?其他人更新不會有問題，可超時輟下，等待匯

總?cè)藚f(xié)詢問）

4、和申請者一樣，如果修改表結(jié)構(gòu)人，負(fù)聲范圍中的其他表雖然結(jié)構(gòu)未變化，但有重要測

試數(shù)據(jù)的可?同備份，并說明清焚。

5、之所以，這樣做防止大家項目CVS同步了，但由于不知道誰自己改了表，沒及時通知

大家，導(dǎo)致大家項目都運(yùn)行不起來，陷入癱瘓狀態(tài)。所以每個人必須嚴(yán)格按照流程做

事。也為r以后生成文檔準(zhǔn)南方便。

6、有良好建議請聯(lián)系我，以后繼續(xù)完善該手冊！！

7、參考操作見下圖：

你修改什么表，備份時，就在哪幾個表上打鉤！”不要選其他表

有的mysql版本有這個問題可能??！所以備份后大家看卜里面是不是就那幾個選中的袁。不

是的話，先刪掉其表,然后再備份發(fā)給匯總?cè)?/p>

rInforMation

BackupProject

ontrol

B*kupPtCfKt

Definethenameandcontentofthebackup

UserAdmimstrMion

Gtnefal

ServerConnections

ProiKCtNameNamefotthisbxkupproject

S<hemxt3BackupContent

:RtpWMionStatus

JBackupD3

日

mformation.schemj□

R?fto<e

淡

?noovationpoMdb

JUIOS日

耳

目

Bxkup8*aS

』wPr，ySa.eProjectF，,《WEMb.up

3.623服務(wù)器連接方法(CVS)

3.1打開MyEclipse,在FiIe菜單下選擇Import。如圖2T。

PJava-'WyEcJipseEnterprise

fileEditSourceRefacjorfiavigateSearchfroject

KLt+Shi￡t+N?

OpenFile』.

CloseCtrBW

CloseAllCtrHShiftn

Ctrl+S

隨SaveAs...

而SaqAllCtrHShift+S

R?v?ri

Move..

Renane...F2

RefreshF5

ConvertLineDelimiter;To?

西Ennt...Ctrl+P

SvitchVorkspac??

Import...

必Expert..

PropcrtiAlt+Ent?r

圖2-1

3.2.在Import窗口中選擇CVS下面的ProjectsfromCVS.如圖2-2。

圖2-2

3.3點(diǎn)擊Next,進(jìn)入圖2-3所示界面，選擇Createanewrepositorylocationo

116224/project

116.24：/proj?ct

116.224/project

圖2-3

3.4點(diǎn)擊Next進(jìn)入圖2-4所示界面，填入相應(yīng)的信息即可。（如：Host：

121.248.196.1,Repositorypath：/project,User和Password中輸入自己在

服務(wù)上設(shè)置的用戶名和密碼即可）

ICheckoutfFOBCVSn

OU"porg：

IInSave.passvorj^

iSav?dpazzvordsor。storedonyourccnput?rin■￡xl?thatizdi￡￡ibutnot

tmpcqqihla，fftr?nintruder?AvaaA

Configuroconnectionprofaroncoz

⑦|<-ack|「Next>]Emish|Cancel

圖2-4

3.5點(diǎn)擊Next進(jìn)入圖2-5界面，說明連接成功，選擇相應(yīng)項目，選擇Finish

即可。

圖2-5

4.關(guān)于CVS源碼同步及項目遠(yuǎn)程部署管理細(xì)則

4.1項目開發(fā)人員應(yīng)遵循的規(guī)則

I、項目開發(fā)人員在每次修改程序之前，必須先連接623的CVS服務(wù)器將整個項

目的源碼進(jìn)行同步：

2、項目開發(fā)人員在修改完程序的當(dāng)天必須與623的CVS服務(wù)涔進(jìn)行同步：

二項目開發(fā)人員修改完并與62?的CVS服務(wù)器同步以后,必須再次對本次修及

的內(nèi)容進(jìn)行測試。

4、原則上項目開發(fā)人員不允許直接修改623的CVS服務(wù)器里的源碼，若在某些

特殊情況下確實做了修改，則必須盡快同步到自己本機(jī)的MyEclipsc中。

5、項口開發(fā)人員如果修改了數(shù)據(jù)庫的表結(jié)構(gòu)，必須將改動的內(nèi)容直接以SQL腳

本的形式（Alier修改語句）提交給項日部署人員。

6、項目開發(fā)人員也不允許直接修改遠(yuǎn)端服務(wù)器中的程序。

4.2項目部署人員應(yīng)遵循的規(guī)則

I、由于目前乘用WAR包部署的方式，因此，項目部署人員在每次進(jìn)行遠(yuǎn)端部

署之前，必須先將本機(jī)源碼與623的CVS服務(wù)器中的源碼同步，然后才可以

制作WAR包，最后進(jìn)行遠(yuǎn)程部署，即項目部署人員本機(jī)的程序與623服務(wù)

器中的程序以及遠(yuǎn)端服務(wù)器中的程序要保證完全一致。

2、項口部署人員在部署項目程序的同時，也要招最近接收到的數(shù)據(jù)庫修改的

SQL腳本在遠(yuǎn)端服務(wù)器中進(jìn)行執(zhí)行。

3、部署完畢之后，項目部署人員需要通知項目組各開發(fā)人員及快測試本次新增

或修改的模塊。

4、為了不影響用戶的對系統(tǒng)的正常訪問，以上部署和測試工作只能在用戶非正

常工作時間進(jìn)行。

5、項目部署人員不允許直接修改遠(yuǎn)端服務(wù)器中的程序。

4.3CVS源碼同步中的常見問題及注意事項

1）提交沖突：

每天開始做項目之前首先要從服務(wù)器端更新項目到本機(jī)，這是因為在Eclipse

和CVS服務(wù)器同步之前，可能別人以對項目進(jìn)行了修改，導(dǎo)致服務(wù)器端版本與

大地不同步，Eclipse中沒有刷新而導(dǎo)致同步報錯。比如當(dāng)前有兩個用戶guesll

和gues2,兩人電腦上的XXX.java文件版本都是1.2,guesll修改了一下提交上

云,版本變?yōu)?.3,因為是第一次提交，所以不會報錯。guesl2編的慢一些.后

提交，這時就會和guesll提交上去的代碼產(chǎn)生沖突。這是因為如果用guest2的

代碼更新CVS,guesil的代碼就會被沖洗抻，所以Eclipse就會報文件沖突。

2）解決方法：

右鍵單擊要提交的文件，選小組里的更新，此時XXX.java文件的版本已變

成1.3,更新后的沖突也標(biāo)記出來了，再跟據(jù)代碼中的沖突合并修改，改完后提

交到CVS上，此時版本變?yōu)?.4。還可以將Eclipse設(shè)置為自動刷新，操作方法：

\Vind（）w->Prcfcrcnccs->Workbcnch.選中Refreshworkspaceautomatically?但這種

方法不推薦使用，如果項口組成員上傳無用的測試文件，都會更新到本地，使項

目看起來比較混亂。

建議：

（I）將項目做成模塊目錄，每個人負(fù)貴自己的模塊，這樣就不容易造成重復(fù)

修改。

<2）做到每日提交，并且要求代碼是完整可運(yùn)行的，保證其它人更新運(yùn)行你

的代碼后不會產(chǎn)生錯誤。

（3）任何人做修改時都要更新最新版本到本機(jī)。

此外，CVS不允許進(jìn)行刪除服務(wù)器端文件，所以大家最好不要提交臨時文

件及臨時目錄，如編譯產(chǎn)生的文件和目錄。還有不要傳和項口無關(guān)的程序.二去，

否則會導(dǎo)致服務(wù)器臃腫，結(jié)構(gòu)不清晰，不便項目組其他成員查看。如果有?些測

試用的文件上傳，要新建一個臨時項目上傳，與主項目分離。這樣小組成員在更

新項目的時候就不會把一些無用的文件更新到本地.

不同功能模塊的文件分開Commii,同一功能模塊的文件一次Commit,對于

分析錯誤、減少沖突、版本回退等有酉助。

如果Eclipse項目前有">”符號，這是做了修改的程序還沒有提交到CVS

服務(wù)器上，只要提交一下此標(biāo)記就會消失。

5.服務(wù)器配置說明

5.1項目部署與服務(wù)器啟動

1、項目部署：

將打女/的war包放入C:\Program-ilesXApochcSoftwareroundotion\Tomcat2、2、

5.5\webapps目錄卜即可，注意先冬份之前的項目。

服務(wù)器啟動：

(1)采用C:\ProgramFiles\ApacheSoftwareFoundation\Tomcat5.5\bin目錄下的

tomcat5.exe啟動，這個啟動方式會彈出命令窗口可以杳看錯誤信息，如果要關(guān)

閉服務(wù)涔只要把窗口關(guān)閉即可。

0C.\Pr?^r**Softv*r?Fonad?ti?a\T<?Bcat5.5\bin\to?e*tS.exeBl0E3

2B10-8-522:51:55org.logic*Icobwebs.proxoo1.HouseKeepersweep

警告：#0309wasactivefor73953raillisecondeandhasbeenrefwvedautorwaticaly.M

TheThreadresponsiblewasnaned*http-80-Proccssor4,buttheSQLitperfH

omedisunknownbecausethetracepropertyisnotenabled.

2010-8-522：51：55org.losicalcobwebs.p^oxool.HouseKeepersweep

警告：#B310iKisactivefor63234nilliseconds?ndh?sbeenrenouedAutoiwnticaly.

TheThreadresponsiblewasnaned,http-80-Procefisorl2*,butthelastSQLitper

fomedisunknownbecausethetracepropertyisnotenabled.

2Hl8-8-522:51:55org.logicAlcobwebs.proxool.HouseKeepersweep

委告：110311wasactivefor63234nillisecondsandhasbeenrenovedautorwaticaly.

TheThreadresponsibleWASnAncd*http-80-Proccssorl2*,butthel>stSQLitper

fomedisunknownbecausethetracepropertyisnotenabled.

2010-8-522：51：55org.logicaIcobwebs.proxool.HouseKeepersweep

誓安：0H312UASactivefor63203nillisecondsAndHASbeenrerwvedautorwoticaly.

TheThreadresponsiblewasnaned*http-80-Processorl2*,butthelastSQLitper

fomedisunknownbecausetkctracepropertyisnotenabled.

2010-8-522:54:12org.apache.catalina.corc.ApplicationContextlog

信息：null

2R1H-8522:54:12org.Apache.catalinA.core.Applicationcontextlog

信息：null

2010-8-522:54:13org.apache.catalina.core.Applicationcontextlog

佶息：null

2010-8-522:54:13org.apache.catalina.core.ApplicationContextlog

信息：null

(2)采用C:\ProgramFiles\ApacheSoftwareFoundation\Tomcat5.5\bin目錄卜.的

tomcat5w.exe啟動，會彈出窗口,按start啟動tomcat,按stop關(guān)閉tomcat。

5.2服務(wù)器java內(nèi)存溢出的詳細(xì)解決方案

服務(wù)器內(nèi)存溢出類型：

jtva.lang.OutOfMcinorjError:PcrmGcnspace

解決方案：

打開tomcat5.5的安裝日親，雙打開bin文件爽，雙擊ionjcat5w.exe.點(diǎn)擊第四個標(biāo)簽"java",

在Javaoptions中添加如下內(nèi)容：

-Xms800M

-Xmx800M

-XX:PennSize=12SM

-XX:MaxNcwSize=256M

-XX:MaxPcnnSizc=256M

點(diǎn)擊確定即可°

5.3域名配置說明

U）找到C:\WINDO\VS\systcm32klrivcrs\ctc目錄下的域名解析文件host文件，用記事本打

開進(jìn)入

II是服務(wù)器IP地址

■圮事本■向E3

文件CD???1）格式如超助QP

1Copyright(c)1993-1999HicrosoFtCorp.

>

1ThisisasanpleHOSTSfileusedbyMicrosoftTCP/IPForWindows.

1

1ThisFilecontainsthenappingsofIPaddressestohostnanes.Each

lentry