org.jboss.aop.joinpoint
Class ConstructorCalledByMethodInvocation

java.lang.Object
  org.jboss.aop.joinpoint.InvocationBase
      org.jboss.aop.joinpoint.CallerInvocation
          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