「java注释和注解」JAVA中的注释
本篇文章给大家谈谈java注释和注解,以及JAVA中的注释对应的知识点,希望对各位有所帮助,不要忘了收藏本站喔。
本文目录一览:
java中常用注解分别是什么及汉语意思!
Annotation(注解)是JDK5.0及以后版本引入的。它可以用于创建文档,跟踪代码中的依赖性,甚至执行基本编译时检查。注释是以‘@注释名’在代码中存在的,根据注释参数的个数,我们可以将注释分为:标记注释、单值注释、完整注释三类。它们都不会直接影响到程序的语义,只是作为注释(标识)存在,我们可以通过反射机制编程实现对这些元数据的访问。另外,你可以在编译时选择代码里的注释是否只存在于源代码级,或者它也能在class文件中出现。
元数据的作用
如果要对于元数据的作用进行分类,目前还没有明确的定义,不过我们可以根据它所起的作用,大致可分为三类:
编写文档:通过代码里标识的元数据生成文档。
代码分析:通过代码里标识的元数据对代码进行分析。
编译检查:通过代码里标识的元数据让编译器能实现基本的编译检查。
基本内置注解
@Override java中覆写
@Deprecated的作用是对不应该在使用的方法添加注释,当编程人员使用这些方法时,将会在编译时显示提示信息,它与javadoc里的
@deprecated标记有相同的功能,准确的说,它还不如javadoc
@deprecated,因为它不支持参数
@SuppressWarnings,其参数有:
deprecation,使用了过时的类或方法时的警告
unchecked,执行了未检查的转换时的警告
fallthrough,当 Switch 程序块直接通往下一种情况而没有 Break 时的警告
path,在类路径、源文件路径等中有不存在的路径时的警告
serial,当在可序列化的类上缺少 serialVersionUID 定义时的警告
finally ,任何 finally 子句不能正常完成时的警告
all,关于以上所有情况的警告
自定义注释
它类似于新创建一个接口类文件,但为了区分,我们需要将它声明为@interface,如:public @interface NewAnnotation {}............
java里的注解都有哪些?都有什么用处啊?
注释有 3 中基本类型a. 标记注释 -- 没有变量,只有名称标识。例如 @annotationb. 单一值注释 -- 在标记注释的基础上提供一段数据。如 @annotation(“data”)c. 完整注释 -- 可以包括多个数据成员,每个数据成员由名称和值构成。@annotation(val1="data1",val2="data2")Java 中提供 3 个内置注释类型a. Override ,只能用于方法 ( 不能用于类,包声明或者其他构造 )作用:可以保证编译时候 Override 函数的声明正确性用法: @Overridepublic void fun(){..}b.Deprecated 同样只能作用与方法作用:对不应再使用的方法进行注解用法: @Deprecated public void fun{...} // 它们说这个注释跟函数要同一行c.SupressWarnings 可以注释一段代码作用:关闭特定的警告信息,例如你在使用泛型的时候未指定类型用法: @SupressWarnings(value={"unchecked"}).. 代码Java 中还提供了四种元注释,专门负责注释其他的注释@Target 表示该注释可以用于什么地方。可用的 ElementType 参数包括:CONSTRUCTOR : 构造器的声明FIELD : 域声明 ( 包括 enum 实例 )LOCAL_VARIABLE : 局部变量声明METHOD : 方法声明PACKAGE : 包声明PARAMETER : 参数声明TYPE : 类、接口 ( 包括注解类型 ) 或 enum 声明@Retention 表示需要在什么级别保存该注释信息。可选的 RetentionPoicy 参数包括:SOURCE : 注释将被编译器丢掉CLASS : 注释在 class 文件中可用,但会被 VM 丢弃RUNTIME : VM 将在运行时也保留注释,因此可以通过反射机制读取注释的信息。
java 文档注释是注释什么的,不是有多行注释了吗?
1、【文档注释】是写在类或者方法的上面的。
文档注释可以用eclipse导出chm格式的帮助文档,拿给其他人用时,方便他人理解。文档注释被调用的方法,当鼠标移到上面时提醒注释内容。
使用文档注释时,需要在开始的 /** 之后,第一行或几行是关于类、变量和方法的主要描述。
之后,可以包含一个或多个何种各样的@ 标签。每一个@标签必须在一个新行的开始或者在一行的开始紧跟星号(*)。多个相同类型的标签应该放成一组。
2、【多行注释】注释的也是方法或类,言下之意就是一次性的将程序中的多行代码注释掉,但多行注释的内容不能用于生成一个开发者文档。
3、【多行注释与文档注释的区别】多行注释的内容不能用于生成一个开发者文档,而文档注释的内容可以生产一个开发者文档。
扩展资料
java常用的文档注释标签
1、@author:标识一个类的作者
实例: @authordescription
2、@deprecated:指名一个过期的类或成员
实例: @deprecateddescription
3、@exception:标志一个类抛出的异常
实例:@exceptionexception-nameexplanation
4、{@inheritDoc}:从直接父类继承的注释
实例:Inheritsacommentfromtheimmediatesurperclass.
5、{@link}:插入一个到另一个主题的链接
实例:{@linknametext}
6、{@linkplain}:插入一个到另一个主题的链接,但是该链接显示纯文本字体
实例:Insertsanin-linelinktoanothertopic.
7、@param:说明一个方法的参数
实例:@paramparameter-nameexplanation
8、@return:说明返回值类型
实例:@returnexplanation
9、@see:指定一个到另一个主题的链接
实例:@seeanchor
10、@serial:说明一个序列化属性
实例:@serialdescription
参考资料:百度百科-java注释
关于java注释和注解和JAVA中的注释的介绍到此就结束了,不知道你从中找到你需要的信息了吗 ?如果你还想了解更多这方面的信息,记得收藏关注本站。