@Generated(value="com.neeve.adm.AdmGenerator", date="Thu May 07 15:37:32 EDT 2020") @AdmGenerated(compatLevel="4.0.0", admVersion="nvx-rumi-adm v3.14 (build 29)", date="5/7/20 3:37 PM", buildInfo="nvx-talon-3.14.19 (nvx-codegen-plugin)") public interface ISrvMonHeartbeatMessage extends IRogNode, IRogMessage, IRogCopyableNode<ISrvMonHeartbeatMessage>, com.neeve.server.mon.common.IHasSrvMonXvmHeader
The XVM heartbeat is emitted by a Talon XVM at regular intervals and contains all of the stats reported by a XVM.
ADM Type | Message |
Factory | SrvMonFactory |
ADM Field Summary |
---|
Field | Type | Id | Description |
---|---|---|---|
adminClientStats | SrvMonAdminClientStats[] | 11 | Collects stats related to the admin client connections. |
appsInfo | SrvMonAppInfo[] | 9 | Information about the apps configured for this XVM. |
appsStats | SrvMonAppStats[] | 10 | Platform and user stats for loaded applications. |
collectionEndTime | Long | 3 | The collection end time in nanoseconds (e.g. System.nanoTime()). |
collectionStartTime | Long | 2 | The collection start time in nanoseconds (e.g. System.nanoTime()). |
collectionStartWallTime | Long | 1 | The collection start time in milliseconds since the Epoch (e.g. System.currentTimeMillis()). |
heartbeatLoggerStats | SrvMonAppMessageLoggerStats |
15 | Logger stats for the xvm's binary heartbeat log (if enabled). |
loadedTime | Date | 12 | The time at which the XVM loaded. |
poolStats | SrvMonPoolStats[] | 8 | Collects process wide pooling stats. |
serverHostName | String | 5 | The XVM's hostname. |
serverName | String | 4 | The name of the XVM. |
serverPid | String | 6 | The XVM process id. |
sysStats | SrvMonSysStats |
7 | Collects System System level stats such process or memory usage. |
systemName | String | 13 | The name of the system to which the XVM belongs. |
systemVersion | String | 14 | The version of the system to which the XVM belongs. |
xvmHeader | SrvMonXvmHeader | 6004 | Details about the message source. |
IRogNode.PoolingListener
IStoreObject.EncodingType
Modifier and Type | Method and Description |
---|---|
void |
addAdminClientStats(SrvMonAdminClientStats val)
Adds the provided value to the list of 'adminClientStats' values.
|
void |
addAppsInfo(SrvMonAppInfo val)
Adds the provided value to the list of 'appsInfo' values.
|
void |
addAppsStats(SrvMonAppStats val)
Adds the provided value to the list of 'appsStats' values.
|
void |
addPoolStats(SrvMonPoolStats val)
Adds the provided value to the list of 'poolStats' values.
|
void |
clearAdminClientStats()
Clears the value of 'adminClientStats'.
|
void |
clearAppsInfo()
Clears the value of 'appsInfo'.
|
void |
clearAppsStats()
Clears the value of 'appsStats'.
|
void |
clearCollectionEndTime()
Clears the value of 'collectionEndTime'.
|
void |
clearCollectionStartTime()
Clears the value of 'collectionStartTime'.
|
void |
clearCollectionStartWallTime()
Clears the value of 'collectionStartWallTime'.
|
void |
clearHeartbeatLoggerStats()
Clears the value of 'heartbeatLoggerStats'.
|
void |
clearLoadedTime()
Clears the value of 'loadedTime'.
|
void |
clearPoolStats()
Clears the value of 'poolStats'.
|
void |
clearServerHostName()
Clears the value of 'serverHostName'.
|
void |
clearServerName()
Clears the value of 'serverName'.
|
void |
clearServerPid()
Clears the value of 'serverPid'.
|
void |
clearSysStats()
Clears the value of 'sysStats'.
|
void |
clearSystemName()
Clears the value of 'systemName'.
|
void |
clearSystemVersion()
Clears the value of 'systemVersion'.
|
void |
clearXvmHeader()
Clears the value of 'xvmHeader'.
|
SrvMonHeartbeatMessage |
copy()
Creates a copy of this SrvMonHeartbeatMessage.
|
void |
copyInto(SrvMonHeartbeatMessage target)
Copies the contents of this SrvMonHeartbeatMessage into the target.
|
SrvMonAdminClientStats[] |
getAdminClientStats()
Gets the value of 'adminClientStats'.
|
SrvMonAdminClientStats[] |
getAdminClientStatsEmptyIfNull()
Gets the value of 'adminClientStats' or an empty array if the value is
null or not set. |
XIterator<SrvMonAdminClientStats> |
getAdminClientStatsIterator()
Gets the value of 'adminClientStats' as iterator of values.
|
SrvMonAppInfo[] |
getAppsInfo()
Gets the value of 'appsInfo'.
|
SrvMonAppInfo[] |
getAppsInfoEmptyIfNull()
Gets the value of 'appsInfo' or an empty array if the value is
null or not set. |
XIterator<SrvMonAppInfo> |
getAppsInfoIterator()
Gets the value of 'appsInfo' as iterator of values.
|
SrvMonAppStats[] |
getAppsStats()
Gets the value of 'appsStats'.
|
SrvMonAppStats[] |
getAppsStatsEmptyIfNull()
Gets the value of 'appsStats' or an empty array if the value is
null or not set. |
XIterator<SrvMonAppStats> |
getAppsStatsIterator()
Gets the value of 'appsStats' as iterator of values.
|
long |
getCollectionEndTime()
Gets the value of 'collectionEndTime'.
|
long |
getCollectionStartTime()
Gets the value of 'collectionStartTime'.
|
long |
getCollectionStartWallTime()
Gets the value of 'collectionStartWallTime'.
|
SrvMonAppMessageLoggerStats |
getHeartbeatLoggerStats()
Gets the value of 'heartbeatLoggerStats'.
|
void |
getHeartbeatLoggerStatsTo(SrvMonAppMessageLoggerStats val)
Copies the value of SrvMonAppMessageLoggerStats into the provided value.
|
Date |
getLoadedTime()
Gets the value of 'loadedTime'.
|
long |
getLoadedTimeAsTimestamp()
Retrieves the date as a timestamp (a zero garbage operation for XBuf encoding).
|
SrvMonPoolStats[] |
getPoolStats()
Gets the value of 'poolStats'.
|
SrvMonPoolStats[] |
getPoolStatsEmptyIfNull()
Gets the value of 'poolStats' or an empty array if the value is
null or not set. |
XIterator<SrvMonPoolStats> |
getPoolStatsIterator()
Gets the value of 'poolStats' as iterator of values.
|
String |
getServerHostName()
Gets the value of 'serverHostName'.
|
<T extends XString> |
getServerHostNameTo(XString.Factory<T> factory)
Copies the value of this String field into a new XString from the given factory.
|
void |
getServerHostNameTo(XString val)
Copies the value of 'serverHostName' into the provided XString.
|
XString |
getServerHostNameUnsafe()
Gets the raw value of 'serverHostName'.
|
String |
getServerName()
Gets the value of 'serverName'.
|
<T extends XString> |
getServerNameTo(XString.Factory<T> factory)
Copies the value of this String field into a new XString from the given factory.
|
void |
getServerNameTo(XString val)
Copies the value of 'serverName' into the provided XString.
|
XString |
getServerNameUnsafe()
Gets the raw value of 'serverName'.
|
String |
getServerPid()
Gets the value of 'serverPid'.
|
<T extends XString> |
getServerPidTo(XString.Factory<T> factory)
Copies the value of this String field into a new XString from the given factory.
|
void |
getServerPidTo(XString val)
Copies the value of 'serverPid' into the provided XString.
|
XString |
getServerPidUnsafe()
Gets the raw value of 'serverPid'.
|
SrvMonSysStats |
getSysStats()
Gets the value of 'sysStats'.
|
void |
getSysStatsTo(SrvMonSysStats val)
Copies the value of SrvMonSysStats into the provided value.
|
String |
getSystemName()
Gets the value of 'systemName'.
|
<T extends XString> |
getSystemNameTo(XString.Factory<T> factory)
Copies the value of this String field into a new XString from the given factory.
|
void |
getSystemNameTo(XString val)
Copies the value of 'systemName' into the provided XString.
|
XString |
getSystemNameUnsafe()
Gets the raw value of 'systemName'.
|
String |
getSystemVersion()
Gets the value of 'systemVersion'.
|
<T extends XString> |
getSystemVersionTo(XString.Factory<T> factory)
Copies the value of this String field into a new XString from the given factory.
|
void |
getSystemVersionTo(XString val)
Copies the value of 'systemVersion' into the provided XString.
|
XString |
getSystemVersionUnsafe()
Gets the raw value of 'systemVersion'.
|
com.neeve.server.mon.common.SrvMonXvmHeader |
getXvmHeader()
Gets the value of 'xvmHeader'.
|
void |
getXvmHeaderTo(com.neeve.server.mon.common.SrvMonXvmHeader val)
Copies the value of SrvMonXvmHeader into the provided value.
|
boolean |
hasCollectionEndTime()
Checks for the presence of 'collectionEndTime'.
|
boolean |
hasCollectionStartTime()
Checks for the presence of 'collectionStartTime'.
|
boolean |
hasCollectionStartWallTime()
Checks for the presence of 'collectionStartWallTime'.
|
boolean |
hasHeartbeatLoggerStats()
Checks for the presence of 'heartbeatLoggerStats'.
|
boolean |
hasLoadedTime()
Checks for the presence of 'loadedTime'.
|
boolean |
hasServerHostName()
Checks for the presence of 'serverHostName'.
|
boolean |
hasServerName()
Checks for the presence of 'serverName'.
|
boolean |
hasServerPid()
Checks for the presence of 'serverPid'.
|
boolean |
hasSysStats()
Checks for the presence of 'sysStats'.
|
boolean |
hasSystemName()
Checks for the presence of 'systemName'.
|
boolean |
hasSystemVersion()
Checks for the presence of 'systemVersion'.
|
boolean |
hasXvmHeader()
Checks for the presence of 'xvmHeader'.
|
void |
lendAdminClientStats(SrvMonAdminClientStats val)
Adds the provided value to the list of 'adminClientStats' values and acquires a reference to it.
|
void |
lendAdminClientStats(SrvMonAdminClientStats[] val)
Lends the value of 'adminClientStats'.
|
void |
lendAdminClientStatsFrom(XIterator<SrvMonAdminClientStats> val)
Sets the value of 'adminClientStats' by lending the values from the provided iterator.
|
void |
lendAppsInfo(SrvMonAppInfo val)
Adds the provided value to the list of 'appsInfo' values and acquires a reference to it.
|
void |
lendAppsInfo(SrvMonAppInfo[] val)
Lends the value of 'appsInfo'.
|
void |
lendAppsInfoFrom(XIterator<SrvMonAppInfo> val)
Sets the value of 'appsInfo' by lending the values from the provided iterator.
|
void |
lendAppsStats(SrvMonAppStats val)
Adds the provided value to the list of 'appsStats' values and acquires a reference to it.
|
void |
lendAppsStats(SrvMonAppStats[] val)
Lends the value of 'appsStats'.
|
void |
lendAppsStatsFrom(XIterator<SrvMonAppStats> val)
Sets the value of 'appsStats' by lending the values from the provided iterator.
|
void |
lendHeartbeatLoggerStats(SrvMonAppMessageLoggerStats val)
'Lends' a reference of the SrvMonAppMessageLoggerStats to the message for this field.
|
void |
lendPoolStats(SrvMonPoolStats val)
Adds the provided value to the list of 'poolStats' values and acquires a reference to it.
|
void |
lendPoolStats(SrvMonPoolStats[] val)
Lends the value of 'poolStats'.
|
void |
lendPoolStatsFrom(XIterator<SrvMonPoolStats> val)
Sets the value of 'poolStats' by lending the values from the provided iterator.
|
void |
lendServerHostName(XString val)
Lends the value of 'serverHostName' to this object.
|
void |
lendServerName(XString val)
Lends the value of 'serverName' to this object.
|
void |
lendServerPid(XString val)
Lends the value of 'serverPid' to this object.
|
void |
lendSysStats(SrvMonSysStats val)
'Lends' a reference of the SrvMonSysStats to the message for this field.
|
void |
lendSystemName(XString val)
Lends the value of 'systemName' to this object.
|
void |
lendSystemVersion(XString val)
Lends the value of 'systemVersion' to this object.
|
void |
lendXvmHeader(com.neeve.server.mon.common.SrvMonXvmHeader val)
'Lends' a reference of the SrvMonXvmHeader to the message for this field.
|
void |
setAdminClientStats(SrvMonAdminClientStats[] val)
Sets the value of 'adminClientStats'.
|
void |
setAdminClientStatsFrom(XIterator<SrvMonAdminClientStats> val)
Sets the value of 'adminClientStats' using the values from the provided iterator.
|
void |
setAppsInfo(SrvMonAppInfo[] val)
Sets the value of 'appsInfo'.
|
void |
setAppsInfoFrom(XIterator<SrvMonAppInfo> val)
Sets the value of 'appsInfo' using the values from the provided iterator.
|
void |
setAppsStats(SrvMonAppStats[] val)
Sets the value of 'appsStats'.
|
void |
setAppsStatsFrom(XIterator<SrvMonAppStats> val)
Sets the value of 'appsStats' using the values from the provided iterator.
|
void |
setCollectionEndTime(long val)
Sets the value of 'collectionEndTime'.
|
void |
setCollectionStartTime(long val)
Sets the value of 'collectionStartTime'.
|
void |
setCollectionStartWallTime(long val)
Sets the value of 'collectionStartWallTime'.
|
void |
setHeartbeatLoggerStats(SrvMonAppMessageLoggerStats val)
Sets the value of 'heartbeatLoggerStats'.
|
void |
setLoadedTime(Date val)
Sets the value of 'loadedTime'.
|
void |
setLoadedTimeAsTimestamp(long val)
Sets the date value as a timestamp.
|
void |
setPoolStats(SrvMonPoolStats[] val)
Sets the value of 'poolStats'.
|
void |
setPoolStatsFrom(XIterator<SrvMonPoolStats> val)
Sets the value of 'poolStats' using the values from the provided iterator.
|
void |
setServerHostName(String val)
Sets the value of 'serverHostName'.
|
void |
setServerHostNameFrom(long val)
Sets the value of this String field to the given numeric value.
|
void |
setServerHostNameFrom(XString val)
Copies the provided XString value into this object's 'serverHostName'.
|
void |
setServerName(String val)
Sets the value of 'serverName'.
|
void |
setServerNameFrom(long val)
Sets the value of this String field to the given numeric value.
|
void |
setServerNameFrom(XString val)
Copies the provided XString value into this object's 'serverName'.
|
void |
setServerPid(String val)
Sets the value of 'serverPid'.
|
void |
setServerPidFrom(long val)
Sets the value of this String field to the given numeric value.
|
void |
setServerPidFrom(XString val)
Copies the provided XString value into this object's 'serverPid'.
|
void |
setSysStats(SrvMonSysStats val)
Sets the value of 'sysStats'.
|
void |
setSystemName(String val)
Sets the value of 'systemName'.
|
void |
setSystemNameFrom(long val)
Sets the value of this String field to the given numeric value.
|
void |
setSystemNameFrom(XString val)
Copies the provided XString value into this object's 'systemName'.
|
void |
setSystemVersion(String val)
Sets the value of 'systemVersion'.
|
void |
setSystemVersionFrom(long val)
Sets the value of this String field to the given numeric value.
|
void |
setSystemVersionFrom(XString val)
Copies the provided XString value into this object's 'systemVersion'.
|
void |
setXvmHeader(com.neeve.server.mon.common.SrvMonXvmHeader val)
Sets the value of 'xvmHeader'.
|
SrvMonAdminClientStats[] |
takeAdminClientStats()
Takes the value of 'adminClientStats'.
|
SrvMonAppInfo[] |
takeAppsInfo()
Takes the value of 'appsInfo'.
|
SrvMonAppStats[] |
takeAppsStats()
Takes the value of 'appsStats'.
|
SrvMonAppMessageLoggerStats |
takeHeartbeatLoggerStats()
'Takes' a reference to the heartbeatLoggerStats field from the message.
|
SrvMonPoolStats[] |
takePoolStats()
Takes the value of 'poolStats'.
|
SrvMonSysStats |
takeSysStats()
'Takes' a reference to the sysStats field from the message.
|
com.neeve.server.mon.common.SrvMonXvmHeader |
takeXvmHeader()
'Takes' a reference to the xvmHeader field from the message.
|
deserializeFromProtobuf, dispose, dump, getAttachment, getIsLiveInboundMessage, getIsPriority, getIsReadOnly, getMetadata, getParent, getPoolingListener, getType, metadataToJsonString, serializeToProtobuf, setAsInboundMessage, setAsInternal, setAsLastTransaction, setAsMessage, setAsOutboundMessage, setAsPriority, setAsReadOnly, setAsReplayedMessage, setAttachment, setInMsgsInTransaction, setOutMsgsInTransaction, setParentId, setPoolingListener, setTransactionInSequenceNumber, setTransactionOutSequenceNumber
acquire, deserialize, deserializeMetadata, deserializeMetadata, getContentEncodingType, getOwnershipCount, getSerializedMetadataLength, getStoreMetadata, serialize, serializeMetadata, setFieldValue
ensureId, getBinding, getCheckpointVersion, getCommittedDataSize, getId, getOfid, getStableTransactionId, getTransactionId, setBinding, setCheckpointVersion, setCommittedDataSize, setId, setStableTransactionId, setTransactionId
getMessageReflector
getEnqueueTs, getEnqueueTsMicros, getGraphId, getInMsgsInTransaction, getIsInboundMessage, getIsInternal, getIsLastTransaction, getIsMessage, getIsOutboundMessage, getIsReplayedMessage, getMessageBus, getMessageChannel, getMessageFlow, getMessageKey, getMessageSender, getMessageSequenceNumber, getMessageTransportHeaders, getOutMsgsInTransaction, getOutTs, getOutTsMicros, getParentId, getPreProcessingTs, getPreProcessingTsMicros, getTransactionInSequenceNumber, getTransactionOutSequenceNumber, isPossibleDuplicate, metadataToJsonString, metadataToString
getValidationErrors, isValid
void setCollectionStartWallTime(long val)
val
- The value to set.long getCollectionStartWallTime()
void clearCollectionStartWallTime()
setCollectionStartWallTime(long)
boolean hasCollectionStartWallTime()
getCollectionStartWallTime()
void setCollectionStartTime(long val)
val
- The value to set.long getCollectionStartTime()
void clearCollectionStartTime()
setCollectionStartTime(long)
boolean hasCollectionStartTime()
getCollectionStartTime()
void setCollectionEndTime(long val)
val
- The value to set.long getCollectionEndTime()
void clearCollectionEndTime()
setCollectionEndTime(long)
boolean hasCollectionEndTime()
getCollectionEndTime()
void setLoadedTime(Date val)
val
- The value to set.Date getLoadedTime()
void setLoadedTimeAsTimestamp(long val)
val
- The date value in milliseconds from the epochlong getLoadedTimeAsTimestamp()
NOTE:
Note that a return value of -1 could also indicate 1 millisecond before the epoch.
In cases where a such an ambiguity is a practical concern, hasLoadedTime()
should be called.
void clearLoadedTime()
setLoadedTime(Date)
boolean hasLoadedTime()
getLoadedTime()
void setXvmHeader(com.neeve.server.mon.common.SrvMonXvmHeader val)
setXvmHeader
in interface com.neeve.server.mon.common.IHasSrvMonXvmHeader
val
- The value to set.void lendXvmHeader(com.neeve.server.mon.common.SrvMonXvmHeader val)
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.
lendXvmHeader
in interface com.neeve.server.mon.common.IHasSrvMonXvmHeader
val
- the value to 'lend' to lend.com.neeve.server.mon.common.SrvMonXvmHeader getXvmHeader()
getXvmHeader
in interface com.neeve.server.mon.common.IHasSrvMonXvmHeader
void getXvmHeaderTo(com.neeve.server.mon.common.SrvMonXvmHeader val)
IF the value is not set, then the contents of the provided SrvMonXvmHeader are cleared.
getXvmHeaderTo
in interface com.neeve.server.mon.common.IHasSrvMonXvmHeader
val
- the value to copy intoSrvMonXvmHeader.copyInto(SrvMonXvmHeader)
com.neeve.server.mon.common.SrvMonXvmHeader takeXvmHeader()
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.
takeXvmHeader
in interface com.neeve.server.mon.common.IHasSrvMonXvmHeader
null
if the field is not set.boolean hasXvmHeader()
hasXvmHeader
in interface com.neeve.server.mon.common.IHasSrvMonXvmHeader
getXvmHeader()
void clearXvmHeader()
clearXvmHeader
in interface com.neeve.server.mon.common.IHasSrvMonXvmHeader
setXvmHeader(SrvMonXvmHeader)
void setServerName(String val)
val
- The value to set.String getServerName()
void lendServerName(XString val)
This method is equivalent to setServerName 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.
val
- The value to set.IllegalArgumentException
- If the value is mutable.void setServerNameFrom(long val)
NOTE:
This is the same as calling setServerName(String)
.
with Long.valueOf(val).toString(), except that using this method is a zero garbage
operation for Xbuf encoding.
<T extends XString> T getServerNameTo(XString.Factory<T> factory)
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;
factory
- The factory from which to get the XString to copy into and returnnull
.NullPointerException
- if the provided factory is nullvoid setServerNameFrom(XString val)
NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this setter
can be more efficient than setServerName(String)
because it avoids encoding the value into a String
if the given XString
is already encoded.
void getServerNameTo(XString val)
NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this getter
can be more efficient than getServerName()
bec
because it can avoid decoding the value into an String
.
getServerName()
XString getServerNameUnsafe()
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.
getServerName()
void clearServerName()
setServerName(String)
boolean hasServerName()
getServerName()
void setServerHostName(String val)
val
- The value to set.String getServerHostName()
void lendServerHostName(XString val)
This method is equivalent to setServerHostName 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.
val
- The value to set.IllegalArgumentException
- If the value is mutable.void setServerHostNameFrom(long val)
NOTE:
This is the same as calling setServerHostName(String)
.
with Long.valueOf(val).toString(), except that using this method is a zero garbage
operation for Xbuf encoding.
<T extends XString> T getServerHostNameTo(XString.Factory<T> factory)
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;
factory
- The factory from which to get the XString to copy into and returnnull
.NullPointerException
- if the provided factory is nullvoid setServerHostNameFrom(XString val)
NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this setter
can be more efficient than setServerHostName(String)
because it avoids encoding the value into a String
if the given XString
is already encoded.
void getServerHostNameTo(XString val)
NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this getter
can be more efficient than getServerHostName()
bec
because it can avoid decoding the value into an String
.
getServerHostName()
XString getServerHostNameUnsafe()
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.
getServerHostName()
void clearServerHostName()
setServerHostName(String)
boolean hasServerHostName()
getServerHostName()
void setServerPid(String val)
val
- The value to set.String getServerPid()
void lendServerPid(XString val)
This method is equivalent to setServerPid 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.
val
- The value to set.IllegalArgumentException
- If the value is mutable.void setServerPidFrom(long val)
NOTE:
This is the same as calling setServerPid(String)
.
with Long.valueOf(val).toString(), except that using this method is a zero garbage
operation for Xbuf encoding.
<T extends XString> T getServerPidTo(XString.Factory<T> factory)
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;
factory
- The factory from which to get the XString to copy into and returnnull
.NullPointerException
- if the provided factory is nullvoid setServerPidFrom(XString val)
NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this setter
can be more efficient than setServerPid(String)
because it avoids encoding the value into a String
if the given XString
is already encoded.
void getServerPidTo(XString val)
NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this getter
can be more efficient than getServerPid()
bec
because it can avoid decoding the value into an String
.
getServerPid()
XString getServerPidUnsafe()
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.
getServerPid()
void clearServerPid()
setServerPid(String)
boolean hasServerPid()
getServerPid()
void setSysStats(SrvMonSysStats val)
val
- The value to set.void lendSysStats(SrvMonSysStats val)
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.
val
- the value to 'lend' to lend.SrvMonSysStats getSysStats()
void getSysStatsTo(SrvMonSysStats val)
IF the value is not set, then the contents of the provided SrvMonSysStats are cleared.
val
- the value to copy intoSrvMonSysStats.copyInto(SrvMonSysStats)
SrvMonSysStats takeSysStats()
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.
null
if the field is not set.boolean hasSysStats()
getSysStats()
void clearSysStats()
setSysStats(SrvMonSysStats)
void setPoolStats(SrvMonPoolStats[] val)
val
- The value to set.void setPoolStatsFrom(XIterator<SrvMonPoolStats> val)
This method will call XIterator.toFirst()
before and after setting the values, meaning
that all values from the iterator will be set and the iterator will be reset on return.
This method is zero garbage for Xbuf generated classes, and this method is optimized such that calling this with an iterator from another 'poolStats' accessor can copy the values without iteration.
NOTE:
Passing a null
or empty list has the same affect as calling setPoolStats(SrvMonPoolStats[])
with
a value of null
.
val
- the values to set.void lendPoolStatsFrom(XIterator<SrvMonPoolStats> val)
This method will call XIterator.toFirst()
before and after setting the values, meaning
that all values from the iterator will be set and the iterator will be reset on return.
This method will acquire references to each non null value in the provided iterator making it suitable for cases where the values come from another message that may be disposed.
This method is zero garbage for Xbuf generated classes, and this method is optimized such that calling this with an iterator from another 'poolStats' accessor can copy the values without iteration.
NOTE:
Passing a null
or empty list has the same affect as calling setPoolStats(SrvMonPoolStats[])
with
a value of null
.
val
- the values to set.void addPoolStats(SrvMonPoolStats val)
This method is zero garbage for Xbuf generated classes, and this method is optimized such that calling this with an iterator from another 'poolStats' accessor can copy the values without iteration.
For objects generated with json encoding, or transactional state entities, using this method is currently efficient than doing a bulk set. For xbuf generated messages however, this method is optimized to directly serialize to an encoded backing buffer.
val
- the value to add.void lendPoolStats(SrvMonPoolStats val)
Lending of an added value is useful in cases where a field is being added from a source message to provide dispose of the source value when the source message is disposed.
This method is zero garbage for Xbuf generated classes, and this method is optimized such that calling this with an iterator from another 'poolStats' accessor can copy the values without iteration.
For objects generated with json encoding, or transactional state entities, using this method is currently efficient than doing a bulk set. For xbuf generated messages however, this method is optimized to directly serialize to an encoded backing buffer.
val
- the value to add.XIterator<SrvMonPoolStats> getPoolStatsIterator()
This method will always return a non null iterator value. The returned iterator is not threadsafe, and the caller may not hold on to it beyond the pooling lifespan of this object. Depending on the implementation, the same iterator instance may be returned by this object on each call to avoid garbage. Each time this method is called the iterator is reset by calling its toFirst() method. Callers should therefore be especially careful about calling this method while iterating on the iterator returned by this method.
The elements returned by this iterator are owned by and pooled along with this object. The caller must call acquire() on each returned object that it intends to keep beyond the either the next call to next(), toFirst() or the lifespace of this object as each object returned by this iterator is disposed on a subsequent call to next() or when this object is disposed.
This method is zero garbage for Xbuf generated classes, and this method is optimized such that
passing the returned iterator to another object's setXXX(XIterator
void lendPoolStats(SrvMonPoolStats[] val)
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.
val
- the value to 'lend' to lend.SrvMonPoolStats[] getPoolStats()
If the field is not set this method will return null
.
null
.SrvMonPoolStats[] getPoolStatsEmptyIfNull()
null
or not set.
null
if not set.getPoolStats()
SrvMonPoolStats[] takePoolStats()
NOTE:
A nested entity reference returned by getPoolStats()
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.
null
if the field is not set.void clearPoolStats()
setPoolStats(SrvMonPoolStats[])
void setAppsInfo(SrvMonAppInfo[] val)
val
- The value to set.void setAppsInfoFrom(XIterator<SrvMonAppInfo> val)
This method will call XIterator.toFirst()
before and after setting the values, meaning
that all values from the iterator will be set and the iterator will be reset on return.
This method is zero garbage for Xbuf generated classes, and this method is optimized such that calling this with an iterator from another 'appsInfo' accessor can copy the values without iteration.
NOTE:
Passing a null
or empty list has the same affect as calling setAppsInfo(SrvMonAppInfo[])
with
a value of null
.
val
- the values to set.void lendAppsInfoFrom(XIterator<SrvMonAppInfo> val)
This method will call XIterator.toFirst()
before and after setting the values, meaning
that all values from the iterator will be set and the iterator will be reset on return.
This method will acquire references to each non null value in the provided iterator making it suitable for cases where the values come from another message that may be disposed.
This method is zero garbage for Xbuf generated classes, and this method is optimized such that calling this with an iterator from another 'appsInfo' accessor can copy the values without iteration.
NOTE:
Passing a null
or empty list has the same affect as calling setAppsInfo(SrvMonAppInfo[])
with
a value of null
.
val
- the values to set.void addAppsInfo(SrvMonAppInfo val)
This method is zero garbage for Xbuf generated classes, and this method is optimized such that calling this with an iterator from another 'appsInfo' accessor can copy the values without iteration.
For objects generated with json encoding, or transactional state entities, using this method is currently efficient than doing a bulk set. For xbuf generated messages however, this method is optimized to directly serialize to an encoded backing buffer.
val
- the value to add.void lendAppsInfo(SrvMonAppInfo val)
Lending of an added value is useful in cases where a field is being added from a source message to provide dispose of the source value when the source message is disposed.
This method is zero garbage for Xbuf generated classes, and this method is optimized such that calling this with an iterator from another 'appsInfo' accessor can copy the values without iteration.
For objects generated with json encoding, or transactional state entities, using this method is currently efficient than doing a bulk set. For xbuf generated messages however, this method is optimized to directly serialize to an encoded backing buffer.
val
- the value to add.XIterator<SrvMonAppInfo> getAppsInfoIterator()
This method will always return a non null iterator value. The returned iterator is not threadsafe, and the caller may not hold on to it beyond the pooling lifespan of this object. Depending on the implementation, the same iterator instance may be returned by this object on each call to avoid garbage. Each time this method is called the iterator is reset by calling its toFirst() method. Callers should therefore be especially careful about calling this method while iterating on the iterator returned by this method.
The elements returned by this iterator are owned by and pooled along with this object. The caller must call acquire() on each returned object that it intends to keep beyond the either the next call to next(), toFirst() or the lifespace of this object as each object returned by this iterator is disposed on a subsequent call to next() or when this object is disposed.
This method is zero garbage for Xbuf generated classes, and this method is optimized such that
passing the returned iterator to another object's setXXX(XIterator
void lendAppsInfo(SrvMonAppInfo[] val)
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.
val
- the value to 'lend' to lend.SrvMonAppInfo[] getAppsInfo()
If the field is not set this method will return null
.
null
.SrvMonAppInfo[] getAppsInfoEmptyIfNull()
null
or not set.
null
if not set.getAppsInfo()
SrvMonAppInfo[] takeAppsInfo()
NOTE:
A nested entity reference returned by getAppsInfo()
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.
null
if the field is not set.void clearAppsInfo()
setAppsInfo(SrvMonAppInfo[])
void setAppsStats(SrvMonAppStats[] val)
val
- The value to set.void setAppsStatsFrom(XIterator<SrvMonAppStats> val)
This method will call XIterator.toFirst()
before and after setting the values, meaning
that all values from the iterator will be set and the iterator will be reset on return.
This method is zero garbage for Xbuf generated classes, and this method is optimized such that calling this with an iterator from another 'appsStats' accessor can copy the values without iteration.
NOTE:
Passing a null
or empty list has the same affect as calling setAppsStats(SrvMonAppStats[])
with
a value of null
.
val
- the values to set.void lendAppsStatsFrom(XIterator<SrvMonAppStats> val)
This method will call XIterator.toFirst()
before and after setting the values, meaning
that all values from the iterator will be set and the iterator will be reset on return.
This method will acquire references to each non null value in the provided iterator making it suitable for cases where the values come from another message that may be disposed.
This method is zero garbage for Xbuf generated classes, and this method is optimized such that calling this with an iterator from another 'appsStats' accessor can copy the values without iteration.
NOTE:
Passing a null
or empty list has the same affect as calling setAppsStats(SrvMonAppStats[])
with
a value of null
.
val
- the values to set.void addAppsStats(SrvMonAppStats val)
This method is zero garbage for Xbuf generated classes, and this method is optimized such that calling this with an iterator from another 'appsStats' accessor can copy the values without iteration.
For objects generated with json encoding, or transactional state entities, using this method is currently efficient than doing a bulk set. For xbuf generated messages however, this method is optimized to directly serialize to an encoded backing buffer.
val
- the value to add.void lendAppsStats(SrvMonAppStats val)
Lending of an added value is useful in cases where a field is being added from a source message to provide dispose of the source value when the source message is disposed.
This method is zero garbage for Xbuf generated classes, and this method is optimized such that calling this with an iterator from another 'appsStats' accessor can copy the values without iteration.
For objects generated with json encoding, or transactional state entities, using this method is currently efficient than doing a bulk set. For xbuf generated messages however, this method is optimized to directly serialize to an encoded backing buffer.
val
- the value to add.XIterator<SrvMonAppStats> getAppsStatsIterator()
This method will always return a non null iterator value. The returned iterator is not threadsafe, and the caller may not hold on to it beyond the pooling lifespan of this object. Depending on the implementation, the same iterator instance may be returned by this object on each call to avoid garbage. Each time this method is called the iterator is reset by calling its toFirst() method. Callers should therefore be especially careful about calling this method while iterating on the iterator returned by this method.
The elements returned by this iterator are owned by and pooled along with this object. The caller must call acquire() on each returned object that it intends to keep beyond the either the next call to next(), toFirst() or the lifespace of this object as each object returned by this iterator is disposed on a subsequent call to next() or when this object is disposed.
This method is zero garbage for Xbuf generated classes, and this method is optimized such that
passing the returned iterator to another object's setXXX(XIterator
void lendAppsStats(SrvMonAppStats[] val)
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.
val
- the value to 'lend' to lend.SrvMonAppStats[] getAppsStats()
If the field is not set this method will return null
.
null
.SrvMonAppStats[] getAppsStatsEmptyIfNull()
null
or not set.
null
if not set.getAppsStats()
SrvMonAppStats[] takeAppsStats()
NOTE:
A nested entity reference returned by getAppsStats()
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.
null
if the field is not set.void clearAppsStats()
setAppsStats(SrvMonAppStats[])
void setAdminClientStats(SrvMonAdminClientStats[] val)
val
- The value to set.void setAdminClientStatsFrom(XIterator<SrvMonAdminClientStats> val)
This method will call XIterator.toFirst()
before and after setting the values, meaning
that all values from the iterator will be set and the iterator will be reset on return.
This method is zero garbage for Xbuf generated classes, and this method is optimized such that calling this with an iterator from another 'adminClientStats' accessor can copy the values without iteration.
NOTE:
Passing a null
or empty list has the same affect as calling setAdminClientStats(SrvMonAdminClientStats[])
with
a value of null
.
val
- the values to set.void lendAdminClientStatsFrom(XIterator<SrvMonAdminClientStats> val)
This method will call XIterator.toFirst()
before and after setting the values, meaning
that all values from the iterator will be set and the iterator will be reset on return.
This method will acquire references to each non null value in the provided iterator making it suitable for cases where the values come from another message that may be disposed.
This method is zero garbage for Xbuf generated classes, and this method is optimized such that calling this with an iterator from another 'adminClientStats' accessor can copy the values without iteration.
NOTE:
Passing a null
or empty list has the same affect as calling setAdminClientStats(SrvMonAdminClientStats[])
with
a value of null
.
val
- the values to set.void addAdminClientStats(SrvMonAdminClientStats val)
This method is zero garbage for Xbuf generated classes, and this method is optimized such that calling this with an iterator from another 'adminClientStats' accessor can copy the values without iteration.
For objects generated with json encoding, or transactional state entities, using this method is currently efficient than doing a bulk set. For xbuf generated messages however, this method is optimized to directly serialize to an encoded backing buffer.
val
- the value to add.void lendAdminClientStats(SrvMonAdminClientStats val)
Lending of an added value is useful in cases where a field is being added from a source message to provide dispose of the source value when the source message is disposed.
This method is zero garbage for Xbuf generated classes, and this method is optimized such that calling this with an iterator from another 'adminClientStats' accessor can copy the values without iteration.
For objects generated with json encoding, or transactional state entities, using this method is currently efficient than doing a bulk set. For xbuf generated messages however, this method is optimized to directly serialize to an encoded backing buffer.
val
- the value to add.XIterator<SrvMonAdminClientStats> getAdminClientStatsIterator()
This method will always return a non null iterator value. The returned iterator is not threadsafe, and the caller may not hold on to it beyond the pooling lifespan of this object. Depending on the implementation, the same iterator instance may be returned by this object on each call to avoid garbage. Each time this method is called the iterator is reset by calling its toFirst() method. Callers should therefore be especially careful about calling this method while iterating on the iterator returned by this method.
The elements returned by this iterator are owned by and pooled along with this object. The caller must call acquire() on each returned object that it intends to keep beyond the either the next call to next(), toFirst() or the lifespace of this object as each object returned by this iterator is disposed on a subsequent call to next() or when this object is disposed.
This method is zero garbage for Xbuf generated classes, and this method is optimized such that
passing the returned iterator to another object's setXXX(XIterator
void lendAdminClientStats(SrvMonAdminClientStats[] val)
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.
val
- the value to 'lend' to lend.SrvMonAdminClientStats[] getAdminClientStats()
If the field is not set this method will return null
.
null
.SrvMonAdminClientStats[] getAdminClientStatsEmptyIfNull()
null
or not set.
null
if not set.getAdminClientStats()
SrvMonAdminClientStats[] takeAdminClientStats()
NOTE:
A nested entity reference returned by getAdminClientStats()
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.
null
if the field is not set.void clearAdminClientStats()
void setSystemName(String val)
val
- The value to set.String getSystemName()
void lendSystemName(XString val)
This method is equivalent to setSystemName 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.
val
- The value to set.IllegalArgumentException
- If the value is mutable.void setSystemNameFrom(long val)
NOTE:
This is the same as calling setSystemName(String)
.
with Long.valueOf(val).toString(), except that using this method is a zero garbage
operation for Xbuf encoding.
<T extends XString> T getSystemNameTo(XString.Factory<T> factory)
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;
factory
- The factory from which to get the XString to copy into and returnnull
.NullPointerException
- if the provided factory is nullvoid setSystemNameFrom(XString val)
NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this setter
can be more efficient than setSystemName(String)
because it avoids encoding the value into a String
if the given XString
is already encoded.
void getSystemNameTo(XString val)
NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this getter
can be more efficient than getSystemName()
bec
because it can avoid decoding the value into an String
.
getSystemName()
XString getSystemNameUnsafe()
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.
getSystemName()
void clearSystemName()
setSystemName(String)
boolean hasSystemName()
getSystemName()
void setSystemVersion(String val)
val
- The value to set.String getSystemVersion()
void lendSystemVersion(XString val)
This method is equivalent to setSystemVersion 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.
val
- The value to set.IllegalArgumentException
- If the value is mutable.void setSystemVersionFrom(long val)
NOTE:
This is the same as calling setSystemVersion(String)
.
with Long.valueOf(val).toString(), except that using this method is a zero garbage
operation for Xbuf encoding.
<T extends XString> T getSystemVersionTo(XString.Factory<T> factory)
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;
factory
- The factory from which to get the XString to copy into and returnnull
.NullPointerException
- if the provided factory is nullvoid setSystemVersionFrom(XString val)
NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this setter
can be more efficient than setSystemVersion(String)
because it avoids encoding the value into a String
if the given XString
is already encoded.
void getSystemVersionTo(XString val)
NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this getter
can be more efficient than getSystemVersion()
bec
because it can avoid decoding the value into an String
.
getSystemVersion()
XString getSystemVersionUnsafe()
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.
getSystemVersion()
void clearSystemVersion()
setSystemVersion(String)
boolean hasSystemVersion()
getSystemVersion()
void setHeartbeatLoggerStats(SrvMonAppMessageLoggerStats val)
val
- The value to set.void lendHeartbeatLoggerStats(SrvMonAppMessageLoggerStats val)
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.
val
- the value to 'lend' to lend.SrvMonAppMessageLoggerStats getHeartbeatLoggerStats()
void getHeartbeatLoggerStatsTo(SrvMonAppMessageLoggerStats val)
IF the value is not set, then the contents of the provided SrvMonAppMessageLoggerStats are cleared.
val
- the value to copy intoSrvMonAppMessageLoggerStats.copyInto(SrvMonAppMessageLoggerStats)
SrvMonAppMessageLoggerStats takeHeartbeatLoggerStats()
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.
null
if the field is not set.boolean hasHeartbeatLoggerStats()
getHeartbeatLoggerStats()
void clearHeartbeatLoggerStats()
SrvMonHeartbeatMessage copy()
The copy copies primitive, enum and embedded entity fields into the returned copy. Each embedded entity field is cloned so that modifications made to the copy's embedded entity fields do not affect this SrvMonHeartbeatMessage's embedded entity fields.
The returned copy will be writeable even if this SrvMonHeartbeatMessage is read only.
No metadata is copied except as documented IRogCopyableNode
.
See IRogCopyableNode
for more detailed information on the semantics of this method.
copy
in interface CopyableMessageView<ISrvMonHeartbeatMessage>
copy
in interface IRogCopyableNode<ISrvMonHeartbeatMessage>
IRogCopyableNode
,
CopyableMessageView
void copyInto(SrvMonHeartbeatMessage target)
The copy clears the target's contents and copies primitive, enum and embedded entity fields into the provided copy. Each embedded entity field is cloned so that modifications made to the copy's embedded entity fields do not affect this SrvMonHeartbeatMessage's embedded entity fields.
The returned copy will be writeable even if this SrvMonHeartbeatMessage is read only.
No metadata is copied except as documented IRogCopyableNode
.
See IRogCopyableNode
for more detailed information on the semantics of this method.
target
- The target to copy into which must not be null or read only.Copyright © 2019 Neeve Research, LLC. All Rights Reserved.