org.jboss.invocation.pooled.interfaces
Class PooledMarshalledInvocation

java.lang.Object
  org.jboss.invocation.Invocation
      org.jboss.invocation.MarshalledInvocation
          org.jboss.invocation.pooled.interfaces.PooledMarshalledInvocation

All Implemented Interfaces:

Externalizable, Serializable

public class PooledMarshalledInvocation

extends MarshalledInvocation

implements Externalizable

The MarshalledInvocation is an invocation that travels. As such it serializes its payload because of lack of ClassLoader visibility. As such it contains Marshalled data representing the byte[] of the Invocation object it extends Besides handling the specifics of "marshalling" the payload, which could be done at the Invocation level the Marshalled Invocation can hold optimization and needed code for distribution for example the TransactionPropagationContext which is a serialization of the TX for distribution purposes as well as the "hash" for the methods that we send, as opposed to sending Method objects. Serialization "optimizations" should be coded here in the externalization implementation of the class

Version:

$Revision: 1.1.2.1 $ Revisions:

Revisions:

2001120 marc fleury:

• Initial check-in

20020113 Sacha Labourey:

• Make Externalizable calls (writeExternal) idempotent: until now, serialization on a MarshalledInvocation could only performed once (transaction was removed and METHOD type was modified). If another call was re-using the same object (in clustering for example), the call was making a ClassCastException because of the changed METHOD type in the Map that occured in the previous call to writeExternal)

20020911 Bill Burke:

• Optimize access to certain variables. Avoid hash lookups.

Author:

Marc Fleury

See Also:

, Serialized Form

Field Summary

Fields inherited from class org.jboss.invocation.MarshalledInvocation

marshalledArgs, methodHash, methodMap, tpc

Fields inherited from class org.jboss.invocation.Invocation

args, as_is_payload, invocationContext, invocationType, INVOKE_SIGNATURE, method, objectName, payload, transient_payload

Constructor Summary

PooledMarshalledInvocation()

PooledMarshalledInvocation(Invocation invocation)

PooledMarshalledInvocation(Object id, Method m, Object[] args, Transaction tx, Principal identity, Object credential)

Method Summary

Object[]	getArguments()
Object	getCredential()
Object	getEnterpriseContext()
Object	getId()
Principal	getPrincipal()
Transaction	getTransaction() get the transaction.
void	readExternal(ObjectInput in)
void	setCredential(Object credential) Change the security credentials of this invocation.
void	setEnterpriseContext(Object enterpriseContext)
void	setId(Object id) Return the invocation target ID.
void	setPrincipal(Principal principal) Change the security identity of this invocation.
void	setTransaction(Transaction tx) set the transaction.
void	writeExternal(ObjectOutput out)

Methods inherited from class org.jboss.invocation.MarshalledInvocation

calculateHash, getFullInterfaceHashes, getInterfaceHashes, getMethod, getPayloadValue, getTransactionPropagationContext, getUseFullHashMode, getValue, methodToHashesMap, removeHashes, setMethodMap, setTransactionPropagationContext, setUseFullHashMode

Methods inherited from class org.jboss.invocation.Invocation

getAsIsPayload, getAsIsValue, getInvocationContext, getObjectName, getPayload, getTransientPayload, getTransientValue, getType, isLocal, setArguments, setInvocationContext, setMethod, setObjectName, setType, setValue, setValue

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

PooledMarshalledInvocation

public PooledMarshalledInvocation()

PooledMarshalledInvocation

public PooledMarshalledInvocation(Invocation invocation)

PooledMarshalledInvocation

public PooledMarshalledInvocation(Object id,
                                  Method m,
                                  Object[] args,
                                  Transaction tx,
                                  Principal identity,
                                  Object credential)

Method Detail

getEnterpriseContext

public Object getEnterpriseContext()

Overrides:

getEnterpriseContext in class Invocation

setEnterpriseContext

public void setEnterpriseContext(Object enterpriseContext)

Overrides:

setEnterpriseContext in class Invocation

getId

public Object getId()

Overrides:

getId in class Invocation

setId

public void setId(Object id)

Description copied from class: Invocation

Return the invocation target ID. Can be used to identify a cached object

Overrides:

setId in class Invocation

setTransaction

public void setTransaction(Transaction tx)

Description copied from class: Invocation

set the transaction.

Overrides:

setTransaction in class Invocation

getTransaction

public Transaction getTransaction()

Description copied from class: Invocation

get the transaction.

Overrides:

getTransaction in class Invocation

getCredential

public Object getCredential()

Overrides:

getCredential in class Invocation

setCredential

public void setCredential(Object credential)

Description copied from class: Invocation

Change the security credentials of this invocation.

Overrides:

setCredential in class Invocation

getPrincipal

public Principal getPrincipal()

Overrides:

getPrincipal in class Invocation

setPrincipal

public void setPrincipal(Principal principal)

Description copied from class: Invocation

Change the security identity of this invocation.

Overrides:

setPrincipal in class Invocation

getArguments

public Object[] getArguments()

Overrides:

getArguments in class MarshalledInvocation

writeExternal

public void writeExternal(ObjectOutput out)
                   throws IOException

Specified by:

writeExternal in interface Externalizable

Overrides:

writeExternal in class MarshalledInvocation

Throws:

IOException

readExternal

public void readExternal(ObjectInput in)
                  throws IOException,
                         ClassNotFoundException

Specified by:

readExternal in interface Externalizable

Overrides:

readExternal in class MarshalledInvocation

Throws:

IOException

ClassNotFoundException