Java 注解（Java.Annotation）

偏执的太偏执、 2024-03-27 15:32 3阅读 0赞

### 什么是注解 ###

*  Annotation 从jdk5.0引入的
 *  Annotation 作用：
    
     *  不是程序本身，可以对程序做出解释（这一点和注释（comment）没有区别）
     *  可以被其他程序（比如：编译器）读取
 *  Annotation 格式：
    
     *  注解是以“@注释名”在代码中存在的，还可以添加一些数值，例如：@supperessWarnings(value=“unchecked”)
 *  Annotation 可以在哪里使用
    
     *  可以附加在如：package、class、method、field、等上面，相当于给他们添加了额外的辅助信息，我们可以通过，反射机制编程实现对这些元数据的访问。

package com.annotation;
    
    //测试学习什么是注解
    public class Test01 extends Object{
        
        //@Override 重写的注解
        @Override
        public String toString(){
        
            return super.toString();
        }
    }

### 内置注解 ###

*  @Override：定义在java.lang.Override 中，这个注释只适用于修辞方法，表示一个方法的声明打算重写超类中另一个方法的声明
 *  @Deprecated：定义在 java.lang.Deperecated 中，此注解可以用于修辞方法、属性、类，表示不鼓励程序员使用这样的元素，通常是因为它很危险，或者存在更好的选择
 *  @SuppressWarnings ： 定义在 java.lang.SuppressWarnings 中，用来抑制编译时的警告信息。
    
     *  与前两个不同，你需要添加一个参数才能正确使用，这些参数都是已经定义好了的
     *  我们选择性使用就好了
     *  @SuppressWarnings(“all”)
     *  @SuppressWarnings(“unchecked”)
     *  @SuppressWarnings (value=\{“unchecked”,“deprecation”\})
     *  等等…

package com.annotation;
    
    import java.util.ArrayList;
    import java.util.List;
    
    //测试学习什么是注解
    public class Test01 extends Object{
        
        //@Override 重写的注解
        @Override
        public String toString(){
        
            return super.toString();
        }
    
        //@Deprecated   不推荐程序员使用，但是可以使用，或者存在更好的方式
        @Deprecated
        public static void test(){
        
            System.out.println("Deprecated");
        }
        //@SuppressWarnings("all")  镇压全部警告，可以放在方法上，也可以放在类上
        @SuppressWarnings("all")
        public void test02(){
        
            List list = new ArrayList();
        }
    
        public static void main(String[] args) {
        
            test();
        }
    }

### 元注解 ###

*  元注解的作用就是，负责注解其他注解，Java 定义了4个标准的meta-annotation 类型，他们被用来体工队其他annotation 类型作说明
 *  这些类型和他们所支持的类在java.lang.annotation 包中可以找到。（**@Target @Retention @Documented @Inherited**）
    
     *  **@Target**：用于描述注解的使用范围（注解可以用在什么地方）
     *  **@Retention**： 表示需要什么级别保存该注释信息，用于描述注解的生命周期
        
         *  (SOURCE < CLASS < **RUNTIME**)
     *  @Documented:说明该注解将被包含在javadoc中
     *  @Inherited：说明子类可以**继承**父类中的该注解

package com.annotation;
    
    import java.lang.annotation.*;
    
    //测试元注解
    @MyAnnotation 
    public class Test02 {
        
    
        public void test(){
        
    
        }
    }
    
    //定义一个注解
    //@Target   表示我们的注解可以用在那些地方
    @Target(value = {
        ElementType.METHOD,ElementType.TYPE})
    
    //@Retention    表示我们的注解在什么时候还有效 RUNTIME>CLASS>SOURCE
    @Retention(value = RetentionPolicy.RUNTIME)
    
    //@Documented   表示是否将我们的注解生成在JAVAdoc中
    @Documented
    
    
    //@Inherited  表示子类可以继承父类的注解
    @Inherited    
        
    @interface MyAnnotation{
        
    
    }

### 自定义注解 ###

*  使用 @interface 自定义注解时，自动继承了java.lang.annotation.Annotation 接口
 *  分析：
    
     *  @ interface 用来声明一个注解，格式：**pubilc @interface 注解名 \{定义内容\}**
     *  其中的每一个方法，其实是声明了一个 配置参数
     *  返回值类型就是参数类型
     *  default 声明参数默认值
     *  如果**只有一个参数，命名为value**，这样可以省略 value = 直接给参数赋值
     *  注解元素必须要有值，我们顶底注解元素时，经常使用空字符串，0作为默认值。
 *  int id() default -1;//**如果默认值为-1，代表不存在**
 *  注解可以显示赋值，**如果没有默认值，我们就必须给注解赋值**
 *  注解赋值时，没有顺序
 *  注解的参数 ： **参数类型 + 参数名 ();**
 *

package com.annotation;
    
    import java.lang.annotation.ElementType;
    import java.lang.annotation.Retention;
    import java.lang.annotation.RetentionPolicy;
    import java.lang.annotation.Target;
    
    //自定义注解
    public class Test03 {
        
        //注解可以显示赋值，如果没有默认值，我们就必须给注解赋值
        @MyAnnotation2(age = 18,name = "旺财",schools = {
        "河北农业大学，河北农大"})//没有顺序
        public void test(){
        
            
        }
        
        //只有一个值，使用value命名：在使用的时候可以省略 value = 直接赋值
        @MyAnnotation3("旺财")
        public void test2(){
        
            
        }
    }
    
    @Target({
        ElementType.TYPE,ElementType.METHOD})
    @Retention(RetentionPolicy.RUNTIME)
    @interface MyAnnotation2{
        
        //注解的参数 ： 参数类型 + 参数名 ();
        String name() default "";
        //default  代表默认值
        int age() default 0;
        int id() default -1;//如果默认值为-1，代表不存在
        
        String[] schools() default {
        "自学Java，河北农大"};
    }
    
    @Target({
        ElementType.TYPE,ElementType.METHOD})
    @Retention(RetentionPolicy.RUNTIME)
    @interface MyAnnotation3{
        
        String value();//如果只有一个值，建议使用value命名：在使用的时候可以省略 value = 直接赋值
    }