java注释规范
来源:互联网 发布:海奇软件app 编辑:程序博客网 时间:2024/06/02 04:24
以下转自java注释
http://blog.csdn.net/shiyuezhong/article/details/8205281/
原则:
1、注释形式统一
在整个应用程序中,使用具有一致的标点和结构的样式来构造注释。如果在其它项目中发现它们的注释规范与这份文档不同,按照这份规范写代码,不要试图在既成的规范系统中引入新的规范。
2、注释内容准确简洁
内容要简单、明了、含义准确,防止注释的多义性,错误的注释不但无益反而有害。
注释条件:
1、基本注释(必须加)
(a) 类(接口)的注释
/**
类的描述
@author Administrator
@Time 2012-11-2014:49:01
*
*/
public classTest extends Button {
……
}
(b) 构造函数的注释
public class Test extends Button {
/**
构造方法 的描述
@param name
按钮的上显示的文字
*/
public Test(String name){
……
}
}
(c) 方法的注释
public class Test extends Button {
/**
为按钮添加颜色
*@param color
按钮的颜色
*@return
*@exception (方法有异常的话加)
@author Administrator
@Time2012-11-20 15:02:29
*/
public voidaddColor(String color){
……
}
}
(d) 全局变量的注释
public final class String
implements java.io.Serializable, Comparable,CharSequence
{
/* The value is used for characterstorage. /
private final char value[];//全局变量
/* The offset is the first index of thestorage that is used. /
private final int offset;//全局变量
/* The count is the number of charactersin the String. /
private final int count;//全局变量
/* Cache the hash code for the string /
private int hash; // Default to 0
……
}
(e) 字段/属性的注释
public class EmailBody implements Serializable{
private String id;
private String senderName;//发送人姓名
private String title;//不能超过120个中文字符
private String content;//邮件正文
private String attach;//附件,如果有的话
private String totalCount;//总发送人数
private String successCount;//成功发送的人数
private Integer isDelete;//0不删除 1删除
private Date createTime;//目前不支持定时 所以创建后即刻发送
privateSet EmailList;
……
}
备注:简单的代码做简单注释,注释内容不大于10个字即可,另外,持久化对象(已经存储到数据库或保存到本地硬盘中的对象)或VO对象的getter、setter方法不需加注释。具体的注释格式请参考下面举例。(java各种对象的链接http://www.cnblogs.com/bluestorm/archive/2012/09/26/2703234.html)
2、特殊必加注释(必须加)
(a) 典型算法必须有注释。
(b) 在代码不明晰处必须有注释。
(c) 在代码修改处加上修改标识的注释。
(d) 在循环和逻辑分支组成的代码中加注释。
(e) 为他人提供的接口必须加详细注释。
备注:具体的注释格式自行定义,要求注释内容准确简洁。
注释格式:
1、单行(single-line)注释:“//……”
2、块(block)注释:“/……/”
3、文档注释:“/*……/”
4、javadoc 注释标签语法
@author 对类的说明 标明开发该类模块的作者
@version 对类的说明 标明该类模块的版本
@see 对类、属性、方法的说明 参考转向,也就是相关主题
@param 对方法的说明 对方法中某参数的说明
@return 对方法的说明 对方法返回值的说明
@exception 对方法的说明 对方法可能抛出的异常进行说明
更详细的注释:http://gyhgc.iteye.com/blog/225039
- java注释规范
- Java注释规范
- Java注释规范
- java 注释规范
- Java注释规范
- Java 注释规范
- Java注释规范
- Java注释规范
- java注释规范
- java注释规范
- java注释规范
- Java注释规范
- Java代码注释规范
- Java注释规范
- Java注释规范
- java 注释规范
- Java注释规范[转载]
- Java的注释规范
- 加解密 签名
- Program4_G
- Android编程实现自动检测版本及自动升级的方法
- Linux开发工具(gcc gdb make shell)——c的预处理、编译、汇编和链接
- c++面向对象编程补充(一) 重载 覆盖 隐藏区别
- java注释规范
- 【树的重心】 POJ 1655 Balancing Act
- HDU 1829 A Bug's Life(基础种类并查集)
- LeetCode刷题系列(十六)Some Little Questions
- 日本国立国会图书馆书籍批量下载(一)
- java新手学习之开发教程
- Leetcode刷题系列(十七)Graph相关
- java语言编程简介
- Leetcode刷题系列(十八)CombinationSum && WordLadder