java注解笔记

1：为什么要学习注解？学习注解有什么好处？学完能做什么？

• 1、能够读懂别人写的代码，特别是框架相关的代码
• 2、让编程更加简洁，代码更加清晰
• 3、让别人高看一眼

2:按照运行机制分类

源码注解:只存在于源码中，在.class文件中没有
编译时注解:源码和.class文件中均存在 如:@override @deprecated等jdk自带的注解 （起到提示代码的作用）
运行时注解:运行阶段仍然会起作用，甚至影响运行逻辑，如:spring的autowired

解析注解 ： 通过反射获取类、函数或成员上的运行时注解信息，从而实现动态控制程序运行的逻辑。

@Override：重写父类的该函数。@Deprecated: 表示该函数已过时。 前两个都是有在父类，下面用在子类@SuppressWarning:忽略某某警告

@Target({ElementType,.METHOD, ElementType.TYPE}) 表示既能够写在方法上 也能写在类上，如果 只写了 其中一个那么 超过作用域 编译器都会报错。。

自定义注解.png

使用自定义注解.png

** 使用注解的语法：@<注解名>（<成员名1>=<成员值1>,<成员名2>=<成员值2>,......） **

1、注解要用@interface注解标明
2、成员变量必须无异常
3、成员类型受限：原始类型，String,Class,Annotation,Enumeration
4、可以使用default
5、注解类可以没有成员，称之为标识注解
6、注解类只有一个成员时，必须取名为value()，在使用时可以忽略成员名和赋值号（=）

注解的分类：元注解——注解的注解

• 方法1： T getAnnotation(Class annotationClass): 返回改程序元素上存在的、指定类型的注解，如果该类型注解不存在，则返回null。
• 方法2：Annotation[] getAnnotations():返回该程序元素上存在的所有注解。
• 方法3：boolean is AnnotationPresent(Class annotationClass):判断该程序元素上是否包含指定类型的注解，存在则返回true，否则返回false.
• 方法4：Annotation[] getDeclaredAnnotations()：返回直接存在于此元素上的所有注释。与此接口中的其他方法不同，该方法将忽略继承的注释。（如果没有注释直接存在于此元素上，则返回长度为零的一个数组。）该方法的调用者可以随意修改返回的数组；这不会对其他调用者返回的数组产生任何影响。

public class FruitRun {

    public static void main(String[] args) {

        FruitInfoUtil.getFruitInfo(Apple.class);
        // 输出： 
        // 水果名称：Apple
        // 水果颜色：RED
        // 供应商编号：1 供应商名称：美国苹果公司 供应商地址：美国硅谷
    }
}

/*********** 注解声明 ***************/

/**
 * 水果名称注解
 */
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@interface FruitName {
    String value() default "";
}

/**
 * 水果颜色注解
 */
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@interface FruitColor {
    /**
     * 颜色枚举
     */
    public enum Color {
        BULE, RED, GREEN
    };

    /**
     * 颜色属性
     * 
     * @return
     */
    Color fruitColor() default Color.GREEN;

}

/**
 * 水果供应者注解
 */
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@interface FruitProvider {
    /**
     * 供应商编号
     * 
     * @return
     */
    public int id() default -1;

    /**
     * 供应商名称
     * 
     * @return
     */
    public String name() default "";

    /**
     * 供应商地址
     * 
     * @return
     */
    public String address() default "";
}

/*********** 注解使用 ***************/

class Apple {

    @FruitName("Apple")
    private String appleName;

    @FruitColor(fruitColor = Color.RED)
    private String appleColor;

    @FruitProvider(id = 1, name = "美国苹果公司", address = "美国硅谷")
    private String appleProvider;

    public void setAppleColor(String appleColor) {
        this.appleColor = appleColor;
    }

    public String getAppleColor() {
        return appleColor;
    }

    public void setAppleName(String appleName) {
        this.appleName = appleName;
    }

    public String getAppleName() {
        return appleName;
    }

    public void setAppleProvider(String appleProvider) {
        this.appleProvider = appleProvider;
    }

    public String getAppleProvider() {
        return appleProvider;
    }

    public void displayName() {
        System.out.println("水果的名字是：苹果");
    }
}

/*********** 注解处理器 ***************/

class FruitInfoUtil {
    public static void getFruitInfo(Class clazz) {

        String strFruitName = " 水果名称：";
        String strFruitColor = " 水果颜色：";
        String strFruitProvicer = "供应商信息：";

        Field[] fields = clazz.getDeclaredFields();

        for (Field field : fields) {
            if (field.isAnnotationPresent(FruitName.class)) {
                FruitName fruitName = (FruitName) field.getAnnotation(FruitName.class);
                strFruitName = strFruitName + fruitName.value();
                System.out.println(strFruitName);
            } else if (field.isAnnotationPresent(FruitColor.class)) {
                FruitColor fruitColor = (FruitColor) field.getAnnotation(FruitColor.class);
                strFruitColor = strFruitColor + fruitColor.fruitColor().toString();
                System.out.println(strFruitColor);
            } else if (field.isAnnotationPresent(FruitProvider.class)) {
                FruitProvider fruitProvider = (FruitProvider) field.getAnnotation(FruitProvider.class);
                strFruitProvicer = " 供应商编号：" + fruitProvider.id() + " 供应商名称：" + fruitProvider.name() + " 供应商地址："
                        + fruitProvider.address();
                System.out.println(strFruitProvicer);
            }
        }
    }
}

注解知识.png

图文参考：（http://www.cnblogs.com/peida/archive/2013/04/26/3038503.html） 及慕课网 http://www.imooc.com/learn/456