注解【内置、自定义】

day38中

注解

简介

什么是注解

java.annotation包 Annotation是从JDK1.5开始引入的新技术，注解即可以对程序员解释又可以对程序解释

不是程序本身，可以对程序作出解释（与注释(comment)类似）

可以被其他程序（编译器）读取

注解vs注释

注释：对程序员解释代码信息

注解：对程序和程序员解释代码信息

作用

可以作用于包、类、方法、属性上，给他们添加额外的信息

应用：可以附加在package、class、method、field等上面，相当于给他们添加了额外的辅助信息，我们可以通过反射机制实现对这些数据的访问

格式

注解是以“@注释名”在代码中存在的，还可以添加一些参数

例如：@SuppressWarnings(value=“unchecked”)

内置注解

​ 理解：Java给我们提供个注解

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

@Deprecated：定义在java.lang.Deprecated中.此注解可以用于修饰方法，属性，类。表示不鼓励使用这样的元素.通常是因为它很危险或者存在更好的选择

@SuppressWarnings：镇压警告，定义在java.lang.SuppressWarnings中用来抑制编译时的警告信息，与前两个注释有所不同.你需要添加参数才能正确使用。这些参数都是已经定义好了的.我们选择性的使用就好了 @SuppressWarnings(“all”)抑制所有类型的警告信息 @SuppressWarnings(“unchecked”)抑制单类型的警告信息 @SuppressWarnings(value={“unchecked”,“deprecation”})抑制多类型的警告信息

public class Test01 {
	
	//@Override表示该方法是重写父类的方法
	@Override
	public String toString() {
		return super.toString();
	}
	
	//@Deprecated表示该方法已过时
	@Deprecated
	public void method01(){
	}
	
	//@SuppressWarnings表示镇压警告的注解
	@SuppressWarnings("all")
	public void method02(){
		
		ArrayList list = new ArrayList();
		list.add(100);
		list.add(123.123);
		list.add("莫愁前路无知己");
	}
	//直观：镇压警告（报警告的黄线会去除）
}

元注解

元注解的作用：负责注解其他注解，Java定义了4个标准的meta-annotation类型，他们被用来提供对其他annotation类型作说明

这些类型和它们所支持的类在java.lang.annotation包中可以找到

（@Target，@Retention，@Documented，@Inherited )

@Target：用于描述注解的使用范围(即:被描述的注解可以用在什么地方）

**@**Retention：表示需要要在什么级别保存该注择信息，用于描述注解的生命周期

(SOURCE 【 源文件 】< CLASS 【 class文件】< RUNTIME【 运行时也存在 】)

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

@lnherited：说明子类可以继承父类中的该注解

自定义注解

使用@interface自定义注解时，自动继承了java.lang.annotation.Annotation接口

分析：

@interface用来声明一个注解，格式：public @interface注解名{定义内容}

其中的每一个方法实际上是声明了一个配置参数.

方法的名称就是参数的名称.

返回值类型就是参数的类型（返回值只能是基本类型、Class、String、enum）

可以通过default来声明参数的默认值

如果只有一个参数成员，一般参数名为value()

注解元素必須要有值，我们定义注解元素时，经常使用空字符串.0作为默认值

注解的使用范围

注解用annotation类【new一个Annotation编写MyAnnotaction】

补充：

注解里的参数，参数名必须加上小阔号
泛型上好像作用在类后面，不能作用在方法上
自定义范围的定义语句省略【简化编写】

/**
 * 注解的使用范围
 * ElementType.TYPE 类上
 * ElementType.FIELD 属性上
 * ElementType.METHOD 方法上
 * ElementType.PARAMETER 参数上
 * ElementType.LOCAL_VARIABLE 局部变量上
 * ElementType.TYPE_PARAMETER 泛型上
 */
//@Target(value={ElementType.TYPE,ElementType.FIELD,ElementType.METHOD,ElementType.PARAMETER,ElementType.LOCAL_VARIABLE,ElementType.TYPE_PARAMETER})
//@Target({ElementType.TYPE,ElementType.FIELD,ElementType.METHOD,ElementType.PARAMETER,ElementType.LOCAL_VARIABLE,ElementType.TYPE_PARAMETER})
@Target({TYPE,FIELD,METHOD,PARAMETER,LOCAL_VARIABLE,TYPE_PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotaction {
}

@MyAnnotaction
public class Test01<@MyAnnotaction T> {
	
	public static void main(String[] args) {
		
	}
	
	@MyAnnotaction
	String attr;

	@MyAnnotaction
	public static void method(@MyAnnotaction String str){
		
		@MyAnnotaction
		int i = 100;
		System.out.println(i);
	}
}

参数

只有value情况才可在注解时省略value，其他类型必须写上
默认值时可不写@MyAnnotaction()的括号及里面的参数内容

一个参数

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotaction {
	
	String value();
	
}

public class Test01 {
	
	@MyAnnotaction(value="aaa")
	public void method01(){
	}
	
	@MyAnnotaction("bbb")
	public void method02(){
	}
}

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotaction {
	
	String[] value() default "xyz";
	
}

public class Test01 {
	
	@MyAnnotaction("aaa")
	public void method01(){
	}
	
	@MyAnnotaction(value="bbb")
	public void method02(){
	}
	
	@MyAnnotaction(value={"aaa","bbb"})
	public void method03(){
	}
	
	@MyAnnotaction()
	public void method04(){
	}
	
	@MyAnnotaction
	public void method05(){
	}
}

多个参数

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotaction {
	
	String str1();
	String str2();
	String[] value() default {"xxx","yyy"};
	
}

public class Test01 {
	
	@MyAnnotaction(str1="aaa",str2="bbb",value="ccc")
	public void method01(){
	}
	
	@MyAnnotaction(str1="aaa",str2="bbb",value={"xxx","yyy","zzz"})
	public void method02(){
	}
	
	@MyAnnotaction(str1="aaa",str2="bbb")
	public void method03(){
	}
}

反射获取注解信息及实际运用

反射内容

总结

2.注解
概念
内置注解
元注解
自定义注解（注意参数）