Java-注解学习

了解注解

在学习一个新知识的时候，首先要了解这个知识的的作用，在去学习如何使用，最后了解它的底层原理。

1、注解介绍

JDK5.0开始，Java增加了注解功能。注解可以在程序编译、加载、运行时被读取，然后执行相应的操作。

注解和注释
注释是用来对类、方法或是属性进行解释的，没有实际作用。
注解可以对类、方法或是属性进行操作。

2、注解的使用

注解的使用十分简单，只需要在类、方法或属性上使用 @注解名就行了。

class Person{
    public void wolk(){
        System.out.println("人走路");
    }
}
class Student extends Person{
    @Override//注解：重写标记
    public void wolk() {
        System.out.println("学生走路");
    }
}

@Override表示子类的方法是重写的父类的方法，在程序编译时期会检查该方法是否满足重写的要求。

Java的3个内置注解

• @Override 重写标记，表示子类方法是重写的父类方法
• @Deprecated 过时标记 表示该方法不推荐使用，有更好的替代方法
• @SuppressWarnings 压制警告 可以压制当前代码的警告

经常用的就是@Override这个注解了，其他的用的不多。

如何自定义一个注解

在学习如何自己定义一个注解之前，先看看Java内置的注解是如何定义的。

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.SOURCE)
public @interface Override {
}

其中使用了@interface声明了Override是一个注解，@Target注解表示@Override使用的位置，@Retention注解表示@Override的生命周期。
@Target、@Retention是元注解。
元注解：用来修饰注解的注解
Java中的元注解有四个：

• @Target
• @Retention
• @Documented
• @Inherited

1. @Target
@Target用来说明注解使用的位置，它有一个ElementType[]属性。ElementType是一个枚举类型。

public enum ElementType {
   
    TYPE, /**  Class, interface (including annotation type), or enum declaration 该注解可以用在类、接口（注解）或枚举上 */

    FIELD, /**Field declaration (includes enum constants) 该注解可以用在属性上（枚举属性） */

    METHOD,/**Method declaration 该注解可以用在方法上 */
 
    PARAMETER,/** Formal parameter declaration 该注解可以用在参数上*/
    
    CONSTRUCTOR,/** Constructor declaration  该注解可以用在构造器上*/

    LOCAL_VARIABLE,/** Local variable declaration 该注解可以用在局部变量上*/

    ANNOTATION_TYPE,/** Annotation type declaration 该注解可以用在注解类型上 */

    PACKAGE,/** Package declaration 该注解可以用在包上*/

    /**
     * Type parameter declaration
     * 该注解可以用在泛型上
     * @since 1.8
     */
    TYPE_PARAMETER,

    /**
     * Use of a type
     * 该注解可以用在任意类型上
     * @since 1.8
     */
    TYPE_USE
}

2. @Retention
@Retention表示该注解的生命周期。@Retention有一个属性，属性是一个枚举类型。枚举了注解的三个生命周期。

public enum RetentionPolicy {
    
    SOURCE,//表示注解只保留在源码阶段，只在源码阶段起作用

    CLASS,//表示注解保留在.class文件中，在类加载时不会被加载，jvm不可获得注解信息。默认值

    RUNTIME//表示注解保留在.class文件中，在类加载时会被加载，jvm可以获得注解信息
}

3. @Documented
@Documented表示该注解在使用javadoc命令时，将该注解包含到Java文档中。

4. @Inherited
@Inherited表示被该注解修饰的类的子类会继承该注解。
如果一个类被@Inherited修饰，那它的子类如果没有被其他注解修饰，子类会继承父类的注解

注解的属性

注解的属性可以是以下类型：

• 8个基本数据类型（char、byte、short、int、long、float、double、boolean）
• String
• enum
• class
• annotation
• 也可以是上面几种类型的数据类型

定义了注解的属性后，在使用注解时需要给注解的属性赋值。也可以在定义属性时使用default设置默认值。

@Target({ElementType.TYPE})
@interface MyAnno{
    String value() default "我的注解";
}

写在最后

写这个的作用主要是用来复习自己的知识，有写的不对或不完整的地方，请大家多多包涵。