【Java】使用注解的方法
编程学习日记
2020年11月23日,我在查阅Javadoc时了解到了关于注解的知识,现在来总结一下。
「アノテーション」とは什么意思?
标注是英语中表示注释、备注等意思的词,也是编程术语,指向代码中添加注意事项的功能并在空白处添加文字的功能。如果理解标注,Java代码将更加易于阅读。
标注分为三种类型,根据数据的有无和数量而不同。
-
- 名前だけでデータのないマーカー(@Override、@Deprecatedなど)
-
- データ1つ持つ単位アノテーション(@SuppressWarningsなど)
- 複数のデータを持つフルアノテーション
广泛采用的标注
@Override 在中国本土化
覆盖了父类的方法表示该方法是一个描述方法。如果有一个父类中没有的方法,则会产生错误,可以消除描述的错误。
已废弃
表明描述方法的规范已被不推荐使用。可用于在Java新版本中保留旧的描述时。
@抑制警告
通过在参数中指定消息,可以将通过描述方法发出的警告隐藏起来。
其他注释
除了上面介绍的三种标注方式外,还有一种称为元标注的自定义标注方式。
@目标
为了声明独自定义的注释所针对的对象,决定是应该在类或方法上附加还是在变量上附加。
@保留
这是用来决定在编译时或程序运行时是否保留注解信息的。
@作者
写下作者的名字。
@param
記述引數和引數說明
@return(返回)
写下返回值的解释
@例外
写出方法抛出的异常类及其说明。
@版本
在代码中描述类、方法等的版本信息
请参阅
写出引用的关联类和方法等的目标。
文献参考
【Java入門】解析和创建”Javadoc”和”注解”的基础知识(1/4)
Java中的”注解”是什么?介绍其用法和创建方法