SysOperateLog

先看注解的定义：

@Documented
@Retention(RUNTIME)
@Target(METHOD)
public @interface SysOperateLog {
    /**
     * 操作类型，取值为 com.gosun.isap.operlog.api.OperateType
     * 
     * @return 操作类型
     */
    int operateType();

    /**
     * 业务类型，取值为com.gosun.isap.operlog.api.ServiceType
     * 
     * @return 业务类型
     */
    int serviceType();

    /**
     * 操作描述
     * 
     * @return 操作描述信息
     */
    String description();
}

一个目标为方法的运行时注解，有三个数据。

Around

通过Spring Aop切面实现日志的记录功能，在这里主要用到了Around这个注解，该注解的意思是在目标方法运行之前和运行之后增加某些功能，可以改变执行目标方法的参数值，也可以改变执行目标方法之后的返回值。
在我们的项目中：
@Around("within(com.gosun.isap..*) && @annotation(rl)")
如果看不懂肯定就是因为within(com.gosun.isap..*) && @annotation(rl)这句表达式。
下面就分析一下这句表达式的意思：
within的官方定义是：
within - limits matching to join points within certain types (simply the execution of a method declared within a matching type when using Spring AOP)
简单的说就是匹配某个类型。

com.gosun.isap..*：
官方例子：within(com.xyz.service..*)
any join point (method execution only in Spring AOP) within the service package or a sub-package
和spring的component-scan类似，递归扫描下面的包。

@annotation的官方定义是：
@annotation - limits matching to join points where the subject of the join point (method being executed in Spring AOP) has the given annotation
简单的说就是只匹配拥有某个注解的方法。

上面两个条件用&&连接起来意思就很清楚了，切入com.gosun.isap下的包，并且在类方法包含SysOperateLog注解的情况下，增加日志功能。

Spring

在spring配置文件中添加配置启用Aop功能

    <context:component-scan base-package="com.gosun.isap.operlog"></context:component-scan>
    <aop:aspectj-autoproxy/> 

实现

在看看方法的具体实现：

    @Around("within(com.gosun.isap..*) && @annotation(rl)")
    public Object writeOperateLog(ProceedingJoinPoint jp, SysOperateLog rl) throws Throwable {
        String className = jp.getTarget().getClass().toString();// 获取目标类名
        className = className.substring(className.indexOf("com"));
        String signature = jp.getSignature().toString();// 获取目标方法签名
        String methodName = signature.substring(signature.lastIndexOf(".") + 1, signature.indexOf("("));
        Object[] parames = jp.getArgs();// 获取目标方法体参数
        String params = parseParames(parames); // 解析目标方法体的参数

        int serviceType = rl.serviceType();
        int operateType = rl.operateType();
        String description = rl.description();

        StringBuilder sbLogDetail = new StringBuilder();
        sbLogDetail.append(description).append(", 参数为:").append(params);

        Object object;
        try {
            object = jp.proceed();
            if (object != null && object instanceof ResponseResult) {
                int code = ((ResponseResult) object).getHead().getErrorCode();
                if (code == ErrorCode.ERR_OK) {
                    success(serviceType, operateType, sbLogDetail.toString());
                } else {
                    failed(serviceType, operateType, sbLogDetail.toString(),
                            ((ResponseResult) object).getHead().getMessage());
                }
            } else {
                success(serviceType, operateType, sbLogDetail.toString());
            }
        } catch (Throwable throwable) {
            failed(serviceType, operateType, sbLogDetail.toString(), throwable.getMessage());
            throw throwable;
        }
        return object;
    }

    private void success(int serviceType, int operateType, String description) {
        try {
            OperateLogWriter.success(serviceType, operateType, description);
        } catch (Exception e) {
            logger.error("Write operate log error ", e);
        }
    }

    private void failed(int serviceType, int operateType, String description, String reason) {
        try {
            OperateLogWriter.fail(serviceType, operateType, description, reason);
        } catch (Exception e) {
            logger.error("Write operate log error ", e);
        }
    }

可以看到不管是成功还是失败，最终依旧调用了OperateLogWriter去写日志，但通过AOP的方式解耦了分散在业务逻辑中的写日志代码。
在这里object = jp.proceed();才真正的执行了我们的方法，并通过返回的对象int code = ((ResponseResult) object).getHead().getErrorCode();判断方法的成功与失败，然后写入日志。

int serviceType = rl.serviceType();
int operateType = rl.operateType();
String description = rl.description();

这三句话将注解中的内容提取出来写入日志中，因此这个注解的使用也非常简单：

@SysOperateLog(serviceType = ServiceType.CONFIG_RES， operateType = OperateType.CONFIG_ADD, description = "添加时间模板")

最终这些元数据都会写入到日志中。