JAVA注解详谈
前言
注解也是引入自JDK 1.5，自引入后它就成为了Java平台中非常重要的一部分。开发过程中，我们也时常在应用代码中会看到诸如@Override，@Deprecated这样的注解。
那么，为什么要引入注解，还是以前的答案:
不管是什么，只要是新入的东西，基本都有三个目的:
很多人抱怨软件行业技术迭代快速，自己跟不上等等都是不对的。从机器语言到汇编语言再到现在的高级语言，所有的技术迭代都只是减少我们的工作量，让我们的工作更加简单快捷。但是这种简单快捷是建立在我们的基础牢固，一步一个脚印的情况下。如果囫囵吞枣的学习，对于所有的知识都是一知半解，那么新东西的出现对于我们而言，只是增加了学习量，而不是减少了工作量。1.使得开发维护更便捷，减少程序员的开发工作量。
2.提高程序运行效率。
3.更加安全
所以，学习知识，还是慢慢来，比较快。 慢慢来，也会越来越有兴趣。
至于引入注解是为什么呢，请看下面分解。
什么是注解
Annotation(注释)其实就是元数据(MetaData，即解释数据的数据) 。
- Annotation 其实就是代码里的特殊标记, 这些标记可以在编译, 类加载, 运行时被读取, 并执行相应的处理. 通过使用 Annotation, 程序员可以在不改变原有逻辑的情况下, 在源文件中嵌入一些补充信息.
- Annotation 可以像修饰符一样被使用, 可用于修饰包,类, 构造器, 方法, 成员变量, 参数, 局部变量的声明, 这些信息被保存在 Annotation 的 “name=value” 对中.
- Annotation 能被用来为程序元素(类, 方法, 成员变量等) 设置元数据
- Annotations仅仅是元数据，和业务逻辑无关。这就意味着，注解仅仅是个对于数据描述而已，再没有其他逻辑功能。但是其他的组件却可以借助读取这个对数据的描述而添加一些业务逻辑。更专业的说法是:
Annotations不包含业务逻辑，那么必须有人来实现这些逻辑。元数据的用户来做这个事情。Annotations仅仅提供它定义的属性(类/方法/包/域)的信息。Annotations的用户(同样是一些代码)来读取这些信息并实现必要的逻辑。(还是上面的通俗说法比较好理解吧)
为什么引入注解
使用Annotation之前(甚至在使用之后)，XML被广泛的应用于描述元数据。不知何时开始一些应用开发人员和架构师发现XML的维护越来越糟糕了。他们希望使用一些和代码紧耦合的东西，而不是像XML那样和代码是松耦合的(在某些情况下甚至是完全分离的)代码描述。
就如道家所讲，一阴一阳之谓道，整个宇宙规律都是如此，代码也是一个平衡的系统，所以就需要注解来平衡一下XML的松耦合。
下面我们通过一个例子来理解这两者(XML 和 Annotation)的区别。
假如你想为应用设置很多的常量或参数，这种情况下，XML是一个很好的选择，因为它不会同特定的代码相连。如果你想把某个方法声明为服务，那么使用Annotation会更好一些，因为这种情况下需要注解和方法紧密耦合起来，开发人员也必须认识到这点。
另一个很重要的因素是Annotation定义了一种标准的描述元数据的方式。在这之前，开发人员通常使用他们自己的方式定义元数据。例如，使用标记interfaces，注释，transient关键字等等。每个程序员按照自己的方式定义元数据，而不像Annotation这种标准的方式。
目前，许多框架将XML和Annotation两种方式结合使用，平衡两者之间的利弊。
使用注解
1.基本使用:
基本的 Annotation使用 Annotation 时要在其前面增加 @ 符号, 并把该 Annotation 当成一个修饰符使用. 用于修饰它支持的程序元素
2.三个基本的 Annotation(大家估计经常都用，肯定一看就能懂):
- @Override: 限定重写父类方法, 该注释只能用于方法
- @Deprecated: 用于表示某个程序元素(类, 方法等)已过时
- @SuppressWarnings: 抑制编译器警告.
3.自定义注解
J2SE5.0版本在 java.lang.annotation提供了四种元注解，专门注解其他的注解：
@Documented –注解是否将包含在JavaDoc中
@Retention –什么时候使用该注解
@Target? –注解用于什么地方
@Inherited – 是否允许子类继承该注解
@Documented–一个简单的Annotations标记注解，表示是否将注解信息添加在java文档中。
@Retention– 定义该注解的生命周期。
- RetentionPolicy.SOURCE – 在编译阶段丢弃。这些注解在编译结束之后就不再有任何意义，所以它们不会写入字节码。@Override, @SuppressWarnings都属于这类注解。
- RetentionPolicy.CLASS – 在类加载的时候丢弃。在字节码文件的处理中有用。注解默认使用这种方式。
- RetentionPolicy.RUNTIME– 始终不会丢弃，运行期也保留该注解，因此可以使用反射机制读取该注解的信息。我们自定义的注解通常使用这种方式。
@Target – 表示该注解用于什么地方。如果不明确指出，该注解可以放在任何地方。以下是一些可用的参数。需要说明的是：属性的注解是兼容的，如果你想给7个属性都添加注解，仅仅排除一个属性，那么你需要在定义target包含所有的属性。
ElementType.TYPE:用于描述类、接口或enum声明
ElementType.FIELD:用于描述实例变量
ElementType.METHOD
ElementType.PARAMETER
ElementType.CONSTRUCTOR
ElementType.LOCAL_VARIABLE
ElementType.ANNOTATION_TYPE 另一个注释
ElementType.PACKAGE 用于记录java文件的package信息
@Inherited – 定义该注释和子类的关系
那么，注解的内部到底是如何定义的呢？
Annotations只支持基本类型、String及枚举类型。注释中所有的属性被定义成方法，并允许提供默认值。
- 定义新的 Annotation 类型使用 @interface 关键字
- Annotation 的成员变量在 Annotation 定义中以无参数方法的形式来声明. 其方法名和返回值定义了该成员的名字和类型.
- 可以在定义 Annotation 的成员变量时为其指定初始值, 指定成员变量的初始值可使用 default 关键字
- 没有成员定义的 Annotation 称为标记; 包含成员变量的 Annotation 称为元数据 Annotation
如下所示:
注解
import java.lang.annotation.Retention;
import java.lang.annotation.Target;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.ElementType;
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface Level {
public enum Priority {LOW, MEDIUM, HIGH}
public enum Status {STARTED, NOT_STARTED}
String author() default "LCDZhao";
Priority priority() default Priority.LOW;
Status status() default Status.NOT_STARTED;
}
使用注解
@Level(status = Status.STARTED, author = "lcdzhao" , priority = Priority.LOW)
public static void testAnnotation(){
System.out.println("I,m just test annotation!!!");
}
如果注解中只有一个属性，可以直接命名为“value”，使用时无需再标明属性名。
@interface Author{
String value();
}
@Author("Yashwant")
public void someMethod() {
}
到现在呢，一切很完美，注解的使用就这么简单。但是很多同学就要问了，注解就这样吗，也没有什么功能嘛。其实注解看起来是这样，但是当它和反射配合起来时，功能就会变得异常强大。很多例如Spring等的框架就是这样实现的。如下:
public static void main(String args[]) {
Class aClass = AnnotationTest.class;
Method[] methods = aClass.getDeclaredMethods();
for(Method method:methods){
System.out.println(method);
Level annotation = method.getAnnotation(Level.class);
if(annotation != null){
System.out.println(annotation.author());
System.out.println(annotation.priority());
System.out.println(annotation.status());
}
}
}
看到了吧，配上反射，再加上逻辑，注解的能力就体现了。
很多框架的实现其实也就是 注解+反射 ， 缺一不可呐！！！
参考资料:
注解基础