黑马程序员技术交流社区

标题: java中自定义注释听了不懂有什么用 [打印本页]

作者: 沈样 时间: 2012-3-12 10:32
标题: java中自定义注释听了不懂有什么用
java中自定义注释听了不懂有什么用,不知道用在那个场合,有点迷惑?

该贴已经同步到沈样的微博

作者: 泮和顺 时间: 2012-3-12 10:54
本帖最后由泮和顺于 2012-3-12 10:55 编辑

/**
*@文档说明而已
*
*/
JAVA还自带Javadoc工具吧文档说明可以做成html..真是厉害

作者: 沈样 时间: 2012-3-12 16:00
我是想说自定义的注解有什么用,不是系统自还的那些注解

作者: 刘豪杰 时间: 2012-3-12 16:25
只是为了方便阅读，你注释出来之后，基本上每一块是什么作用都写的很清楚了，即使以后你或者别人看你的代码，也能很快知道你写的这些代码是什么作用，如果不写，那么阅读起来就会很麻烦，甚至到时候连你自己都不知道那些代码是做什么的

//
这个是单行注释，如果你注释的内容比较短，一行可以搞定，直接用这个就行

/*

*/

这个是多行注释，如果注释内容较多，一行搞不定，可以用这个,注释内容写在/*和*/中间

/**

*/

这个一般用于文档注释，比如你写了一个小系统，可以在里边写上作者名（你的名字），所用的语言什么等跟这个小系统相关的一些内容

作者: 李成航 时间: 2012-3-12 16:49
以后大多javaweb开发，像ssh都是基于注解的，所以很重要。

作者: 沈样 时间: 2012-3-13 22:32
现在看高级部分看得有点晕晕的继续多看几遍

作者: 彭沛东 时间: 2012-3-14 00:07
貌似我也不懂到底拿着干什么。

作者: 冯建鹏 时间: 2012-3-14 00:32
自定义注释：
注释若干行，并写入javadoc文档。每个文档注释都会被置于注释定界符
之中，注释文档将用来生成HTML格式的代码报告，所以注释文
档必须书写在类、域、构造函数、方法，以及字段(field)定义之前。注释文档由两部分组成——描述、块标记。
●javadoc注释标签语法
@author 对类的说明标明开发该类模块的作者
@version 对类的说明标明该类模块的版本
@see 对类、属性、方法的说明参考转向，也就是相关主题
@param 对方法的说明对方法中某参数的说明
@return 对方法的说明对方法返回值的说明
@exception 对方法的说明对方法可能抛出的异常进行说明
JAVA注释具体实现：
1、源文件注释
2、类（模块）注释：
2、接口注释：
3、构造函数注释：
4、函数注释：
5、方法注释：
6、方法内部注释：
7、全局变量注释：
8、局部（中间）变量注释：
9、实参/参数注释：
10、字段/属性注释：字段描述，属性说明。
11、常量：常量通常具有一定的实际意义，要定义相应说明。
http://blog.sina.com.cn/s/blog_7540bf5f0100t3mv.html这个网址里面写的挺详细

其实自定义注释的好处就是方便以后开发人员阅读代码，更好更快的理解每块代码的作用。

作者: 四海为家 时间: 2012-3-14 01:07
本帖最后由四海为家于 2012-3-14 01:08 编辑

注释：分为三类，
      //单行注释，
      /* .....*/多行注释，注意多行注释不能够嵌套多行注释
      /** ..../文档注释：这是java特有的。如今流行的API文档，就是得益于此。
自定义注释：注解说明程序中的文字（可以进行程序的调式），是对代码的一种说明，提高了代码的阅读性，对开发有实际的意义。对于java初学者来说，注释是值得重视的，要写好代码，就必须要会写注释，因为它提供了我们写代码的思路和步骤。有利于我们的java能力的提高，可以说，注释不分场合，在代码中随时可写，可用，力求提高代码可读性。

欢迎光临黑马程序员技术交流社区 (http://bbs.itheima.com/)

黑马程序员IT技术论坛 X3.2