码迷,mamicode.com
首页 > 编程语言 > 详细

Java注释详解

时间:2015-08-20 13:21:37      阅读:164      评论:0      收藏:0      [点我收藏+]

标签:java   注释   

在编写程序时,经常需要添加一些注释,用以描述某段代码的作用。

一般来说,对于一份规范的程序源代码而言,注释应该占到源代码的 1/3 以上。因此,注释是程序源代码的重要组成部分,一定要加以重视哦!

Java 中注释有三种类型:单行注释、多行注释、文档注释

技术分享

我们可以通过 javadoc 命令从文档注释中提取内容,生成程序的 API 帮助文档。

技术分享

打开首页,查看下生成的 API 文档

技术分享

PS:使用文档注释时还可以使用 javadoc 标记,生成更详细的文档信息:

       @author 标明开发该类模块的作者

       @version 标明该类模块的版本

       @see 参考转向,也就是相关主题

       @param 对方法中某参数的说明

       @return 对方法返回值的说明

       @exception 对方法可能抛出的异常进行说明


版权声明:本文为博主原创文章,未经博主允许不得转载。

Java注释详解

标签:java   注释   

原文地址:http://blog.csdn.net/qq_20480611/article/details/47804071

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!