JavaWeb开发编程规范V10
- 1、下载文档前请自行甄别文档内容的完整性,平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益,请联系客服反馈,我们会尽快为您处理(人工客服工作时间:9:00-18:30)。
Java Web 开发编程规范V1.0
----- By Away @2013.11.13 代码编写规范目的:能够在编码过程中实现规范化,为以后的程序开发中养成良好的行为习惯。
代码编写规范使用范围:J2EE项目开发。
1 包命名规范:
目的:包的命名规范应当体现出项目资源良好的划分
1.servlet类所在包命名规范:公司名称.开发组名称.项目名称.web.servlet
例如:com.whut.web.servlet
2.自定义标签类所在包命名规范:公司名称.开发组名称.项目名称.web.tags
例如:com.whut.web.tags
3.过滤器类所在包命名规范:公司名称.开发组名称.项目名称.web.filter
例如:com.whut.web.filter
4.Action类所在包命名规范:公司名称.开发组名称.项目名称.web.struts.action
例如:com.whut.web.struts.action
5.ActionForm类所在包命名规范:公司名称.开发组名称.项目名称.web.struts.form
例如:com.whut.web.struts.form
6.Javabean所在包命名规范:公司名称.开发组名称.项目名称.web.struts.service.impl
例如:com.whut.web.service.impl
7.Javabean实现接口命名规范:公司名称.开发组名称.项目名称.web.service
例如:com.whut.web.service
8.DAO类所在包命名规范:公司名称.开发组名称.项目名称.dao.impl
例如:com.whut.web.dao.impl
9.DAO类所实现的接口在包中命名规范:公司名称.开发组名称.项目名称.dao
例如:com.whut.web.dao
10.POJO类与hbm文件所在包命名规范:公司名称.开发组名称.项目名称.dao.hbm
例如:com.whut.web.dao.hbm
11.全局公共类、接口类所在包命名规范:公司名称.开发组名称.项目名称.global
例如:com.whut.web.global
12.全局工具类所在包命名规范:公司名称.开发组名称.项目名称.util
例如:com.whut.web..util
2 类命名规范
基本命名规范:
1.类、接口命名
命名规范:以大写字母开头,如果有多个单词,每个单词头字母大写
例如:StudentInfo
2.接口命名
命名规范:以大写字母"I"开头,如果有多个单词,每个单词头字母大写
例如:IStudentInfo
3.接口实现类命名:
命名规范:将实现的接口名称的首字母"I"去掉,以"Impl作为结尾",如果有多个单词,每个单词头字母大写。
例如:StudentInfoImpl
3 J2EE+SSH框架命名规范
1.servlet类命名:
命名规范:以Servlet单词结尾
例如:LoginServlet
2.POJO命名:
使用hibernate自动生成的类即可
3.DAO类命名:
使用hibernate自动生成的类即可
4.Action类命名:
命名规范:Action的命名以POJO名称来制定,POJO名称Action
例如:
一个POJO名称为Diary,其对应的action为DiaryAction
5.ActionForm类命名:
命名规范:ActionForm的命名以POJO名称来制定,POJO名称Form
例如:
一个POJO名称为Diary,其对应的actioForm为DiaryForm
6.业务逻辑接口命名:
命名规范:业务逻辑接口的命名以POJO名称来制定,IPOJO名称Service
例如:
一个POJO名称为Diary,其对应的业务逻辑接口为IDiaryService
7.业务逻辑实现类命名:
命名规范:业务逻辑接口实现类的命名以POJO名称来制定
例如:
一个POJO名称为Diary,对应的业务逻辑接口实现类名为DiaryServiceImpl
4类变量命名:
命名规范:变量名首字母必须小写,如果该变量名有多个单词组成,后面的单词首字母大写,单词与单词之间不要使用"_"做连接,变量名访问控制必须为私有,可以对其增加setter与getter方法。
5 常量命名:
命名规范:所有字母大写,如果有多个单词组成,单词与单词之间以"_"隔开。而且该变量必须是公共、静态、final类型
例如:public static final String USER_NAME="userName";
6方法命名
命名规范:首字母必须小写,如果该变量名有多个单词组成,后面的单词首字母大写,单词与单词之间不要使用"_"做连接。单词不要使用名词。
例如:public int checkLogin(String name,String pwd){}
7 注释规范
注释规范是整个开发规范中最为重要的组成部分,必须严格执行。
1.类的注释:
作用:注释整个类,简单概述该类作用。
书写规范:类的注释必须写在该类的声明语法之前。在注释中要描述该类的基本作用,作者,日期,版本,公司名称,版权声明。