Package org.springframework.aop.support
Class ControlFlowPointcut
java.lang.Object
org.springframework.aop.support.ControlFlowPointcut
- All Implemented Interfaces:
Serializable
,ClassFilter
,MethodMatcher
,Pointcut
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, Rob Harrop, Juergen Hoeller, Sam Brannen
- See Also:
-
Field Summary
Fields inherited from interface org.springframework.aop.ClassFilter
TRUE
Fields inherited from interface org.springframework.aop.MethodMatcher
TRUE
-
Constructor Summary
ConstructorDescriptionControlFlowPointcut
(Class<?> clazz) Construct a new pointcut that matches all control flows below that class.ControlFlowPointcut
(Class<?> clazz, String methodName) Construct a new pointcut that matches all calls below the given method in the given class. -
Method Summary
Modifier and TypeMethodDescriptionboolean
Return the ClassFilter for this pointcut.int
It's useful to know how many times we've fired, for optimization.Return the MethodMatcher for this pointcut.int
hashCode()
boolean
Is this MethodMatcher dynamic, that is, must a final call be made on theMethodMatcher.matches(java.lang.reflect.Method, Class, Object[])
method at runtime even if the 2-arg matches method returnstrue
?boolean
Subclasses can override this for greater filtering (and performance).boolean
Subclasses can override this if it's possible to filter out some candidate classes.boolean
Check whether there a runtime (dynamic) match for this method, which must have matched statically.toString()
-
Constructor Details
-
ControlFlowPointcut
Construct a new pointcut that matches all control flows below that class.- Parameters:
clazz
- the clazz
-
ControlFlowPointcut
Construct a new pointcut that matches all calls below the given method in the given class. If no method name is given, matches all control flows below the given class.- Parameters:
clazz
- the clazzmethodName
- the name of the method (may benull
)
-
-
Method Details
-
matches
Subclasses can override this for greater filtering (and performance).- Specified by:
matches
in interfaceClassFilter
- Parameters:
clazz
- the candidate target class- Returns:
- whether the advice should apply to the given target class
-
matches
Subclasses can override this if it's possible to filter out some candidate classes.- Specified by:
matches
in interfaceMethodMatcher
- Parameters:
method
- the candidate methodtargetClass
- the target class- Returns:
- whether or not this method matches statically
-
isRuntime
public boolean isRuntime()Description copied from interface:MethodMatcher
Is this MethodMatcher dynamic, that is, must a final call be made on theMethodMatcher.matches(java.lang.reflect.Method, Class, Object[])
method at runtime even if the 2-arg matches method returnstrue
?Can be invoked when an AOP proxy is created, and need not be invoked again before each method invocation,
- Specified by:
isRuntime
in interfaceMethodMatcher
- Returns:
- whether or not a runtime match via the 3-arg
MethodMatcher.matches(java.lang.reflect.Method, Class, Object[])
method is required if static matching passed
-
matches
Description copied from interface:MethodMatcher
Check whether 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 theMethodMatcher.isRuntime()
method returnstrue
. Invoked immediately before potential running of the advice, after any advice earlier in the advice chain has run.- Specified by:
matches
in interfaceMethodMatcher
- Parameters:
method
- the candidate methodtargetClass
- the target classargs
- arguments to the method- Returns:
- whether there's a runtime match
- See Also:
-
getEvaluations
public int getEvaluations()It's useful to know how many times we've fired, for optimization. -
getClassFilter
Description copied from interface:Pointcut
Return the ClassFilter for this pointcut.- Specified by:
getClassFilter
in interfacePointcut
- Returns:
- the ClassFilter (never
null
)
-
getMethodMatcher
Description copied from interface:Pointcut
Return the MethodMatcher for this pointcut.- Specified by:
getMethodMatcher
in interfacePointcut
- Returns:
- the MethodMatcher (never
null
)
-
equals
-
hashCode
public int hashCode() -
toString
-