org.sim0mq.message.federatestarter

Class FS4FederateKilledMessage

java.lang.Object

org.sim0mq.message.Sim0MQMessage

org.sim0mq.message.federatestarter.FS4FederateKilledMessage

All Implemented Interfaces:

Serializable

public class FS4FederateKilledMessage
extends Sim0MQMessage

FederateKilled, FS.4. Message sent by the Federate Starter to the Federation Manager in response to message FM.8.

Copyright (c) 2016-2019 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved.
BSD-style license. See Sim0MQ License.

Author:

Alexander Verbraeck

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	FS4FederateKilledMessage.Builder Builder for the FederateStarted Message.

Field Summary

Fields inherited from class org.sim0mq.message.Sim0MQMessage

VERSION

Constructor Summary

Constructors

Constructor and Description
FS4FederateKilledMessage(Object simulationRunId, Object senderId, Object receiverId, long messageId, String instanceId, boolean status, String error)

Method Summary

Modifier and Type	Method and Description
byte[]	createByteArray() Create a byte array of the fields.
static FS4FederateKilledMessage	createMessage(Object[] fields, Object intendedReceiverId) Build a message from an Object[] that was received.
Object[]	createObjectArray() Create a Sim0MQ object array of the fields.
String	getError()
String	getInstanceId()
static String	getMessageType()
short	getNumberOfPayloadFields() Get the number of payload fields in the message.
boolean	isStatus()

Methods inherited from class org.sim0mq.message.Sim0MQMessage

check, getMagicNumber, getMessageId, getMessageStatus, getMessageTypeId, getReceiverId, getSenderId, getSimulationRunId

Methods inherited from class java.lang.Object

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

Constructor Detail

FS4FederateKilledMessage

public FS4FederateKilledMessage(Object simulationRunId,
                                Object senderId,
                                Object receiverId,
                                long messageId,
                                String instanceId,
                                boolean status,
                                String error)
                         throws Sim0MQException,
                                NullPointerException

Parameters:

simulationRunId - the Simulation run ids can be provided in different types. Examples are two 64-bit longs indicating a UUID, or a String with a UUID number, a String with meaningful identification, or a short or an int with a simulation run number.

senderId - The sender id can be used to send back a message to the sender at some later time.

receiverId - The receiver id can be used to check whether the message is meant for us, or should be discarded (or an error can be sent if we receive a message not meant for us).

messageId - The unique message number is meant to confirm with a callback that the message has been received correctly. The number is unique for the sender, so not globally within the federation.

instanceId - The sender id of the model that was started or had an error while starting. This is exactly the same as the instanceId sent by the Federation Manager in the StartFederate message.

status - Did the termination of the model succeed?

error - If there was an error with the model termination, the error message is sent as well. Otherwise this field is an empty string.

Throws:

Sim0MQException - on unknown data type

NullPointerException - when one of the parameters is null

Method Detail

getInstanceId

public String getInstanceId()

Returns:

instanceId

isStatus

public boolean isStatus()

Returns:

status

getError

public String getError()

Returns:

error

getMessageType

public static final String getMessageType()

Returns:

messagetype

getNumberOfPayloadFields

public short getNumberOfPayloadFields()

Get the number of payload fields in the message.

Specified by:

getNumberOfPayloadFields in class Sim0MQMessage

Returns:

short; the number of payload fields in the message.

createObjectArray

public Object[] createObjectArray()

Create a Sim0MQ object array of the fields.

Specified by:

createObjectArray in class Sim0MQMessage

Returns:

Object[] a Sim0MQ object array of the fields

createByteArray

public byte[] createByteArray()
                       throws Sim0MQException,
                              org.djutils.serialization.SerializationException

Create a byte array of the fields.

Specified by:

createByteArray in class Sim0MQMessage

Returns:

byte[] a Sim0MQ byte array of the content

Throws:

Sim0MQException - on unknown data type as part of the content

org.djutils.serialization.SerializationException - when the byte array cannot be created, e.g. because the number of bytes does not match

createMessage

public static FS4FederateKilledMessage createMessage(Object[] fields,
                                                     Object intendedReceiverId)
                                              throws Sim0MQException

Build a message from an Object[] that was received.

Parameters:

fields - Object[]; the fields in the message

intendedReceiverId - id of the intended receiver

Returns:

a Sim0MQ message

Throws:

Sim0MQException - when number of fields is not correct