[Java-基础] 注解

引言

在进行Spring Boot 入门的时候,主程序需要@SpringBootApplication 来标注一个主程序类,说明这是一个Spring Boot应用。这个的作用是什么?去掉的话会报错。如果单写这个不引入头文件也会报错,这说明这个东西是有意义的,会被编译器识别。当点进去,发现它又包括了很多个注解。

本着负责任的态度,来探究一下注解是什么。

注解的概念

  • 注解:Annotation 是从JDK5.0开始引入的新技术
  • Annotation 的作用:
    • 并不是程序本身,他可以对程序做出某种解释。这一点跟注释有点像
    • 但是注解可以被其他程序(比如:编译器)所读取。注释不会被注解读取。
  • Annotation 的格式:
    • 通常是以@注释名在代码中存在的,还可以添加一些参数值:例如:@SuppressWarnings(value='unchecked')
  • Annotation 的使用:
    • 可以附加在package,class,method,field等上面,相当于给它们添加了额外的辅助信息,我们可以通过反射机制编程实现对这些元数据的访问。
    • ps:学长曾说反射机制一定要理解,这个应该很重要。

内置注解

@Ovrride

public class zhujie /*extends Object*/{
    @Override
    public String toString(){
        return "hello";
    }
}

这里重写的是Object里的toString方法,加上@Ovrride什么意思呢?

@Ovrride就是一个注解,表示这个方法是重写了父类方法。但是如果这么写:

public class zhujie /*extends Object*/{
    @Override
    public String tostring(){
        return "hello";
    }
}

就会报错。

@Override并没有实际的作用,不写也是可以的,但是写上有以下好处:

  • 可以当注释用,表示这个方法名是父类有的
  • 编译器也可以识别,如果没有就会报错。所以加上编译器就会帮你检查方法的正确性。

@Deprecated

这个注解表示不推荐使用,但还是可以用的。

一个横线代表不推荐。

@SuppressWarnings

这个感觉真的太有用了。在写代码的时候重视会出现警告,但是有些警告多了反而麻烦。

这个注解上文说过是带参数的。

具体用法可以看这篇博客:https://www.cnblogs.com/perfei456/p/8962167.html

自定义注解

@Override打开,可以看到注解的格式:

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

@Target({ElementType.METHOD})
@Retention(RetentionPolicy.SOURCE)
public @interface Override {
}

自己写的注解跟这格式差不多,可能比这复杂

元注解

元注解的作用就是负责注解其他注解。Java定义了4个标准的meta-annotation类型,用来提供对其它annotation类型作说明

比较常用的是上面出现的@Target,@Retention

  • @Target

    它的作用就是用来描述注解的使用范围,比如说是可以修饰类,还是可以修饰方法的

  public enum ElementType {
      /** Class, interface (including annotation type), or enum declaration */
      /** 用于描述类、接口(包括注解类型)或enum声明*/
      TYPE,
  
      /** Field declaration (includes enum constants) */
      /** 用于描述域 (包括enum常量)*/
      FIELD,
  
      /** Method declaration */
      /** 用于描述方法 */
      METHOD,
  
      /** Formal parameter declaration */
      /** 用于描述参数 */
      PARAMETER,
  
      /** Constructor declaration */
      /** 用于描述构造器 */
      CONSTRUCTOR,
  
      /** Local variable declaration */
      /** 用于描述局部变量 */
      LOCAL_VARIABLE,
  
      /** Annotation type declaration */
      /** 用于描述注解 */
      ANNOTATION_TYPE,
  
      /** Package declaration */
      /** 用于描述包 */
      PACKAGE,
  
      /**
       * Type parameter declaration
       * 用于描述参数类型
       * @since 1.8
       */
      TYPE_PARAMETER,
  
      /**
       * Use of a type
       *类型的使用
       * @since 1.8
       */
      TYPE_USE
  }

如果用于描述方法的结果放在类前面,那么就会报错

  • 如果要多个参数也是可以的

@Target(value = { ElementType.METHOD,ElementType.TYPE})

  • @Retention

    Retention注解有一个属性value,是RetentionPolicy类型的,Enum RetentionPolicy是一个枚举类型,这个枚举决定了Retention注解应该如何去保持,也可理解为Rentention 搭配 RententionPolicy使用。RetentionPolicy有3个值:CLASS RUNTIME SOURCE
    按生命周期来划分可分为3类:

    取值 作用
    SOURCE 只在源文件中有效
    CLASS 在class文件中有效
    RUNTIME 在运行时有效,为runtime可以被反射机制读取

    在注解里定义的每一个方法实际上是声明一个配置参数。

  public @interface SetAnnotation {
      /*参数类型 参数名()*/
     String f();
      /*如果不加default,那么前面必须传一个参数*/
     /*可以通过default来声明参数的默认值*/
      String f() default "";
      int age() default 0;
  }

注解元素必须要有值,在定义注解元素的时候,经常使用空字符串,0作为默认值,也经常使用负数表示不存在的含义。

结语

但是注解如果只是定义了参数并没有用,还需要通过反射或其他程序去解析这些注解才有用。

现在只是暂时学习了语法。

原文地址:https://www.cnblogs.com/smallocean/p/12343551.html