org.jboss.aop.joinpoint
Class ConstructorInvocationWrapper

java.lang.Object
  extended by org.jboss.aop.joinpoint.InvocationBase
      extended by org.jboss.aop.joinpoint.ConstructorInvocation
          extended by org.jboss.aop.joinpoint.ConstructorInvocationWrapper
All Implemented Interfaces:
Serializable, Invocation

public class ConstructorInvocationWrapper
extends ConstructorInvocation

Comment

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

Field Summary
 
Fields inherited from class org.jboss.aop.joinpoint.ConstructorInvocation
arguments, constructor
 
Fields inherited from class org.jboss.aop.joinpoint.InvocationBase
advisor, currentInterceptor, instanceResolver, interceptors, metadata, responseContextInfo, targetObject
 
Constructor Summary
ConstructorInvocationWrapper(ConstructorInvocation wrapped, Interceptor[] interceptors)
           
 
Method Summary
 void addResponseAttachment(Object key, Object val)
           
 Invocation copy()
          Copies complete state of Invocation object.
 Advisor getAdvisor()
           
 Object[] getArguments()
          Returns a non-null array containing all constructor arguments.
 Constructor<?> getConstructor()
           
 MetaDataResolver getInstanceResolver()
           
 SimpleMetaData getMetaData()
          Return all the contextual data attached to this invocation
 Object getMetaData(Object group, Object attr)
          This method resolves metadata based on the context of the invocation.
 Object getResponseAttachment(Object key)
           
 Map<Object,Object> getResponseContextInfo()
           
 Object getTargetObject()
           
 Object invokeNext()
          Invoke on the next interceptor in the chain.
 void setArguments(Object[] args)
          Replaces constructor argument values by the ones contained in arguments.
 void setConstructor(Constructor<?> constructor)
           
 void setMetaData(SimpleMetaData data)
          Set all the contextual data attached to this invocation
 void setResponseContextInfo(Map<Object,Object> responseContextInfo)
           
 void setTargetObject(Object targetObject)
           
 
Methods inherited from class org.jboss.aop.joinpoint.ConstructorInvocation
getWrapper, invokeTarget, resolveAnnotation, resolveTypedAnnotation
 
Methods inherited from class org.jboss.aop.joinpoint.InvocationBase
getCurrentInterceptor, getInterceptors, invokeNext, resolveAnnotation, resolveClassAnnotation, resolveClassMetaData, resolveTypedAnnotation, resolveTypedClassAnnotation, setAdvisor, setInstanceResolver
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ConstructorInvocationWrapper

public ConstructorInvocationWrapper(ConstructorInvocation wrapped,
                                    Interceptor[] interceptors)
Method Detail

getMetaData

public Object getMetaData(Object group,
                          Object attr)
Description copied from class: ConstructorInvocation
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 ConstructorInvocation

invokeNext

public Object invokeNext()
                  throws Throwable
Description copied from class: ConstructorInvocation
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 ConstructorInvocation
Throws:
Throwable

getInstanceResolver

public MetaDataResolver getInstanceResolver()
Overrides:
getInstanceResolver in class InvocationBase

getArguments

public Object[] getArguments()
Description copied from class: ConstructorInvocation
Returns a non-null array containing all constructor arguments.

The returned array can be changed by the advice or interceptor accordingly. All changes are reflected on joinpoint execution, and are noticed as well by other advices and interceptors that are executed after the current one.
However, changes to this array are limited to the scope of current advice execution, and must be performed before execution of ConstructorInvocation.invokeNext(), InvocationBase.invokeNext(Interceptor[]), or ConstructorInvocation.invokeTarget() method. Otherwise, inconsistency on joinpoint argument values may be noticed.

Overrides:
getArguments in class ConstructorInvocation
Returns:
the constructor arguments

setArguments

public void setArguments(Object[] args)
Description copied from class: ConstructorInvocation
Replaces constructor argument values by the ones contained in arguments.

Advices and interceptors must be aware that, for performance reasons, this array does not get copied across; its reference is directly used instead. Hence, changes to arguments array after this method being called are forbidden. Otherwise, inconsistency on joinpoint argument values may be noticed.

Overrides:
setArguments in class ConstructorInvocation
Parameters:
args - a non-null array containing the new values of constructor arguments. The size of this array must be the same as the one of ConstructorInvocation.getArguments(), as well as the element types.

copy

public Invocation copy()
Description copied from class: ConstructorInvocation
Copies complete state of Invocation object.

Specified by:
copy in interface Invocation
Overrides:
copy in class ConstructorInvocation
Returns:
a copy of this instance

getConstructor

public Constructor<?> getConstructor()
Overrides:
getConstructor in class ConstructorInvocation

setConstructor

public void setConstructor(Constructor<?> constructor)
Overrides:
setConstructor in class ConstructorInvocation

getResponseContextInfo

public Map<Object,Object> getResponseContextInfo()
Specified by:
getResponseContextInfo in interface Invocation
Overrides:
getResponseContextInfo in class InvocationBase

setResponseContextInfo

public void setResponseContextInfo(Map<Object,Object> responseContextInfo)
Specified by:
setResponseContextInfo in interface Invocation
Overrides:
setResponseContextInfo in class InvocationBase

addResponseAttachment

public void addResponseAttachment(Object key,
                                  Object val)
Specified by:
addResponseAttachment in interface Invocation
Overrides:
addResponseAttachment in class InvocationBase

getResponseAttachment

public Object getResponseAttachment(Object key)
Specified by:
getResponseAttachment in interface Invocation
Overrides:
getResponseAttachment in class InvocationBase

getMetaData

public SimpleMetaData getMetaData()
Description copied from class: InvocationBase
Return all the contextual data attached to this invocation

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

setMetaData

public void setMetaData(SimpleMetaData data)
Description copied from class: InvocationBase
Set all the contextual data attached to this invocation

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

getAdvisor

public Advisor getAdvisor()
Specified by:
getAdvisor in interface Invocation
Overrides:
getAdvisor in class InvocationBase

getTargetObject

public Object getTargetObject()
Specified by:
getTargetObject in interface Invocation
Overrides:
getTargetObject in class InvocationBase

setTargetObject

public void setTargetObject(Object targetObject)
Specified by:
setTargetObject in interface Invocation
Overrides:
setTargetObject in class InvocationBase


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