Interface MethodInterceptor

  • All Superinterfaces:
    Advice, Interceptor

    public interface MethodInterceptor
    extends Interceptor
    Intercepts calls on an interface on its way to the target. These are nested "on top" of the target.

    The user should implement the 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)):

     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;
       }
     }
     
    • Method Detail

      • invoke

        java.lang.Object invoke​(MethodInvocation invocation)
                         throws java.lang.Throwable
        Implement this method to perform extra treatments before and after the invocation. Polite implementations would certainly like to invoke Joinpoint.proceed().
        Parameters:
        invocation - the method invocation joinpoint
        Returns:
        the result of the call to Joinpoint.proceed(), might be intercepted by the interceptor.
        Throws:
        java.lang.Throwable - if the interceptors or the target-object throws an exception.