#千锋逆战班# 第35天 注解，Properties #笔记总结#

1、注解

• 定义：Java注解（Annotation）又称为标注，是JDK 5.0 引入的一种注释机制。
• Java 语言中的类、方法、变量、参数和包等都可以被标注。
• 注解可以通过反射获取内容。
• 支持自定义标注。

1.1、JDK内置注解

共有7个，3个在java.lang中，剩下4个在java.lang.annotation中。

作用在代码的注解：

• @Override - 检查该方法是否是重写方法。如果发现其父类，或者是引用的接口中并没有该方法时，会报编译错误。
• @Deprecated - 标记过时方法。如果使用该方法，会报编译警告
• @SuppressWarnings - 指示编译器去忽略注解中声明的警告。

元注解：（标记注解的注解）

• @Retention - 注解声明周期; 1: java文件里 2: class文件里 3: 运行时。
• @Target - 标记这个注解可以注解哪些元素。
• @Documented - 标记这些注解是否包含在用户文档中。
• @Inherited - 标记这个注解能否被继承;

JDK 7新注解：

• @SafeVarargs - Java 7 开始支持，忽略任何使用参数为泛型变量的方法或构造函数调用产生的警告。
• @FunctionalInterface - Java 8 开始支持，标识一个匿名函数或函数式接口。
• @Repeatable - Java 8 开始支持，标识某注解可以在同一个声明上使用多次。

1.2、自定义注解

语法： 使用@interface 来声明一个注解
            使用4个元注解来标识这个注解

@Documented
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Inherited
public @interface MyAnno {

	String name() default "";
	
}

@Target(ElementType.TYPE)详解（标识该注释可以定义在什么位置）

public enum ElementType {
    TYPE,               /* 类、接口（包括注释类型）或枚举声明  */

    FIELD,              /* 字段声明（包括枚举常量）  */

    METHOD,             /* 方法声明  */

    PARAMETER,          /* 参数声明  */

    CONSTRUCTOR,        /* 构造方法声明  */

    LOCAL_VARIABLE,     /* 局部变量声明  */

    ANNOTATION_TYPE,    /* 注释类型声明  */

    PACKAGE             /* 包声明  */
        
    /**
     * Type parameter declaration
     * 针对类型参数(泛型)  <@xx T>
     * @since 1.8
     */
    TYPE_PARAMETER,

    /**
     * Use of a type
     *
     	能标注任何类型名称
     
     * @since 1.8
     */
    TYPE_USE
}

@Retention(RetentionPolicy.RUNTIME) 详解（标识自定义注释的声明周期）

public enum RetentionPolicy {
    SOURCE,   /* Annotation信息仅存在于编译器处理期间，编译器处理完之后就没有该Annotation信息了  */

    CLASS,    /* 编译器将Annotation存储于类对应的.class文件中。默认行为  */

    RUNTIME   /* 编译器将Annotation存储于class文件中，并且可由JVM读入 */
}

1.3、注解的属性

• 注解只有成员变量，无方法

• 注解的成员变量在注解的定义中以“无形参的方法”形式来声明，其方法名定义了该成员变量的名字，其返回值定义了该成员变量的类型;

• 注解的属性,如果没有default,表示使用注解时,需要对该属性进行赋值;

• 默认的value
  如果一个注解内仅仅只有一个名字为 value 的属性时，应用这个注解时可以直接把属性值填写到括号内。

• 无属性
  一个注解没有任何属性，那么在应用这个注解的时候，括号都可以省略。
  没有强制要赋值的属性,就可以省略括号

1.4、通过反射获取注解

• x.getDeclaredAnnotations();
  //方法返回此元素上直接存在的所有注解。 与此接口中的其他方法不同，此方法忽略了继承的注解
• x.getAnnotations();
  //返回所有的注解

2、Properties

• 用来存储数据的一种类

2.1、文件定义

• 后缀properties是一种属性的文件，也可以说是配置文件
• 这种文件以 key=value 格式存储内容

2.2、Properties对象

• Properties类继承自Hashtable类 并且实现了Map的接口，使用键值对形式来存储数据，Properties特殊之处是也得键和值都是字符创类型。

2.3、Properties使用

load(InputStream inStream)
这个方法可以从.properties属性文件对应的文件输入流中，加载属性列表到Properties类对象。

store(OutputStream out, String comments)
这个方法将Properties类对象的属性列表保存到输出流中。

getProperty/setProperty
这两个方法是分别是获取和设置属性信息。