org.aspectj.weaver.tools

Interface StandardPointcutExpression

All Known Implementing Classes:

StandardPointcutExpressionImpl

public interface StandardPointcutExpression

Represents an AspectJ pointcut expression and provides convenience methods to determine whether or not the pointcut matches join points specified in terms of the java.lang.reflect interfaces.

Method Summary

Modifier and Type	Method and Description
boolean	couldMatchJoinPointsInType(java.lang.Class aClass) Determine whether or not this pointcut could ever match a join point in the given class.
java.lang.String	getPointcutExpression() Return a string representation of this pointcut expression.
ShadowMatch	matchesMethodCall(ResolvedMember aMethod, ResolvedMember withinCode) Determine whether or not this pointcut matches a method call to the given method, made during the execution of the given method or constructor.
ShadowMatch	matchesMethodExecution(ResolvedMember aMethod) Determine whether or not this pointcut matches the execution of a given method.
ShadowMatch	matchesStaticInitialization(ResolvedType aType) Determine whether or not this pointcut matches the static initialization of the given class.
boolean	mayNeedDynamicTest() Returns true iff this pointcut contains any expression that might necessitate a dynamic test at some join point (e.g.
void	setMatchingContext(MatchingContext aMatchContext) Set the matching context to be used for subsequent calls to match.

Method Detail

setMatchingContext

void setMatchingContext(MatchingContext aMatchContext)

Set the matching context to be used for subsequent calls to match.

See Also:

MatchingContext

couldMatchJoinPointsInType

boolean couldMatchJoinPointsInType(java.lang.Class aClass)

Determine whether or not this pointcut could ever match a join point in the given class.

Parameters:

aClass - the candidate class

Returns:

true iff this pointcut may match a join point within(aClass), and false otherwise

mayNeedDynamicTest

boolean mayNeedDynamicTest()

Returns true iff this pointcut contains any expression that might necessitate a dynamic test at some join point (e.g. args)

matchesMethodExecution

ShadowMatch matchesMethodExecution(ResolvedMember aMethod)

Determine whether or not this pointcut matches the execution of a given method.

Parameters:

aMethod - the method being executed

Returns:

a ShadowMatch indicating whether the pointcut always, sometimes, or never matches join points representing the execution of the method.

matchesStaticInitialization

ShadowMatch matchesStaticInitialization(ResolvedType aType)

Determine whether or not this pointcut matches the static initialization of the given class.

Parameters:

aClass - the class being statically initialized

Returns:

a ShadowMatch indicating whether the pointcut always, sometimes, or never matchs join points representing the static initialization of the given type

matchesMethodCall

ShadowMatch matchesMethodCall(ResolvedMember aMethod,
                              ResolvedMember withinCode)

Determine whether or not this pointcut matches a method call to the given method, made during the execution of the given method or constructor.

Parameters:

aMethod - the method being called

withinCode - the Method or Constructor from within which the call is made

Returns:

a ShadowMatch indicating whether the pointcut always, sometimes, or never matches join points representing a call to this method during the execution of the given member.

getPointcutExpression

java.lang.String getPointcutExpression()

Return a string representation of this pointcut expression.