org.objectweb.dream.message
Interface MessageNC

All Superinterfaces:
Message
All Known Subinterfaces:
ExtensibleMessageNC
All Known Implementing Classes:
BasicExtensibleMessageNC

public interface MessageNC
extends Message

Extends the Message interface and allows sub messages to be retrieved using a name. Note that it is optional to associate sub messages with names. MessageNC is a naming context for its sub messages having a name. This means that a message can not have two sub messages with the same name.


Field Summary
 
Fields inherited from interface org.objectweb.dream.message.Message
EMPTY_MESSAGE_ARRAY
 
Method Summary
 Message getSubMessage(String name)
          Returns a sub message of this message, or null if this message doesn't have a sub message with the specified name.
 Iterator getUnnamedSubMessageIterator()
          Returns an Iterator that iterate over the unnamed sub messages of this message.
 Message[] getUnnamedSubMessages()
          Returns an (eventually empty) array containing the unnamed sub messages of this message.
 
Methods inherited from interface org.objectweb.dream.message.Message
getChunk, getMessageManagerId, getMessageType, getSubMessageIterator, getSubMessages, recycle, setMessageManagerId, transfertChunkStates
 

Method Detail

getSubMessage

public Message getSubMessage(String name)
Returns a sub message of this message, or null if this message doesn't have a sub message with the specified name.

Parameters:
name - the name of the sub message, as specified in the message type.
Returns:
a sub message of this message.

getUnnamedSubMessageIterator

public Iterator getUnnamedSubMessageIterator()
Returns an Iterator that iterate over the unnamed sub messages of this message.

Returns:
an iterator on the sub messages.

getUnnamedSubMessages

public Message[] getUnnamedSubMessages()
Returns an (eventually empty) array containing the unnamed sub messages of this message.

Returns:
an array containing the sub messages of this message.


Copyright © 2003, 2004 - INRIA Rhone-Alpes - All Rights Reserved.