java interface简写_JAVA注解@Interface基础知识

java注解是在JDK5时引入的新特性，大多数框架(SpringBoot、MyBatis、Quartz)背后都在大量使用注解开发。

一、先进行一个小试验，了解注解开发流程

建立maven项目annotation：

1

2 4.0.0

3 org.guangsoft

4 annotation

5 1.0

6 war

7 annotation

8

基础注解类：

1 packageorg.guangsoft.annotation.entity;2

3 importjava.lang.annotation.ElementType;4 importjava.lang.annotation.Retention;5 importjava.lang.annotation.RetentionPolicy;6 importjava.lang.annotation.Target;7

8 @Target(ElementType.METHOD)9 @Retention(RetentionPolicy.RUNTIME)10 public @interfaceDBInfo {11 String driver() default "";12 String url() default "";13 String username() default "";14 String password() default "";15 }

其中，@Target表示此注解只能用于方法上，@Retention表示该注解生存期是运行时

测试类：

1 packageorg.guangsoft.annotation.utils;2

3 importjava.lang.reflect.Method;4

5 importorg.guangsoft.annotation.entity.DBInfo;6

7 public classJDBCUtil1 {8

9 @DBInfo(url="guanghe:annotation")10 public static void getConnection() throwsException {11 Method method = JDBCUtil1.class.getMethod("getConnection", null);12 DBInfo info = method.getAnnotation(DBInfo.class);13 System.out.println(info.url());14 }15

16 public static voidmain(String args[]) {17 try{18 JDBCUtil1.getConnection();19 } catch(Exception e) {20 e.printStackTrace();21 }22 }23 }

从这里我们可以看出，获取注解用的是反射。

运行结果：

二、注解开发基本知识

@Target类型

1 public enumElementType {2 /**标明该注解可以用于类、接口(包括注解类型)或enum声明*/

3 TYPE,4 /**标明该注解可以用于字段(域)声明，包括enum实例*/

5 FIELD,6 /**标明该注解可以用于方法声明*/

7 METHOD,8 /**标明该注解可以用于参数声明*/

9 PARAMETER,10 /**标明注解可以用于构造函数声明*/

11 CONSTRUCTOR,12 /**标明注解可以用于局部变量声明*/

13 LOCAL_VARIABLE,14 /**标明注解可以用于注解声明(应用于另一个注解上)*/

15 ANNOTATION_TYPE,16 /**标明注解可以用于包声明*/

17 PACKAGE,18 /**

19 * 标明注解可以用于类型参数声明(1.8新加入)20 *@since1.821 */

22 TYPE_PARAMETER,23 /**

24 * 类型使用声明(1.8新加入)25 *@since1.826 */

27 TYPE_USE28 }

@Target使用方法：

1 @Target(value={CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, PARAMETER, TYPE})

@Retention类型：

SOURCE：

注解将被编译器丢弃(该类型的注解信息只会保留在源码里，源码经过编译后，注解信息会被丢弃，不会保留在编译好的class文件里)

CLASS：

注解在class文件中可用，但会被VM丢弃(该类型的注解信息会保留在源码里和class文件里，在执行的时候，不会加载到虚拟机中)，请注意，当注解未定义Retention值时，默认值是CLASS，如Java内置注解，@Override、@Deprecated、@SuppressWarnning等

RUNTIME：

注解信息将在运行期(JVM)也保留，因此可以通过反射机制读取注解的信息(源码、class文件和执行的时候都有注解的信息)，如SpringMvc中的@Controller、@Autowired、@RequestMapping等。

@Retention使用方法：

1 @Retention(RetentionPolicy.RUNTIME) //只允许使用一种生命周期

支持类型：

所有基本类型(int,float,boolean,byte,double,char,long,short)String  Class  enum  Annotation  以及上述类型的数组

1 public @interfaceAnnotationElement {2 //枚举类型

3 enumStatus {FIXED,NORMAL};4 //声明枚举

5 Status status() defaultStatus.FIXED;6 //布尔类型

7 boolean showSupport() default false;8 //String类型

9 String name()default "";10 //class类型

11 Class> testCase() default Void.class;12 //注解嵌套

13 Reference reference() default @Reference(next=true);14 //数组类型

15 long[] value();16 }

注解书写规定

注解书写要求以(key1 = value1, key2 = value2)的形式书写。

其中value如果是多个值要用{}将value括起来，即(key1 = value1, key2={value21,value22})的形式。

当注解中定义了名为value的元素，并且在使用该注解时，如果该元素是唯一需要赋值的一个元素，那么此时无需使用key=value的语法，而只需在括号()内给出value元素所需的值即可。

内置注解

java提供了许多内置注解，主要介绍三个：

@Override：用于标明此方法覆盖了父类的方法

@Deprecated：用于标明已经过时的方法或类

@SuppressWarnnings:用于有选择的关闭编译器对类、方法、成员变量、变量初始化的警告

1 @Target(ElementType.METHOD)2 @Retention(RetentionPolicy.SOURCE)3 public @interfaceOverride {4 }5

6 @Documented7 @Retention(RetentionPolicy.RUNTIME)8 @Target(value={CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, PARAMETER, TYPE})9 public @interfaceDeprecated {10 }11

12 @Target({TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE})13 @Retention(RetentionPolicy.SOURCE)14 public @interfaceSuppressWarnings {15 String[] value();16 }

利用反射获取注解

getAnnotation(Class annotationClass) 该元素如果存在指定类型的注解，则返回这些注解，否则返回 null。

Annotation[]getAnnotations()返回此元素上存在的所有注解，包括从父类继承的

booleanisAnnotationPresent(Class extends Annotation> annotationClass)如果指定类型的注解存在于此元素上，则返回 true，否则返回 false。

Annotation[]getDeclaredAnnotations()返回直接存在于此元素上的所有注解，注意，不包括父类的注解，调用者可以随意修改返回的数组；这不会对其他调用者返回的数组产生任何影响，没有则返回长度为0的数组