org.aspectj.lang
Interface JoinPoint

public interface JoinPoint

Provides reflective access to both the state available at a join point and static information about it. This information is available from the body of advice using the special form thisJoinPoint. The primary use of this reflective information is for tracing and logging applications.

 aspect Logging {
     before(): within(com.bigboxco..*) && execution(public * *(..)) {
         System.err.println("entering: " + thisJoinPoint);
         System.err.println("  w/args: " + thisJoinPoint.getArgs());
         System.err.println("      at: " + thisJoinPoint.getSourceLocation());
     }
 }
 

Inner Class Summary

static interface

JoinPoint.StaticPart This helper object contains only the static information about a join point.

Field Summary

static String	ADVICE_EXECUTION
static String	CONSTRUCTOR_CALL
static String	CONSTRUCTOR_EXECUTION
static String	EXCEPTION_HANDLER
static String	FIELD_GET
static String	FIELD_SET
static String	INITIALIZATION
static String	METHOD_CALL
static String	METHOD_EXECUTION The legal return values from getKind()
static String	PREINTIALIZATION
static String	STATICINITIALIZATION

Method Summary

Object[]	getArgs() Returns the arguments at this join point.
String	getKind() Returns a String representing the kind of join point.
Signature	getSignature() Returns the signature at the join point.
SourceLocation	getSourceLocation() Returns the source location corresponding to the join point.
JoinPoint.StaticPart	getStaticPart() Returns an object that encapsulates the static parts of this join point.
Object	getTarget() Returns the target object.
Object	getThis() Returns the currently executing object.
String	toLongString() Returns an extended string representation of the join point.
String	toShortString() Returns an abbreviated string representation of the join point.
String	toString()

Field Detail

METHOD_EXECUTION

public static final String METHOD_EXECUTION

The legal return values from getKind()

METHOD_CALL

public static final String METHOD_CALL

CONSTRUCTOR_EXECUTION

public static final String CONSTRUCTOR_EXECUTION

CONSTRUCTOR_CALL

public static final String CONSTRUCTOR_CALL

FIELD_GET

public static final String FIELD_GET

FIELD_SET

public static final String FIELD_SET

STATICINITIALIZATION

public static final String STATICINITIALIZATION

PREINTIALIZATION

public static final String PREINTIALIZATION

INITIALIZATION

public static final String INITIALIZATION

EXCEPTION_HANDLER

public static final String EXCEPTION_HANDLER

ADVICE_EXECUTION

public static final String ADVICE_EXECUTION

Method Detail

toString

public String toString()

Overrides:

toString in class Object

toShortString

public String toShortString()

Returns an abbreviated string representation of the join point.

toLongString

public String toLongString()

Returns an extended string representation of the join point.

getThis

public Object getThis()

Returns the currently executing object. This will always be the same object as that matched by the this pointcut designator. Unless you specifically need this reflective access, you should use the this pointcut designator to get at this object for better static typing and performance.

Returns null when there is no currently executing object available. This includes all join points that occur in a static context.

getTarget

public Object getTarget()

Returns the target object. This will always be the same object as that matched by the target pointcut designator. Unless you specifically need this reflective access, you should use the target pointcut designator to get at this object for better static typing and performance.

Returns null when there is no target object.

getArgs

public Object[] getArgs()

Returns the arguments at this join point.

getSignature

public Signature getSignature()

Returns the signature at the join point. getStaticPart().getSignature() returns the same object

getSourceLocation

public SourceLocation getSourceLocation()

Returns the source location corresponding to the join point.

If there is no source location available, returns null.

Returns the SourceLocation of the defining class for default constructors.

getStaticPart().getSourceLocation() returns the same object.

getKind

public String getKind()

Returns a String representing the kind of join point. This String is guaranteed to be interned. getStaticPart().getKind() returns the same object.

getStaticPart

public JoinPoint.StaticPart getStaticPart()

Returns an object that encapsulates the static parts of this join point.