com.threerings.presents.dobj

Class MessageEvent

java.lang.Object

com.threerings.presents.dobj.DEvent

com.threerings.presents.dobj.NamedEvent

com.threerings.presents.dobj.MessageEvent

All Implemented Interfaces:

Streamable

Direct Known Subclasses:

ServerMessageEvent

public class MessageEvent
extends NamedEvent

A message event is used to dispatch a message to all subscribers of a distributed object without actually changing any of the fields of the object. A message has a name, by which different subscribers of the same object can distinguish their different messages, and an array of arguments by which any contents of the message can be delivered.

See Also:

DObjectManager.postEvent(com.threerings.presents.dobj.DEvent)

Nested Class Summary

Nested classes/interfaces inherited from interface com.threerings.io.Streamable

Streamable.Closure

Field Summary

Fields inherited from class com.threerings.presents.dobj.DEvent

eventId

Constructor Summary

Constructors

Constructor and Description
MessageEvent(int targetOid, String name, Object[] args) Constructs a new message event on the specified target object with the supplied name and arguments.

Method Summary

Modifier and Type	Method and Description
boolean	applyToObject(DObject target) Applies the attribute modifications represented by this event to the specified target object.
Object[]	getArgs() Returns the arguments to this message.
void	setArgs(Object[] args) Replaces the arguments associated with this message event.

Methods inherited from class com.threerings.presents.dobj.NamedEvent

getName

Methods inherited from class com.threerings.presents.dobj.DEvent

alreadyApplied, getActualTransport, getSourceOid, getTargetOid, getTransport, isPrivate, noteActualTransport, setSourceOid, setTargetOid, setTransport, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

MessageEvent

public MessageEvent(int targetOid,
                    String name,
                    Object[] args)

Constructs a new message event on the specified target object with the supplied name and arguments.

Parameters:

targetOid - the object id of the object whose attribute has changed.

name - the name of the message event.

args - the arguments for this message. This array should contain only values of valid distributed object types.

Method Detail

getArgs

public Object[] getArgs()

Returns the arguments to this message.

setArgs

public void setArgs(Object[] args)

Replaces the arguments associated with this message event. Note: this should only be called on events that have not yet been dispatched into the distributed object system.

applyToObject

public boolean applyToObject(DObject target)
                      throws ObjectAccessException

Description copied from class: DEvent

Applies the attribute modifications represented by this event to the specified target object. This is called by the distributed object manager in the course of dispatching events and should not be called directly.

Specified by:

applyToObject in class DEvent

Returns:

true if the object manager should go on to notify the object's listeners of this event, false if the event should be treated silently and the listeners should not be notified.

Throws:

ObjectAccessException - thrown if there is any problem applying the event to the object (invalid attribute, etc.).