Java 自定义注解

Java 自定义注解， 以及@interface @Target @Retention @Around @Before @After ProceedingJoinPoint JoinPoint 等用法

注解应用非常广泛，我们自定义注解能简化开发各种各种业务

一、关键字解释
(1) 定义注解时，关键字
@interface 来表示注解类的类型

@Target @Retention 这两个具体值，需要分析注解的应用场景来确定；
对于“调用方法时打印入参和出参”的例子，是在调用调用方法时，则使用RetentionPolicy.RUNTIME， 且作用于方法上，则使用ElementType.METHOD；

(2) 实现注解时，关键字

@Before、@After、@AfterReturning 方法的入参是JoinPoint类型
@Around 方法的入参是ProceedingJoinPoint类型

ProceedingJoinPoint继承了JoinPoint类型，并扩展出了proceed()方法，执行proceed()也就是执行原始的函数具体业务方法，可以通过JoinPoint对象获取一些请求上的参数，比如request，parms等；

执行顺序：
@Around >> @Before >> 被添加注解的方法业务执行 >> @After >> @AfterReturning

特别注意：
注解中，可以存在@Around、@Before 、@After或、@AfterReturning任意组合
注解中，存在@Around ，也存在@Before 、@After或、@AfterReturning时、会先执行@Around；

在@Around中，执行参数的ProceedingJoinPoint.proceed()， 会触发@Before 、“被添加注解的方法业务执行” 、@After、@AfterReturning的执行，

在@Around中，不执行参数的ProceedingJoinPoint.proceed()， 不会触发@Before 、“被添加注解的方法业务执行”，特别注意；所以正常逻辑中，ProceedingJoinPoint.proceed()都应该触发执行。

@Around 的返回值应该为 “被添加注解的方法业务执行” 的返回值。通过获取Object bizData = ProceedingJoinPoint.proceed(), 也可以对返回值加工再返回；

三、代码实现
(1) 定义注解

package com.xxxxx.annotation;

import java.lang.annotation.*;

@Target({ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
public @interface MethodParam {

    /**
     * 自定义方法， 日志描述信息， 可有可无
     *
     * @return
     */
    String description() default "";

    /**
     * 自定义方法1， 日志描述信息， 可有可无
     *
     * @return
     */
    String description1() default "";

    /**
     * 自定义方法2， 日志描述信息， 可有可无
     *
     * @return
     */
    String description2() default "";
}

其中description() description1() description2() 都是自定义方法（相当于调用注解时的传参），当业务需要就声明，不需要就无需声明

(2) 实现注解

package com.xxxxx.annotation.annotationAspect;

import com.xxxxx.annotation.MethodParam;
import org.aspectj.lang.JoinPoint;
import org.aspectj.lang.ProceedingJoinPoint;
import org.aspectj.lang.annotation.*;
import org.aspectj.lang.reflect.MethodSignature;
import org.springframework.stereotype.Component;

import java.lang.reflect.Method;

@Aspect
@Component
public class MethodParamAspect {

    /**
     * 声明切点
     */
    @Pointcut(value = "@annotation(com.xxxxx.annotation.MethodParam)")
    public void doPointCut() {
        System.out.print("执行doPointCut \n");
    }

    /**
     * 调用方法前后执行
     * @param joinPoint
     */
    @Around(value = "doPointCut()")
    public Object doAround(ProceedingJoinPoint joinPoint) throws Throwable{
        System.out.print("执行doAround \n");

        //获取注解入参
        MethodSignature signature = (MethodSignature) joinPoint.getSignature();
        Method method = signature.getMethod();
        MethodParam methodParamNew = method.getAnnotation(MethodParam.class);
        String description = methodParamNew.description();
        String description1 = methodParamNew.description1();
        String description2 = methodParamNew.description2();


        //被添加注解的方法业务执行
        Object bizData = joinPoint.proceed();

        //处理其他业务
        
        return bizData;
    }

    /**
     * 调用方法之【前】执行
     * @param joinPoint
     */
    @Before(value = "doPointCut()")
    public void doBefore(JoinPoint joinPoint){
        System.out.print("执行doBefore \n");
        //处理其他业务
    }


    /***
     * 调用方法之【后】执行
     *
     * @param joinPoint
     */
    @After(value = "doPointCut()")
    public void doAfter(JoinPoint joinPoint){
        System.out.print("执行doAfter \n");
        //处理其他业务
    }


    /***
     * @After执行之【后】执行
     *
     * @param joinPoint
     * @param res 具体业务的返回值 (可有可无)
     */
    @AfterReturning(value = "doPointCut()",returning = "res")
    public void doAfterReturning(JoinPoint joinPoint, String res){
        System.out.print("执行doAfterReturning \n");
        //处理其他业务
    }
}

(3) 使用注解

package com.xxxxx.component;

import com.xxxxx.annotation.MethodParam;
import org.springframework.stereotype.Component;
import java.util.Random;

@Component
public class OrderComponent {

    @MethodParam(description = "aaa", description1 = "bbb", description2 = "ccc")
    public String testAnnotation(String val1, String val2){
        String aa = val1.concat(val2)
        .concat(String.valueOf(String.format("%04d",new Random().nextInt(9999))));
        System.out.print(aa + "\n");
        return aa;
    }
}