Java 注解(Annotation)的机制与使用
2021/7/21 1:35:48
本文主要是介绍Java 注解(Annotation)的机制与使用,对大家解决编程问题具有一定的参考价值,需要的程序猿们随着小编来一起学习吧!
一、什么是注解
了解什么是注解? Annotation
-
Annotation是从JDK5.0 开始引入的技术
-
注解的作用:
- 可以对程序做出解释 (类似于平时写的注释)
- 可以被其他程序读取(如:编译器等)
-
注解的格式:
-
以 @[注释名] 的形式在代码中存在,并且还可以添加一些参数
e.g. @SuppressWarnings(value = "unchecked")
-
-
注解 可以用在哪?
- 附加在 package、class 、method、field等上面,相当于给他们添加了额外的辅助信息
- 可以通过反射机制编程实现对元数据的访问
package annotation; // 什么是注解 public class Demo01 extends Object{ public static void main(String[] args) { } // 重写的注解 @Override public String toString() { return super.toString(); } }
内置注解
1、 @Override : 定义在java.lang. 包下,此注释只适用于修饰方法,表示一个方法声明打算重写超类/父类中的另一个方法声明
2、@Deprecated : 定义在java.lang.Deprecated中,可以用于修饰方法、属性、类,表示不鼓励程序员使用这样的元素,通常是因为它很危险(过时)或者存在更好地选择。
3、@SuppressWarnings : 定义在java.lang.SuppressWrnings中, 也叫正压警告,用来抑制编译时的警告信息。
- 与前两个注释有所不同,这里需要添加一个参数才能正确使用
- @SuppressWarnings("all")
- @SuppressWarnings("unchecked")
- @SuppressWarnings(value={"unchecked", "deprecation"})
- .....
package annotation; import java.util.ArrayList; import java.util.List; public class Demo02 { public static void main(String[] args) { test(); } @Deprecated // 不推荐程序员使用 public static void test() { System.out.println("Deprecated!"); } @SuppressWarnings("all") public void test02() { List list = new ArrayList<>(); } }
元注解 meta-annotation
-
元注解的作用
-
负责注解其他注解
Java定义了4个标准的meta-annotation类型,他们被用来提供对其他annotaiton类型作说明
-
-
这些类型和他们所支持的类放在 java.lang.annotation包中
- @Target :用于描述注解的使用范围(即:被描述的注解可以用在哪?)
- @Retention : 表示需要在什么级别保存该注释信息,用于描述注解的生命周期
- Source < Class < Runtime
- @Documented : 说明该注解将被包含在 javadoc中
- @Inherited : 说明子类可以继承父类中的该注解
package annotation; import java.lang.annotation.*; /* 元注解 */ @MyAnnotation //not applitable to class public class Demo03 { @MyAnnotation public void test() { } } //定义一个注解类 // Target表示我们的注解可以用在哪些地方 @Target(value ={ElementType.METHOD,ElementType.TYPE} ) // Retention 表示注解在什么地方还有效 @Retention(value = RetentionPolicy.RUNTIME) @Documented // 表示是否将为注解生成在 Javadoc中 @Inherited // 子类可以继承父类的注解 @interface MyAnnotation { }
自定义注解
1、使用 @interface 自定义注解时,自动继承了java.lang.annotation.Annotation接口
2、细节
-
@interface 用来声明一个注解
具体格式: public @interface 注解名 { }
-
其中的每一个方法实际上是声明了一个配置参数
-
方法的名称就是参数的名称
-
返回值类型就是参数的类型 (基本数据类型,Class,String,enum)
-
可以通过default来声明参数的默认值
-
如果只有一个参数成员,一般参数名为value
-
注解元素必须要有值 定义注解元素时,经常使用空字符串,0作为默认值
package annotation; // 自定义注解 import java.lang.annotation.ElementType; import java.lang.annotation.Retention; import java.lang.annotation.RetentionPolicy; import java.lang.annotation.Target; public class Demo04 { // 注解可以显示赋值,若没有默认值,就必须给注解赋值,否则将报错 @MyAnnotation01(name = "lzh") public void test() { } @MyAnnotation02("lzh") public void test2() { } } @Target(value = {ElementType.TYPE, ElementType.METHOD}) @Retention(RetentionPolicy.RUNTIME) @interface MyAnnotation01 { // 注解的参数 : 参数类型 + 参数名(); String name() default ""; int age() default 0; int id() default -1; // 如果默认值为-1,代表不存在 String[] schools() default {"清华大学"}; } @Target(value = {ElementType.TYPE, ElementType.METHOD}) @Retention(RetentionPolicy.RUNTIME) @interface MyAnnotation02{ String value(); // 只有一个参数 默认为value }
这篇关于Java 注解(Annotation)的机制与使用的文章就介绍到这儿,希望我们推荐的文章对大家有所帮助,也希望大家多多支持为之网!
- 2024-11-16Maven资料入门指南
- 2024-11-16Maven资料入门教程
- 2024-11-16MyBatis Plus资料:新手入门教程与实践指南
- 2024-11-16MyBatis-Plus资料入门教程:快速上手指南
- 2024-11-16Mybatis资料入门教程:新手必看指南
- 2024-11-16MyBatis资料详解:新手入门与初级实战指南
- 2024-11-16MyBatisPlus资料:初学者入门指南与实用教程
- 2024-11-16MybatisPlus资料详解:初学者入门指南
- 2024-11-16MyBatisX资料:新手入门与初级教程
- 2024-11-16RESTful接口资料详解:新手入门指南