com.alibaba.jvm.sandbox.api.listener.ext

类 AdviceListener

java.lang.Object

com.alibaba.jvm.sandbox.api.listener.ext.AdviceListener

public class AdviceListener
extends Object

通知监听器

将Event转换为更友好的Advice，当然，代价是一定的性能开销

从以下版本开始:

sandbox-api:1.0.10

作者:

luanjia@taobao.com

构造器概要

构造器

构造器和说明
AdviceListener()

方法概要

限定符和类型	方法和说明
protected void	after(Advice advice) 方法调用后通知，无论是正常返回还是抛出异常都会调用
protected void	afterCall(Advice advice, int callLineNum, String callJavaClassName, String callJavaMethodName, String callJavaMethodDesc, String callThrowJavaClassName) 目标方法调用结束之后，无论正常返回还是抛出异常 在一个方法调用过程中会调用其他的方法，CALL系列的事件就是来描述这一类调用的情况。
protected void	afterCallReturning(Advice advice, int callLineNum, String callJavaClassName, String callJavaMethodName, String callJavaMethodDesc) 目标方法返回之后 在一个方法调用过程中会调用其他的方法，CALL系列的事件就是来描述这一类调用的情况。
protected void	afterCallThrowing(Advice advice, int callLineNum, String callJavaClassName, String callJavaMethodName, String callJavaMethodDesc, String callThrowJavaClassName) 目标方法调用异常之后 在一个方法调用过程中会调用其他的方法，CALL系列的事件就是来描述这一类调用的情况。
protected void	afterReturning(Advice advice) 方法调用返回后通知 在这个通知环节，通过Advice.getParameterArray()拿到的入参有可能已经被方法内部改变过，不再是原有的入业务入参 在这个通知环节，你无法通过Advice.changeParameter(int, Object)来改变方法入参， 因为整个方法已经执行过了，再次改变已经失去了意义
protected void	afterThrowing(Advice advice) 方法调用抛出异常后通知
protected void	before(Advice advice) 方法调用前通知 通知处理与当前业务同属一个线程 通知处理失败不会影响当前业务处理结果 在通知处理过程中依然可以使用Advice.changeParameter(int, Object)来改变入参， 也可以继续使用ProcessController来改变代码执行流程
protected void	beforeCall(Advice advice, int callLineNum, String callJavaClassName, String callJavaMethodName, String callJavaMethodDesc) 目标方法调用之前 在一个方法调用过程中会调用其他的方法，CALL系列的事件就是来描述这一类调用的情况。
protected void	beforeLine(Advice advice, int lineNum) 行为即将经过的代码行

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

AdviceListener

public AdviceListener()

方法详细资料

before

protected void before(Advice advice)
               throws Throwable

方法调用前通知

• 通知处理与当前业务同属一个线程
• 通知处理失败不会影响当前业务处理结果
• 在通知处理过程中依然可以使用Advice.changeParameter(int, Object)来改变入参， 也可以继续使用ProcessController来改变代码执行流程

参数:

advice - 通知信息

抛出:

Throwable - 处理通知错误

afterReturning

protected void afterReturning(Advice advice)
                       throws Throwable

方法调用返回后通知

• 在这个通知环节，通过Advice.getParameterArray()拿到的入参有可能已经被方法内部改变过，不再是原有的入业务入参
• 在这个通知环节，你无法通过Advice.changeParameter(int, Object)来改变方法入参， 因为整个方法已经执行过了，再次改变已经失去了意义

参数:

advice - 通知信息

抛出:

Throwable - 处理通知错误

另请参阅:

before(Advice)

after

protected void after(Advice advice)
              throws Throwable

方法调用后通知，无论是正常返回还是抛出异常都会调用

参数:

advice - 通知信息

抛出:

Throwable - 处理通知错误

另请参阅:

afterReturning(Advice), afterThrowing(Advice)

afterThrowing

protected void afterThrowing(Advice advice)
                      throws Throwable

方法调用抛出异常后通知

参数:

advice - 通知信息

抛出:

Throwable - 处理通知错误

另请参阅:

afterReturning(Advice)

beforeCall

protected void beforeCall(Advice advice,
                          int callLineNum,
                          String callJavaClassName,
                          String callJavaMethodName,
                          String callJavaMethodDesc)

目标方法调用之前

在一个方法调用过程中会调用其他的方法，CALL系列的事件就是来描述这一类调用的情况。 CALL系列事件必定是包含在BEFORE/RETURN/THROWS事件之间。

参数:

advice - Caller的行为通知

callLineNum - 调用发生的代码行(可能为-1，取决于目标编译代码的编译策略)

callJavaClassName - 调用目标类名

callJavaMethodName - 调用目标行为名称

callJavaMethodDesc - 调用目标行为描述

afterCallReturning

protected void afterCallReturning(Advice advice,
                                  int callLineNum,
                                  String callJavaClassName,
                                  String callJavaMethodName,
                                  String callJavaMethodDesc)

目标方法返回之后

在一个方法调用过程中会调用其他的方法，CALL系列的事件就是来描述这一类调用的情况。 CALL系列事件必定是包含在BEFORE/RETURN/THROWS事件之间。

参数:

advice - Caller的行为通知

callLineNum - 调用发生的代码行(可能为-1，取决于目标编译代码的编译策略)

callJavaClassName - 调用目标类名

callJavaMethodName - 调用目标行为名称

callJavaMethodDesc - 调用目标行为描述

afterCallThrowing

protected void afterCallThrowing(Advice advice,
                                 int callLineNum,
                                 String callJavaClassName,
                                 String callJavaMethodName,
                                 String callJavaMethodDesc,
                                 String callThrowJavaClassName)

目标方法调用异常之后

在一个方法调用过程中会调用其他的方法，CALL系列的事件就是来描述这一类调用的情况。 CALL系列事件必定是包含在BEFORE/RETURN/THROWS事件之间。

参数:

advice - Caller的行为通知

callLineNum - 调用发生的代码行(可能为-1，取决于目标编译代码的编译策略)

callJavaClassName - 调用目标类名

callJavaMethodName - 调用目标行为名称

callJavaMethodDesc - 调用目标行为描述

callThrowJavaClassName - 调用目标异常类名

afterCall

protected void afterCall(Advice advice,
                         int callLineNum,
                         String callJavaClassName,
                         String callJavaMethodName,
                         String callJavaMethodDesc,
                         String callThrowJavaClassName)

目标方法调用结束之后，无论正常返回还是抛出异常

在一个方法调用过程中会调用其他的方法，CALL系列的事件就是来描述这一类调用的情况。 CALL系列事件必定是包含在BEFORE/RETURN/THROWS事件之间。

参数:

advice - Caller的行为通知

callLineNum - 调用发生的代码行(可能为-1，取决于目标编译代码的编译策略)

callJavaClassName - 调用目标类名

callJavaMethodName - 调用目标行为名称

callJavaMethodDesc - 调用目标行为描述

callThrowJavaClassName - 调用目标异常类名，若正常返回则为 null

从以下版本开始:

sandbox-api:1.2.2

beforeLine

protected void beforeLine(Advice advice,
                          int lineNum)

行为即将经过的代码行

参数:

advice - Caller的行为通知

lineNum - 即将经过的代码行