package net.hasor.core.classcode.aop;
/**
* 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(AopInvocation)} 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 AopInterceptor {
/** Implement this method to perform extra treatments before and after the invocation. */
public Object invoke(AopInvocation invocation) throws Throwable;
}