org.jboss.aop.joinpoint
Class ConstructorCalledByMethodInvocation

java.lang.Object
  extended by org.jboss.aop.joinpoint.InvocationBase
      extended by org.jboss.aop.joinpoint.CallerInvocation
          extended by org.jboss.aop.joinpoint.ConstructorCalledByMethodInvocation
All Implemented Interfaces:
Serializable, Invocation
Direct Known Subclasses:
ConstructorCalledByMethodInvocationWrapper

public class ConstructorCalledByMethodInvocation
extends CallerInvocation

This is a helper wrapper class for an Invocation object. It is used to add or get values or metadata that pertains to an AOP method invocation.

Version:
$Revision: 70849 $
Author:
Bill Burke
See Also:
Serialized Form

Field Summary
protected  Class<?> callingClass
           
protected  Method callingMethod
           
protected  Constructor<?> constructor
           
protected  Method wrappingMethod
           
 
Fields inherited from class org.jboss.aop.joinpoint.CallerInvocation
arguments, callingObject
 
Fields inherited from class org.jboss.aop.joinpoint.InvocationBase
advisor, currentInterceptor, instanceResolver, interceptors, metadata, responseContextInfo, targetObject
 
Constructor Summary
ConstructorCalledByMethodInvocation(Advisor advisor, Class<?> callingClass, Method callingMethod, Constructor<?> constructor, Method wrappingMethod, Object callingObject, Object[] args, Interceptor[] interceptors)
           
ConstructorCalledByMethodInvocation(ConByMethodInfo info, Object callingObject, Interceptor[] interceptors)
           
ConstructorCalledByMethodInvocation(ConByMethodInfo info, Object callingObject, Object[] args, Interceptor[] interceptors)
           
ConstructorCalledByMethodInvocation(Object callingObject, Interceptor[] interceptors)
           
 
Method Summary
 Invocation copy()
          Copies complete state of Invocation object.
 Constructor<?> getCalledConstructor()
           
 Class<?> getCallingClass()
           
 Method getCallingMethod()
           
 Object getMetaData(Object group, Object attr)
          This method resolves metadata based on the context of the invocation.
 Invocation getWrapper(Interceptor[] newchain)
          Returns a wrapper invocation object that can insert a new chain of interceptors at runtime to the invocation flow.
 Method getWrappingMethod()
          Is the called constructor aspectized? If so then this method returns the method that wraps the constructor.
 Object invokeNext()
          Invoke on the next interceptor in the chain.
 Object invokeTarget()
          Invokes the target joinpoint for this invocation skipping any subsequent interceptors in the chain.
 boolean isWrapped()
          Is the called constructor aspectized? If so then there is a wrapping method that must be called.
 
Methods inherited from class org.jboss.aop.joinpoint.CallerInvocation
getArguments, getCallingObject, setArguments
 
Methods inherited from class org.jboss.aop.joinpoint.InvocationBase
addResponseAttachment, getAdvisor, getCurrentInterceptor, getInstanceResolver, getInterceptors, getMetaData, getResponseAttachment, getResponseContextInfo, getTargetObject, invokeNext, resolveAnnotation, resolveAnnotation, resolveClassAnnotation, resolveClassMetaData, resolveTypedAnnotation, resolveTypedAnnotation, resolveTypedClassAnnotation, setAdvisor, setInstanceResolver, setMetaData, setResponseContextInfo, setTargetObject
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

callingClass

protected Class<?> callingClass

callingMethod

protected Method callingMethod

constructor

protected Constructor<?> constructor

wrappingMethod

protected Method wrappingMethod
Constructor Detail

ConstructorCalledByMethodInvocation

public ConstructorCalledByMethodInvocation(ConByMethodInfo info,
                                           Object callingObject,
                                           Object[] args,
                                           Interceptor[] interceptors)

ConstructorCalledByMethodInvocation

public ConstructorCalledByMethodInvocation(ConByMethodInfo info,
                                           Object callingObject,
                                           Interceptor[] interceptors)

ConstructorCalledByMethodInvocation

public ConstructorCalledByMethodInvocation(Advisor advisor,
                                           Class<?> callingClass,
                                           Method callingMethod,
                                           Constructor<?> constructor,
                                           Method wrappingMethod,
                                           Object callingObject,
                                           Object[] args,
                                           Interceptor[] interceptors)

ConstructorCalledByMethodInvocation

public ConstructorCalledByMethodInvocation(Object callingObject,
                                           Interceptor[] interceptors)
Method Detail

getCallingClass

public Class<?> getCallingClass()
Returns:
The class that is making the call on the constructor

getCallingMethod

public Method getCallingMethod()
Returns:
The method that is making the call on the constructor

getCalledConstructor

public Constructor<?> getCalledConstructor()
Returns:
the constructor call being executed by the calling method

isWrapped

public boolean isWrapped()
Is the called constructor aspectized? If so then there is a wrapping method that must be called.

Returns:
true if the constructor is wrapped

getWrappingMethod

public Method getWrappingMethod()
Is the called constructor aspectized? If so then this method returns the method that wraps the constructor.

Returns:
the method that wraps the constructor if isWrapped() returns true; null otherwise.

invokeNext

public Object invokeNext()
                  throws Throwable
Invoke on the next interceptor in the chain. If this is already the end of the chain, reflection will call the constructor, field, or method you are invoking on.

Specified by:
invokeNext in interface Invocation
Overrides:
invokeNext in class InvocationBase
Throws:
Throwable

invokeTarget

public Object invokeTarget()
                    throws Throwable
Invokes the target joinpoint for this invocation skipping any subsequent interceptors in the chain.

Specified by:
invokeTarget in interface Invocation
Overrides:
invokeTarget in class InvocationBase
Throws:
Throwable

getMetaData

public Object getMetaData(Object group,
                          Object attr)
This method resolves metadata based on the context of the invocation. It iterates through its list of MetaDataResolvers to find out the value of the metadata desired.

This list usually is ThreadMetaData, InstanceAdvisor.getMetaData ClassAdvisor.getMethodMetaData (or field, or constructor) ClassAdvisor.getDefaultMetaData

Specified by:
getMetaData in interface Invocation
Overrides:
getMetaData in class InvocationBase

getWrapper

public Invocation getWrapper(Interceptor[] newchain)
Returns a wrapper invocation object that can insert a new chain of interceptors at runtime to the invocation flow. CFlow makes use of this. When the wrapper object finishes its invocation chain it delegates back to the wrapped invocation.

Parameters:
newchain - chain of interceptors to be inserted on invocation
Returns:
an invocation wrapper

copy

public Invocation copy()
Copies complete state of Invocation object.

Returns:
a copy of this instance


Copyright © 2008 JBoss, a division of Red Hat, Inc.. All Rights Reserved.