org.aopalliance.intercept.Joinpoint Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of ehcache Show documentation

Ehcache is an open source, standards-based cache used to boost performance, offload the database and simplify scalability. Ehcache is robust, proven and full-featured and this has made it the most widely-used Java-based cache.

There is a newer version: 2.10.9.2

Show newest version


package org.aopalliance.intercept;

import java.lang.reflect.AccessibleObject;

/**
 * This interface represents a generic runtime joinpoint (in the AOP
 * terminology).
 *
 * A runtime joinpoint is an event that occurs on a static
 * joinpoint (i.e. a location in a the program). For instance, an
 * invocation is the runtime joinpoint on a method (static joinpoint).
 * The static part of a given joinpoint can be generically retrieved
 * using the {@link #getStaticPart()} method.
 *
 * 
In the context of an interception framework, a runtime joinpoint
 * is then the reification of an access to an accessible object (a
 * method, a constructor, a field), i.e. the static part of the
 * joinpoint. It is passed to the interceptors that are installed on
 * the static joinpoint.
 *
 * @see Interceptor */

public interface Joinpoint {

   /**
    * Proceeds to the next interceptor in the chain.
    *
    * 
The implementation and the semantics of this method depends
    * on the actual joinpoint type (see the children interfaces).
    *
    * @return see the children interfaces' proceed definition.
    *
    * @throws Throwable if the joinpoint throws an exception. */
   Object proceed() throws Throwable;

   /**
    * Returns the object that holds the current joinpoint's static
    * part.
    *
    * 
For instance, the target object for an invocation.
    *
    * @return the object (can be null if the accessible object is
    * static). */
   Object getThis();

   /**
    * Returns the static part of this joinpoint.
    *
    * The static part is an accessible object on which a chain of
    * interceptors are installed. */
   AccessibleObject getStaticPart();   

}