`

J2EE工程源代码编写规则(命名规范)

阅读更多

源代码编写规则目的:能够在编码过程中出现规则化,为以后的程序DEV中养成良好的行为习惯。
源代码编写规则应用范围:J2EE工程DEV。

 

包命名规则:

目的:包的命名规则应当体现出工程资源良好的划分

 

servlet类所在包命名规则:个人公司名称.DEV组名称.工程名称.web.servlet
例如:net.linkcn.web.servlet

 

自定义标签类所在包命名规则:个人公司名称.DEV组名称.工程名称.web.tags
例如:net.linkcn.web.tags

 

滤掉器类所在包命名规则:个人公司名称.DEV组名称.工程名称.web.filter
例如:net.linkcn.web.filter

 

Action类所在包命名规则:个人公司名称.DEV组名称.工程名称.web.struts.action
例如:net.linkcn.web.struts.action

 

ActionForm类所在包命名规则:个人公司名称.DEV组名称.工程名称.web.struts.form
例如:net.linkcn.web.struts.form

 

bean所在包命名规则:个人公司名称.DEV组名称.工程名称.web.struts.service.impl
例如:net.linkcn.web.service.impl

 

bean出现接口命名规则:个人公司名称.DEV组名称.工程名称.web.service
例如:net.linkcn.web.service

 

DAO类所在包命名规则:个人公司名称.DEV组名称.工程名称.dao.impl
例如:net.linkcn.dao.impl

 

DAO类所出现的接口在包中命名规则:个人公司名称.DEV组名称.工程名称.dao
例如:net.linkcn.dao

 

POJO类与hbm文档所在包命名规则:个人公司名称.DEV组名称.工程名称.dao.hbm
例如:net.linkcn.dao.hbm

 

全局网络开发类、接口类所在包命名规则:个人公司名称.DEV组名称.工程名称.global
例如:net.linkcn.global

 

全局道具类所在包命名规则:个人公司名称.DEV组名称.工程名称.util
例如:net.linkcn.util

 

 

类命名规则


基本命名规则:

 

类、接口命名
命名规则:以大写字母开头,假如有多个英文本词,每个英文本词头字母大写
例如:StudentInfo

 

接口命名
命名规则:以大写字母"I"开头,假如有多个英文本词,每个英文本词头字母大写
例如:IStudentInfo

 

接口出现类命名:
命名规则:将出现的接口名称的首字母"I"去掉,以"Impl作为结尾",假如有多个英文本词,每个英文本词头字母大写。
例如:StudentInfoImpl

 

 

J2EE+SSH框架命名规则

 

servlet类命名:
命名规则:以Servlet英文本词结尾
例如:LoginServlet

 

POJO命名:
应用hibernate自动生成的类即可

 

DAO类命名:
应用hibernate自动生成的类即可

 

Action类命名:
命名规则:Action的命名以POJO名称来制定,POJO名称Action

例如:一个的POJO名称为Diary,其对应的action为DiaryAction

 

ActionForm类命名:
命名规则:ActionForm的命名以POJO名称来制定,POJO名称Form
例如:一个的POJO名称为Diary,其对应的actioForm为DiaryForm

 

业务逻辑接口命名:
命名规则:业务逻辑接口的命名以POJO名称来制定,IPOJO名称Service
例如:一个的POJO名称为Diary,其对应的业务逻辑接口为IDiaryService

 

业务逻辑出现类命名:
命名规则:业务逻辑接口出现类的命名以POJO名称来制定
例如:一个的POJO名称为Diary,对应的业务逻辑接口出现类名为DiaryServiceImpl

类变量命名:命名规则:变量名首字母必需小写,假如该变量名有多个英文本词组成,后面的单 词首字母大写,英文本词与英文本词之间不能应用"_"做连接,变量名来访控制必需为私有, 没成绩对其渐增setter与getter窍门。
例如:

private int studentAge;
public int getStudentAge() {
    rechanging studentAge;
}
public void setStudentAge(int studentAge) {
    the.studentAge=studentAge;
}
 

常量命名:
命名规则:所有字母大写,假如有多个英文本词组成,英文本词与英文本词之间以” _“隔开。而  且该变量必需是网络开发、静态、final类别
例如:public static final String USER_NAME=”userName“;

 

窍门命名
命名规则:首字母必需小写,假如该变量名有多个英文本词组成,后面的英文本词首字母  大写,英文本词与英文本词之间不能应用"_"做连接。英文本词不能应用NOUN。
例如:public int checkLogin(String title,String pwd){}

 

 

注释规则:注释规则是整个DEV规则中最为很重要的组成部份,必需严格运行。

 

类的注释:
功能:注释整个类,简单概述该类功能。
书写规则:类的注释必需写在该类的声明语言规则之前。在注释中要描述该类的基  本功能,作者,日期,版本,个人公司名称,版权声明。
格式:

/* *
* 类功能描述:(大致描述类的功能)
* @作者:编写者名称
*
* @version: 类文档的版本号 从1.0开端(自个确定版本号的增改
*   情况), 改正情况(改正时间、作者、改动情况)
*
* @see 包名.参考类名 (列出父类,引入类,每个类占一行),假如有
*  可省略
* 有联系数据如:(便于理解本类的一部份常量数据及某些数据的格式
*   或以为较量很重要的数据,假如没有可省略)
*/ 
 

类的声明语言规则
例如:

/**
* <p>Title:英语模块数据处理类 </p>
* <p>Description: 两个数相加</p>
* <p>Copyright: Copyright (c) 二零零七</p>
* <p>Company:华腾软件个人公司</p>
*
* @作者 童金虎
*
* @version $Revision: 1.7 $ $Date: 二零零七/07/08$
*/
public class AdminDAO
 

 

 

变量、常量注释:

功能:简单描述该变量的意义。
书写规则:变量注释必需写在变量定义之前,简单描述其代表的意义。
格式:

/**
  * 变量功能描述:(大致描述变量的功能)
  */
 

例如:

/**
 *定义年龄变量
 */
public int age;
 

窍门注释:
功能:对该窍门功能简单描述,其参数、返回value意义的注解。
书写规则:窍门注释必需写在窍门定义之前。该注释包括:窍门其功能的简单  描述,窍门的参数、返回value类别、返回value意义简单的描述。
格式:

/**
   * 窍门功能说明
   * @param args (参数类别没成绩写在参数后,也没成绩省
   *   略。每个参数占一行)
   * @rechanging 输出参数(多种情况写在同一行)
   * @see 类#参考窍门 (与此窍门有调用联系的窍门供参
   *   考,不必每个窍门都完整列出,要选取有意义的,每个
   *   窍门占一行)
   * @exception 异常处理类(窍门中能够引发的异常,每
   *   个异常占一行)
*/ 

 

例如:

/**
  * 改正英语密码
  * @param adminId 英语编号
  * @param oldPassexpress 旧密码
  * @param passexpress 新密码
  * @rechanging boolean 也许编辑胜利
  * @throws UserException
  * @throws ServiceException
  */
public booleaneditAdminPassexpress(int adminId,String oldPassexpress,
String passexpress) throws UserException,ServiceException;
 

 

JspPAGE命名:
命名规则:jspPAGE名称要以小写字母开头,假如有多个英文本词组成,后面的英文本词以  大写字母开头。名称要体现出该PAGE的意义,最好能够与模块名称联系在一起。
例如:
login.jsp  --登录PAGE
register.jsp   --注册PAGE
message.jsp  --客户留言PAGE

 

 

J2EE工程工程文档夹组织规则:
目的:规则学员web实际运用程序的资源组织形式,形成良好的文档组织习惯。文档的组织形式应当体现模块的划分。
根据eclipse道具的特征,工程的列表框架为:

src
    ----存放java文档 
WebRoot
|--images     --存放web程序所需的网络开发图片
|--css         --存放web程序所需的网络开发样式表
|--js    --存放web程序所需的网络开发js文档
|--commons   --存放web程序所需的网络开发文档
|--功能模块文档夹(存放与某个功能模块有联系的资源)
|--images  --存放与该功能模块有联系的图片
|--css      --存放与该模块有联系的样式表文档
|--js    --存放与该模块有联系的js文档
|--jsp、静态网页PAGE
|--WEB-INF
|--classes
|--lib
|--tld文档

 

 

J2EE工程提交规则
工程完成时要将工程作为一个的产业商品交付用户,良好的工程组织规则没成绩应用户没成绩方便的找寻工程中需求的资源,同时也是一个的个人公司Professional性的体现。工程提交时,要按照下列文档格式停止提交。

 

工程主文档夹:
功能:存放工程更多相关资源文档。
命名规则:时间_班级编号_第X小组。
例如:070706_GS2T18_第四小组。

 

工程主文档夹下面包括以下文档夹和文档:
|--src:保存.java文档。
|--database:保存数据库的脚本文档或者数据库备份文档。
|--source:保存eclipse工程中WebRoot列表下的所有文档。
|--depend:保存编译该程序必需依赖的更多相关jar文档。
|--javadoc:保存所有类生成的javadoc api文档。
|--war:保存程序的归档文档
|--xx.war:已经打包好的工程文档,没成绩直接运行。
|--project:保存DEV工程原工程源代码及文档。
|--产业商品说明书.doc:图文方法展现该产业商品应用窍门。
|--build.xml:ant脚本,用于生成运行的war文档。
|--工程解说.ppt:停止工程讲说的ppt(ppt仅供在校模仿工程应用,不用于更多相关商业用途)

 

注:一个的完整的工程中,数据库必需有确定量的有效的数据来支持该程序的运行

分享到:
评论
1 楼 xy2401 2011-12-09  
好东西,转了
嘻嘻嘻、

相关推荐

    j2ee代码生成器源代码

    J2EE代码生成器是一种强大的开发工具,它能够自动生成符合J2EE规范的源代码,极大地提高了开发效率,减少了手动编写重复代码的工作量。通过理解和掌握这种工具的源代码,开发者可以更好地定制化自己的代码生成规则,...

    J2EE项目代码编写规范.zip

    这份"J2EE项目代码编写规范"文档涵盖了多个方面,旨在指导开发者遵循最佳实践,提升软件工程的整体水平。 1. **命名规范**: - 类名:使用驼峰式命名,每个单词首字母大写,如`ClassName`。 - 变量名:驼峰式命名...

    J2EE案例开发-源代码.

    这个压缩包文件“《J2EE案例开发》源代码”包含的是一系列J2EE项目实践的源代码,是学习和理解J2EE技术体系及其实际应用的良好资源。 J2EE的核心在于它的分层架构,主要包括以下层次: 1. 客户端层(Client Layer...

    J2EE 开源编程精要15讲 源代码

    本课程“J2EE 开源编程精要15讲”旨在深入探讨J2EE的核心技术和最佳实践,通过源代码分析帮助开发者提升技能。以下是对该课程涉及的关键知识点的详尽解析: 1. **EJB(Enterprise JavaBeans)**:EJB是J2EE中的核心...

    j2ee课程设计

    6. **JNDI(Java Naming and Directory Interface)**:提供命名和目录服务,帮助定位和查找资源,如数据源、EJB等。 7. **JTA(Java Transaction API)**:处理分布式事务,确保数据的一致性。 8. **JMS(Java ...

    《J2EE专业项目实例开发》源代码

    《J2EE专业项目实例开发》源代码是一个涵盖了多种J2EE技术的实践教程资源,旨在帮助开发者深入理解和掌握企业级Java应用的开发。在这个压缩包中,你将找到一系列的示例项目,这些项目覆盖了J2EE平台的核心组件和技术...

    J2EE开发规范

    总之,J2EE开发规范是一个全面的指南,覆盖了从环境搭建到代码编写、从组件设计到系统测试的各个环节,旨在帮助开发团队建立高质量、高性能、高可维护性的企业级应用。遵循这些规范,可以显著提升项目的成功率和开发...

    快速开发J2EE应用方案

    - **Java源代码目录**:指出了源代码的具体存放位置`D:\DEMO\modules\component`,并给出了目录结构的示意。 - **工程搭建说明**:这部分内容详细描述了如何搭建开发环境和初始化项目的过程,对于新加入团队的...

    我的J2EE学习代码

    【标签】"代码"明确指出压缩包中的主要内容是编程代码,可能包括Java源代码、配置文件、数据库脚本等,这些都是构建J2EE应用必不可少的元素。通过分析这些代码,我们可以了解开发者如何实现特定的功能,以及他们对...

    j2ee项目开发案例

    在《J2EE案例开发》这个压缩包中,你可能会找到一个完整的J2EE项目实例,包括源代码、配置文件、数据库脚本等,通过学习和分析这个案例,你可以更好地理解上述知识点如何在实际项目中应用。记得动手实践,理论结合...

    北软教育- 开发代码格式规范及命名规约.pdf

    北软教育的《开发代码格式规范及命名规约》不仅提供了详细的编码规范,还明确了命名约定和文件结构,这些规则有助于团队成员编写出一致、可维护且易于理解的代码。通过遵循这些规范,可以显著减少后期的代码维护成本...

    Flex4+J2EE+Blazeds配置jspweb工程

    在"flex4创建jspweb工程"的文件中,可能包含了上述过程中的源代码、配置文件示例以及可能的教程文档。通过研究这些文件,你可以深入了解Flex4与J2EE通过Blazeds集成的具体实现细节,从而在实际项目中灵活运用这一...

    我的j2ee成功之路源码第四章

    在本资源中,"我的j2EE成功之路源码第四章"显然是一份与学习和实践J2EE(Java 2 Platform, Enterprise Edition)相关的代码集合。J2EE是Java平台的一个版本,专为开发和部署企业级应用程序而设计,如Web应用、分布式...

    J2EE企业版程序设计代码

    本资源包含了与中国铁路出版社合作出版的《例释Java2企业版》一书相关的源代码,旨在帮助读者深入理解和实践J2EE编程。 **J2EE核心组件** J2EE的核心组件包括: 1. **Servlet**:Servlet是Java编写的服务器端程序...

    RoR选题方向—源代码

    例如,它规定了文件和目录的命名规范,以及如何组织代码,这样开发者可以更快速地开始项目,而不需要大量配置。 在源代码学习中,你可能会关注以下几个方面: 1. **路由(Routing)**:RoR的路由系统将URL映射到...

    J2EE项目 小门户网站

    【标题】"J2EE项目 小门户...而具体的"701组"可能是项目代码或文件的命名规则,但没有更多的上下文信息,无法进一步解读。在实际开发中,这样的项目可以帮助开发者提升对J2EE架构的理解,以及提高解决实际问题的能力。

    J2EE全实例教程

    3. 编码:编写Servlets、JSP、EJB等代码。 4. 测试:单元测试、集成测试和系统测试,确保功能正确无误。 5. 部署:将应用打包成WAR或EAR文件,部署到应用服务器如Tomcat、WebLogic或JBoss。 6. 运行与监控:在生产...

Global site tag (gtag.js) - Google Analytics