cn.taketoday.aop.ThrowsAdvice Maven / Gradle / Ivy
/*
* Original Author -> Harry Yang ([email protected]) https://taketoday.cn
* Copyright © TODAY & 2017 - 2021 All Rights Reserved.
*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see [http://www.gnu.org/licenses/]
*/
package cn.taketoday.aop;
/**
* Tag interface for throws advice.
*
* There are not any methods on this interface, as methods are invoked by
* reflection. Implementing classes must implement methods of the form:
*
*
void afterThrowing([Method, args, target], ThrowableSubclass);
*
* Some examples of valid methods would be:
*
*
public void afterThrowing(Exception ex)
* public void afterThrowing(RemoteException)
* public void afterThrowing(Method method, Object[] args, Object target, Exception ex)
* public void afterThrowing(Method method, Object[] args, Object target, ServletException ex)
*
* The first three arguments are optional, and only useful if we want further
* information about the joinpoint, as in AspectJ after-throwing advice.
*
* Note: If a throws-advice method throws an exception itself, it will
* override the original exception (i.e. change the exception thrown to the user).
* The overriding exception will typically be a RuntimeException; this is compatible
* with any method signature. However, if a throws-advice method throws a checked
* exception, it will have to match the declared exceptions of the target method
* and is hence to some degree coupled to specific target method signatures.
* Do not throw an undeclared checked exception that is incompatible with
* the target method's signature!
*
* @author Rod Johnson
* @author Juergen Hoeller
* @author TODAY 2021/2/20 22:20
* @see AfterReturningAdvice
* @see MethodBeforeAdvice
* @since 3.0
*/
public interface ThrowsAdvice extends AfterAdvice {
}