java学习方法注释_java的注解学习

学习路线: 1. 什么是注解  2. 内置注解 3.元注解 4.自定义注解

1.什么是注解(Annotation):

Annotation的作用: 不是程序本身,但可以对程序作出解释,(这一点和注释(comment)没什么区别).

可以被其他程序(比如:编译器等)读取.--->配合反射使用.

Annotation的格式: 注解以"@注解名"在代码中存在,还可以添加一些参数值,如:@SuppressWarnings(value="unchecked").

Annotation在哪里使用? 可以附加在package,class,method,field等上面,相当于给他们添加额外的辅助信息,我们可以通过反射机制编程实现对这些元数据的访问.

2.内置注解

@Override: 定义在 java.lang.Override中,此注解只适用于修辞方式,表示一个方法声明打算重写超类的另一个方法.

@Deprecated:定义在java.lang.Deprecated中,此注解用于修辞方法,属性,类,表示不鼓励程序员使用,通常因为有危险或更好的选择.

@SuppressWarnings:定义在lava.lang.SuppressWarnings中,用来抑制表意识的警告信息. (需要带参数)

@SuppressWarnings("all") , @SuppressWarnings("unchecked") , @SuppressWarnings(value={"unchecked","deprecation"})

3.元注解

元注解的作用是负责解释其他注解,java定义了4个标准的meta-annotation类型,他们被用来提供对其他annotation类型的说明.

这些类型和他们所支持的类在java.lang.annotation包中可以找到(@Target , @Retention , @ Documented , @ Inherited)

@Target : 用于描述注解的使用范围(被标书的注解可以在什么地方使用, 类,方法 ,或字段上)

@Retention: 表示需要在什么级别保存该注释信息,用于描述注解的生命周期.(SOURCE

@Document: 说明该注解将被包含在javadoc中

@Inherited: 说明子类可以继承父类中的该注解

4.自定义注解

//注解参数 赋值 没有顺序 (只有一个参数建议用value命令参数变量)

packagecom.cc8w.test;importjava.lang.annotation.Documented;importjava.lang.annotation.ElementType;importjava.lang.annotation.Inherited;importjava.lang.annotation.Retention;importjava.lang.annotation.RetentionPolicy;importjava.lang.annotation.Target;//@Target表示注解在什么地方使用(下面例子限制在 类和方法上)

@Target(value={ElementType.METHOD,ElementType.TYPE})//@Retention 表示我们的注解在什么地方有效 (runtime>class>source)

@Retention(value =RetentionPolicy.RUNTIME)//@Documented 表示是否将注解上传到javadoc 文档中

@Documented//@Inherited 子类可以继承父类的注解

@Inheritedpublic @interfaceMyannnotation {//注解的参数: 参数类型 + 参数名();

String value() default ""; //有默认值

int age (); //没有默认值

int id() default -1;//如果默认值-1表示不存在

String [] school();//数组

}