atavism.server.messages

Class PerceptionMessage

java.lang.Object

atavism.msgsys.Message

atavism.server.messages.PerceptionMessage

All Implemented Interfaces:

HasTarget, java.io.Serializable

public class PerceptionMessage
extends Message
implements HasTarget

Changes to the objects perceived by a target object. The PerceptionMessage contains a list of gained objects and a list of lost objects. Gained objects are newly perceived and lost objects are no longer perceivable.

Gained and lost objects are each described by an PerceptionMessage.ObjectNote. The ObjectNote contains the object OID (subject) and object type. The ObjectNote may optionally contain some arbitrary object information (see PerceptionMessage.ObjectNote.getObjectInfo()).

ObjectNote supports a different target for each perceived object, but this capability is currently not used and may become deprecated.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	PerceptionMessage.ObjectNote Described a gained or lost perceivable object.

Field Summary

Fields inherited from class atavism.msgsys.Message

flags, msgId, msgInstanceOid, msgType, remoteAgent

Constructor Summary

Constructors

Constructor and Description
PerceptionMessage() No-arg constructor required for marshalling.
PerceptionMessage(MessageType msgType) Create message of the given message type.
PerceptionMessage(MessageType msgType, OID target) Create message of the given message type and target.

Method Summary

Modifier and Type	Method and Description
void	addStealthedObject(OID subjectOid) Add a stealthed object.
PerceptionMessage.ObjectNote	gainObject(OID targetOid, OID subjectOid, ObjectType objectType) Add a gained object.
void	gainObject(PerceptionMessage.ObjectNote note) Add a gained object.
int	getGainObjectCount() Get number of gained objects.
java.util.List<PerceptionMessage.ObjectNote>	getGainObjects() Get gained object list.
int	getLostObjectCount() Get number of lost objects.
java.util.List<PerceptionMessage.ObjectNote>	getLostObjects() Get lost object list.
int	getStealthedGainObjectCount() Get number of gain objects that were in mode stealth.
java.util.List<PerceptionMessage.ObjectNote>	getStealthedGainObjects() Get gain object list that were in the stealth mode.
int	getStealthedLostObjectCount() Get number of lost objects that were in mode stealth.
java.util.List<PerceptionMessage.ObjectNote>	getStealthedLostObjects() Get lost object list that were in the stealth mode.
java.util.List<OID>	getSteathedObjects() Get stealthed object list.
OID	getTarget() Get the message target.
void	lostObject(OID targetOid, OID subjectOid) Add a lost object.
void	lostObject(OID targetOid, OID subjectOid, ObjectType objectType) Add a lost object.
void	lostObject(PerceptionMessage.ObjectNote note) Add a lost object.
void	setTarget(OID target) Set the message target OID.
void	stealthedGainObject(PerceptionMessage.ObjectNote note) Add a gain object that were in stealth mode.
void	stealthedLostObject(PerceptionMessage.ObjectNote note) Add a lost object that were in stealth mode.

Methods inherited from class atavism.msgsys.Message

getEnqueueTime, getMsgId, getMsgInstanceOid, getMsgType, getSenderName, isRPC, setEnqueueTime, setEnqueueTime, setMsgInstanceOid, setMsgType, toBytes, toBytes, toBytes, ToString

Methods inherited from class java.lang.Object

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

Constructor Detail

PerceptionMessage

public PerceptionMessage()

No-arg constructor required for marshalling.

PerceptionMessage

public PerceptionMessage(MessageType msgType)

Create message of the given message type.

PerceptionMessage

public PerceptionMessage(MessageType msgType,
                         OID target)

Create message of the given message type and target.

Method Detail

getTarget

public OID getTarget()

Get the message target.

Specified by:

getTarget in interface HasTarget

Returns:

OID

setTarget

public void setTarget(OID target)

Set the message target OID.

Specified by:

setTarget in interface HasTarget

gainObject

public PerceptionMessage.ObjectNote gainObject(OID targetOid,
                                               OID subjectOid,
                                               ObjectType objectType)

Add a gained object.

gainObject

public void gainObject(PerceptionMessage.ObjectNote note)

Add a gained object.

lostObject

public void lostObject(OID targetOid,
                       OID subjectOid)

Add a lost object.

lostObject

public void lostObject(OID targetOid,
                       OID subjectOid,
                       ObjectType objectType)

Add a lost object.

lostObject

public void lostObject(PerceptionMessage.ObjectNote note)

Add a lost object.

stealthedGainObject

public void stealthedGainObject(PerceptionMessage.ObjectNote note)

Add a gain object that were in stealth mode.

stealthedLostObject

public void stealthedLostObject(PerceptionMessage.ObjectNote note)

Add a lost object that were in stealth mode.

getGainObjects

public java.util.List<PerceptionMessage.ObjectNote> getGainObjects()

Get gained object list.

Returns:

null if there are no gained objects.

getLostObjects

public java.util.List<PerceptionMessage.ObjectNote> getLostObjects()

Get lost object list.

Returns:

null if there are no lost objects.

getStealthedGainObjects

public java.util.List<PerceptionMessage.ObjectNote> getStealthedGainObjects()

Get gain object list that were in the stealth mode.

Returns:

null if there are no lost objects.

getStealthedLostObjects

public java.util.List<PerceptionMessage.ObjectNote> getStealthedLostObjects()

Get lost object list that were in the stealth mode.

Returns:

null if there are no lost objects.

getGainObjectCount

public int getGainObjectCount()

Get number of gained objects.

getLostObjectCount

public int getLostObjectCount()

Get number of lost objects.

getStealthedGainObjectCount

public int getStealthedGainObjectCount()

Get number of gain objects that were in mode stealth.

getStealthedLostObjectCount

public int getStealthedLostObjectCount()

Get number of lost objects that were in mode stealth.

addStealthedObject

public void addStealthedObject(OID subjectOid)

Add a stealthed object.

getSteathedObjects

public java.util.List<OID> getSteathedObjects()

Get stealthed object list.

Returns:

null if there are no lost objects.