package net.hasor.core;
/**
* Intercepts calls on an interface on its way to the target. These are nested "on top" of the target.
* <p>
* The user should implement the {@link #invoke(MethodInvocation)} method to
* modify the original behavior. E.g. the following class implements a tracing
* interceptor (traces all the calls on the intercepted method(s)):
*
* <pre class=code>
* class TracingInterceptor implements MethodInterceptor {
* Object invoke(MethodInvocation i) throws Throwable {
* System.out.println("method " + i.getMethod() + " is called on "
* + i.getThis() + " with args " + i.getArguments());
* Object ret = i.proceed();
* System.out.println("method " + i.getMethod() + " returns " + ret);
* return ret;
* }
* }
* </pre>
*/
public interface MethodInterceptor {
/**
* implement this method to perform extra treatments before and after the invocation.
* @param invocation 拦截器链
* @return 返回拦截器执行结果
* @throws Throwable 抛出的异常
*/
public Object invoke(MethodInvocation invocation) throws Throwable;
}