Java注解之 @Target、@Retention、@Documented简介

=========================

1.@interface可以实现三种功能：

(1)声明类:Class

(2)声明类别:Category

(3)声明扩展:Extension

2.声明类：这个就比较常用了，在这里不多说。代码：

@interface SomeClass : NSObject <SomeDelegate>{

}

@end

3.声明类别：

(1)类别能在不更改原来的类代码的情况下，为类增加方法或者重写类的方法。

(2)类别只能添加或者重写方法，但是不能添加变量。

(3)有网友说将类别名设定为“Private”,就能使类别中增加的方法成为私有方法，这个是不成立的(经过实际代码验证)。

(4)如果是重写类的已经存在的方法，则此重写的方法会在整个运行环境中生效，而且不需要在用到的地方导入实现类；

如果是为类增加新的方法，则需要在用的地方导入。

(5)代码：

@interface ClassName(类别名){

}

@end

4.声明扩展：

(1)扩展和类别语法上的的区别很简单，就是类别名省略，只保留括号。

(2)扩展只是增加原来类的方法和变量的声明，而不包含实现，所以，扩展没有独立的实现(@implementation)，而是和原来的类共享一个实现。

(3)扩展不仅能在原来类的基础上增加方法，也能增加变量。

(4)如果将扩展写到实现文件中，则增加的变量和方法就是私有变量和私有方法。

(5)代码：

@interface ClassName(){

}

@end

============================

先来看一个Spring中的一个常用注解

@Target({ElementType.TYPE}) 注解

ElementType 这个枚举类型的常量提供了一个简单的分类：注释可能出现在Java程序中的语法位置（这些常量与元注释类型(@Target)一起指定在何处写入注释的合法位置）

package java.lang.annotation;
/**
* The constants of this enumerated type provide a simple classification of the
* syntactic locations where annotations may appear in a Java program. These
* constants are used in {@link Target java.lang.annotation.Target}
* meta-annotations to specify where it is legal to write annotations of a
* given type.
* @author Joshua Bloch
* @since 1.5
* @jls 9.6.4.1 @Target
* @jls 4.1 The Kinds of Types and Values
*/
public enum ElementType {
/** 类, 接口 (包括注释类型), 或枚举声明 */
TYPE,
/** 字段声明（包括枚举常量） */
FIELD,
/** 方法声明(Method declaration) */
METHOD,
/** 正式的参数声明 */
PARAMETER,
/** 构造函数声明 */
CONSTRUCTOR,
/** 局部变量声明 */
LOCAL_VARIABLE,
/** 注释类型声明 */
ANNOTATION_TYPE,
/** 包声明 */
PACKAGE,
/**
* 类型参数声明
*
* @since 1.8
*/
TYPE_PARAMETER,
/**
* 使用的类型
*
* @since 1.8
*/
TYPE_USE
}

@Retention({RetentionPolicy.Runtime}) 注解

RetentionPolicy这个枚举类型的常量描述保留注释的各种策略，它们与元注释(@Retention)一起指定注释要保留多长时间

@Documented注解

Documented注解表明这个注释是由 javadoc记录的，在默认情况下也有类似的记录工具。如果一个类型声明被注释了文档化，它的注释成为公共API的一部分。