注解(Annotation)学习笔记
注解的基本概念
Annotation的作用?
注解不是程序本身,可以对程序作出解释,可以被其他程序读取
Annotation的格式
注解是以“@注释名”在代码中存在的,还可以添加一些参数值
例如:
@SuppressWarnings(value = "unchecked")
Annotation在哪里使用
注解可以附加在package,class,method,field等上面,相当于给他们添加了额外的辅助信息,我们可以通过反射机制编程实现对这些元数据的访问。
内置注解
@Override
@Overrride定义在java.lang.Override中,此注解只适用于修饰方法,表示一个方法声明打算重写超类中的另一个方法声明。
@Deprecated
@Deprecated定义在java.lang.Deprecated中,此注解可以用于修饰方法,属性,类,表示不不鼓励程序员使用这样的元素,通常是因为它很危险或者存在更好的选择。
@SuppressWarnings
@SuppressWarnings定义在java.lang.SuppressWarnings中,用来抑制编程时的警告信息。(与前边的两个注解有所不同的是,你需要添加一个参数才能正确使用)
元注解
元注解的作用就是负责注解其他注解,Java定义了4个标准的meta-annotation类型,他们被用来提供对其他annotation类型做说明。
@Target 用于描述注解的使用范围
@Retention 表示需要在什么级别保存该注解信息,用于描述注解的生命周期
@Docunented 说明该注解将被包含在javadoc中
@Inherited 说明子类可以继承父类中的该注解
自定义注解
使用 @interface自定义注解时,自动继承了 java.lang.annotation.Annotation 接口
分析:
- @interface 用来声明一个注解,格式:public @interface 注解名 { 定义内容 }
- 其中的每一个方法实际上是生命里一个配置参数
- 方法的名称就是参数的名称
- 返回值类型就是参数的类型(基本类型,Class,String,enum)
- 可以通过default来声明参数的默认值
- 如果只有一个参数成员,一般参数名为 value
- 注解元素必须要有值,我们定义注解元素时,经常使用空字符串,0作为默认值
代码
package com.ztece.PlusDemo;
import java.lang.annotation.*;
public class AnnotationDemo {
//注解可以显式赋值,如果没有赋值,我们就必须给注解赋值
@MyAnnotation1(name = "我的注解",school = {"青岛大学"})//有默认值的就不需要再赋值
public void test(){}
public static void main(String[] args) {
}
@MyAnnotation2("因为自定义的注解中,只有一个参数,且这个唯一的参数以value命名,所以可以不适用参数的名字,直接赋值")
public void test2(){}
}
@Target({ElementType.TYPE,ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@interface MyAnnotation1{
//注意下边的不是方法,而是注解的参数
//注解的参数: 参数类型 + 参数名();
String name();
int id() default 12138;//默认参数
int age() default -1;//如果默认值是-1,代表不存在
String[] school();
}
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
//注意只有一个参数的情况
@interface MyAnnotation2{
//只用一个参数,可以设为value
String value();
}
上一篇: 显示图例(legend)
下一篇: 学习Java注解Annotation