Java注解

注解

一、概念

在Java中，注解是一种元数据（metadata）形式，提供了对程序代码进行标记和说明的方式。注解可以用于类、方法、字段等元素上，用来提供额外的信息给编译器、解释器或其他工具。

理解：

注解即可以对程序员解释又可以对程序解释

二、注解与注释的区别

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

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

三、作用

1. 提供信息给编译器：可以用注解向编译器提供信息，帮助编译器进行编译检查，优化代码生成等。
2. 编译时处理：可以在编译时通过注解处理器（Annotation Processor）来处理注解，生成额外的代码、配置文件等。
3. 运行时处理：可以通过反射机制在运行时获取注解信息，实现一些特定功能，如配置加载、AOP等。
4. 代码分析：可以通过注解进行代码分析，实现静态代码检查、代码生成等功能。
5. 替代配置文件：可以使用注解替代繁琐的配置文件，简化配置管理。
6. 框架支持：许多框架（如Spring、Hibernate）使用注解来简化配置和提供额外的功能。
7. 文档生成：可以通过注解生成文档，如Javadoc。
8. 测试框架：测试框架（如JUnit）使用注解来标记测试方法、设置测试环境等。
9. 依赖注入：通过注解实现依赖注入，如Spring框架中的@Autowired注解。
10. 标记过时元素：使用@Deprecated注解标记已过时的方法或类，提醒开发者不要再使用。

总的来说，注解在Java中具有广泛的应用，可以帮助开发者简化代码、提高代码可读性和可维护性，同时也为各种框架和工具提供了扩展和定制的能力 。

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

四、注解的格式

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

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

五、内置注解

理解：Java给我们提供的注解

常用的内置注解：

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

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

@SuppressWarnings：镇压警告，定义在java.lang.SuppressWarnings中用来抑制编译时的警告信息，与前两个注释有所不同.你需要添加参数才能正确使用。这些参数都是已经定义好了的.我们选择性的使用就好了

@SuppressWarnings(“all”)：抑制所有类型的警告信息

@SuppressWarnings(“unchecked”)：抑制单类型的警告信息

@SuppressWarnings(value={“unchecked”,“deprecation”})：抑制多类型的警告信息

示例代码：

import java.util.ArrayList;

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 < RUNTIME)

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

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

七、自定义注解

概念： 在Java中，开发者可以通过@interface关键字来定义自己的注解，从而为代码添加自定义的元数据信息。自定义注解可以用来标记类、方法、字段等，为程序提供额外的信息和指导。

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

分析：

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

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

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

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

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

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

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

示例代码：

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

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(){
	}
}

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