org.springframework.aop.support
Class ControlFlowPointcut

java.lang.Object
  extended byorg.springframework.aop.support.ControlFlowPointcut
All Implemented Interfaces:
ClassFilter, MethodMatcher, Pointcut, Serializable

public class ControlFlowPointcut
extends Object
implements Pointcut, ClassFilter, MethodMatcher, Serializable

Pointcut and method matcher for use in simple cflow-style pointcut. Note that evaluating such pointcuts is 10-15 times slower than evaluating normal pointcuts, but they are useful in some cases.

Author:
Rod Johnson
See Also:
ControlFlow, Serialized Form

Field Summary
 
Fields inherited from interface org.springframework.aop.Pointcut
TRUE
 
Fields inherited from interface org.springframework.aop.ClassFilter
TRUE
 
Fields inherited from interface org.springframework.aop.MethodMatcher
TRUE
 
Constructor Summary
ControlFlowPointcut(Class clazz)
           
ControlFlowPointcut(Class clazz, String methodName)
          Construct a new pointcut that matches all calls below the given method in the given class.
 
Method Summary
 ClassFilter getClassFilter()
           
 int getEvaluations()
          It's useful to know how many times we've fired, for optimization.
 MethodMatcher getMethodMatcher()
           
 boolean isRuntime()
          Is this MethodMatcher dynamic?
 boolean matches(Class clazz)
          Subclasses can override this for greater filtering (and performance).
 boolean matches(Method method, Class targetClass)
          Subclasses can override this if it's possible to filter out some candidate classes.
 boolean matches(Method method, Class targetClass, Object[] args)
          Is there a runtime (dynamic) match for this method, which must have matched statically.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ControlFlowPointcut

public ControlFlowPointcut(Class clazz)

ControlFlowPointcut

public ControlFlowPointcut(Class clazz,
                           String methodName)
Construct a new pointcut that matches all calls below the given method in the given class. If the method name is null, matches all control flows below that class.

Parameters:
clazz -
methodName -
Method Detail

matches

public boolean matches(Class clazz)
Subclasses can override this for greater filtering (and performance).

Specified by:
matches in interface ClassFilter
Parameters:
clazz - candidate target class
Returns:
whether the advice should apply to this candidate target class

matches

public boolean matches(Method method,
                       Class targetClass)
Subclasses can override this if it's possible to filter out some candidate classes.

Specified by:
matches in interface MethodMatcher
Parameters:
method - the candidate method
targetClass - target class (may be null, in which case the candidate class must be taken to be the method's declaring class)
Returns:
whether or not this method matches statically

isRuntime

public boolean isRuntime()
Description copied from interface: MethodMatcher
Is this MethodMatcher dynamic? Must a final call be made on the matches(Method, Class, Object[]) method at runtime even if the 2-arg matches method returns true? Can be invoked when an AOP proxy is created, and need not be invoked again before each method invocation,

Note: Could be pulled up into a Matcher super-interface to apply to fields also.

Specified by:
isRuntime in interface MethodMatcher
Returns:
whether or not a runtime matche via the 3-arg matches() method is required if static matching passed.

matches

public boolean matches(Method method,
                       Class targetClass,
                       Object[] args)
Description copied from interface: MethodMatcher
Is there a runtime (dynamic) match for this method, which must have matched statically. This method is invoked only if the 2-arg matches method returns true for the given method and target class, and if the isRuntime() method returns true. Invoked immediately before potentially running of the advice, after any advice earlier in the advice chain has run.

Specified by:
matches in interface MethodMatcher
Parameters:
method - the candidate method
targetClass - target class
args - arguments to the method
Returns:
whether there's a runtime match
See Also:
MethodMatcher.matches(Method, Class)

getEvaluations

public int getEvaluations()
It's useful to know how many times we've fired, for optimization.


getClassFilter

public ClassFilter getClassFilter()
Specified by:
getClassFilter in interface Pointcut

getMethodMatcher

public MethodMatcher getMethodMatcher()
Specified by:
getMethodMatcher in interface Pointcut


Copyright (C) 2003-2004 The Spring Framework Project.