net.hasor.cobble.dynamic.MethodInterceptor Maven / Gradle / Ivy
The newest version!
/*
* Copyright 2008-2009 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package net.hasor.cobble.dynamic;
/**
* Intercepts calls on an interface on its way to the target. These are nested "on top" of the target.
*
* 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)):
*
*
* 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;
* }
* }
*
*
* copy from org.aopalliance.intercept.MethodInterceptor
* @author Rod Johnson
*/
@FunctionalInterface
public interface MethodInterceptor {
/**
* implement this method to perform extra treatments before and after the invocation.
* @param invocation 拦截器链
* @return 返回拦截器执行结果
* @throws Throwable 抛出的异常
*/
Object invoke(MethodInvocation invocation) throws Throwable;
}