java注解学习笔记

注解概述

注解就是代码中的特殊标记, 用于替代配置文件.
相比配置文件而言(比如.xml, .properties等), 语义化更好, 看起来直观, 类型也可以直接获取,
不像在配置文件中, 读到的都是字符串, 还要做各种转换.

三个常用的注解

@Override, @SuppressWarnings, @Deprecated
例子:

public class ComponentClass {    // overwrite父类中的方法    @Override    public boolean equals(Object obj) {        return super.equals(obj);    }    // 标注为已过时, 不建议再使用    @Deprecated    public void oldMethod() {        // 抑制警告        @SuppressWarnings("unused")        int i = 0;    }}

编写自己的注解

import java.lang.annotation.ElementType;import java.lang.annotation.Retention;import java.lang.annotation.RetentionPolicy;import java.lang.annotation.Target;@Retention(RetentionPolicy.RUNTIME)@Target({ElementType.CONSTRUCTOR, ElementType.METHOD})public @interface Component {    String selector() default "app";    String template();    ChildComponent c() default @ChildComponent(selector="c-app", template="<div></div>");}

注解的属性

注解的属性可以有以下一些类型:
原始数据类型(boolean, byte, char, short, int, long, float, double), 字符串,
类, 注解(比如上面的ChildComponent), 枚举或者上述类型的一维数组.

元注解(meta annotation)

常用的元注解: @Retention, @Target.

@Retention: 注解保留的时期(域, scope), 有三个值:

时期 说明 注意事项 RetentionPolicy.SOURCE 编译过后就丢弃, 在字节码中已经没有了 RetentionPolicy.CLASS 注解可以保留在java字节码中,jvm运行时不会保留该注解 默认值 RetentionPolicy.RUNTIME 注解可以保留在运行期, 可以通过反射获取 常用

@Target: 注解可以作用到的位置: 可取的值有: 类, 接口, 枚举, 注解, 字段(包括枚举常量), 方法声明,
形式参数, 构造函数声 局部变量, 包, 类型参数(1.8新加), 类型声明(1.8新加).

解析注解

主要是利用反射相关的方法来解析, 如:

import java.lang.reflect.Method;public class ComponentClass {    @Component(selector="app", template="<div>component</div>",            c=@ChildComponent(selector="c-app", template="<div>child</div>"))    public Component parseAnnotation() {        Method method;        try {            method = ComponentClass.class.getMethod("parseAnnotation", new Class[]{});            Component c = method.getAnnotation(Component.class);            return c;        } catch (Exception e) {            e.printStackTrace();        }        return null;    }    // 测试    ComponentClass cc = new ComponentClass();    Component c = cc.parseAnnotation();    /*输出:    selector: app, template: <div>component</div>,    c.selector: c-app, c.template: <div>child</div>    */    System.out.printf("selector: %s, template: %s,\nc.selector: %s, c.template: %s",            c.selector(), c.template(), c.c().selector(), c.c().template());}

可以看到: c.selector, c.cc().selector这种语法还是很简洁的.

欢迎补充指正!