Package org.sim0mq.message.modelcontroller

Class MC2AckNakMessage

java.lang.Object

org.sim0mq.message.Sim0MQMessage

org.sim0mq.message.Sim0MQReply

org.sim0mq.message.modelcontroller.MC2AckNakMessage

All Implemented Interfaces:

Serializable

public class MC2AckNakMessage
extends Sim0MQReply

AckNak, MC.2. Message sent by the Model to acknowledge the reception and implementation of a message sent by the Federation Manager.

Copyright (c) 2016-2020 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	Description
static class	MC2AckNakMessage.Builder	Builder for the StartFederate Message.

Field Summary

Fields inherited from class org.sim0mq.message.Sim0MQMessage

VERSION

Constructor Summary

Constructors

Constructor	Description
MC2AckNakMessage(Object[] objectArray)
MC2AckNakMessage(Object federationId, Object senderId, Object receiverId, Object messageId, Object uniqueId, boolean status, String error)

Method Summary

Modifier and Type	Method	Description
String	getError()
boolean	getStatus()

Methods inherited from class org.sim0mq.message.Sim0MQReply

getReplyToId

Methods inherited from class org.sim0mq.message.Sim0MQMessage

check, createByteArray, createObjectArray, decode, decodeToArray, encodeReplyUTF16, encodeReplyUTF8, encodeUTF16, encodeUTF8, getFederationId, getMagicNumber, getMessageId, getMessageTypeId, getNumberOfPayloadFields, getReceiverId, getSenderId, isBigEndian, listPayload, print

Methods inherited from class java.lang.Object

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

Constructor Detail

MC2AckNakMessage

public MC2AckNakMessage(Object federationId,
                        Object senderId,
                        Object receiverId,
                        Object messageId,
                        Object uniqueId,
                        boolean status,
                        String error)
                 throws Sim0MQException,
                        NullPointerException

Parameters:

federationId - the federation id can be coded using 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.

uniqueId - Id to identify the callback to the message.

status - boolean; indicates whether the command sent by the FM has been successfully implemented, e.g. whether the run control parameters are set successfully.

error - If ‘status’ is False, an error message that indicates what went wrong. Otherwise, an empty string.

Throws:

Sim0MQException - on unknown data type

NullPointerException - when one of the parameters is null

MC2AckNakMessage

public MC2AckNakMessage(Object[] objectArray)
                 throws Sim0MQException,
                        NullPointerException

Parameters:

objectArray - Object[]; Full message object array

Throws:

Sim0MQException - on unknown data type

NullPointerException - when one of the parameters is null

Method Detail

getStatus

public final boolean getStatus()

Returns:

status

getError

public final String getError()

Returns:

error