这一段时间在看Java源码以及别人的一些代码时总会看到一些用 @ 修饰的东西。以前最熟悉的就是@override重写,但当我看到这个
真的可以说是被“震惊”了,所以打算来学习一下Java的文档注释。
Java 支持三种注释方式。前两种分别是 // 和 ,第三种被称作说明注释,它以 **结束,前两种都是都是非常熟悉的了,最有意思的是第三种说明注释。
Java标签这里只列举几个常见的Java标签
| 标签 | 描述 | 示例 |
|---|---|---|
| @author | 标识一个类的作者 | @author description |
| @return | 说明返回值类型 | @return exp |
| @param | 说明一个方法的参数 | @param parameter-name exp |
| @exception | 标志一个类抛出的异常 | @exception exception-name exp |
| @throws | 和 @exception标签一样 | 同上 |
| @serial | 说明一个序列化属性 | @serial description |
在开始的
public interface OrderInterface {
List 利用
JavaDoc给的注释确实实用,但我们每次用起来还是会特别的麻烦,其实我们可以自定义成模板在 IDE 上,这样每次通过快捷键就可自动帮你输出在方法中,省去了很多时间,也使代码更加规范。 如何自定义模板?可以参考这几篇博客:



