注释有3中基本类型
a.标记注释 --没有变量,只有名称标识。例如 @annotation
b.单一值注释 --在标记注释的基础上提供一段数据。如 @annotation(“data”)
c.完整注释 --可以包括多个数据成员,每个数据成员由名称和值构成。
@annotation(val1="data1",val2="data2")
2.Java的“注释”
Java中提供3个内置注释类型
a. Override ,只能用于方法(不能用于类,包声明或者其他构造)
作用:可以保证编译时候Override函数的声明正确性
用法:@Override
public 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将在运行时也保留注释,因此可以通过反射机制读取注释的信息。
@Documented 将注释包含在JavaDoc中
@Inheried 允许子类继承父类中的注释。
3. 在Java中定义自己的注释
Java语言支持一种新的类型--注释类型(annotation type),跟普通类差不多,在类中以符号( @ )的形式注释其他 Java 代码
下面将通过一个简单的例子来实现(代码是Brett McLaughlin 的)
@interface 申明
i.简单的注释类型
package com.oreilly.tiger.ch06;
/**
* Marker annotation to indicate that a method or class
* is still in progress.
*/
public @interface InProgress { }
ii.使用定制的注释类型
@com.oreilly.tiger.ch06.InProgress
public void calculateInterest(float amout,float rate)
{
//Need to finish this method later
}
iii.添加成员
package com.oreilly.tiger.ch06;
/**
* Marker annotation to indicate that a method or class
* is still in progress.
*/
public @interface InProgress {
String value();
}
@com.oreilly.tiger.ch06.InProgress
@TODO("Figure out the amount of interest per month")
//或者@TODO(value="Figure out the amount of interest per month")
public void calculateInterest(float amount,float rate)
{
}
iv.设置默认值
package com.oreilly.tiger.ch06;
public @interface GroupTODO {
public enum Serverity { CRITICAL,IMPORTANT,IRIVIAL,DOCMENTATION };
Severity severity()
default Severity.IMPORTANT;
String item ();
String assignedTo();
String dateAssigned();
}
}
v.使用默认值
@com.oreilly.tiger.ch06.InProgress
@GroupTODO(
item="Figure out the amount of interest per month",
assignedTo = "Brett McLaughlin",
dateAssigned = "08/04/2004"
)
public void calculateInterest(float amount, float rate)
{
//Need to finish this method later
}
vi.改写默认值
@com.oreilly.tiger.ch06.InProgress
@GroupTODO
{
severity = GroupTODO.Severity.DOCUMENTATION,
item = "Need to explain how this rather unusal method works",
assignedTo = "Jon Stevens",
dateAssigned = "07/30/2004"
}
转至:http://javaopen.iteye.com/blog/645915
分享到:
相关推荐
这是一个java注解的详解demo,详细对你很有用
Java 注解技术详解
java注解代码java注解代码java注解代码java注解代码java注解代码java注解代码java注解代码java注解代码java注解代码java注解代码java注解代码java注解代码java注解代码java注解代码java注解代码java注解代码java注解...
java注解详解[文].pdf
java程序使用JPA注解详解 JPA注解详解 java 程序使用 JPA注解 详解
NULL 博文链接:https://mzl-2011.iteye.com/blog/1066783
java程序使用JPA注解详解.zip java程序使用JPA注解详解.zip java程序使用JPA注解详解.zip java程序使用JPA注解详解.zip java程序使用JPA注解详解.zip
java注解详解,十分有用。
自己学习扫雷程序时,对代码做了一定的注释,对扫雷程序进行了代码注释,适合初学者。
Eclipse Java注释模板设置详解
Java注解特性详解[汇编].pdf
根据张孝祥视频内容,进行了个人的理解以及注释,分析,同时将自己写的测试用的主要代码和理解写在了文档中。由于第一课和第二课是没什么技术的部分,只是简单的概括,所以,笔记丛第三课开始,不要误认为这个是不...
java程序使用JPA注解详解.doc
Java开发自定义注解详解.doc
spring3 注解 详解spring3 注解 详解spring3 注解 详解
NULL 博文链接:https://wangming2012.iteye.com/blog/1941123
Java元注解是Java注解的重要特性,下面我就来详解常见的4大Java元注解
java 自定义注解验证 可自己添加所需要的注解,本案例中只写了三个自定义注解类 本案例只花了半天时间,如有不好之处请多提提意见。谢谢!
有关于java的注释规范的详细描述,单行注释、多行注释、分块注释等这些java的三种注释方式
Java代码注释率检查器