@Generated(value="com.neeve.adm.AdmJsonGenerator", date="Fri Dec 05 11:53:59 EST 2025") @AdmGenerated(encoding="Json", compatLevel="4.1.0", admVersion="Unknown Version", date="12/5/25 11:53 AM", buildInfo="nvx-eagle-2.9-SNAPSHOT Json Encoding") @AdmFactoryInfo(factoryClass=MessageFactory.class, vfid=132, ofid=132, typeId=1002) public final class MessageHeader extends Object implements IMessageHeader
| ADM Type | Embedded Entity |
| Factory | MessageFactory |
| ADM Field Summary |
|---|
| Field | Type | Id | Description |
|---|---|---|---|
| channelId | String | 32729 | No doc provided. |
| credentials | Credentials |
32732 | No doc provided. |
| error | ErrorContext |
32730 | No doc provided. |
| origin | String | 32737 | No doc provided. |
| requestId | String | 32733 | No doc provided. |
| senderVersion | Version |
32731 | No doc provided. |
| sessionId | String | 32735 | No doc provided. |
| sourceId | String | 32736 | No doc provided. |
| transactionId | String | 32734 | No doc provided. |
| Modifier and Type | Field and Description |
|---|---|
static MessageHeader[] |
EMPTY_ARRAY
A preallocated empty array used to avoid garbage when returning empty arrays of this type.
|
| Constructor and Description |
|---|
MessageHeader() |
| Modifier and Type | Method and Description |
|---|---|
MessageHeader |
acquire() |
void |
clearChannelId()
Clears the value of 'channelId'.
|
void |
clearContent() |
void |
clearCredentials()
Clears the value of 'credentials'.
|
void |
clearError()
Clears the value of 'error'.
|
void |
clearOrigin()
Clears the value of 'origin'.
|
void |
clearRequestId()
Clears the value of 'requestId'.
|
void |
clearSenderVersion()
Clears the value of 'senderVersion'.
|
void |
clearSessionId()
Clears the value of 'sessionId'.
|
void |
clearSourceId()
Clears the value of 'sourceId'.
|
void |
clearTransactionId()
Clears the value of 'transactionId'.
|
Object |
clone()
Creates a clone of this object.
|
MessageHeader |
copy() |
void |
copyInto(MessageHeader copy) |
static MessageHeader |
create() |
static MessageHeader |
createFrom(byte[] serializedJson) |
static MessageHeader |
createFromJson(String json) |
static MessageHeader |
createFromSerializedJson(byte[] serializedJson) |
static MessageHeader |
createFromSerializedJson(ByteBuffer serializedJson) |
MessageHeader |
deserializeFromByteArray(byte[] array) |
MessageHeader |
deserializeFromByteBuffer(ByteBuffer buffer) |
MessageHeader |
deserializeFromNative(long address,
int addressOffset,
int length) |
void |
dispose() |
String |
getChannelId()
Gets the value of 'channelId'.
|
static int |
getChannelIdFieldId() |
<T extends XString> |
getChannelIdTo(XString.Factory<T> factory)
Copies the value of this String field into a new XString from the given factory.
|
void |
getChannelIdTo(XString val)
Copies the value of 'channelId' into the provided XString.
|
XString |
getChannelIdUnsafe()
Gets the raw value of 'channelId'.
|
Credentials |
getCredentials()
Gets the value of 'credentials'.
|
static int |
getCredentialsFieldId() |
void |
getCredentialsTo(Credentials to)
Copies the value of Credentials into the provided value.
|
ErrorContext |
getError()
Gets the value of 'error'.
|
static int |
getErrorFieldId() |
void |
getErrorTo(ErrorContext to)
Copies the value of ErrorContext into the provided value.
|
boolean |
getIsReadOnly() |
String |
getOrigin()
Gets the value of 'origin'.
|
static int |
getOriginFieldId() |
<T extends XString> |
getOriginTo(XString.Factory<T> factory)
Copies the value of this String field into a new XString from the given factory.
|
void |
getOriginTo(XString val)
Copies the value of 'origin' into the provided XString.
|
XString |
getOriginUnsafe()
Gets the raw value of 'origin'.
|
int |
getOwnerCount() |
String |
getRequestId()
Gets the value of 'requestId'.
|
static int |
getRequestIdFieldId() |
<T extends XString> |
getRequestIdTo(XString.Factory<T> factory)
Copies the value of this String field into a new XString from the given factory.
|
void |
getRequestIdTo(XString val)
Copies the value of 'requestId' into the provided XString.
|
XString |
getRequestIdUnsafe()
Gets the raw value of 'requestId'.
|
Version |
getSenderVersion()
Gets the value of 'senderVersion'.
|
static int |
getSenderVersionFieldId() |
void |
getSenderVersionTo(Version to)
Copies the value of Version into the provided value.
|
int |
getSerializeToNativeLength() |
String |
getSessionId()
Gets the value of 'sessionId'.
|
static int |
getSessionIdFieldId() |
<T extends XString> |
getSessionIdTo(XString.Factory<T> factory)
Copies the value of this String field into a new XString from the given factory.
|
void |
getSessionIdTo(XString val)
Copies the value of 'sessionId' into the provided XString.
|
XString |
getSessionIdUnsafe()
Gets the raw value of 'sessionId'.
|
String |
getSourceId()
Gets the value of 'sourceId'.
|
static int |
getSourceIdFieldId() |
<T extends XString> |
getSourceIdTo(XString.Factory<T> factory)
Copies the value of this String field into a new XString from the given factory.
|
void |
getSourceIdTo(XString val)
Copies the value of 'sourceId' into the provided XString.
|
XString |
getSourceIdUnsafe()
Gets the raw value of 'sourceId'.
|
String |
getTransactionId()
Gets the value of 'transactionId'.
|
static int |
getTransactionIdFieldId() |
<T extends XString> |
getTransactionIdTo(XString.Factory<T> factory)
Copies the value of this String field into a new XString from the given factory.
|
void |
getTransactionIdTo(XString val)
Copies the value of 'transactionId' into the provided XString.
|
XString |
getTransactionIdUnsafe()
Gets the raw value of 'transactionId'.
|
void |
getValidationErrors(List<XString> results,
String errorPrefix) |
boolean |
hasChannelId()
Checks for the presence of 'channelId'.
|
boolean |
hasCredentials()
Checks for the presence of 'credentials'.
|
boolean |
hasError()
Checks for the presence of 'error'.
|
boolean |
hasOrigin()
Checks for the presence of 'origin'.
|
boolean |
hasRequestId()
Checks for the presence of 'requestId'.
|
boolean |
hasSenderVersion()
Checks for the presence of 'senderVersion'.
|
boolean |
hasSessionId()
Checks for the presence of 'sessionId'.
|
boolean |
hasSourceId()
Checks for the presence of 'sourceId'.
|
boolean |
hasTransactionId()
Checks for the presence of 'transactionId'.
|
boolean |
isBufferBacked() |
boolean |
isReferenceCounted() |
boolean |
isValid() |
void |
lendChannelId(XString val)
Lends the value of 'channelId' to this object.
|
void |
lendCredentials(Credentials val)
'Lends' a reference of the Credentials to the message for this field.
|
void |
lendError(ErrorContext val)
'Lends' a reference of the ErrorContext to the message for this field.
|
void |
lendOrigin(XString val)
Lends the value of 'origin' to this object.
|
void |
lendRequestId(XString val)
Lends the value of 'requestId' to this object.
|
void |
lendSenderVersion(Version val)
'Lends' a reference of the Version to the message for this field.
|
void |
lendSessionId(XString val)
Lends the value of 'sessionId' to this object.
|
void |
lendSourceId(XString val)
Lends the value of 'sourceId' to this object.
|
void |
lendTransactionId(XString val)
Lends the value of 'transactionId' to this object.
|
byte[] |
serializeToByteArray() |
ByteBuffer |
serializeToByteBuffer() |
int |
serializeToNative(long address,
int addressOffset) |
void |
setAsReadOnly() |
void |
setChannelId(String val)
Sets the value of 'channelId'.
|
void |
setChannelIdFrom(long val)
Sets the value of this String field to the given numeric value.
|
void |
setChannelIdFrom(XString val)
Copies the provided XString value into this object's 'channelId'.
|
void |
setCredentials(Credentials val)
Sets the value of 'credentials'.
|
void |
setError(ErrorContext val)
Sets the value of 'error'.
|
void |
setOrigin(String val)
Sets the value of 'origin'.
|
void |
setOriginFrom(long val)
Sets the value of this String field to the given numeric value.
|
void |
setOriginFrom(XString val)
Copies the provided XString value into this object's 'origin'.
|
void |
setRequestId(String val)
Sets the value of 'requestId'.
|
void |
setRequestIdFrom(long val)
Sets the value of this String field to the given numeric value.
|
void |
setRequestIdFrom(XString val)
Copies the provided XString value into this object's 'requestId'.
|
void |
setSenderVersion(Version val)
Sets the value of 'senderVersion'.
|
void |
setSessionId(String val)
Sets the value of 'sessionId'.
|
void |
setSessionIdFrom(long val)
Sets the value of this String field to the given numeric value.
|
void |
setSessionIdFrom(XString val)
Copies the provided XString value into this object's 'sessionId'.
|
void |
setSourceId(String val)
Sets the value of 'sourceId'.
|
void |
setSourceIdFrom(long val)
Sets the value of this String field to the given numeric value.
|
void |
setSourceIdFrom(XString val)
Copies the provided XString value into this object's 'sourceId'.
|
void |
setTransactionId(String val)
Sets the value of 'transactionId'.
|
void |
setTransactionIdFrom(long val)
Sets the value of this String field to the given numeric value.
|
void |
setTransactionIdFrom(XString val)
Copies the provided XString value into this object's 'transactionId'.
|
Credentials |
takeCredentials()
'Takes' a reference to the credentials field from the message.
|
ErrorContext |
takeError()
'Takes' a reference to the error field from the message.
|
Version |
takeSenderVersion()
'Takes' a reference to the senderVersion field from the message.
|
String |
toString() |
public static final MessageHeader[] EMPTY_ARRAY
public static MessageHeader create()
public static MessageHeader createFromJson(String json)
public static MessageHeader createFromSerializedJson(ByteBuffer serializedJson)
public static MessageHeader createFromSerializedJson(byte[] serializedJson)
public static MessageHeader createFrom(byte[] serializedJson)
public final void clearContent()
public final void setAsReadOnly()
public final boolean getIsReadOnly()
public static final int getOriginFieldId()
public final void setOrigin(String val)
IMessageHeadersetOrigin in interface IMessageHeaderval - The value to set.public final String getOrigin()
IMessageHeadergetOrigin in interface IMessageHeaderpublic final void lendOrigin(XString val)
IMessageHeaderThis method is equivalent to setOrigin except that it allows this object to defer copying the value until this object is next serialized. This means that the caller must not modify or dispose the value being passed in to this method.
Note, also, that unlike lendXXX methods for embedded entities, this method does not attempt to acquire or dispose of the value passed in even if the value is poolable.
lendOrigin in interface IMessageHeaderval - The value to set.public final void setOriginFrom(long val)
IMessageHeader
NOTE:
This is the same as calling IMessageHeader.setOrigin(String).
with Long.valueOf(val).toString(), except that using this method is a zero garbage
operation for Xbuf encoding.
setOriginFrom in interface IMessageHeaderpublic final <T extends XString> T getOriginTo(XString.Factory<T> factory)
IMessageHeader
If the value of this field is not null this method creates an XString from
the provided Factory, copies this field's value into the type, and returns the new
XString.);
This is a zero garbage operation if the provided factory is backed by a pool and the pool; has available instances;
getOriginTo in interface IMessageHeaderfactory - The factory from which to get the XString to copy into and returnnull.public final void setOriginFrom(XString val)
IMessageHeader
NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this setter
can be more efficient than IMessageHeader.setOrigin(String)
because it avoids encoding the value into a String if the given XString is already encoded.
setOriginFrom in interface IMessageHeaderpublic final void getOriginTo(XString val)
IMessageHeader
NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this getter
can be more efficient than IMessageHeader.getOrigin() bec
because it can avoid decoding the value into an String.
getOriginTo in interface IMessageHeaderIMessageHeader.getOrigin()public final XString getOriginUnsafe()
IMessageHeader
NOTE:
This method retrieves the raw value backed by this object's buffer. This is a useful operation
when copying this field value to another object because it avoids copying the data into an intermediate
XString and instead allows direct byte transfer from the raw value to the target object.
However, this accessor is inherently unsafe because the buffer backing this object can be changed which would consequently invalidate the XString returned by this method. Consequently, the caller must not retain the returned raw value beyond the scope of this object's lifespan and access to the raw value follows the same threading rules as access to this object.
Additionally, the caller must not in any way mutate or modify the returned value as doing so could corrupt this object's backing buffer.
getOriginUnsafe in interface IMessageHeaderIMessageHeader.getOrigin()public final void clearOrigin()
IMessageHeaderclearOrigin in interface IMessageHeaderIMessageHeader.setOrigin(String)public final boolean hasOrigin()
IMessageHeaderhasOrigin in interface IMessageHeaderIMessageHeader.getOrigin()public static final int getSourceIdFieldId()
public final void setSourceId(String val)
IMessageHeadersetSourceId in interface IMessageHeaderval - The value to set.public final String getSourceId()
IMessageHeadergetSourceId in interface IMessageHeaderpublic final void lendSourceId(XString val)
IMessageHeaderThis method is equivalent to setSourceId except that it allows this object to defer copying the value until this object is next serialized. This means that the caller must not modify or dispose the value being passed in to this method.
Note, also, that unlike lendXXX methods for embedded entities, this method does not attempt to acquire or dispose of the value passed in even if the value is poolable.
lendSourceId in interface IMessageHeaderval - The value to set.public final void setSourceIdFrom(long val)
IMessageHeader
NOTE:
This is the same as calling IMessageHeader.setSourceId(String).
with Long.valueOf(val).toString(), except that using this method is a zero garbage
operation for Xbuf encoding.
setSourceIdFrom in interface IMessageHeaderpublic final <T extends XString> T getSourceIdTo(XString.Factory<T> factory)
IMessageHeader
If the value of this field is not null this method creates an XString from
the provided Factory, copies this field's value into the type, and returns the new
XString.);
This is a zero garbage operation if the provided factory is backed by a pool and the pool; has available instances;
getSourceIdTo in interface IMessageHeaderfactory - The factory from which to get the XString to copy into and returnnull.public final void setSourceIdFrom(XString val)
IMessageHeader
NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this setter
can be more efficient than IMessageHeader.setSourceId(String)
because it avoids encoding the value into a String if the given XString is already encoded.
setSourceIdFrom in interface IMessageHeaderpublic final void getSourceIdTo(XString val)
IMessageHeader
NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this getter
can be more efficient than IMessageHeader.getSourceId() bec
because it can avoid decoding the value into an String.
getSourceIdTo in interface IMessageHeaderIMessageHeader.getSourceId()public final XString getSourceIdUnsafe()
IMessageHeader
NOTE:
This method retrieves the raw value backed by this object's buffer. This is a useful operation
when copying this field value to another object because it avoids copying the data into an intermediate
XString and instead allows direct byte transfer from the raw value to the target object.
However, this accessor is inherently unsafe because the buffer backing this object can be changed which would consequently invalidate the XString returned by this method. Consequently, the caller must not retain the returned raw value beyond the scope of this object's lifespan and access to the raw value follows the same threading rules as access to this object.
Additionally, the caller must not in any way mutate or modify the returned value as doing so could corrupt this object's backing buffer.
getSourceIdUnsafe in interface IMessageHeaderIMessageHeader.getSourceId()public final void clearSourceId()
IMessageHeaderclearSourceId in interface IMessageHeaderIMessageHeader.setSourceId(String)public final boolean hasSourceId()
IMessageHeaderhasSourceId in interface IMessageHeaderIMessageHeader.getSourceId()public static final int getChannelIdFieldId()
public final void setChannelId(String val)
IMessageHeadersetChannelId in interface IMessageHeaderval - The value to set.public final String getChannelId()
IMessageHeadergetChannelId in interface IMessageHeaderpublic final void lendChannelId(XString val)
IMessageHeaderThis method is equivalent to setChannelId except that it allows this object to defer copying the value until this object is next serialized. This means that the caller must not modify or dispose the value being passed in to this method.
Note, also, that unlike lendXXX methods for embedded entities, this method does not attempt to acquire or dispose of the value passed in even if the value is poolable.
lendChannelId in interface IMessageHeaderval - The value to set.public final void setChannelIdFrom(long val)
IMessageHeader
NOTE:
This is the same as calling IMessageHeader.setChannelId(String).
with Long.valueOf(val).toString(), except that using this method is a zero garbage
operation for Xbuf encoding.
setChannelIdFrom in interface IMessageHeaderpublic final <T extends XString> T getChannelIdTo(XString.Factory<T> factory)
IMessageHeader
If the value of this field is not null this method creates an XString from
the provided Factory, copies this field's value into the type, and returns the new
XString.);
This is a zero garbage operation if the provided factory is backed by a pool and the pool; has available instances;
getChannelIdTo in interface IMessageHeaderfactory - The factory from which to get the XString to copy into and returnnull.public final void setChannelIdFrom(XString val)
IMessageHeader
NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this setter
can be more efficient than IMessageHeader.setChannelId(String)
because it avoids encoding the value into a String if the given XString is already encoded.
setChannelIdFrom in interface IMessageHeaderpublic final void getChannelIdTo(XString val)
IMessageHeader
NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this getter
can be more efficient than IMessageHeader.getChannelId() bec
because it can avoid decoding the value into an String.
getChannelIdTo in interface IMessageHeaderIMessageHeader.getChannelId()public final XString getChannelIdUnsafe()
IMessageHeader
NOTE:
This method retrieves the raw value backed by this object's buffer. This is a useful operation
when copying this field value to another object because it avoids copying the data into an intermediate
XString and instead allows direct byte transfer from the raw value to the target object.
However, this accessor is inherently unsafe because the buffer backing this object can be changed which would consequently invalidate the XString returned by this method. Consequently, the caller must not retain the returned raw value beyond the scope of this object's lifespan and access to the raw value follows the same threading rules as access to this object.
Additionally, the caller must not in any way mutate or modify the returned value as doing so could corrupt this object's backing buffer.
getChannelIdUnsafe in interface IMessageHeaderIMessageHeader.getChannelId()public final void clearChannelId()
IMessageHeaderclearChannelId in interface IMessageHeaderIMessageHeader.setChannelId(String)public final boolean hasChannelId()
IMessageHeaderhasChannelId in interface IMessageHeaderIMessageHeader.getChannelId()public static final int getSessionIdFieldId()
public final void setSessionId(String val)
IMessageHeadersetSessionId in interface IMessageHeaderval - The value to set.public final String getSessionId()
IMessageHeadergetSessionId in interface IMessageHeaderpublic final void lendSessionId(XString val)
IMessageHeaderThis method is equivalent to setSessionId except that it allows this object to defer copying the value until this object is next serialized. This means that the caller must not modify or dispose the value being passed in to this method.
Note, also, that unlike lendXXX methods for embedded entities, this method does not attempt to acquire or dispose of the value passed in even if the value is poolable.
lendSessionId in interface IMessageHeaderval - The value to set.public final void setSessionIdFrom(long val)
IMessageHeader
NOTE:
This is the same as calling IMessageHeader.setSessionId(String).
with Long.valueOf(val).toString(), except that using this method is a zero garbage
operation for Xbuf encoding.
setSessionIdFrom in interface IMessageHeaderpublic final <T extends XString> T getSessionIdTo(XString.Factory<T> factory)
IMessageHeader
If the value of this field is not null this method creates an XString from
the provided Factory, copies this field's value into the type, and returns the new
XString.);
This is a zero garbage operation if the provided factory is backed by a pool and the pool; has available instances;
getSessionIdTo in interface IMessageHeaderfactory - The factory from which to get the XString to copy into and returnnull.public final void setSessionIdFrom(XString val)
IMessageHeader
NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this setter
can be more efficient than IMessageHeader.setSessionId(String)
because it avoids encoding the value into a String if the given XString is already encoded.
setSessionIdFrom in interface IMessageHeaderpublic final void getSessionIdTo(XString val)
IMessageHeader
NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this getter
can be more efficient than IMessageHeader.getSessionId() bec
because it can avoid decoding the value into an String.
getSessionIdTo in interface IMessageHeaderIMessageHeader.getSessionId()public final XString getSessionIdUnsafe()
IMessageHeader
NOTE:
This method retrieves the raw value backed by this object's buffer. This is a useful operation
when copying this field value to another object because it avoids copying the data into an intermediate
XString and instead allows direct byte transfer from the raw value to the target object.
However, this accessor is inherently unsafe because the buffer backing this object can be changed which would consequently invalidate the XString returned by this method. Consequently, the caller must not retain the returned raw value beyond the scope of this object's lifespan and access to the raw value follows the same threading rules as access to this object.
Additionally, the caller must not in any way mutate or modify the returned value as doing so could corrupt this object's backing buffer.
getSessionIdUnsafe in interface IMessageHeaderIMessageHeader.getSessionId()public final void clearSessionId()
IMessageHeaderclearSessionId in interface IMessageHeaderIMessageHeader.setSessionId(String)public final boolean hasSessionId()
IMessageHeaderhasSessionId in interface IMessageHeaderIMessageHeader.getSessionId()public static final int getTransactionIdFieldId()
public final void setTransactionId(String val)
IMessageHeadersetTransactionId in interface IMessageHeaderval - The value to set.public final String getTransactionId()
IMessageHeadergetTransactionId in interface IMessageHeaderpublic final void lendTransactionId(XString val)
IMessageHeaderThis method is equivalent to setTransactionId except that it allows this object to defer copying the value until this object is next serialized. This means that the caller must not modify or dispose the value being passed in to this method.
Note, also, that unlike lendXXX methods for embedded entities, this method does not attempt to acquire or dispose of the value passed in even if the value is poolable.
lendTransactionId in interface IMessageHeaderval - The value to set.public final void setTransactionIdFrom(long val)
IMessageHeader
NOTE:
This is the same as calling IMessageHeader.setTransactionId(String).
with Long.valueOf(val).toString(), except that using this method is a zero garbage
operation for Xbuf encoding.
setTransactionIdFrom in interface IMessageHeaderpublic final <T extends XString> T getTransactionIdTo(XString.Factory<T> factory)
IMessageHeader
If the value of this field is not null this method creates an XString from
the provided Factory, copies this field's value into the type, and returns the new
XString.);
This is a zero garbage operation if the provided factory is backed by a pool and the pool; has available instances;
getTransactionIdTo in interface IMessageHeaderfactory - The factory from which to get the XString to copy into and returnnull.public final void setTransactionIdFrom(XString val)
IMessageHeader
NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this setter
can be more efficient than IMessageHeader.setTransactionId(String)
because it avoids encoding the value into a String if the given XString is already encoded.
setTransactionIdFrom in interface IMessageHeaderpublic final void getTransactionIdTo(XString val)
IMessageHeader
NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this getter
can be more efficient than IMessageHeader.getTransactionId() bec
because it can avoid decoding the value into an String.
getTransactionIdTo in interface IMessageHeaderIMessageHeader.getTransactionId()public final XString getTransactionIdUnsafe()
IMessageHeader
NOTE:
This method retrieves the raw value backed by this object's buffer. This is a useful operation
when copying this field value to another object because it avoids copying the data into an intermediate
XString and instead allows direct byte transfer from the raw value to the target object.
However, this accessor is inherently unsafe because the buffer backing this object can be changed which would consequently invalidate the XString returned by this method. Consequently, the caller must not retain the returned raw value beyond the scope of this object's lifespan and access to the raw value follows the same threading rules as access to this object.
Additionally, the caller must not in any way mutate or modify the returned value as doing so could corrupt this object's backing buffer.
getTransactionIdUnsafe in interface IMessageHeaderIMessageHeader.getTransactionId()public final void clearTransactionId()
IMessageHeaderclearTransactionId in interface IMessageHeaderIMessageHeader.setTransactionId(String)public final boolean hasTransactionId()
IMessageHeaderhasTransactionId in interface IMessageHeaderIMessageHeader.getTransactionId()public static final int getRequestIdFieldId()
public final void setRequestId(String val)
IMessageHeadersetRequestId in interface IMessageHeaderval - The value to set.public final String getRequestId()
IMessageHeadergetRequestId in interface IMessageHeaderpublic final void lendRequestId(XString val)
IMessageHeaderThis method is equivalent to setRequestId except that it allows this object to defer copying the value until this object is next serialized. This means that the caller must not modify or dispose the value being passed in to this method.
Note, also, that unlike lendXXX methods for embedded entities, this method does not attempt to acquire or dispose of the value passed in even if the value is poolable.
lendRequestId in interface IMessageHeaderval - The value to set.public final void setRequestIdFrom(long val)
IMessageHeader
NOTE:
This is the same as calling IMessageHeader.setRequestId(String).
with Long.valueOf(val).toString(), except that using this method is a zero garbage
operation for Xbuf encoding.
setRequestIdFrom in interface IMessageHeaderpublic final <T extends XString> T getRequestIdTo(XString.Factory<T> factory)
IMessageHeader
If the value of this field is not null this method creates an XString from
the provided Factory, copies this field's value into the type, and returns the new
XString.);
This is a zero garbage operation if the provided factory is backed by a pool and the pool; has available instances;
getRequestIdTo in interface IMessageHeaderfactory - The factory from which to get the XString to copy into and returnnull.public final void setRequestIdFrom(XString val)
IMessageHeader
NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this setter
can be more efficient than IMessageHeader.setRequestId(String)
because it avoids encoding the value into a String if the given XString is already encoded.
setRequestIdFrom in interface IMessageHeaderpublic final void getRequestIdTo(XString val)
IMessageHeader
NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this getter
can be more efficient than IMessageHeader.getRequestId() bec
because it can avoid decoding the value into an String.
getRequestIdTo in interface IMessageHeaderIMessageHeader.getRequestId()public final XString getRequestIdUnsafe()
IMessageHeader
NOTE:
This method retrieves the raw value backed by this object's buffer. This is a useful operation
when copying this field value to another object because it avoids copying the data into an intermediate
XString and instead allows direct byte transfer from the raw value to the target object.
However, this accessor is inherently unsafe because the buffer backing this object can be changed which would consequently invalidate the XString returned by this method. Consequently, the caller must not retain the returned raw value beyond the scope of this object's lifespan and access to the raw value follows the same threading rules as access to this object.
Additionally, the caller must not in any way mutate or modify the returned value as doing so could corrupt this object's backing buffer.
getRequestIdUnsafe in interface IMessageHeaderIMessageHeader.getRequestId()public final void clearRequestId()
IMessageHeaderclearRequestId in interface IMessageHeaderIMessageHeader.setRequestId(String)public final boolean hasRequestId()
IMessageHeaderhasRequestId in interface IMessageHeaderIMessageHeader.getRequestId()public static final int getCredentialsFieldId()
public final void setCredentials(Credentials val)
IMessageHeadersetCredentials in interface IMessageHeaderval - The value to set.public final void lendCredentials(Credentials val)
IMessageHeader
NOTE:
It is illegal to hold onto an entity 'set' on a message post the disposal of the container message.
This is true even if a reference to the entity is explicitly 'acquired' by the application via acquire().
To hold onto the reference of an entity beyond the lifecycle of its container message, an application must own a reference to the entity (via, for example, 'taking' the entity off an inbound message) and then 'lend' the entity to the message for sending. The act of 'lending' an entity to a message implies that the application continues to own the entity even though the message is holding a reference to it for the duration of the send.
lendCredentials in interface IMessageHeaderval - the value to 'lend' to lend.public final Credentials getCredentials()
IMessageHeadergetCredentials in interface IMessageHeaderpublic final void getCredentialsTo(Credentials to)
IMessageHeaderIF the value is not set, then the contents of the provided Credentials are cleared.
getCredentialsTo in interface IMessageHeaderto - the value to copy intoCredentials.copyInto(Credentials)public final Credentials takeCredentials()
IMessageHeader
NOTE:
A nested entity reference returned by getXXX() is only valid until the entity is disposed
i.e. the act of getting an entity does not transfer ownership of the entity to the application
A message disposes of its reference to its contained entities when it is disposed itself.
An AEP engine disposes a message on return from its message handler. Therefore, applications working with AEP engines that wish to hold onto a nested entity reference post return from its containing message's handler must either acquire a reference to the container message or 'take' the nested entity itself from the container message. The act of 'taking' an entity differs from 'getting' an entity in that 'take' does what is necessary to ensure that the entity contents are not cleared and the entity not disposed when the message itself is disposed. For a taken entity to be disposed, the application must explicitly dispose it when done working with it.
takeCredentials in interface IMessageHeadernull if the field is not set.public final void clearCredentials()
IMessageHeaderclearCredentials in interface IMessageHeaderIMessageHeader.setCredentials(Credentials)public final boolean hasCredentials()
IMessageHeaderhasCredentials in interface IMessageHeaderIMessageHeader.getCredentials()public static final int getSenderVersionFieldId()
public final void setSenderVersion(Version val)
IMessageHeadersetSenderVersion in interface IMessageHeaderval - The value to set.public final void lendSenderVersion(Version val)
IMessageHeader
NOTE:
It is illegal to hold onto an entity 'set' on a message post the disposal of the container message.
This is true even if a reference to the entity is explicitly 'acquired' by the application via acquire().
To hold onto the reference of an entity beyond the lifecycle of its container message, an application must own a reference to the entity (via, for example, 'taking' the entity off an inbound message) and then 'lend' the entity to the message for sending. The act of 'lending' an entity to a message implies that the application continues to own the entity even though the message is holding a reference to it for the duration of the send.
lendSenderVersion in interface IMessageHeaderval - the value to 'lend' to lend.public final Version getSenderVersion()
IMessageHeadergetSenderVersion in interface IMessageHeaderpublic final void getSenderVersionTo(Version to)
IMessageHeaderIF the value is not set, then the contents of the provided Version are cleared.
getSenderVersionTo in interface IMessageHeaderto - the value to copy intoVersion.copyInto(Version)public final Version takeSenderVersion()
IMessageHeader
NOTE:
A nested entity reference returned by getXXX() is only valid until the entity is disposed
i.e. the act of getting an entity does not transfer ownership of the entity to the application
A message disposes of its reference to its contained entities when it is disposed itself.
An AEP engine disposes a message on return from its message handler. Therefore, applications working with AEP engines that wish to hold onto a nested entity reference post return from its containing message's handler must either acquire a reference to the container message or 'take' the nested entity itself from the container message. The act of 'taking' an entity differs from 'getting' an entity in that 'take' does what is necessary to ensure that the entity contents are not cleared and the entity not disposed when the message itself is disposed. For a taken entity to be disposed, the application must explicitly dispose it when done working with it.
takeSenderVersion in interface IMessageHeadernull if the field is not set.public final void clearSenderVersion()
IMessageHeaderclearSenderVersion in interface IMessageHeaderIMessageHeader.setSenderVersion(Version)public final boolean hasSenderVersion()
IMessageHeaderhasSenderVersion in interface IMessageHeaderIMessageHeader.getSenderVersion()public static final int getErrorFieldId()
public final void setError(ErrorContext val)
IMessageHeadersetError in interface IMessageHeaderval - The value to set.public final void lendError(ErrorContext val)
IMessageHeader
NOTE:
It is illegal to hold onto an entity 'set' on a message post the disposal of the container message.
This is true even if a reference to the entity is explicitly 'acquired' by the application via acquire().
To hold onto the reference of an entity beyond the lifecycle of its container message, an application must own a reference to the entity (via, for example, 'taking' the entity off an inbound message) and then 'lend' the entity to the message for sending. The act of 'lending' an entity to a message implies that the application continues to own the entity even though the message is holding a reference to it for the duration of the send.
lendError in interface IMessageHeaderval - the value to 'lend' to lend.public final ErrorContext getError()
IMessageHeadergetError in interface IMessageHeaderpublic final void getErrorTo(ErrorContext to)
IMessageHeaderIF the value is not set, then the contents of the provided ErrorContext are cleared.
getErrorTo in interface IMessageHeaderto - the value to copy intoErrorContext.copyInto(ErrorContext)public final ErrorContext takeError()
IMessageHeader
NOTE:
A nested entity reference returned by getXXX() is only valid until the entity is disposed
i.e. the act of getting an entity does not transfer ownership of the entity to the application
A message disposes of its reference to its contained entities when it is disposed itself.
An AEP engine disposes a message on return from its message handler. Therefore, applications working with AEP engines that wish to hold onto a nested entity reference post return from its containing message's handler must either acquire a reference to the container message or 'take' the nested entity itself from the container message. The act of 'taking' an entity differs from 'getting' an entity in that 'take' does what is necessary to ensure that the entity contents are not cleared and the entity not disposed when the message itself is disposed. For a taken entity to be disposed, the application must explicitly dispose it when done working with it.
takeError in interface IMessageHeadernull if the field is not set.public final void clearError()
IMessageHeaderclearError in interface IMessageHeaderIMessageHeader.setError(ErrorContext)public final boolean hasError()
IMessageHeaderhasError in interface IMessageHeaderIMessageHeader.getError()public final byte[] serializeToByteArray()
public final ByteBuffer serializeToByteBuffer()
public final boolean isBufferBacked()
public final int getSerializeToNativeLength()
public final int serializeToNative(long address,
int addressOffset)
public final MessageHeader deserializeFromByteArray(byte[] array)
public final MessageHeader deserializeFromByteBuffer(ByteBuffer buffer)
public final MessageHeader deserializeFromNative(long address, int addressOffset, int length)
public final boolean isReferenceCounted()
public final MessageHeader acquire()
public final int getOwnerCount()
public final void dispose()
public final Object clone()
This method differs from the copy() method in that:
public final MessageHeader copy()
public final void copyInto(MessageHeader copy)
public final boolean isValid()
isValid in interface IRogValidatablepublic final void getValidationErrors(List<XString> results, String errorPrefix)
getValidationErrors in interface IRogValidatableCopyright © 2016 Neeve Research, LLC. All Rights Reserved.