org.aspectj.lang
Interface JoinPoint

All Known Subinterfaces:
JoinPoint
All Known Implementing Classes:
JoinPointImpl, JoinPointImpl, JoinPointImpl.StaticPartImpl

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());
     }
 }
 


Nested Class Summary
static interface JoinPoint.StaticPart
          This helper object contains only the static information about a join point.
 
Field Summary
static java.lang.String ADVICE_EXECUTION
           
static java.lang.String CONSTRUCTOR_CALL
           
static java.lang.String CONSTRUCTOR_EXECUTION
           
static java.lang.String EXCEPTION_HANDLER
           
static java.lang.String FIELD_GET
           
static java.lang.String FIELD_SET
           
static java.lang.String INITIALIZATION
           
static java.lang.String METHOD_CALL
           
static java.lang.String METHOD_EXECUTION
          The legal return values from getKind()
static java.lang.String PREINTIALIZATION
           
static java.lang.String STATICINITIALIZATION
           
 
Method Summary
 java.lang.Object[] getArgs()
          Returns the arguments at this join point.
 java.lang.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
 java.lang.Object getTarget()
           Returns the target object.
 java.lang.Object getThis()
           Returns the currently executing object.
 java.lang.String toLongString()
          Returns an extended string representation of the join point.
 java.lang.String toShortString()
          Returns an abbreviated string representation of the join point.
 java.lang.String toString()
           
 

Field Detail

METHOD_EXECUTION

public static final java.lang.String METHOD_EXECUTION
The legal return values from getKind()

See Also:
Constant Field Values

METHOD_CALL

public static final java.lang.String METHOD_CALL
See Also:
Constant Field Values

CONSTRUCTOR_EXECUTION

public static final java.lang.String CONSTRUCTOR_EXECUTION
See Also:
Constant Field Values

CONSTRUCTOR_CALL

public static final java.lang.String CONSTRUCTOR_CALL
See Also:
Constant Field Values

FIELD_GET

public static final java.lang.String FIELD_GET
See Also:
Constant Field Values

FIELD_SET

public static final java.lang.String FIELD_SET
See Also:
Constant Field Values

STATICINITIALIZATION

public static final java.lang.String STATICINITIALIZATION
See Also:
Constant Field Values

PREINTIALIZATION

public static final java.lang.String PREINTIALIZATION
See Also:
Constant Field Values

INITIALIZATION

public static final java.lang.String INITIALIZATION
See Also:
Constant Field Values

EXCEPTION_HANDLER

public static final java.lang.String EXCEPTION_HANDLER
See Also:
Constant Field Values

ADVICE_EXECUTION

public static final java.lang.String ADVICE_EXECUTION
See Also:
Constant Field Values
Method Detail

toString

public java.lang.String toString()

toShortString

public java.lang.String toShortString()
Returns an abbreviated string representation of the join point.


toLongString

public java.lang.String toLongString()
Returns an extended string representation of the join point.


getThis

public java.lang.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 java.lang.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 java.lang.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 java.lang.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