Java注解拾遗

注解简介：

注解Annotation是jdk1.5的新增功能，在现在的日常开发中，几乎离不开注解，写篇短文，来做个拾遗。

注解作用：

Annotation(注解)的作用是修饰包、类、构造方法、方法、成员变量等。

注解语法及定义形式：

　　@interface关键字定义
　　注解包含成员，成员以无参数的方法的形式被声明。其方法名和返回值定义了该成员的名字和类型。
　　成员赋值是通过@Annotation(name=value)的形式
　　注解需要标明注解的生命周期，注解的修饰目标等信息，这些信息是通过元注解实现。

　　举例：

@Documented

@Retention(RetentionPolicy.RUNTIME)

@Target(ElementType.ANNOTATION_TYPE)

public @interface Target {

    /**

     * Returns an array of the kinds of elements an annotation type

     * can be applied to.

     * @return an array of the kinds of elements an annotation type

     * can be applied to

     */

    ElementType[] value();

}

元注解@Retention，成员value的值为RetentionPolicy.RUNTIME、
元注解@Target，成员value是个数组，用{}形式赋值，值为ElementType.ANNOTATION_TYPE
成员名称为value，类型为ElementType[]

注解分类：

内置标准注解：

　　　　@Override：用于修饰此方法覆盖了父类的方法
　　　　 @Deprecated：用于修饰已经过时的方法
　　　　 @SuppressWarnnings:用于通知java编译器禁止特定的编译警告

元注解：

　　　　@Target：说明Annotation所修饰的对象范围
　　　　@Retention：说明Annotation的生命周期
　　　　@Documented ：Documented是一个标记注解，主要是用于javadoc
　　　　@Inherited ：Inherited也是一个标记注解，假如一个标记了Inherited的注解修饰一个类，那么继承于此类的子类，同样继承该注解
　　　　　　　　　　这样虽然完成了继承，但是注解本身是不允许继承的。

普通注解：

　　　　自定义的完成特定任务的注解

注解生命周期：

　　　　注解的生命周期是由元注解Retention修饰的
　　　　看下Retention的源码

@Documented

@Retention(RetentionPolicy.RUNTIME)

@Target(ElementType.ANNOTATION_TYPE)

public @interface Retention {

/**

* Returns the retention policy.

* @return the retention policy

*/

RetentionPolicy value();

}

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.

*/

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

*/

RUNTIME

}

SOURCE: 注解只保留在源文件，当Java文件编译成class文件的时候，注解被遗弃
CLASS: 注解被保留到class文件，jvm加载class文件时候被遗弃。这是默认的生命周期
RUNTIME: 注解不仅被保存到class文件中，jvm加载class文件之后，仍然存在，保存到class对象中，可以通过反射来获取

注解的修饰目标：

　　注解的修饰目标是由元注解Target修饰的

@Documented

@Retention(RetentionPolicy.RUNTIME)

@Target(ElementType.ANNOTATION_TYPE)

public @interface Target {

/**

* Returns an array of the kinds of elements an annotation type

* can be applied to.

* @return an array of the kinds of elements an annotation type

* can be applied to

*/

ElementType[] value();

}

public enum ElementType {

/** Class, interface (including annotation type), or enum declaration */

TYPE,

/** Field declaration (includes enum constants) */

FIELD,

/** Method declaration */

METHOD,

/** Formal parameter declaration */

PARAMETER,

/** Constructor declaration */

CONSTRUCTOR,

/** Local variable declaration */

LOCAL_VARIABLE,

/** Annotation type declaration */

ANNOTATION_TYPE,

/** Package declaration */

PACKAGE,

/**

* Type parameter declaration

*

* @since 1.8

*/

TYPE_PARAMETER,

/**

* Use of a type

*

* @since 1.8

*/

TYPE_USE

}

TYPE:指的是在类，接口（包括注解）或者enum上使用的注解
FIELD:指的在field属性，也包括enum常量使用的注解
METHOD:指的是在方法声明上使用的注解
PARAMETER:指的是在参数上使用的注解
CONSTRUCTOR: 指的是在构造器使用的注解
LOCAL_VARIABLE:指的是在局部变量上使用的注解
ANNOTATION_TYPE:指的是在注解上使用的元注解
PACKAGE:指的是在包上使用的注解

自定义注解：

　　自定义注解是利用注解方面很重要的一个方面，这次把项目里的一个自定义的注解分析下
代码如下：

@Target(ElementType.METHOD)

@Retention(RetentionPolicy.RUNTIME)

public @interface LogMethod {

}

@Slf4j

public class LogMethodInterceptor implements MethodInterceptor {

@Override

public Object invoke(MethodInvocation methodInvocation) throws Throwable {

String className = String.valueOf(methodInvocation.getMethod().getDeclaringClass());

String methodName = methodInvocation.getMethod().getName();

Object[] arguments = methodInvocation.getArguments();

log.info("Before:" + className + "." + methodName + "()");

log.info("Arguments:" + JsonTools.toJsonString(arguments));

long start = System.currentTimeMillis();

Object resultObj = methodInvocation.proceed();

long end = System.currentTimeMillis();

log.info("After:result is " + JsonTools.toJsonString(resultObj) + ",the execute time is " + (end - start) + " ms");

return resultObj;

}

}

具体配置：

<bean id="logMethodInterceptor" class="com.*LogMethodInterceptor"/>

<aop:config proxy-target-class="true">

<aop:pointcut id="logMethodPointcut"

expression="execution(* com*service.impl.*.*(..)) and @annotation(com.*annotation.LogMethod)"/>

<aop:advisor advice-ref="logMethodInterceptor" pointcut-ref="logMethodPointcut"/>

</aop:config>

LogMethod 定义了一个生命周期为RUNTIME 作用在METHOD上的注解
LogMethodInterceptor 注解的处理器
利用Spring的AOP完整在方法的出入口分别打印参数的相关日志

巴特西