JAVA中的@interface

注解@interface不是接口是注解类，在jdk1.5之后加入的功能，使用@interface自定义注解时，自动继承了java.lang.annotation.Annotation接口。

在定义注解时，不能继承其他的注解或接口。@interface用来声明一个注解，其中的每一个方法实际上是声明了一个配置参数。方法的名称就是参数的名称，返回值类型就是参数的类型（返回值类型只能是基本类型、Class、String、enum）。可以通过default来声明参数的默认值。

就是不能定义 public @interface A extends B 这样的形式，必须裸的，只能是 public @interface A 形式

在Java API文档中特意强调了如下内容：
Annotation是所有注释类型的公共扩展接口。注意，手动扩展这个接口并不定义注释类型。还要注意，这个接口本身并不定义注释类型。注释类型的更多信息可以在Java™语言规范的9.6节。

1.java中的interface和@interface有什么区别？

public interface Test {
}

与

public @interface Test {
}

@符号表示注释类型定义。

这意味着它实际上不是一个接口，而是一个新的注释类型-用作函数修饰符，例如@override

接口：

通常，接口公开合同而不公开基础实现细节。在面向对象的编程中，接口定义了抽象类型，这些抽象类型公开行为，但不包含逻辑。实现由实现接口的类或类型定义。

@interface ：(注释类型)

以下面的示例为例，它有很多注释：

public class Generation3List extends Generation2List {

   // Author:  Huang
   // Date: 6/27/2003
   // Current revision: 6
   // Last modified: 6/12/2023
   // By: Jane Doe


   // class code goes here

}

代替此，您可以声明注释类型

@interface ClassPreamble {
   String author();
   String date();
   int currentRevision() default 1;
   String lastModified() default"N/A";
   String lastModifiedBy() default"N/A";
   // Note use of array
   String[] reviewers();
}

然后可以注释一个类，如下所示：

@ClassPreamble (
   author ="Huang",
   date ="6/27/2003",
   currentRevision = 6,
   lastModified ="6/12/2023",
   lastModifiedBy ="Huang",
   // Note array notation
   reviewers = {"Alice","Bob","Cindy"}
)
public class Generation3List extends Generation2List {

// class code goes here

}

总结：

interface关键字表示您正在使用Java声明传统接口类。
@interface关键字用于声明新的注释类型。

接口
Java编程语言中的"语言"是一种抽象类型，用于指定类必须实现的行为。它们类似于协议。使用interface关键字声明接口

@接口
用于创建您自己的(自定义)Java批注。注释在它们自己的文件中定义，就像Java类或接口一样。这是自定义Java注释示例：

@interface MyAnnotation {

    String   value();

    String   name();
    int      age();
    String[] newNames();

}

本示例定义了一个名为MyAnnotation的注释，该注释具有四个元素。注意@interface关键字。这会向Java编译器发出信号，这是Java注释定义。

注意，每个元素的定义都类似于接口中的方法定义。它具有数据类型和名称。您可以将所有原始数据类型用作元素数据类型。您也可以使用数组作为数据类型。您不能将复杂对象用作数据类型。

要使用上面的注释，可以使用如下代码：

@MyAnnotation(
    value="123",
    name="Jakob",
    age=37,
    newNames={"Jenkov","Peterson"}
)
public class MyClass {


}

语法规范
我们以spring中的@component注解为例，其格式如下所示

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Indexed
public @interface Component {

	String value() default "";

}

其中主要包括四个部分

2.1 继承的Annotation父接口
等价于，编译时会自动添加这个父接口：

public @interface Component  extends java.lang.annotation.Annotation{

}

2.2 @Target中的参数ElementType
该参数声明这个注解可以加在上面位置，只能在类上、或只能在方法上

@component注解为例，只能加在类或接口上，不能加载方法上。

public enum ElementType {
    TYPE,               /* 类、接口（包括注释类型）或枚举声明  */

    FIELD,              /* 字段声明（包括枚举常量）  */

    METHOD,             /* 方法声明  */

    PARAMETER,          /* 参数声明  */

    CONSTRUCTOR,        /* 构造方法声明  */

    LOCAL_VARIABLE,     /* 局部变量声明  */

    ANNOTATION_TYPE,    /* 注释类型声明  */

    PACKAGE             /* 包声明  */
}

2.3 @Retention中的参数RetentionPolicy

public enum RetentionPolicy {
    SOURCE,            /* Annotation信息仅存在于编译器处理期间，编译器处理完之后就没有该Annotation信息了  */

    CLASS,             /* 编译器将Annotation存储于类对应的.class文件中。默认行为  */

    RUNTIME            /* 编译器将Annotation存储于class文件中，并且可由JVM读入 */
}

2.4 成员变量
以无形参的方法形式来声明Annotation的成员变量，方法名和返回值定义了成员变量名称和类型。

注意：定义成员变量，以方法的形式定义，而不是普通类的那种直接定义方式

使用default关键字设置默认值，没设置默认值的变量则使用时必须提供，有默认值的变量使用时可以设置也可以不设置。

//定义带成员变量注解MyTag
@Rentention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface MyTag{
  //定义两个成员变量，以方法的形式定义
  String name();
  int age() default 20;
}

在使用该注解的地方，需要给属性赋值，如果属性定义时，带有default，则可以不用赋值，age可以不用赋值，而name必须赋值：

//使用
public class Test{
  @MyTag(name="test")
  public void info(){}
}

获取注解信息
可以通过反射的方式获取注解在某个元素上的注解和其中的值，在Java反射类库reflect中，Class类实现了AnnotatedElement接口，其中包含多个获取annotation的方法

package bat.ke.qq.com.controller;

import org.springframework.stereotype.Component;

import java.lang.annotation.Annotation;
import java.lang.reflect.InvocationTargetException;
import java.util.ArrayList;
import java.util.HashSet;
import java.util.List;
import java.util.Set;

@Component
public class MySearchMetaAnnations {
    public static void main(String[] args) throws NoSuchMethodException, InvocationTargetException, IllegalAccessException {
        List<String> test = new ArrayList<>();
        //通过反射获取某个类上注解
        Annotation[] annotations = MySearchMetaAnnations.class.getAnnotations();
        Set<Annotation> set = new HashSet<>();
        for (Annotation annotation : annotations) {
            recursivelyAnnotaion(annotation, set);
        }
        System.out.println(set);
    }

    //递归获取注解的注解
    public static void recursivelyAnnotaion(Annotation annotation, Set<Annotation> set) {
        //通过set元素唯一的特点来实现递归搜索所有的注解
        if (set.add(annotation)) {
            //获取注解的注解数组
            if (annotation.annotationType().getAnnotations().length > 0) {
                //搜索子注解
                for (Annotation childAnnotation : annotation.annotationType().getAnnotations()) {
                    recursivelyAnnotaion(childAnnotation, set);
                }

            }
            System.out.println(annotation.annotationType().getName());
        }
    }

}

执行结果：

java.lang.annotation.Target
java.lang.annotation.Retention
java.lang.annotation.Documented
java.lang.annotation.Target
org.springframework.stereotype.Indexed
org.springframework.stereotype.Component
[@java.lang.annotation.Documented(), @org.springframework.stereotype.Indexed(), @java.lang.annotation.Target(value=[TYPE]), @org.springframework.stereotype.Component(value=), @java.lang.annotation.Target(value=[ANNOTATION_TYPE]), @java.lang.annotation.Retention(value=RUNTIME)]

3.2 使用场景——框架初始化过程中模拟扫描jar包和文件夹中的所有注解
模拟加载某个jar包后，扫描里面的类及注解


/**
 * 一个简单的模拟搜索包下面所有注解的工具类
 */
public class MySearchAnnationsInPackage {

  public static void main(String[] args) {

    // 包下面的类
    Set<Class<?>> clazzs = getClasses("designPattern");
    if (clazzs == null) {
      return;
    }

    System.out.println( "class总量：" + clazzs.size());
    // 某类或者接口的子类
    //Set<Class<?>> inInterface = getByInterface(Object.class, clazzs);
    //System.out.printf(inInterface.size() + "");

    for (Class<?> clazz : clazzs) {

      // 获取类上的注解
      Annotation[] annos = clazz.getAnnotations();
      for (Annotation anno : annos) {
        System.out.println(clazz.getSimpleName().concat(".").concat(anno.annotationType().getSimpleName()));
      }

      // 获取方法上的注解
      Method[] methods = clazz.getDeclaredMethods();
      for (Method method : methods) {
        Annotation[] annotations = method.getDeclaredAnnotations();
        for (Annotation annotation : annotations) {
          System.out.println(clazz.getSimpleName().concat(".").concat(method.getName()).concat(".")
              .concat(annotation.annotationType().getSimpleName()));
        }
      }
    }
  }

  /**
   * 从包package中获取所有的Class
   *
   * @param pack
   * @return
   */
  public static Set<Class<?>> getClasses(String pack) {

    // 第一个class类的集合
    Set<Class<?>> classes = new LinkedHashSet<>();
    // 是否循环迭代
    boolean recursive = true;
    // 获取包的名字 并进行替换
    String packageName = pack;
    String packageDirName = packageName.replace('.', '/');
    // 定义一个枚举的集合 并进行循环来处理这个目录下的things
    Enumeration<URL> dirs;
    try {
      dirs = Thread.currentThread().getContextClassLoader().getResources(packageDirName);
      // 循环迭代下去
      while (dirs.hasMoreElements()) {
        // 获取下一个元素
        URL url = dirs.nextElement();
        // 得到协议的名称
        String protocol = url.getProtocol();
        // 如果是以文件的形式保存在服务器上
        if ("file".equals(protocol)) {
          System.err.println("file类型的扫描");
          // 获取包的物理路径
          String filePath = URLDecoder.decode(url.getFile(), "UTF-8");
          // 以文件的方式扫描整个包下的文件 并添加到集合中
          findAndAddClassesInPackageByFile(packageName, filePath, recursive, classes);
        } else if ("jar".equals(protocol)) {
          // 如果是jar包文件
          // 定义一个JarFile
          // System.err.println("jar类型的扫描");
          JarFile jar;
          try {
            // 获取jar
            jar = ((JarURLConnection) url.openConnection()).getJarFile();
            // 从此jar包 得到一个枚举类
            Enumeration<JarEntry> entries = jar.entries();
            // 同样的进行循环迭代
            while (entries.hasMoreElements()) {
              // 获取jar里的一个实体 可以是目录 和一些jar包里的其他文件 如META-INF等文件
              JarEntry entry = entries.nextElement();
              String name = entry.getName();
              // 如果是以/开头的
              if (name.charAt(0) == '/') {
                // 获取后面的字符串
                name = name.substring(1);
              }
              // 如果前半部分和定义的包名相同
              if (name.startsWith(packageDirName)) {
                int idx = name.lastIndexOf('/');
                // 如果以"/"结尾 是一个包
                if (idx != -1) {
                  // 获取包名 把"/"替换成"."
                  packageName = name.substring(0, idx).replace('/', '.');
                }
                // 如果可以迭代下去 并且是一个包
                if ((idx != -1) || recursive) {
                  // 如果是一个.class文件 而且不是目录
                  if (name.endsWith(".class") && !entry.isDirectory()) {
                    // 去掉后面的".class" 获取真正的类名
                    String className = name.substring(packageName.length() + 1, name.length() - 6);
                    try {
                      // 添加到classes
                      classes.add(Class.forName(packageName + '.' + className));
                    } catch (ClassNotFoundException e) {
                      e.printStackTrace();
                    }
                  }
                }
              }
            }
          } catch (IOException e) {
            // log.error("在扫描用户定义视图时从jar包获取文件出错");
            e.printStackTrace();
          }
        }
      }
    } catch (IOException e) {
      e.printStackTrace();
    }

    return classes;
  }

  /**
   * 以文件的形式来获取包下的所有Class
   *
   * @param packageName
   * @param packagePath
   * @param recursive
   * @param classes
   */
  public static void findAndAddClassesInPackageByFile(String packageName, String packagePath, final boolean recursive,
                                                      Set<Class<?>> classes) {
    // 获取此包的目录 建立一个File
    File dir = new File(packagePath);
    // 如果不存在或者 也不是目录就直接返回
    if (!dir.exists() || !dir.isDirectory()) {
      // log.warn("用户定义包名 " + packageName + " 下没有任何文件");
      return;
    }
    // 如果存在 就获取包下的所有文件 包括目录
    File[] dirfiles = dir.listFiles(new FileFilter() {
      // 自定义过滤规则 如果可以循环(包含子目录) 或则是以.class结尾的文件(编译好的java类文件)
      public boolean accept(File file) {
        return (recursive && file.isDirectory()) || (file.getName().endsWith(".class"));
      }
    });
    // 循环所有文件
    for (File file : dirfiles) {
      // 如果是目录 则继续扫描
      if (file.isDirectory()) {
        findAndAddClassesInPackageByFile(packageName + "." + file.getName(), file.getAbsolutePath(), recursive,
            classes);
      } else {
        // 如果是java类文件 去掉后面的.class 只留下类名
        String className = file.getName().substring(0, file.getName().length() - 6);
        try {
          // 添加到集合中去
          // classes.add(Class.forName(packageName + '.' + className));
          // 经过回复同学的提醒，这里用forName有一些不好，会触发static方法，没有使用classLoader的load干净
          classes.add(
              Thread.currentThread().getContextClassLoader().loadClass(packageName + '.' + className));
        } catch (ClassNotFoundException e) {
          // log.error("添加用户自定义视图类错误 找不到此类的.class文件");
          e.printStackTrace();
        }
      }
    }
  }

  @SuppressWarnings({"rawtypes", "unchecked"})
  public static Set<Class<?>> getByInterface(Class clazz, Set<Class<?>> classesAll) {
    Set<Class<?>> classes = new LinkedHashSet<Class<?>>();
    // 获取指定接口的实现类
    if (!clazz.isInterface()) {
      try {
        /**
         * 循环判断路径下的所有类是否继承了指定类 并且排除父类自己
         */
        Iterator<Class<?>> iterator = classesAll.iterator();
        while (iterator.hasNext()) {
          Class<?> cls = iterator.next();
          /**
           * isAssignableFrom该方法的解析，请参考博客：
           * http://blog.csdn.net/u010156024/article/details/44875195
           */
          if (clazz.isAssignableFrom(cls)) {
            if (!clazz.equals(cls)) {// 自身并不加进去
              classes.add(cls);
            } else {

            }
          }
        }
      } catch (Exception e) {
        System.out.println("出现异常");
      }
    }
    return classes;
  }
}

注解的作用
Annotation 是一个辅助类，它在 Junit、Struts、Spring 等工具框架中被广泛使用。

4.1 编译检查
Annotation 具有"让编译器进行编译检查的作用"。例如，@SuppressWarnings, @Deprecated 和 @Override 都具有编译检查作用。

4.2 在反射中使用 Annotation
在reflect库中的的Class, Method, Field 等类都实现了AnnotatedElement接口，这也意味着，我们可以在反射中解析并使用 Annotation，详细是使用方法可以参考第三节中的内容。

4.3 根据 Annotation 生成帮助文档
通过给 Annotation 注解加上 @Documented 标签，能使该 Annotation 标签出现在 javadoc 中。

JAVA中的@interface

1.java中的interface和@interface有什么区别？

悦读