项目命名规范_java项目命名规范 - CSDN
精华内容
参与话题
  • JAVA项目命名规范

    2019-01-08 15:33:36
    1.项目名全部小写; 2.包名全部小写; 3.类名的首字母大写,如果类名由多个单词构成,则每个单词的首字母都要大写; 如:public Class MyHelloWord { } 4.变量名、方法名首字母小写,如果名称由多个单词组成,每个...

    1.项目名全部小写;
    2.包名全部小写;
    3.类名的首字母大写,如果类名由多个单词构成,则每个单词的首字母都要大写;
    如:public Class MyHelloWord { }
    4.变量名、方法名首字母小写,如果名称由多个单词组成,每个单词的首字母都要大写;
    如:int index=0;
    public void toString(){}
    5.常量的名称全部大写;
    如:public static final String WMS_SUCCESS_CODE = “0000”;
    6.所有命名必须遵循以下原则:
    (1) 名称只能由字母、数字、下划线、$符号组成,
    (2)不能以数字开头
    (3)名称不能使用JAVA中的关键字。
    (4)坚决不允许出现中文及拼音命名。

    展开全文
  • 项目的一些命名规范

    2019-04-30 00:10:50
    命名规范:目的:包的命名规范应当体现出项目资源良好的划分 servlet类所在包命名规范:公司名称.开发组名称.项目名称.web.servlet例如:net.linkcn.web.servlet 自定义标签类所在包命名规范:公司名...

    代码编写规范目的:能够在编码过程中实现规范化,为以后的程序开发中养成良好的行为习惯。
    代码编写规范使用范围:J2EE项目开发。
    包命名规范:
    目的:包的命名规范应当体现出项目资源良好的划分

    servlet类所在包命名规范:公司名称.开发组名称.项目名称.web.servlet
    例如:net.linkcn.web.servlet

    自定义标签类所在包命名规范:公司名称.开发组名称.项目名称.web.tags
    例如:net.linkcn.web.tags

    过滤器类所在包命名规范:公司名称.开发组名称.项目名称.web.filter
    例如:net.linkcn.web.filter

    Action类所在包命名规范:公司名称.开发组名称.项目名称.web.struts.action
    例如:net.linkcn.web.struts.action

    ActionForm类所在包命名规范:公司名称.开发组名称.项目名称.web.struts.form
    例如:net.linkcn.web.struts.form

    Javabean所在包命名规范:公司名称.开发组名称.项目名称.web.struts.service.impl
    例如:net.linkcn.web.service.impl

    Javabean实现接口命名规范:公司名称.开发组名称.项目名称.web.service
    例如:net.linkcn.web.service

    DAO类所在包命名规范:公司名称.开发组名称.项目名称.dao.impl
    例如:net.linkcn.dao.impl

    DAO类所实现的接口在包中命名规范:公司名称.开发组名称.项目名称.dao
    例如:net.linkcn.dao

    POJO类与hbm文件所在包命名规范:公司名称.开发组名称.项目名称.dao.hbm
    例如:net.linkcn.dao.hbm

    全局公共类、接口类所在包命名规范:公司名称.开发组名称.项目名称.global
    例如:net.linkcn.global

    全局工具类所在包命名规范:公司名称.开发组名称.项目名称.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(){
    return studentAge;
    }
    public void setStudentAge(int studentAge) {
    this.studentAge=studentAge;
    }

    常量命名:
    命名规范:所有字母大写,如果有多个单词组成,单词与单词之间以” _“隔开。而 且该变量必须是公共、静态、final类型
    例如:public static final String USER_NAME=”userName“;

    方法命名
    命名规范:首字母必须小写,如果该变量名有多个单词组成,后面的单词首字母 大写,单词与单词之间不要使用"_"做连接。单词不要使用名词。
    例如:public int checkLogin(String name,String pwd){}

    注释规范:注释规范是整个开发规范中最为重要的组成部分,必须严格执行。

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

    类的声明语法

    例如:

    public class AdminDAO

    变量、常量注释:
    作用:简单描述该变量的意义。
    书写规范:变量注释必须写在变量定义之前,简单描述其代表的意义。
    格式:

    例如:

    public int age;
    方法注释:
    作用:对该方法功能简单描述,其参数、返回值意义的注解。
    书写规范:方法注释必须写在方法定义之前。该注释包括:方法其功能的简单 描述,方法的参数、返回值类型、返回值意义简单的描述。
    格式:

    例如:

    public booleaneditAdminPassword(int adminId,String oldPassword,
    String password) throws UserException,ServiceException;

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

    J2EE项目工程文件夹组织规范:
    目的:规范学员web应用程序的资源组织形式,形成良好的文件组织习惯。文件的组织形式应当体现模块的划分。

    根据eclipse工具的特征,项目的目录结构为:
    src
    ----存放java文件
    WebRoot
    |--images --存放web程序所需的公共图片
    |--css --存放web程序所需的公共样式表
    |--js --存放web程序所需的公共js文件
    |--commons --存放web程序所需的公共文件
    |--功能模块文件夹(存放与某个功能模块相关的资源)
    |--images --存放与该功能模块相关的图片
    |--css --存放与该模块相关的样式表文件
    |--js --存放与该模块相关的js文件
    |--jsp、html页面
    |--WEB-INF
    |--classes
    |--lib
    |--tld文件

    J2EE项目提交规范
    项目完成时要将项目作为一个产品交付用户,良好的项目组织规范可以使用户可以方便的找寻项目中需要的资源,同时也是一个公司专业性的体现。项目提交时,要按照下列文件格式进行提交。

    项目主文件夹:
    作用:存放项目其他资源文件。
    命名规范:时间_班级编号_第X小组。
    例如:070706_GS2T18_第四小组。
    项目主文件夹下面包括以下文件夹和文件:
    |--src:保存.java文件。
    |--database:保存数据库的脚本文件或者数据库备份文件。
    |--source:保存eclipse工程中WebRoot目录下的所有文件。
    |--depend:保存编译该程序必须依赖的其他jar文件。
    |--javadoc:保存所有类生成的javadoc api文档。
    |--war:保存程序的归档文件
    |--xx.war:已经打包好的工程文件,可以直接运行。
    |--project:保存开发项目原工程代码及文件。
    |--产品说明书.doc:图文方式展现该产品使用方法。
    |--build.xml:ant脚本,用于生成运行的war文件。
    |--项目解说.ppt:进行项目讲解的ppt(ppt仅供在校模拟项目使用,不用于其他商业用途)
    注:一个完整的项目中,数据库必须有一定量的有效的测试数据来支持该程序的运行

    包的命名 
    Java包的名字都是由小写单词组成。但是由于Java面向对象编程的特性,每一名Java程序员都可以编写属于自己的Java包,为了保障每个 Java包命名的唯一性,在最新的Java编程规范中,要求程序员在自己定义的包的名称之前加上唯一的前缀。由于互联网上的域名称是不会重复的,所以程序 员一般采用自己在互联网上的域名称作为自己程序包的唯一前缀。
    例如: net.frontfree.javagroup

    类的命名
    类的名字必须由大写字母开头而单词中的其他字母均为小写;如果类名称由多个单词组成,则每个单词的首字母均应为大写例如TestPage;如果类名 称中包含单词缩写,则这个所写词的每个字母均应大写,如:XMLExample,还有一点命名技巧就是由于类是设计用来代表对象的,所以在命名类时应尽量 选择名词。   
    例如: Circle

    方法的命名
    方法的名字的第一个单词应以小写字母作为开头,后面的单词则用大写字母开头。
    例如: sendMessge

    常量的命名
    常量的名字应该都使用大写字母,并且指出该常量完整含义。如果一个常量名称由多个单词组成,则应该用下划线来分割这些单词。
    例如: MAX_VALUE

    参数的命名
    参数的命名规范和方法的命名规范相同,而且为了避免阅读程序时造成迷惑,请在尽量保证参数名称为一个单词的情况下使参数的命名尽可能明确。

    Javadoc注释
    Java除了可以采用我们常见的注释方式之外,Java语言规范还定义了一种特殊的注释,也就是我们所说的Javadoc注释,它是用来记录我们代 码中的API的。Javadoc注释是一种多行注释,以结束,注释可以包含一些HTML标记符和专门的关键词。使用Javadoc 注释的好处是编写的注释可以被自动转为在线文档,省去了单独编写程序文档的麻烦。
    例如:

    在每个程序的最开始部分,一般都用Javadoc注释对程序的总体描述以及版权信息,之后在主程序中可以为每个类、接口、方法、字段添加 Javadoc注释,每个注释的开头部分先用一句话概括该类、接口、方法、字段所完成的功能,这句话应单独占据一行以突出其概括作用,在这句话后面可以跟 随更加详细的描述段落。在描述性段落之后还可以跟随一些以Javadoc注释标签开头的特殊段落,例如上面例子中的@auther和@version,这 些段落将在生成文档中以特定方式显示。

    变量和常量命名
    变量命名的方法采用匈牙利命名法,基本结构为scope_typeVariableName,它使用3字符前缀来表示数据类型,3个字符的前缀必须 小写,前缀后面是由表意性强的一个单词或多个单词组成的名字,而且每个单词的首写字母大写,其它字母小写,这样保证了对变量名能够进行正确的断句。例如, 定义一个整形变量,用来记录文档数量:intDocCount,其中int表明数据类型,后面为表意的英文名,每个单词首字母大写。这样,在一个变量名就 可以反映出变量类型和变量所存储的值的意义两方面内容,这使得代码语句可读性强、更加容易理解。byte、int、char、long、float、 double、boolean和short。
    变量类型和首字母对照关系如下表:
    数据类型/对象类型 / 变量前缀 / 备注
    byte bye
    char chr
    float flt
    boolean bln 做布尔变量时,使用bln
    Integer/int int
    String str
    Single sng
    short sht
    Long/long lng
    Double/double dbl
    Currency cur
    Variant bln astr obj vnt 做布尔变量用时,用bln,做字符串数组用时,用astr,做为对象使用时,用obj,不确定时,用vnt。
    对于数组,在数据类型的前缀前再增加一个a,例如字符串数组为astr。对于在多个函数内都要使用的全局变量,在前面再增加“g_”。例如一个全局的字符串变量:g_strUserInfo。

    在变量命名时要注意以下几点:
    · 选择有意义的名字,注意每个单词首字母要大写。

    · 在一段函数中不使用同一个变量表示前后意义不同的两个数值。

    · i、j、k等只作为小型循环的循环索引变量。

    · 避免用Flag来命名状态变量。

    · 用Is来命名逻辑变量,如:blnFileIsFound。通过这种给布尔变量肯定形式的命名方式,使得其它开发人员能够更为清楚
    的理解布尔变量所代表的意义。

    · 如果需要的话,在变量最后附加计算限定词,如:curSalesSum。

    · 命名不相包含,curSales和curSalesSum。

    · Static Final 变量的名字应该都大写,并且指出完整含义。

    · 如果需要对变量名进行缩写时,一定要注意整个代码中缩写规则的一致性。例如,如果在代码的某些区域中使用intCnt,而在另一些区域中又使用intCount,就会给代码增加不必要的复杂性。建议变量名中尽量不要出现缩写。

    · 通过在结尾处放置一个量词,就可创建更加统一的变量,它们更容易理解,也更容易搜索。例如,请使用 strCustomerFirst和strCustomerLast,而不要使用strFirstCustomer和strLastCustomer。常 用的量词后缀有:First(一组变量中的第一个)、Last(一组变量中的最后一个)、Next(一组变量中的下一个变量)、Prev(一组变量中的上 一个)、Cur(一组变量中的当前变量)。

    · 为每个变量选择最佳的数据类型,这样即能减少对内存的需求量,加快代码的执行速度,又会降低出错的可能性。用于变量的数据类型可能会影响该变量进行计算所产生的结果。在这种情况下,编译器不会产生运行期错误,它只是迫使该值符合数据类型的要求。这类问题极难查找。

    · 尽量缩小变量的作用域。如果变量的作用域大于它应有的范围,变量可继续存在,并且在不再需要该变量后的很长时间内仍然占用资源。它们的主要问题是,任何类 中的任何方法都能对它们进行修改,并且很难跟踪究竟是何处进行修改的。占用资源是作用域涉及的一个重要问题。对变量来说,尽量缩小作用域将会对应用程序的 可靠性产生巨大的影响。
    关于常量的命名方法,在JAVA代码中,无论什么时候,均提倡应用常量取代数字、固定字符串。也就是说,程序中除0,1以外,尽量不应该出现其他数 字。常量可以集中在程序开始部分定义或者更宽的作用域内,名字应该都使用大写字母,并且指出该常量完整含义。如果一个常量名称由多个单词组成,则应该用下 划线“_”来分割这些单词如:NUM_DAYS_IN_WEEK、MAX_VALUE。

    展开全文
  • 一、包命名规范:目的:包的命名规范应当体现出项目资源良好的划分 1.servlet类所在包命名规范:公司名称.开发组名称.项目名称.web.servlet 例如:net.linkcn.web.servlet 2.自定义标签类所在包命名规范:公司名称...

    代码编写规范目的:能够在编码过程中实现规范化,为以后的程序开发中养成良好的行为习惯。


    代码编写规范使用范围:J2EE项目开发。


    一、包命名规范:
    目的:包的命名规范应当体现出项目资源良好的划分

    1.servlet类所在包命名规范:公司名称.开发组名称.项目名称.web.servlet
    例如:net.linkcn.web.servlet


    2.自定义标签类所在包命名规范:公司名称.开发组名称.项目名称.web.tags
    例如:net.linkcn.web.tags


    3.过滤器类所在包命名规范:公司名称.开发组名称.项目名称.web.filter
    例如:net.linkcn.web.filter


    4.Action类所在包命名规范:公司名称.开发组名称.项目名称.web.struts.action
    例如:net.linkcn.web.struts.action


    5.ActionForm类所在包命名规范:公司名称.开发组名称.项目名称.web.struts.form
    例如:net.linkcn.web.struts.form


    6.Javabean所在包命名规范:公司名称.开发组名称.项目名称.web.struts.service.impl
    例如:net.linkcn.web.service.impl


    7.Javabean实现接口命名规范:公司名称.开发组名称.项目名称.web.service
    例如:net.linkcn.web.service


    8.DAO类所在包命名规范:公司名称.开发组名称.项目名称.dao.impl
    例如:net.linkcn.dao.impl


    9.DAO类所实现的接口在包中命名规范:公司名称.开发组名称.项目名称.dao
    例如:net.linkcn.dao


    10.POJO类与hbm文件所在包命名规范:公司名称.开发组名称.项目名称.dao.hbm
    例如:net.linkcn.dao.hbm


    11.全局公共类、接口类所在包命名规范:公司名称.开发组名称.项目名称.global
    例如:net.linkcn.global


    12.全局工具类所在包命名规范:公司名称.开发组名称.项目名称.util
    例如:net.linkcn.util

     


    二、类命名规范
    基本命名规范:

    1.类、接口命名
    命名规范:以大写字母开头,如果有多个单词,每个单词头字母大写
    例如:StudentInfo

     

    2.接口命名

    命名规范:以大写字母"I"开头,如果有多个单词,每个单词头字母大写
    例如:IStudentInfo

    3.接口实现类命名:
    命名规范:将实现的接口名称的首字母"I"去掉,以"Impl作为结尾",如果有多个单词,每个单词头字母大写。
    例如:StudentInfoImpl

    4.J2EE+SSH框架命名规范
    servlet类命名:
    命名规范:以Servlet单词结尾
    例如:LoginServlet

    5.POJO命名:
    使用hibernate自动生成的类即可

    6.DAO类命名:
    使用hibernate自动生成的类即可

    7.Action类命名:
    命名规范:Action的命名以POJO名称来制定,POJO名称Action
    例如:
    一个POJO名称为Diary,其对应的action为DiaryAction

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

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

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

    11.类变量命名:
    命名规范:变量名首字母必须小写,如果该变量名有多个单词组成,后面的单 词首字母大写,单词与单词之间不要使用"_"做连接,变量名访问控制必须为私有, 可以对其增加setter与getter方法。
    例如:
    private int studentAge;
    public int getStudentAge(){
    return studentAge;
    }
    public void setStudentAge(int studentAge) {
    this.studentAge=studentAge;
    }

    12.常量命名:
    命名规范:所有字母大写,如果有多个单词组成,单词与单词之间以” _“隔开。而 且该变量必须是公共、静态、final类型
    例如:public static final String USER_NAME=”userName“;

    13.方法命名
    命名规范:首字母必须小写,如果该变量名有多个单词组成,后面的单词首字母 大写,单词与单词之间不要使用"_"做连接。单词不要使用名词。
    例如:public int checkLogin(String name,String pwd){}

    14.注释规范:

    注释规范是整个开发规范中最为重要的组成部分,必须严格执行。

    15.类的注释:
    作用:注释整个类,简单概述该类作用。
    书写规范:类的注释必须写在该类的声明语法之前。

    在注释中要描述该类的基 本作用,作者,日期,版本,公司名称,版权声明。
    格式:

    16.类的声明语法

    例如:public class AdminDAO

    17.变量、常量注释:
    作用:简单描述该变量的意义。
    书写规范:变量注释必须写在变量定义之前,简单描述其代表的意义。
    格式:
    例如:
    public int age;

    18.方法注释:
    作用:对该方法功能简单描述,其参数、返回值意义的注解。
    书写规范:方法注释必须写在方法定义之前。该注释包括:方法其功能的简单 描述,方法的参数、返回值类型、返回值意义简单的描述。
    格式:
    例如:
    public booleaneditAdminPassword(int adminId,String oldPassword,
    String password) throws UserException,ServiceException;

    三、Jsp页面命名:
    命名规范:jsp页面名称要以小写字母开头,如果有多个单词组成,后面的单词以 大写字母开头。名称要体现出该页面的意义,最好能够与模块名称联系在一起。
    例如:
    login.jsp --登录页面
    register.jsp --注册页面
    message.jsp --客户留言页面

     

    四、J2EE项目工程文件夹组织规范:
    目的:规范学员web应用程序的资源组织形式,形成良好的文件组织习惯。文件的组织形式应当体现模块的划分。

    1.根据eclipse工具的特征,项目的目录结构为:


    src
    ----存放java文件 
    WebRoot
    |--images --存放web程序所需的公共图片
    |--css --存放web程序所需的公共样式表
    |--js --存放web程序所需的公共js文件
    |--commons --存放web程序所需的公共文件
    |--功能模块文件夹(存放与某个功能模块相关的资源)
    |--images --存放与该功能模块相关的图片
    |--css --存放与该模块相关的样式表文件
    |--js --存放与该模块相关的js文件
    |--jsp、html页面
    |--WEB-INF
    |--classes
    |--lib
    |--tld文件

    2.J2EE项目提交规范

          项目完成时要将项目作为一个产品交付用户,良好的项目组织规范可以使用户可以方便的找寻项目中需要的资源,同时也是一个公司专业性的体现。项目提交时,要按照下列文件格式进行提交。

    1)项目主文件夹:
    作用:存放项目其他资源文件。

    命名规范:时间_班级编号_第X小组。
    例如:070706_GS2T18_第四小组。


    2)项目主文件夹下面包括以下文件夹和文件:
    |--src:保存.java文件。
    |--database:保存数据库的脚本文件或者数据库备份文件。
    |--source:保存eclipse工程中WebRoot目录下的所有文件。
    |--depend:保存编译该程序必须依赖的其他jar文件。
    |--javadoc:保存所有类生成的javadoc api文档。
    |--war:保存程序的归档文件
    |--xx.war:已经打包好的工程文件,可以直接运行。
    |--project:保存开发项目原工程代码及文件。
    |--产品说明书.doc:图文方式展现该产品使用方法。
    |--build.xml:ant脚本,用于生成运行的war文件。
    |--项目解说.ppt:进行项目讲解的ppt(ppt仅供在校模拟项目使用,不用于其他商业用途)
    注:一个完整的项目中,数据库必须有一定量的有效的测试数据来支持该程序的运行

    3)包的命名  
         Java包的名字都是由小写单词组成。但是由于Java面向对象编程的特性,每一名Java程序员都可以编写属于自己的Java包,为了保障每个 Java包命名的唯一性,在最新的Java编程规范中,要求程序员在自己定义的包的名称之前加上唯一的前缀。由于互联网上的域名称是不会重复的,所以程序 员一般采用自己在互联网上的域名称作为自己程序包的唯一前缀。 
    例如: net.frontfree.javagroup 

    4)类的命名 
        类的名字必须由大写字母开头而单词中的其他字母均为小写;如果类名称由多个单词组成,则每个单词的首字母均应为大写例如TestPage;如果类名 称中包含单词缩写,则这个所写词的每个字母均应大写,如:XMLExample,还有一点命名技巧就是由于类是设计用来代表对象的,所以在命名类时应尽量 选择名词。    
    例如: Circle 

    5)方法的命名 
        方法的名字的第一个单词应以小写字母作为开头,后面的单词则用大写字母开头。 
    例如: sendMessge 

    6)常量的命名 
    常量的名字应该都使用大写字母,并且指出该常量完整含义。如果一个常量名称由多个单词组成,则应该用下划线来分割这些单词。 
    例如: MAX_VALUE 

    7)参数的命名 
    参数的命名规范和方法的命名规范相同,而且为了避免阅读程序时造成迷惑,请在尽量保证参数名称为一个单词的情况下使参数的命名尽可能明确。 

    8)Javadoc注释 
        Java除了可以采用我们常见的注释方式之外,Java语言规范还定义了一种特殊的注释,也就是我们所说的Javadoc注释,它是用来记录我们代 码中的API的。Javadoc注释是一种多行注释,以结束,注释可以包含一些HTML标记符和专门的关键词。使用Javadoc 注释的好处是编写的注释可以被自动转为在线文档,省去了单独编写程序文档的麻烦。 
    例如: 

        在每个程序的最开始部分,一般都用Javadoc注释对程序的总体描述以及版权信息,之后在主程序中可以为每个类、接口、方法、字段添加 Javadoc注释,每个注释的开头部分先用一句话概括该类、接口、方法、字段所完成的功能,这句话应单独占据一行以突出其概括作用,在这句话后面可以跟 随更加详细的描述段落。在描述性段落之后还可以跟随一些以Javadoc注释标签开头的特殊段落,例如上面例子中的@auther和@version,这 些段落将在生成文档中以特定方式显示。

    9)变量和常量命名
         变量命名的方法采用匈牙利命名法,基本结构为scope_typeVariableName,它使用3字符前缀来表示数据类型,3个字符的前缀必须 小写,前缀后面是由表意性强的一个单词或多个单词组成的名字,而且每个单词的首写字母大写,其它字母小写,这样保证了对变量名能够进行正确的断句。

         例如, 定义一个整形变量,用来记录文档数量:intDocCount,其中int表明数据类型,后面为表意的英文名,每个单词首字母大写。这样,在一个变量名就 可以反映出变量类型和变量所 存储的值的意义两方面内容,这使得代码语句可读性强、更加容易理解。byte、int、char、long、float、 double、boolean和short。

        变量类型和首字母对照关系如下表:
    数据类型/对象类型 / 变量前缀 / 备注 
    byte bye 
    char chr 
    float flt 
    boolean bln 做布尔变量时,使用bln 
    Integer/int int 
    String str 
    Single sng 
    short sht 
    Long/long lng 
    Double/double dbl 
    Currency cur 
    Variant bln astr obj vnt 做布尔变量用时,用bln,做字符串数组用时,用astr,做为对象使用时,用obj,不确定时,用vnt。
    对于数组,在数据类型的前缀前再增加一个a,例如字符串数组为astr。对于在多个函数内都要使用的全局变量,在前面再增加“g_”。例如一个全局的字符串变量:g_strUserInfo。

    10)在变量命名时要注意以下几点:
    · 选择有意义的名字,注意每个单词首字母要大写。

    · 在一段函数中不使用同一个变量表示前后意义不同的两个数值。

    · i、j、k等只作为小型循环的循环索引变量。 

    · 避免用Flag来命名状态变量。 

    · 用Is来命名逻辑变量,如:blnFileIsFound。通过这种给布尔变量肯定形式的命名方式,使得其它开发人员能够更为清楚
    的理解布尔变量所代表的意义。 

    · 如果需要的话,在变量最后附加计算限定词,如:curSalesSum。 

    · 命名不相包含,curSales和curSalesSum。

    · Static Final 变量的名字应该都大写,并且指出完整含义。 

    · 如果需要对变量名进行缩写时,一定要注意整个代码中缩写规则的一致性。例如,如果在代码的某些区域中使用intCnt,而在另一些区域中又使用intCount,就会给代码增加不必要的复杂性。建议变量名中尽量不要出现缩写。 

    · 通过在结尾处放置一个量词,就可创建更加统一的变量,它们更容易理解,也更容易搜索。例如,请使用 strCustomerFirst和strCustomerLast,而不要使用strFirstCustomer和strLastCustomer。常 用的量词后缀有:First(一组变量中的第一个)、Last(一组变量中的最后一个)、Next(一组变量中的下一个变量)、Prev(一组变量中的上 一个)、Cur(一组变量中的当前变量)。

    · 为每个变量选择最佳的数据类型,这样即能减少对内存的需求量,加快代码的执行速度,又会降低出错的可能性。用于变量的数据类型可能会影响该变量进行计算所产生的结果。在这种情况下,编译器不会产生运行期错误,它只是迫使该值符合数据类型的要求。这类问题极难查找。

    · 尽量缩小变量的作用域。如果变量的作用域大于它应有的范围,变量可继续存在,并且在不再需要该变量后的很长时间内仍然占用资源。它们的主要问题是,任何类 中的任何方法都能对它们进行修改,并且很难跟踪究竟是何处进行修改的。占用资源是作用域涉及的一个重要问题。对变量来说,尽量缩小作用域将会对应用程序的 可靠性产生巨大的影响。 
    关于常量的命名方法,在JAVA代码中,无论什么时候,均提倡应用常量取代数字、固定字符串。也就是说,程序中除0,1以外,尽量不应该出现其他数 字。常量可以集中在程序开始部分定义或者更宽的作用域内,名字应该都使用大写字母,并且指出该常量完整含义。如果一个常量名称由多个单词组成,则应该用下 划线“_”来分割这些单词如:NUM_DAYS_IN_WEEK、MAX_VALUE。

    展开全文
  • 项目命名规范

    2013-04-20 15:29:48
    项目命名规范: 原则:尽量简单   类及文件命名规则: 1、包全限定名:com.xxxx.service 2、所有类都分层放入对应的包中,如DAO放入com.xxx.dao中 3、所有类命名规则如:模块名+功能名(如:userDao.java) 4...

    项目命名规范:

    原则:尽量简单

     

    类及文件命名规则:

    1、包全限定名:com.xxxx.service

    2、所有类都分层放入对应的包中,如DAO放入com.xxx.dao中

    3、所有类命名规则如:模块名+功能名(如:userDao.java)

    4、Action类都以action结尾以方便struts.xml文件中的配置

    5、JSP命名如:模块名_动作_描述(如:user_add_error.jsp)

       表名与Model同名,加前缀t_

    action的类名为模块名 + 后缀Action

    每个模块原则上只配一个Action   

     action在配置文件中的名字为模块名首字母小写

    增删改查的方法分别为add/update/delete/query

     采用*-*配置

          <li>包名为模块名小写</li>

          <li>Action放在统一的包中</

     

    包命名规则

    dao 与数据库的操作,增删改查等方法
    modal 一般都是javabean对象,例如与数据库的某个表相关联。
    service 供外部调用,等于对dao,modal等进行了包装。
    impl 定义的接口
    util 通常都是工具类,如字符串处理、日期处理等


    字段命名:

    普通字段:表名_对应英文名词(topic_title)

    外键:表名_对应表名_对应字段名(topic_board_id)

    主键:表名_本表表名_字段名称(topic_topic_id)

     

    表的命名:_model名

    字段:保存和属性名一致

    库名:项目名

    用层来划分包

     

    开发步骤:

    1、建立界面原型

    2、建立struts.xml

           确定namespace

           确定package

           确定action名称

           确定result

           将界面原型页面进行修改,匹配现有设置

           测试

    3、建立数据库

    4、建立model层

    5、建立service层

    6、着手开发

      常见的SSH层一般分为7层:

              dao层(数据库接口),daoimpl层(数据库操作实现类),vo层(POJO类,数据库实体类),service层(业务逻辑层接口),

    serviceimpl层(业务逻辑实现层),action层(web逻辑处理层),form(表单处理层)。

    展开全文
  • java项目命名规范

    万次阅读 2018-01-10 12:30:25
    一、命名规范 1、 项目名全部小写 2、 包名全部小写 3、 类名首字母大写,如果类名由多个单词组成,每个单词的首字母都要大写。 如:public class MyFirstClass{} 4、 变量名、方法名首字母小写,如果名称...
  • Java项目命名规范

    2020-10-12 19:07:14
    Java项目命名规范 一、项目名 全部小写,比如cms、workdesk,jobserver等 二、java相关命名 a、类命名:每音节单词前的第一个字母大写,比如FieldInfo、Expression等\ b、普通变量(包括spring里的变量引用命名):第一...
  • 项目命名:[项目类型]-[项目编号]-[所属总公司英文简称]-[公司英文简称]-[项目名称]项目类型:00:个人项目 01:外部项目 02:工作项目项目编号: 01,02,03 .....所属总公司英文简称(可选): 有的话根据实际情况...
  • Java项目命名规范(简洁版)——高薪必看

    万次阅读 多人点赞 2014-12-26 11:39:56
    作为一个优秀的项目经理或项目带头人,必须养成良好优秀的项目命名规则和习惯。接下来把查到的资料整理一下,实际上,在很多项目中,也是遵循以下的规则。 一、项目名 全部小写,比如cms、workdesk,jobserver等 ...
  • 版本号命名规范及原则

    千次阅读 2019-08-15 17:31:04
    1 命名规范 主版本号.子版本号.修正版本号 2 命名原则 (1)项目初版本时,版本号可以为 0.1.0; (2)当项目在进行了局部修改或 bug 修正时,主版本号和子版本号都不变,修正版本号加 1; (3)当项目在原有...
  • Github库名命名规范

    千次阅读 2017-12-27 21:19:24
    Github库名命名规范一、必要性说明由于迁移到Github上的项目越来越多,对项目的管理越来越困难。由于各项目命名具有随意性,用之代表git仓库名后就很难快速回忆起这个项目的相关细节,通常需要不断打开某个库才能...
  • 目的:包的命名规范应当体现出项目资源良好的划分servlet类所在包命名规范:公司名称.开发组名称.项目名称.web.servlet 例如:net.linkcn.web.servlet自定义标签类所在包命名规范:公司名称.开发组名称.项目名称....
  • Github仓库命名规范

    千次阅读 2018-10-11 16:03:19
    Github仓库命名规范   命名规则 GIT库名一律采用项目名-类型-年月的形式。其中对项目名的规范如下: 库名中不得出现下述规定的字符- \ @ ! # $ % ^ &amp; * () [] {} | \ ; : '' ’ , 。 《 》 &lt;...
  • JAVA命名规范性总结

    万次阅读 2018-06-12 16:10:56
    一:命名规范1、项目名全部小写2、包名全部小写 在新建一个包项目时可能会涉及到多层设计,每层的包名要遵循包名全部小写的规范,如图在一个功能的逐层上级的包名全部是小写和字符组成 3、类名的命名要遵循首字母...
  • springboot业务模块命名规范

    千次阅读 2019-04-01 11:45:10
  • Python开发规范及文件命名

    万次阅读 2018-05-28 16:24:42
    Python开发规范 常用目录 目录名 作用 log 日志目录 conf 配置目录 core 核心代码 libs/modules 第三方库 docs 文档库 README 帮助文档 bin 启动入口,存放可执行文件 ...
  • Maven项目命名规范

    万次阅读 2017-03-09 15:38:09
    Guide to naming conventions on groupId, artifactId and version groupId will identify your project uniquely across all projects, so we need to enforce a naming schema. It has to follow the package ...
  • Java包(package)的命名规范&规则

    千次阅读 2019-08-09 10:03:49
    收藏一下吧! java中的打包机制是为了防止程序多个地方出现相同的名字而将局部程序限定在一块的机制 如不同地区存在 同名同姓的人,为解决这个问题,我们不同地方的所有人(程序)分别打包。调用A的时候分别带上a.A...
  • Java包(package)的命名规范,java中package命名规则

    万次阅读 多人点赞 2015-04-29 14:02:02
    Java的包名都有小写单词组成,类名首字母大写;... 由于Java面向对象的特性,每名Java开发人员都可以编写属于自己的Java Package,为了保障每个Java Package命名的唯一性,在最新的Java编程规范中,要求开发
  • 开发规范:文件 / 项目命名规范

    千次阅读 2016-11-15 11:34:52
    项目命名规范   采用英文小写方式,以下划线连接。如存在版本,最后连接版本号。 例: wash_car_feedback_v2     目录命名 采用英文小写...
  • django app的命名规则

    千次阅读 2016-07-18 22:35:53
    1.一般与app的主要的model名字一致 2.同时考虑URL ,优先级高于model 名字 例如:URL:... 那么,就应该将app的名字取为 weblog,不应该是blog, posts, blogposts等,即使app的主要model 名字是Posts
1 2 3 4 5 ... 20
收藏数 226,119
精华内容 90,447
关键字:

项目命名规范