项目规范和基础配置

项目规范和基础配置项目规范说明1.1名词解释（1）驼峰命名法：就是当变量名或函数名是由一个或多个单字连结在一起，而构成的唯一识别字时，第一个单字以小写字母开始；第二个单字的首字母大写或每一个单字的首字母都采用大写字母，例如：myFirstName、myLastName，这样的变量名看上去就像骆驼峰一样此起彼伏，故得名。（2）首字母大写的驼峰命名法：在驼峰命名法基础上首字母大写。1.2数据库中表、视图、字段的命名a)数据库表命名需以T开头，后接表的英文简写（首字母大写的驼峰命名法），如TUser表。视图命名需以V开头，后接表的英文简写或视图的目的（首字母大写驼峰命名法）。b)字段的命名需以有意义的英文单词组合（首字母大写的驼峰命名法）。1.3项目java代码包含义：严格遵照MVC模式M模型层包括JavaBean和其他数据操作，C控制器层即通过Servlet负责页面的跳转。所以src文件夹分为如下三部分：bean包——内含与数据库表相对应的JavaBean对象，JavaBeanOP——还有对应JavaBean与数据库的操作。servlet包——包括所有与页面交互的Servlet操作；util包——包括公用的或特殊用途的函数。具体如下图：惰1.旱4项目中晋java省包的命名规斥则：陆a)bea稼n帝包的名称命贼名规则为眨bean.园编程人的拼陷音缩写眯.挣编写模块的糊英文单词；己b)ser侨vlet育包的名称命梁名规则为萍servl很et.描编程人的拼令音缩写厌.具编写模块的起英文单词；斜c)ut柔il民包的名称命答名规则为冻util.刮编程人的拼嚼音缩写。煎d)尽注意：命名甩规则的前两近项应为小写法（即偷XX差包礼.前编程人的拼冬音缩写），碌最后一项（津即编写模块语的英文单词钻或是越util汉包的第二项雕）应为大写迈。具体格式斤如图：感1.决5盘Bean刻包中Ja益vaBea似n文件的颤名称蜘bean乱中的粘JavaB府ean柔文件需和数绞据库中的表走一一对应起倡来，以数妄据库中的表汇来命名破JavaB社ean魂文件，如究TUser坟顾表对象准bean尖包的屋TUser养.java哥。如有不与牵数据库表对抱应艇JavaB虾ean锦可自行选择蔽有意义的英存文单词或组墓合来命名，姑但应占首字母大写劈的驼峰命名番法。讽1.饲6来Bean挎包中Ja要vaBea损n对象的棚数据库操作溪文件名称寄所有竭JavaB肺ean染与数据库的幼操作，一律裤命名为么JavaB除eanOP仿山的形式。如斗运TUser鸟蛮对象的数据具库操作命名异为排TUser默OP.ja着va接，其中包括宪所有与数据甘库的操作。申同时每个电OP势文件必须含齿有函数酿inser歼t呀（）、融updat往e送（）和之delet像e侵（）分别表链示新建、修凡改和删除的天含义。具体指代码可参照供钳src.b脂ean.t赛perso桥nop.j旱ava站来写。那1.钟7尽Servl但et包舅中文件的名冈称还servl窄et地文件命名格顾式为桃JavaB碍ean夸对象名芬+庭对碰JavaB换ean誓的操作（如洪新增拥Add句，修改等Modif虫y著，删除网Delet吉e莲，列表怒List,畅厚搜索总Searc铁h废等动词）搂+Serv信let绢。如对脾TUser硬电表的操作呀TUser业AddSe哪rvlet盐迅为新建烘TUser扶对仪牵象宏待的意腿servl兵et肾旺、士迅TUser朝Modif虽yServ蛙let盆现为修改TU曲ser对象梳的雁servl极et卡、花TUser菠Delet鹅eServ佳let削为删除铸TUser殖通对象的带servl筒et画、临TUser留ListS弊ervle叹t睛为显示俊TUser伐拢对象列表的窗servl冒et于等等。亮1.踢8菜Util做包中文件的伶名称勿首字母的大墨写的驼峰命尺名法，保证劈文件名有意简义的英文单盗词。目前系吊统中的公用驶岭java烟文件都在题util获包下，如图信：踏其中扰Const众.java犁谎表示系统用朋到的通用常隆量。杰DateF辣un.ja无va洒为系统对症Date删类型的操作优函数。麻DBCon咸nect.炒java拣为系统通过规的数据库连梦接方法。偷MD5.j光ava诵为锣MD5牧加密算法，将用于用户登纺录密码的加翁密处理。航Pagel短ist.j向ava枣为通用的分森页显示。丛StrFu参n.jav拿a居类为翠servl芬et昂文件去霸reque蚂st诵对象中对象祝咳attri岛bute制属性时的转扁码方法。柴1.盏9盏Java话文件中函数荒的写法糕java摆文件中函数煮命名最好以渣动词该.薪名词的形式周。剂如想根据盘ID获得盼某个对象，馒可以命名为依getX丽XByID去，首字母小倍写，其余单渣词为大写。肿函数中局部睛变量的命名挤为全部小写详，常量为全劫部大写。捉1.兄10肝JSP文痒件的写法炒首页和登录需页的扩JSP刻文件放在根扰目录下，其监余文件按照握英文含义放岭入响应的文坐件夹下，每欠个文件夹下式包括了该模告块的全部操慧作页面。如图：维建议文件夹波的命名为首僚字母大写的银驼峰命名法匆。芦1.袭11、EX省T2的识JS澡文件放置岂与每个页面适对应的J笔S文件放铜到/inc量/编程人的校拼音缩互写（全部小托写）文件夹什下。如图：僚建议命名为巴有意义的英盗文单词或组也合，首字母匀小写的驼峰近命名法。如嚷有大家狮一起用到的盟通过传JS广函数，建议懂新建一个通习过的侵JS耻文件，大家赴一起调用其灵中呢的函数。硬1.沟12薯数据库的连载接的写法嫌详细参照柴src下筹bean磨.tper葛sonop束.java僚文件。简归单说明in木sert旷函数写法，闪代码如下：/***备*孟页作用：向流tpers汇on绑表中添加新醒纪录***/斯publi杜c守void致inse划rt(Ob懂ject赏bean){捐Strin想gsql亲=从棚"inse竟rt编into尸tper可son摔(TPer适sonID牢,TPer仙sonNa聚me,TP辫erson庆Type,求TPers痒onNum仪)va刷lues院(?,?,阵?,?)"阵;担DBCon亦nect庄dbc=侵蜘null甲;try{抗dbc=搞陆new赏DBCo计nnect叙(sql)烦;晋dbc.s柳etStr障ing(1藏,((tp司erson肢)bea陡n).ge包tTPer时sonID鼻());主dbc.s耽etStr咬ing(2贞,((tp饭erson钳)bea稼n).ge廊tTPer队sonNa局me())亏;寺dbc.s婶etStr至ing(3菌,((tp锹erson冠)bea矿n).ge碌tTPer闲sonTy等pe())堤;口dbc.s食etStr充ing(4晨,((tp帖erson躲)bea旗n).ge忍tTPer怨sonNu更m());跳dbc.e信xecut卖eUpda臭te();}满catch控(Exce株ption丝e){驾Syste伏m.out动.prin状tln(e惩.getM酒essag辜e());}仅final掉ly牌{坝dbc.c允lose(素);}}注意：览1同、建议所有丛inser左t改、毒updat誓e悠和支delet姑e祝函数参数都正有锡Objec艇t拢对象；亲2阻、连接数据雅库调用挣DBCon透nect宵中的捧newD丙BConn剑ect因（）方法，饱函数踪sql尿参数，调用训对应的呼setXX辉X励方法替换相靠应类型的声?覆，最后执行棋操作；甜3踩、调用居try禽-贼catch傍萌-冈final墨ly丸的格式，木final纪ly迹用来关闭数走据库的连接碌。次DBcon宵nect传初始化在捏try毯代码块之外倡。应1.朱13讯List获的写法高详细参照测scr下至serv跪let.L衫istSe雪rvlet升.java锈文件。分顷页显示时，物传入tot射alsql亿和sq裕l两个查糟询语句，t见otal误语句为查询夺所有的表中垂对象，sq惯l为调用棋对应页酱面的适积sql语热句，赌二者作为参消数传入Ja问vaBea份n的OP文聪件中遍，际调用get途resul接t联（）方法返材回料List疫列表。恭1.曾14挂代码注释鄙每一个函数久的上方必须爷要写注释。衔格式如下：/***耐*鹅呀作用：向t幅perso后n表中添加胜新纪录***/帮其中作用内箩写明该函数杨的主要用于哗，同时可选执择写下传入此参数含义和科返回参数竭的含义。当寸存在自认为绢不容易理解瘦的代码时，吴需及时写下氧该代码的含融义。通常应光保证每惠5畅行代码内含跌有一行注释御。羞1.旬15蔬Sessi南on和搞forwa旦rd逢只有在码一个对象坚变量需在多蹈个页面共享锦时，才使柔用依sessi寿on预的方式，其哗余都使用请伪求转发方式洲。请求转发膛代码如下：通Servl厦etCon捡text丢sc=th待is.ge饱tServ蜘letCo会ntext麻();裹Reque支stDis惧patch零er珍rd=sc庆.getR此eques关tDisp登atche购r("/s铅ample猛/inde鹅x.jsp跨");的rd.fo拿rward削(requ每est,续respo挣nse);丢数据库汇总秤规范乔2.1妥首先每个人访要做的是先蚊记录下数据夹库中你负责锤哪些表。伐每天某个备时间（商讨倦定），汇总条人中询问每就个人（QQ蚕群中，注意若关注）是否混有数据库表标的结构增删性改，有的人祥员及时响应快。否则，等摊待下次询问桌！（紧急修晶改问题可联槽系汇总人厚）堤如果你有数催据表的增加闷，修改，删根除操作（必勾须注意修改怪自己的EA吓文件，为了逝以后形成完室整的开发数捷据字典），其及时响应（催最好在你项碌目相应文件犁更新服务器刊前）负责汇沸总人询问。聪（以mys掉ql为例，吨把库中你有狸变动的表选界中，然后备馅份出来发给娇负责汇总人怎）浓负责汇总人病接到几个变尼动表备份后雕，将原库中拜对应删去，洞然后还原变杰动表进库。既并向其他开办发人员通知毕，表有改动贸，需要的提妖出申请！！互！匪其他人员申袄请时，如果醋自己负责的芽众多表中有挤重要测试数烘据，可以把加这些表备份睁，并附文字曾说明发给汇绣总人。麦负责汇总人埋，将申请者或，备份的这弄些表从自己朽旧库中删除岗，并还原。木并把总体数烘据库备份给宗申请者。献申请者，删躲除整个库（宪安全考虑最痕好也备份下拌），然后把垫汇总人员箭发的库备份课还原。附加说明：塑申请人，这大里特指汇爪总人员通知抢了有了哪些静变动后，其欣他那些索取妄最新总库的悉人员。骨第4步，第傲5步这里，宵汇总人员不愤需要等所有滴申请人反映滴，而是接受患一个处理并玩发送一个。王为了减轻汇唉总人员负荷阳，申请人注悔意，你确定会距离上次申插请时间较短泉，你的最新桃测试数据很婚少，就不要起因为这一点慰，再去备份须变动的表给村汇总人员哲索取最新劈！！（同样慎如果数据表泄结构增删改岁了，但项目拦文件提交后运，其他人更诊新不会有问中题，可暂时适缓下，等待句汇总人员询族问）脊和申请者一逗样，如果修嘱改表结构人曲，负责范围口中的其他表季虽然结构未饿变化，但有闹重要测试数贷据的可一同筒备份，并说味明清楚。坦之所以，这父样做防止大伐家项目CV别S同步了，交但由于不知物道谁自己改盖了表，没及锐时通知大家诸，导致大家驾项目都运行石不起来，陷青入瘫痪状态追。所以每芬个人必须严搞格按照流程饼做事。也为艳了以后生成塌文档准确方风便。蜜有良好建议义请联系我，催以后继续完源善该手册！且！阔参考操作见店下图：榜你修改什么条表，备份时始，就在哪几僻个表上打钩测！！！裁不要选其他惭表小有的mys萌ql版本有础这个问题可洪能！！所以锦备份后大家伟看下里面是漏不是就那蔽几个选中的霞表。不是的丰话，先删群掉其表，然姿后再备份发直给汇总人隙3．62幼3故服务器连接切方法弹（CVS）犬3.1动打开My射Eclip寒se，在F仰ile菜单旋下选择Im勉port。疲如图2-1主。图2-1卵3.隙2.在Im沾port窗腾口中选择C狐VS下面的于Proje讯ctsf棋romC猎VS。如图虾2-2。图2-2担3.符3可点击Nex胁t，进入图呜2-3所示隶界面，选择昌Creat卫ean蜻ewre彼posit协oryl旬ocati杜on。图2-3伸3.4额点击Nex娱t进入图2毁-4所示界衣面，填入相灯应的信息即叔可。（如：发Host：层121.2夏48.19录6饥.降1咸，Repo舅sitor碎ypat废h：/pr打oject昂，User轿和Pass沾word中恋输入自己在拨服务上设置矛的用户名和学密码即可）图2-4制3．5波点击Nex骑t进入图2踢-5界面，猛说明连接成侍功诚，选择相应销项目，选择偏Finis根h即可。图2-5筐4.炭关于CVS屠源码同步及弱项目远程部蹦署管理细则妨4.1湿项目开发人戒员应遵循的缸规则洒项目开发人售员在每次修岛改程序之前槽，必须先连曾接辣623榴的CVS服便务器将整个酷项目的源码里进行同步；孩项目开发人愚员在修改完惩程序的当天侦必须与昂623赴的CVS服炼务器进行同夹步；穿项目开发人遭员修改完并驾与痕623弓的CVS服聋务器同步以鲜后，必须再夺次对本次修支改的内容进烤行测试。克原则上项目束开发人员不柄允许直接修该改核623睛的CVS服铸务器里的源们码，若在某刺些特殊情况彩下确实做了乖修改，则必文须尽快同步薪到自己本机检的MyEc恒lipse脏中。玩项目开发人爷员如果修改锈了数据库的骄表结构，必漆须将改动的滴内容直接以朗SQL脚本爸的形式（A武lter修昼改语句）提慌交给项目部角署人员。摘项目开发人须员也不允许问直接修改远骂端服务器中均的程序。游4.2问项目部署人旅员应遵循的泊规则臭由于目前采缺用WAR包托部署的方式泽，因此，项阴目部署人员旷在每次进行沸远端部署之蛋前，必须先晒将本机源码熟与件623唤的CVS服蜂务器中的源数码同步，然清后才可以制点作WAR包梦，最后进行理远程部署，贼即项目部署劝人员本机的堵程序与去623猪服务器中的切程序以及远狼端服务器中石的程序要保趴证完全一致舟。排项目部署人胃员在部署项呢目程序的同它时，也要将京最近接收到六的数据库修筐改的SQL丸脚本在远端陵服务器中进钓行执行。倘部署完毕之看后，项目部戏署人员需要促通知项目组私各开发人员督尽快测试本竭次新增或修非改的模块。旧为了不影响档用户的对系绣统的正常访困问，以上部纲署和测试工途作只能在用沙户非正常工率作时间进行悼。撇项目部署人投员不允许直歇接修改远端杆服务器中的谜程序。殊4.3服CVS源码玩同步中的常挤见问题及注扛意事项站1)碰提交冲突：隆每天开始做朵项目之前首毫先要从服务羡器端更新项木目到本机，捐这是因为在司Eclip员se和CV恢S服务器同限步之前，可行能别人以对汤项目进行了裙修改，导致热服务器端版鼓本与本地不料同步，Ec型lipse服中没有刷新声而导致同步惨报错。比如闪当前有两个娘用户gue邀st1和g射ues2，钻两人电脑上永的XXX.熊java文屈件版本都是答1.2，g持uest1研修改了一下蚊提交上去，臣版本变为1非.3，因为表是第一次提览交，所以不而会报错。g琴uest2帜编的慢一些粘，后提交，柜这时就会和督guest供1提交上去敞的代码产生略冲突。这是斤因为如果用誓guest皇2的代码更够新CVS，牙guest剩1的代码就弊会被冲洗掉券，所以Ec洽lipse准就会报文件灭冲突。炉2)汽解决方法：叛右键单击要咽提交的文件窝，选小组里乘的更新，此甲时XXX.惨java文片件的版本已习变成1.3屋，更新后的线冲突也标记正出来了，再膀跟据代码中孟的冲突合并妻修改，改完筝后提交到C榴VS上，此链时版本变为遥1.4。还葛可以将Ec央lipse秆设置为自动玩刷新，操作班方法：Wi滔ndow-贝>Pref春erenc翠es->W逃orkbe盖nch，选笔中Refr钟eshw幸orksp蹄acea弯utoma桥tical提ly。但这桶种方法不推筝荐使用，如叫果春项目喉组成员上传怠无用的测试阻文件，都会贡更新到本地佳，使项目看柳起来比较混遗乱。建议：岭（1）将项歪目做成模块落目录，每个习人负责自己贺的模块，这旷样就不容易俊造成重复修匀改丑。勺（2）做到导每日提交，涌并且要求代做码是完整可忙运行的，保臂证其它人更递新运行你的省代码后不会届产生错误。反（3）任何仙人做修改时励都要更新最醋新版本到本辜机。小此外，遵CVS不允沟许进行删除逆服务器端文以件，所以大晌家最好不要愁提交临时文丛件及临时目抵录，如编译道产生的文件绒和目录。还朝有不要传和毙项目无关的食程序上去，劝否则会导致愁服务器臃肿内，结构不清慈晰，不便串项目阅组其他成员岛查看。如果止有一些测试纸用的文件上确传，要新建叼一个临时项孔目上传，与屈主项目分离味。这样小组军成员在更新牵项目的时候售就不会把一打些无用的文认件更新到本伸地。跪不同功能模羽块的文件分珠开Comm波it，同一霸功能模块的乞文件一次C肠ommit环，对于分析译错误、减少怎冲突、版本兴回退等有帮县助。尖如果Ecl愈ipse项逃目前有言”请>津”历符号，这是肾做了修改的榜程序还没有锯提交到CV续S服务器上陡，只要提交采一下此标记授就会消失。魔5释.竖服务器配置匆说明不5矿.1信项目部署与盈服务器启动枯1、项目牙部署：摧将打好的w莫ar包放入战C:\Pr演ogram竭File造s\Apa庄cheS寒oftwa茎reFo崖undat疾ion\T瞒omcat畅走2、2、米5.5\w胆ebapp六s称目录下即可偏，注意先备眠份之前的项蛋目。沿服务器启动擦：艇采用懒C:\Pr灰ogram肢File待s\Apa端cheS屿oftwa双reFo思undat车ion\T默omcat率5.5\导bin闷目录下的才tomca用t5.ex虎e烫启动，这个洗启动方式会辆弹出命令窗乞口可以查看治错误信息，冲如果要关闭恒服务器只要负把窗口关闭朵即可。挂采用躺C:\Pr导ogram宝File酱s\Apa溉cheS歼oftwa固reFo燃undat详ion\T流omcat巡5.5\援bin茂目录下的饺tomca挎t5w.e屋xe军启动，会弹搂出