框架基础——全面解析Java注解

2022-08-04 18:22:01

为什么学习注解？

学习注解有什么好处？

学完能做什么？

答：1. 能够读懂别人写的代码，特别是框架相关的代码；

　　2. 让编程更加简洁，代码更加清晰；

　　3. 让别人高看一眼。

spring、mybatis使用了大量的注解，会用注解不是目的，会使用自定义注解才是亮点。

java注解在java1.5版本引入。

一、概念

　　Java提供了一种原程序中的元素关联任何信息和任何元数据的途径和方法。

二、Java中的常见注解

1、JDK自带注解

@Override 表示覆盖或重写父类的方法；

@Deprecated 表示该方法已经过时了。（当方法或是类上面有@Deprecated注解时，说明该方法或是类都已经过期不能再用，但不影响以前项目使用，提醒你新替代待的方法或是类。如果程序员不小心使用了它的元素,那么编译器会发出警告信息。）

@SuppressWarnings 表示忽略指定警告，比如@Suppvisewarnings("Deprecation")

比如下面的例子：

person接口：

 public interface Person {

     public String name();

     public int age();

     /*@Deprecated 表示该方法已经过时了*/

     @Deprecated

     public void sing();

     /*注：

      当方法或是类上面有@Deprecated注解时，

      说明该方法或是类都已经过期不能再用，

      但不影响以前项目使用，提醒你新替代待的方法或是类

      */

 }

child实现类：

 public class Child implements Person {

     /*@Override 表示覆盖或重写父类的方法*/

     @Override

     public String name() {

         // TODO Auto-generated method stub

         return null;

     }

     @Override

     public int age() {

         // TODO Auto-generated method stub

         return 0;

     }

     @Override

     public void sing() {

         // TODO Auto-generated method stub

     }

测试类：

 public class Test {

     /*@SuppressWarnings 表示忽略指定警告，比如@Suppvisewarnings("Deprecation")*/

     @SuppressWarnings("deprecation")

     public void sing(){

         Person p=new Child();

         p.sing();

     }

 }

2、第三方注解

具体示例如下：

Autowired将成员变量自动注入进来

三、注解的分类

按运行机制（注解存在于程序的那个阶段）将注解分为三类：源码注解(只在源码存在)、编译注解(在class文件中也存在)、运行时注解(在运行阶段仍然起作用)

按照来源来分的话，有如下三类：
1：JDK自带的注解（Java目前只内置了三种标准注解：@Override、@Deprecated、@SuppressWarnings，以及四种元注解：@Target、@Retention、@Documented、@Inherited）
2：第三方的注解——这一类注解是我们接触最多和作用最大的一类
3：自定义注解——也可以看作是我们编写的注解，其他的都是他人编写注解

按照功能来分的，还有，元注解——注解的注解。

四、自定义注解

1、自定义注解的语法要求

2、元注解

现在逐行分析：

@Target 是注解的作用域 ：表示该注解可以用于一个类中的那些属性及方法上，如果作用域类型有多个用英文逗号分隔

下面是注解的作用域的列表：

@Retention：表示该注解的生命周期

注解按声明周期有个分类：

@Inherited:此注解是标识性的元注解，表示当前注解可以由子注解来继承

@Documented:表示生成javadoc的时候会包含注解

3、使用自定义注解

示例：

注解的定义看起来很像接口的定义，事实上，与其他任何Java接口一样，注解也将会编译成class文件。

定义注解时，会需要一些元注解（meta-annotation），如@Target和@Retention。@Target用来定义你的注解将用于什么地方（例如是一个方法或一个域）。@Retention用来定义该注解在哪一个级别可用，在源代码（SOURCE）、类文件中（CLASS）或者运行时（RUNTIME）。