ds.granules.exchange

Class Exchange

java.lang.Object

ds.granules.exchange.Exchange

Direct Known Subclasses:

DeploymentMessage, ExecutionStatus, ResourceDiscovery

public abstract class Exchange
extends java.lang.Object

This is the base class for exchanges. All specific exchanges need to extend this class and override the abstract methods. This class utilizes the template pattern to marshall and reconstruct the various exchange types.

Author:

Shrideep Pallickara

Constructor Summary

Constructors

Constructor and Description
Exchange()

Method Summary

Modifier and Type	Method and Description
byte[]	getBytes() Retrieve the byte[] representation of the exchange.
int	getConditionFlag()
java.lang.String	getDescription() Retrieve the description associated with this exchange.
int	getExchangeSubType()
int	getExchangeType()
java.lang.String	getIdentifier()
java.lang.String	getRespondTo() Retrieve the respondTo field for this exchange.
long	getTimestamp() Retrieve the timestamp for this exchange.
boolean	isRequest() Indicates whether this exchange is a Request
boolean	isResponse() Indicates whether this exchange is a Response to a previously issued request.
abstract boolean	isValidExchangeSubType() Checks to see if the exchange sub-type in the reconstructed exchange is a valid one.
abstract void	marshallExchangeSpecificElements(FormatWriter mFormat) This method is utilized by the derived classes to marshall (or serialize) elements that are specific to the derived class.
void	reconstruct(byte[] marshalledBytes) Reconstruct the exchange from the byte[] representation.
void	setExchangeType(int exchangeType)
void	setRespondTo(java.lang.String respondTo) Set the repondTo field for this exchange.
void	setTimestamp(long timestamp) Set the timestamp for this exchange.
abstract void	unmarshallExchangeSpecificElements(FormatReader mFormat) This method is utilized by the derived classes to reconstruct elements that are specific to the derived class.

Methods inherited from class java.lang.Object

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

Constructor Detail

Exchange

public Exchange()

Method Detail

getBytes

public final byte[] getBytes()
                      throws FormatException

Retrieve the byte[] representation of the exchange.

Returns:

The byte[] representation of the exchange.

Throws:

java.io.IOException - If there are IO problems while performing this operation.

MarshallingException - If there are Marshalling problems while performing this operation.

FormatException

reconstruct

public final void reconstruct(byte[] marshalledBytes)
                       throws FormatException

Reconstruct the exchange from the byte[] representation.

Parameters:

marshalledBytes - The byte[] representation of the exchange.

Throws:

java.io.IOException - If there are IO problems while performing this operation.

MarshallingException - If there are Marshalling problems while performing this operation.

FormatException

isValidExchangeSubType

public abstract boolean isValidExchangeSubType()

Checks to see if the exchange sub-type in the reconstructed exchange is a valid one.

Returns:

true If the exchange subType is a valid one, or false otherwise.

marshallExchangeSpecificElements

public abstract void marshallExchangeSpecificElements(FormatWriter mFormat)
                                               throws FormatException

This method is utilized by the derived classes to marshall (or serialize) elements that are specific to the derived class. All the base class elements (which are identified by the accessor methods) are handled by the base class even though it is an abstract class.

Parameters:

mFormat - The buffer formatter to write to.

Throws:

java.io.IOException - If there are IO problems while performing this operation.

MarshallingException - If there are Marshalling problems while performing this operation.

FormatException

unmarshallExchangeSpecificElements

public abstract void unmarshallExchangeSpecificElements(FormatReader mFormat)
                                                 throws FormatException

This method is utilized by the derived classes to reconstruct elements that are specific to the derived class. The unmarshall method will reconstruct the object state based on what was marshalled using the marshall method. All the base class elements (which are identified by the accessor methods) are handled by the base class even though it is an abstract class.

Parameters:

mFormat - The buffer formatter to read from.

Throws:

java.io.IOException - If there are IO problems while performing this operation.

MarshallingException - If there are Marshalling problems while performing this operation.

FormatException

setExchangeType

public void setExchangeType(int exchangeType)

Parameters:

exchangeType - The exchangeType to set

getExchangeType

public int getExchangeType()

Returns:

the exchangeType

isRequest

public boolean isRequest()

Indicates whether this exchange is a Request

Returns:

true if this exchange is a request; false otherwise.

isResponse

public boolean isResponse()

Indicates whether this exchange is a Response to a previously issued request.

Returns:

true if the exchange is a reponse; false otherwise.

getExchangeSubType

public int getExchangeSubType()

Returns:

the exchangeSubType

getConditionFlag

public int getConditionFlag()

Returns:

the conditionFlag

getIdentifier

public java.lang.String getIdentifier()

Returns:

the identifier

getDescription

public java.lang.String getDescription()

Retrieve the description associated with this exchange. Typically, this field is used to summarize the exchange in plain English.

Returns:

the description

setRespondTo

public void setRespondTo(java.lang.String respondTo)

Set the repondTo field for this exchange.

Parameters:

respondTo - The respondTo to set

getRespondTo

public java.lang.String getRespondTo()

Retrieve the respondTo field for this exchange.

Returns:

the respondTo

setTimestamp

public void setTimestamp(long timestamp)

Set the timestamp for this exchange.

Parameters:

timestamp - The timestamp to set

getTimestamp

public long getTimestamp()

Retrieve the timestamp for this exchange.

Returns:

the timestamp