org.springframework.aop
Interface MethodMatcher

public interface MethodMatcher
Part of a Pointcut. Checks whether the target method is eligible for advice.

A MethodMatcher may be evaluated statically or at runtime (dynamically). Static matching involves method and (possibly) method attributes. Dynamic matching also makes arguments for a particular call available, and any effects of running previous advice applying to the joinpoint.

If an implementation returns false in its isRuntime() method, evaluation can be performed statically, and the result will be the same for all invocations of this method, whatever their arguments. If the isRuntime() method returns false, the 3-arg matches() method will never be invoked.

If an implementation returns true in its 2-arg matches() method, and its isRuntime() method returns true, the 3-argument matches() method will be invoked immediately before each potential execution of the related advice, to decide whether the advice should run. All previous advice, such as earlier interceptors in an interceptor chain, will have run, so any state changes they have produced in parameters or ThreadLocal state, will be available at the time of evaluation.

Since11.11.2003
VersionNot specified.
AuthorRod Johnson
Wiki javadoc Use textile entry format.
Add your comments here.
Field Summary
static MethodMatcher TRUE
Canonical instance that matches all methods.
Method Summary
boolean isRuntime()
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,
boolean matches( Method method, Class targetClass )
Perform static checking.
boolean matches( Method method, Class targetClass, Object [] args )
Is there a runtime (dynamic) match for this method, which must have matched statically.
TRUE
public static MethodMatcher TRUE
Canonical instance that matches all methods.
Wiki javadoc Use textile entry format.
Add your comments here.
isRuntime
public boolean isRuntime ( )
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.

Wiki javadoc Use textile entry format.
Add your comments here.
matches
public boolean matches ( Method method, Class targetClass )
Perform static checking. If this returns false, or if the isRuntime() method returns false, no runtime check will be made.
Parameters
TypeNameDescription
Method method the candidate method
Class targetClass target class (may be null, in which case the candidate class must be taken to be the method's declaring class)
Wiki javadoc Use textile entry format.
Add your comments here.
matches
public boolean matches ( Method method, Class targetClass, Object [] args )
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.
Parameters
TypeNameDescription
Method method the candidate method
Class targetClass target class
Object [] args arguments to the method
Wiki javadoc Use textile entry format.
Add your comments here.