2018-02-11 发布 spring 自定义注解（annotation）与 aop获取注解

知识点： Java自定义注解、spring aop @aspect的使用

首先我们先介绍Java自定义注解。

在开发过程中，我们实现接口的时候，会出现@Override，有时还会提示写@SuppressWarnings。其实这个就是Java特有的特性，注解。

注解就是某种注解类型的一种实例，我们可以把它用在某个类上进行标注。下面这张图解释注解都是什么？

上图可以看出注解大体分为三种：元注解，标记注解，一般注解；

这一块其他的我就不多做介绍，我们这里主要说一下如何定义自己的注解，在这之前我们必须了解标准元注解和相关定义注解的语法。
元注解的作用就是负责注解其他注解。Java5.0定义了4个标准的meta-annotation类型，它们被用来提供对其它 annotation类型作说明。Java5.0定义的元注解：

1.@Target,

2.@Retention,

3.@Documented,

4.@Inherited

@Target

@Target说明了Annotation所修饰的对象范围：Annotation可被用于 packages、types（类、接口、枚举、Annotation类型）、类型成员（方法、构造方法、成员变量、枚举值）、方法参数和本地变量（如循环变量、catch参数）。在Annotation类型的声明中使用了target可更加明晰其修饰的目标。

作用：用于描述注解的使用范围（即：被描述的注解可以用在什么地方）

取值(ElementType)有：

CONSTRUCTOR:用于描述构造器
FIELD:用于描述符
LOCAL_VARIABLE:用于描述局部变量
METHOD:用于描述方法
PACKAGE:用于描述包
PARAMETER: 用于描述参数
TYPE: 用于描述类、接口（包括注解类型）或者enum声明

@Retention

@Retention定义了该Annotation被保留的时间长短：某些Annotation仅出现在源代码中，而被编译器丢弃；而另一些却被编译在class文件中；编译在class文件中的Annotation可能会被虚拟机忽略，而另一些在class被装载时将被读取（请注意并不影响class的执行，因为Annotation与class在使用上是被分离的）。使用这个meta-Annotation可以对 Annotation的“生命周期”限制。

作用：表示需要在什么级别保存该注释信息，用于描述注解的生命周期（即：被描述的注解在什么范围内有效）

取值（RetentionPoicy）有：

SOURCE:在源文件中有效（即源文件保留）
CLASS:在class文件中有效（即class保留）
RUNTIME:在运行时有效（即运行时保留）

@Documented

@Documented用于描述其它类型的annotation应该被作为被标注的程序成员的公共API，因此可以被例如javadoc此类的工具文档化。Documented是一个标记注解，没有成员。

@Inherited

@Inherited 元注解是一个标记注解，@Inherited阐述了某个被标注的类型是被继承的。如果一个使用了@Inherited修饰的annotation类型被用于一个class，则这个annotation将被用于该class的子类。
注意：@Inherited annotation类型是被标注过的class的子类所继承。类并不从它所实现的接口继承annotation，方法并不从它所重载的方法继承annotation。
当@Inherited annotation类型标注的annotation的Retention是RetentionPolicy.RUNTIME，则反射API增强了这种继承性。如果我们使用java.lang.reflect去查询一个@Inherited annotation类型的annotation时，反射代码检查将展开工作：检查class和其父类，直到发现指定的annotation类型被发现，或者到达类继承结构的顶层。

自定义注解

使用@interface自定义注解时，自动继承了java.lang.annotation.Annotation接口，由编译程序自动完成其他细节。在定义注解时，不能继承其他的注解或接口。@interface用来声明一个注解，其中的每一个方法实际上是声明了一个配置参数。方法的名称就是参数的名称，返回值类型就是参数的类型（返回值类型只能是基本类型、Class、String、enum）。可以通过default来声明参数的默认值。

定义注解格式:

public @interface 注解名 {定义体}

　　注解参数的可支持数据类型:
　　 1. 所有基本数据类型（int,float,boolean,byte,double,char,long,short)
　　 2. String类型
　　 3. Class类型
　　 4. enum类型
　　 5. Annotation类型
　　 6. 以上所有类型的数组
　　
　　Annotation类型里面的参数该怎么设定:
　　第一,只能用public或默认(default)这两个访问权修饰.例如,String value();这里把方法设为defaul默认类型；
　　第二,参数成员只能用基本类型byte,short,char,int,long,float,double,boolean八种基本数据类型和 String,Enum,Class,annotations等数据类型,以及这一些类型的数组.例如,String value();这里的参数成员就为String;
　　第三,如果只有一个参数成员,最好把参数名称设为"value",后加小括号.例:下面的例子FruitName注解就只有一个参数成员。

使用示例：

CacheRedis.java

import java.lang.annotation.*;

@Target(ElementType.METHOD)

@Retention(RetentionPolicy.RUNTIME)

@Documented

public @interface CacheRedis {

    String key();

    int expireTime() default 600;

}

CacheService.java

import org.aspectj.lang.annotation.AfterReturning;

import org.aspectj.lang.annotation.Aspect;

import org.aspectj.lang.annotation.Before;

import org.aspectj.lang.annotation.Pointcut;

import org.slf4j.Logger;

import org.slf4j.LoggerFactory;

import org.springframework.stereotype.Component;

@Aspect

@Component

public class CacheService {

    Logger logger = LoggerFactory.getLogger(CacheService.class);

    @Pointcut(value = "@annotation(com.meizu.bro.service.test.CacheRedis)")

    public void pointCut(){}

    @Before(value = "pointCut() && @annotation(cacheRedis)")

    public void before(CacheRedis cacheRedis) {

        logger.info("the result of this method will be cached.");

    }

    @AfterReturning(value = "pointCut() && @annotation(cacheRedis)",returning = "result")

    public void after(CacheRedis cacheRedis,Object result) {

        String key = cacheRedis.key();

        int expireTime = cacheRedis.expireTime();

        //do something...

        logger.info("-----redis-----[key = " + key + "]"+"[expireTime = " + expireTime + "]");

        logger.info("the result of this method is" + result + ",and has been cached.");

    }

    //@Around("pointCut() && @annotation(cacheRedis)")

    //public Object setCache(ProceedingJoinPoint joinPoint,CacheRedis cacheRedis) {

    //    Object result = 1;

    //

    //    Method method = getMethod(joinPoint);//自定义注解类

    //    //CacheRedis cacheRedis = method.getAnnotation(CacheRedis.class);//获取key值

    //    String key = cacheRedis.key();

    //    int expireTime = cacheRedis.expireTime();

    //    //获取方法的返回类型,让缓存可以返回正确的类型

    //    Class returnType =((MethodSignature)joinPoint.getSignature()).getReturnType();

    //

    //    logger.info("[key = " + key + "]"+"[expireTime = " + expireTime + "]");

    //

    //    return result;

    //}

    //

    //private Method getMethod(ProceedingJoinPoint joinPoint) {

    //    //获取参数的类型

    //    Method method = null;

    //    try {

    //        Signature signature = joinPoint.getSignature();

    //        MethodSignature msig = null;

    //        if (!(signature instanceof MethodSignature)) {

    //            throw new IllegalArgumentException("该注解只能用于方法");

    //        }

    //        msig = (MethodSignature) signature;

    //        method = joinPoint.getTarget().getClass().getMethod(msig.getName(), msig.getParameterTypes());

    //    } catch (NoSuchMethodException e) {

    //        logger.error("annotation no sucheMehtod", e);

    //    } catch (SecurityException e) {

    //        logger.error("annotation SecurityException", e);

    //    }

    //    return method;

    //}

}

测试接口TestController.java

@Controller

public class TestController {

    @Autowired

    private TestService testService;

    @RequestMapping(value = "/test")

    public ModelAndView myTest() {

        int test = testService.test(10);

        return ViewUtil.buildStandardJsonViewByObj(test);

    }

    @RequestMapping(value = "/test1")

    public ModelAndView myTest1() {

        String yanyi = testService.test1("yanyi");

        return ViewUtil.buildStandardJsonViewByObj(yanyi);

    }

}

TestService.java

public interface TestYanyiService {

    int test(int i);

    String test1(String i1);

}

TestServiceImpl.java

import org.springframework.stereotype.Service;

@Service

public class TestYanyiServiceImpl implements TestYanyiService {

    @Override

    @CacheRedis(key = "test",expireTime = 10)

    public int test(int i) {

        return 0;

    }

    @Override

    @CacheRedis(key = "test1")

    public String test1(String i1) {

        return i1;

    }

}

代码完成后，需要在pom文件中导入以下依赖：

            <dependency>

                <groupId>aopalliance</groupId>

                <artifactId>aopalliance</artifactId>

                <version>1.0</version>

            </dependency>

            <dependency>

                <groupId>org.aspectj</groupId>

                <artifactId>aspectjweaver</artifactId>

                <version>1.8.13</version>

            </dependency>

            <dependency>

                <groupId>org.aspectj</groupId>

                <artifactId>aspectjrt</artifactId>

                <version>1.8.13</version>

            </dependency>

            <dependency>

                <groupId>cglib</groupId>

                <artifactId>cglib</artifactId>

                <version>2.2.2</version>

            </dependency>

这一块要注意：aspectjweaver包的版本和JDK版本有关联。如果是JDK 1.7及以上的用户，需要aspectjweaver包的版本不能过低（JDK1.7 —— aspectJ1.7.3+）。否则会报错：报错error at ::0 can't find referenced pointcut。

接下来，在Spring配置文件里进行以下配置

<!-- 启动对@AspectJ注解的支持 -->

<aop:aspectj-autoproxy/> 

<!--通知spring使用cglib而不是jdk的来生成代理方法 AOP可以拦截到Controller->

<aop:aspectj-autoproxy proxy-target-class="true" />

ok! 完成后，调用测试接口，可以看到在控制窗口打印切面类前置和后置的相关log。这时候，我们就可以在里边实现自己的功能咯。（我这里准备实现redis缓存功能。）