AfterReturningAdvice


1   /*
2    * Copyright 2002-2007 the original author or authors.
3    *
4    * Licensed under the Apache License, Version 2.0 (the "License");
5    * you may not use this file except in compliance with the License.
6    * You may obtain a copy of the License at
7    *
8    *      http://www.apache.org/licenses/LICENSE-2.0
9    *
10   * Unless required by applicable law or agreed to in writing, software
11   * distributed under the License is distributed on an "AS IS" BASIS,
12   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13   * See the License for the specific language governing permissions and
14   * limitations under the License.
15   */
16  
17  package org.springframework.aop;
18  
19  import java.lang.reflect.Method  ;
20  
21  /**
22   * After returning advice is invoked only on normal method return, not if an
23   * exception is thrown. Such advice can see the return value, but cannot change it.
24   *
25   * @author Rod Johnson
26   * @see MethodBeforeAdvice
27   * @see ThrowsAdvice
28   */
29  public interface AfterReturningAdvice extends AfterAdvice {
30  
31      /**
32       * Callback after a given method successfully returned.
33       * @param returnValue the value returned by the method, if any
34       * @param method method being invoked
35       * @param args arguments to the method
36       * @param target target of the method invocation. May be <code>null</code>.
37       * @throws Throwable if this object wishes to abort the call.
38       * Any exception thrown will be returned to the caller if it's
39       * allowed by the method signature. Otherwise the exception
40       * will be wrapped as a runtime exception.
41       */
42      void afterReturning(Object   returnValue, Method   method, Object  [] args, Object   target) throws Throwable  ;
43  
44  }
45
A to Z: JavaDoc & Examples Daily Java News & Articles Open Source Projects Open Source Codes Free Computer Books Remove Frame
Popular Tags