注解
Java注解提供了关于代码的一些信息,但并不直接作用于它所注解的代码内容.
注解的一些特征
Java1.5引入了注解,当前许多java框架中大量使用注解,如Hibernate、Jersey、Spring
1.注解作为程序的元数据嵌入到程序当中 (注解需要定义) 2.注解可以被一些解析工具或者是编译工具进行解析 (注解需要看得懂,也就是要别工具识别) 3. 我们可以声明注解在编译过程或执行时产生作用。(直接有执行时机)
注解和注释
在使用注解之前,程序源数据只是通过java注释和javadoc,但是注解提供的功能要远远超过这些。
注解不仅包含了元数据,它还可以作用于程序运行过程中、注解解释器可以通过注解决定程序的执行顺序。
注释给程序员看,注解给注解解释器看。注解可以但注释使用,但注释不可当注解使用
4个元注解 (注解的注解)
(一、)@Target({})
说明注解的定义域,用在什么地方
ElementType.CONSTRUCTOR 构造方法方法
ElementType.FIELD 字段声明(属性声明上)
ElementType.METHOD 成员方法上
ElementType.LOCAL_VARIABLE 局部变量声明
ElementType.ACKAGE 包声明
ElementType.PARAMETER 参数声明,
ElementType.TYPE 类接口
常用写法:
@Target({ElementType.CONSTRUCTOR,ElementType.FIELD,ElementType.METHOD})
(二、)@Retention()
注解的生命周期
RetentionPolicy.SOURCE 只在源码显示,编译时会丢弃,
RetentionPolicy.CLASS 编译时会记录到class中,运行时忽略,
RetentionPolicy.RUNTIME 运行时存在,可以通过反射读取
@Retention(RetentionPolicy.RUNTIME)
(三、)@Inherited
Inherited 允许子类继承
标示注解
注解类可以没有成员,没有成员的注解成为标识注解
(四、) @Documented
生成javadoc的时候包含注解
标识注解
自定义注解
接口的定义
public interface Person {
public String name(String userName);
public Object jump();
}
关键字interface
只有方法名没有方法体,
方法可以有参数
方法的返回值可以是复合类型
方法有修饰符]
注解的定义
package com.test;
import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Inherited;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@Inherited
@Documented
public @interface Boy {
//public String name(String name);
//注解的方法不可带参数
//注解的方法叫做成员
public String name();
//public Object jump();
//注解方法返回值类型限定为:基本类型、String、Enums、Annotation或者是这些类型的数组;
public int jump();
//注解方法可以有默认值;
public int age() default 18;
}
关键词:@interface
注解方法不能带有参数;
注解方法返回值类型限定为:基本类型、String、Enums、Annotation或者是这些类型的数组;
注解方法可以有默认值;方法的返回值
注解本身能够包含元注解,元注解被用来注解其它注解
如果注解只有一个成员(方法),则成员(方法)名必须取名为value(),在使用时可以忽略成员名和赋值号(=)
反射来解析注解(读懂注解的意思)
我们将使用反射技术来解析java类的注解。那么注解的RetentionPolicy应该设置为RUNTIME否则java类的注解信息在执行过程中将不可用,那么我们也不能从中得到任何和注解有关的数据。 请看下一章 注解的解析