com.ibm.conversation
Interface MessageHandle

All Known Implementing Classes:

BasicMessageHandle

public interface MessageHandle

The MessageHandle interface represents a message received by, or to be delivered by, the messaging system.

MessageHandles are what gets passed between Conversations and MessageSystemAdapters. Note: the utility of this interface is not clear at present; it may turn out to be preferable to pass the message object directly, without this wrapper.

Design Q & A:

• Q: Is there any reason to add a "messageObjectType" string?
  A: Probably not. Its only use would be for testing it against a fixed set of alternatives defined at compile time, so it's equivalent to "instanceof".
• Q: How about a "messageSystemType" string?
  A: Possibly. It would help identify what kind of ConversationMetaData would be needed for the conversation the message was associated with. E.g., it could be fed into a ConversationMetaDataFactory. Similar considerations apply to the MessageTransforms.
• Q: Is there any reason to add a "sender"?
  A: Probably not. The objects used to represent sender information vary across messaging systems. Therefore, that kind of information should stay encapsulated inside the ConversationMetaData.

Method Summary

java.lang.Object	getMessage() Returns the message object.
void	setMessage(java.lang.Object newObject) Sets the message object.

Method Detail

getMessage

public java.lang.Object getMessage()

Returns the message object.

Returns:

The message object.

setMessage

public void setMessage(java.lang.Object newObject)

Sets the message object.

Parameters:

newObject - The message object.