《Java编程思想》读书笔记(九)

Author Avatar
wshunli 12月 05, 2017
  • 在其它设备中阅读本文章

《Java编程思想》读书笔记 —— 注解。

第20章 注解

注解(也叫元数据)为我们在代码中添加信息提供了一种形式化的方法,使我们可以在稍后某个时刻非常方便地使用这些数据。

注解的优点:

1.可以提供用来完整地描述程序所需的信息(这些信息无法用Java表达)-> 以将由编译器来测试和验证的格式存储有关程序的额外信息。
2.可以用来生成描述符文件或是新的类的定义->减轻编写”样板”代码的负担。
3.更加干净易读的代码以及编译器类型检查。

注解的语法:除@符号的使用外,其他和Java固有语法一样

Java SE5内置了三种,定义在java.lang中的注解:

@Override 当前的方法定义将覆盖父类(超类)中的方法。
@Deprecated 被注解的元素被取代,不推荐使用。
@SuppressWarnings 关闭不当的编译器警告信息。

基本语法

1.@Target 表示该注解可以用于什么地方。

ElementType参数包括:

public enum ElementType {
    //类、接口(包括注解类型)或是enum声明
    TYPE,
    //域声明(包括enum实例)
    FIELD,
    //方法声明
    METHOD,
    //参数声明
    PARAMETER,
   //构造器声明
    CONSTRUCTOR,
    //局部变量声明
    LOCAL_VARIABLE,
     //注解类型声明
    ANNOTATION_TYPE,
    //包声明
    PACKAGE,
    //类型参数声明(Java1.8开始使用)
    TYPE_PARAMETER,
    //类型使用(Java1.8开始使用)
    TYPE_USE
}

2.@Retention 表示需要在什么级别保存该注解信息。

RetentionPolicy 参数包括:

public enum RetentionPolicy {
    /**
     * Annotations are to be discarded by the compiler.
     *注解将被编译器丢弃
     */
    SOURCE,

    /**
     * Annotations are to be recorded in the class file by the compiler
     * but need not be retained by the VM at run time.  This is the default
     * behavior.
     *注解被编译器保存在类文件中。但在运行的时候没有被VM保存
     */
    CLASS,

    /**
     * Annotations are to be recorded in the class file by the compiler and
     * retained by the VM at run time, so they may be read reflectively.
     *
     * @see java.lang.reflect.AnnotatedElement
     *  注解将被编译器保存在类文件中,在运行的时候也会被VM保存。因此可通过反射机制读取注解的信息
     */
    RUNTIME
}

3.@Documented 将此注解包含在 Javadoc 中。

4.@Inherited 允许子类继承父类中的注解。

定义注解的语法:

package com;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface Test {
}

使用注解的语法:

package com;

public class Testable {
    public void execute(){
        System.out.println("Executing...");
    }
    @Test void testExcute(){
        execute();
    }
}

参考资料
1、Java编程思想学习笔记——注解 - JohnTsai - 博客园
https://www.cnblogs.com/JohnTsai/p/4926203.html
2、《Java编程思想》学习笔记17——注解Annotation - CSDN博客
http://blog.csdn.net/z742182637/article/details/50454204

如果本文对您有所帮助,且您手头还很宽裕,欢迎打赏赞助我,以支付网站服务器和域名费用。 https://paypal.me/wshunli 您的鼓励与支持是我更新的最大动力,我会铭记于心,倾于博客。
本文链接:https://www.wshunli.com/posts/8c5a6523.html