锐客网

  1. 首页 > 生活百科 > it技术 > >

16条java代码规范的简单介绍

IT技术捣鼓

java软件开发的代码规范1、组织与风格
(1).关键词和操作符之间加适当的空格 。
(2).相对独立的程序块与块之间加空行
(3).较长的语句、表达式等要分成多行书写 。
(4).划分出的新行要进行适应的缩进，使排版整齐，语句可读 。
(5).长表达式要在低优先级操作符处划分新行，操作符放在新行之首 。
(6).循环、判断等语句中若有较长的表达式或语句，则要进行适应的划分 。
(7).若函数或过程中的参数较长，则要进行适当的划分 。
(8).不允许把多个短语句写在一行中，即一行只写一条语句 。
(9).函数或过程的开始、结构的定义及循环、判断等语句中的代码都要采用缩进风格 。
注：如果大家有兴趣可以到安安DIY创作室博客 ， 有相关说明性的文章和解释 。
2、注解
Java 的语法与 C++ 及为相似，那么，你知道 Java 的注释有几种吗？是两种？
// 注释一行
/* ...... */ 注释若干行
不完全对 ， 除了以上两种之外 ， 还有第三种，文档注释：
/** ...... */ 注释若干行，并写入 javadoc 文档
注释要简单明了 。
String userName = null; //用户名
边写代码边注释，修改代码同时修改相应的注释，以保证注释与代码的一致性 。
在必要的地方注释，注释量要适中 。注释的内容要清楚、明了 ， 含义准确，防止注释二义性 。
保持注释与其描述的代码相邻 ， 即注释的就近原则 。
对代码的注释应放在其上方相邻位置，不可放在下面 。对数据结构的注释应放在其上方相邻位置 ， 不可放在下面；对结构中的每个域的注释应放在此域的右方；
同一结构中不同域的注释要对齐 。
变量、常量的注释应放在其上方相邻位置或右方 。
全局变量要有较详细的注释 ， 包括对其功能、取值范围、哪些函数或过程存取它以及存取时注意事项等的说明 。
在每个源文件的头部要有必要的注释信息，包括：文件名；版本号；作者；生成日期；模块功能描述（如功能、主要算法、内部各部分之间的关系、该文件与其它文件关系等）；主要函数或过程清单及本文件历史修改记录等 。
/**
* Copy Right Information : Neusoft IIT
* Project : eTrain
* JDK version used : jdk1.3.1
* Comments : config path
* Version : 1.01
* Modification history :2003.5.1
* Sr Date Modified By WhyWhat is modified
* 1. 2003.5.2 Kevin Gao new
**/
在每个函数或过程的前面要有必要的注释信息，包括：函数或过程名称；功能描述；输入、输出及返回值说明；调用关系及被调用关系说明等
/**
* Description :checkout 提款
* @param Hashtable cart info
* @param OrderBean order info
* @return String
*/
public String checkout(Hashtable htCart,
OrderBean orderBean)
throws Exception{
}
javadoc注释标签语法
@author 对类的说明 标明开发该类模块的作者
@version 对类的说明 标明该类模块的版本
@see 对类、属性、方法的说明 参考转向，也就是相关主题
@param 对方法的说明 对方法中某参数的说明
@return 对方法的说明 对方法返回值的说明
@exception 对方法的说明 对方法可能抛出的异常进行说明
3、命名规范
定义这个规范的目的是让项目中所有的文档都看起来像一个人写的，增加可读性，减少项目组中因为换人而带来的损失 。（这些规范并不是一定要绝对遵守，但是一定要让程序有良好的可读性）较短的单词可通过去掉元音形成缩写；要不然最后自己写的代码自己都看不懂了，那可不行 。

推荐阅读


上一篇：委外工单流程sap，sap 委外

下一篇：免费直播ae教程，adobe直播软件功能