com.neeve.server.mon
Interface ISrvMonAppStats

All Superinterfaces:
IRogValidatable
All Known Implementing Classes:
SrvMonAppStats

@Generated(value="com.neeve.adm.AdmGenerator",
           date="Wed Mar 28 10:54:31 EDT 2018")
@AdmGenerated(compatLevel="3.8.0",
              admVersion="nvx-adm v3.7.265 (build 0)",
              date="3/28/18 10:54 AM",
              buildInfo="nvx-talon-3.7.265 (nvx-codegen-plugin)")
public interface ISrvMonAppStats
extends IRogValidatable

Groups together stats for an application.


Method Summary
 void addBusBindingStats(SrvMonAppBusBindingStats val)
          Adds the provided value to the list of 'busBindingStats' values.
 void clearAppName()
          Clears the value of 'appName' Field Description The application name
 void clearBusBindingStats()
          Clears the value of 'busBindingStats' Field Description The applications messaging stats for each configured bus
 void clearEngineStats()
          Clears the value of 'engineStats' Field Description The application's engine stats
 void clearEventMultiplexerStats()
          Clears the value of 'eventMultiplexerStats' Field Description The application's input event multiplexer stats
 void clearStoreBindingStats()
          Clears the value of 'storeBindingStats' Field Description The application's replication and persistent disk storage stats
 void clearUserStats()
          Clears the value of 'userStats' Field Description The application's user defined stats
 String getAppName()
          Gets the value of 'appName' Field Description The application name
<T extends XString>
T
getAppNameTo(XString.Factory<T> factory)
          Copies the value of this String field into a new XString from the given factory.
 void getAppNameTo(XString val)
          Copies the value of 'appName' into the provided XString.
 XString getAppNameUnsafe()
          Gets the raw value of 'appName'.
 SrvMonAppBusBindingStats[] getBusBindingStats()
          Gets the value of 'busBindingStats' If the field is not set this method will return null.
 SrvMonAppBusBindingStats[] getBusBindingStatsEmptyIfNull()
          Gets the value of 'busBindingStats' or an empty array if the value is null or not set.
 XIterator<SrvMonAppBusBindingStats> getBusBindingStatsIterator()
          Gets the value of 'busBindingStats' as iterator of values.
 SrvMonAppEngineStats getEngineStats()
          Gets the value of 'engineStats' Field Description The application's engine stats
 void getEngineStatsTo(SrvMonAppEngineStats val)
          Copies the value of SrvMonAppEngineStats into the provided value.
 SrvMonAppEventMultiplexerStats getEventMultiplexerStats()
          Gets the value of 'eventMultiplexerStats' Field Description The application's input event multiplexer stats
 void getEventMultiplexerStatsTo(SrvMonAppEventMultiplexerStats val)
          Copies the value of SrvMonAppEventMultiplexerStats into the provided value.
 SrvMonAppStoreBindingStats getStoreBindingStats()
          Gets the value of 'storeBindingStats' Field Description The application's replication and persistent disk storage stats
 void getStoreBindingStatsTo(SrvMonAppStoreBindingStats val)
          Copies the value of SrvMonAppStoreBindingStats into the provided value.
 SrvMonUserStats getUserStats()
          Gets the value of 'userStats' Field Description The application's user defined stats
 void getUserStatsTo(SrvMonUserStats val)
          Copies the value of SrvMonUserStats into the provided value.
 boolean hasAppName()
          Checks for the presence of 'appName' Field Description The application name
 boolean hasEngineStats()
          Checks for the presence of 'engineStats' Field Description The application's engine stats
 boolean hasEventMultiplexerStats()
          Checks for the presence of 'eventMultiplexerStats' Field Description The application's input event multiplexer stats
 boolean hasStoreBindingStats()
          Checks for the presence of 'storeBindingStats' Field Description The application's replication and persistent disk storage stats
 boolean hasUserStats()
          Checks for the presence of 'userStats' Field Description The application's user defined stats
 void lendAppName(XString val)
          Sets the value of 'appName' Field Description The application name
 void lendBusBindingStats(SrvMonAppBusBindingStats val)
          Adds the provided value to the list of 'busBindingStats' values and acquires a reference to it.
 void lendBusBindingStats(SrvMonAppBusBindingStats[] val)
          Lends the value of 'busBindingStats' Field Description The applications messaging stats for each configured bus NOTE:
It is illegal to hold onto an entity 'set' on a message post the disposal of the container message.
 void lendBusBindingStatsFrom(XIterator<SrvMonAppBusBindingStats> val)
          Sets the value of 'busBindingStats' by lending the values from the provided iterator.
 void lendEngineStats(SrvMonAppEngineStats val)
          'Lends' a reference of the SrvMonAppEngineStats to the message for this field.
 void lendEventMultiplexerStats(SrvMonAppEventMultiplexerStats val)
          'Lends' a reference of the SrvMonAppEventMultiplexerStats to the message for this field.
 void lendStoreBindingStats(SrvMonAppStoreBindingStats val)
          'Lends' a reference of the SrvMonAppStoreBindingStats to the message for this field.
 void lendUserStats(SrvMonUserStats val)
          'Lends' a reference of the SrvMonUserStats to the message for this field.
 void setAppName(String val)
          Sets the value of 'appName' Field Description The application name
 void setAppNameFrom(long val)
          Sets the value of this String field to the given numeric value.
 void setAppNameFrom(XString val)
          Copies the provided XString value into this object's 'appName'.
 void setBusBindingStats(SrvMonAppBusBindingStats[] val)
          Sets the value of 'busBindingStats' Field Description The applications messaging stats for each configured bus
 void setBusBindingStatsFrom(XIterator<SrvMonAppBusBindingStats> val)
          Sets the value of 'busBindingStats' using the values from the provided iterator.
 void setEngineStats(SrvMonAppEngineStats val)
          Sets the value of 'engineStats' Field Description The application's engine stats
 void setEventMultiplexerStats(SrvMonAppEventMultiplexerStats val)
          Sets the value of 'eventMultiplexerStats' Field Description The application's input event multiplexer stats
 void setStoreBindingStats(SrvMonAppStoreBindingStats val)
          Sets the value of 'storeBindingStats' Field Description The application's replication and persistent disk storage stats
 void setUserStats(SrvMonUserStats val)
          Sets the value of 'userStats' Field Description The application's user defined stats
 SrvMonAppBusBindingStats[] takeBusBindingStats()
          Takes the value of 'busBindingStats' Field Description The applications messaging stats for each configured bus NOTE:
A nested entity reference returned by getBusBindingStats() 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.
 SrvMonAppEngineStats takeEngineStats()
          'Takes' a reference to the engineStats field from the message.
 SrvMonAppEventMultiplexerStats takeEventMultiplexerStats()
          'Takes' a reference to the eventMultiplexerStats field from the message.
 SrvMonAppStoreBindingStats takeStoreBindingStats()
          'Takes' a reference to the storeBindingStats field from the message.
 SrvMonUserStats takeUserStats()
          'Takes' a reference to the userStats field from the message.
 
Methods inherited from interface com.neeve.rog.IRogValidatable
getValidationErrors, isValid
 

Method Detail

setAppName

void setAppName(String val)
Sets the value of 'appName'

Field Description

The application name

Parameters:
val - The value to set.

getAppName

String getAppName()
Gets the value of 'appName'

Field Description

The application name

Returns:
The application name

lendAppName

void lendAppName(XString val)
Sets the value of 'appName'

Field Description

The application name

Parameters:
val - The value to set.

setAppNameFrom

void setAppNameFrom(long val)
Sets the value of this String field to the given numeric value.

Field Description

The application name

NOTE:
This is the same as calling setAppName(String). with Long.valueOf(val).toString(), except that using this method is a zero garbage operation for Xbuf encoding.


getAppNameTo

<T extends XString> T getAppNameTo(XString.Factory<T> factory)
Copies the value of this String field into a new XString from the given factory.

Field Description

The application name

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;

Parameters:
factory - The factory from which to get the XString to copy into and return
Returns:
a new XString from the provided factory if this field is set or null.
Throws:
NullPointerException - if the provided factory is null

setAppNameFrom

void setAppNameFrom(XString val)
Copies the provided XString value into this object's 'appName'.

Field Description

The application name

NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this setter can be more efficient than setAppName(String) because it avoids encoding the value into a String if the given XString is already encoded.


getAppNameTo

void getAppNameTo(XString val)
Copies the value of 'appName' into the provided XString.

Field Description

The application name

NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this getter can be more efficient than getAppName() bec because it can avoid decoding the value into an String.

See Also:
getAppName()

getAppNameUnsafe

XString getAppNameUnsafe()
Gets the raw value of 'appName'.

Field Description

The application name

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.

Returns:
the field's raw value
See Also:
getAppName()

clearAppName

void clearAppName()
Clears the value of 'appName'

Field Description

The application name

See Also:
setAppName(String)

hasAppName

boolean hasAppName()
Checks for the presence of 'appName'

Field Description

The application name

See Also:
getAppName()

setEngineStats

void setEngineStats(SrvMonAppEngineStats val)
Sets the value of 'engineStats'

Field Description

The application's engine stats

Parameters:
val - The value to set.

lendEngineStats

void lendEngineStats(SrvMonAppEngineStats val)
'Lends' a reference of the SrvMonAppEngineStats to the message for this field.

Field Description

The application's engine stats

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.

Parameters:
val - the value to 'lend' to lend.

getEngineStats

SrvMonAppEngineStats getEngineStats()
Gets the value of 'engineStats'

Field Description

The application's engine stats

Returns:
The application's engine stats

getEngineStatsTo

void getEngineStatsTo(SrvMonAppEngineStats val)
Copies the value of SrvMonAppEngineStats into the provided value.

IF the value is not set, then the contents of the provided SrvMonAppEngineStats are cleared.

Parameters:
val - the value to copy into
See Also:
SrvMonAppEngineStats.copyInto(SrvMonAppEngineStats)

takeEngineStats

SrvMonAppEngineStats takeEngineStats()
'Takes' a reference to the engineStats field from the message.

Field Description

The application's engine stats

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.

Returns:
a 'taken' reference to the field or null if the field is not set.

hasEngineStats

boolean hasEngineStats()
Checks for the presence of 'engineStats'

Field Description

The application's engine stats

See Also:
getEngineStats()

clearEngineStats

void clearEngineStats()
Clears the value of 'engineStats'

Field Description

The application's engine stats

See Also:
setEngineStats(SrvMonAppEngineStats)

setEventMultiplexerStats

void setEventMultiplexerStats(SrvMonAppEventMultiplexerStats val)
Sets the value of 'eventMultiplexerStats'

Field Description

The application's input event multiplexer stats

Parameters:
val - The value to set.

lendEventMultiplexerStats

void lendEventMultiplexerStats(SrvMonAppEventMultiplexerStats val)
'Lends' a reference of the SrvMonAppEventMultiplexerStats to the message for this field.

Field Description

The application's input event multiplexer stats

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.

Parameters:
val - the value to 'lend' to lend.

getEventMultiplexerStats

SrvMonAppEventMultiplexerStats getEventMultiplexerStats()
Gets the value of 'eventMultiplexerStats'

Field Description

The application's input event multiplexer stats

Returns:
The application's input event multiplexer stats

getEventMultiplexerStatsTo

void getEventMultiplexerStatsTo(SrvMonAppEventMultiplexerStats val)
Copies the value of SrvMonAppEventMultiplexerStats into the provided value.

IF the value is not set, then the contents of the provided SrvMonAppEventMultiplexerStats are cleared.

Parameters:
val - the value to copy into
See Also:
SrvMonAppEventMultiplexerStats.copyInto(SrvMonAppEventMultiplexerStats)

takeEventMultiplexerStats

SrvMonAppEventMultiplexerStats takeEventMultiplexerStats()
'Takes' a reference to the eventMultiplexerStats field from the message.

Field Description

The application's input event multiplexer stats

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.

Returns:
a 'taken' reference to the field or null if the field is not set.

hasEventMultiplexerStats

boolean hasEventMultiplexerStats()
Checks for the presence of 'eventMultiplexerStats'

Field Description

The application's input event multiplexer stats

See Also:
getEventMultiplexerStats()

clearEventMultiplexerStats

void clearEventMultiplexerStats()
Clears the value of 'eventMultiplexerStats'

Field Description

The application's input event multiplexer stats

See Also:
setEventMultiplexerStats(SrvMonAppEventMultiplexerStats)

setStoreBindingStats

void setStoreBindingStats(SrvMonAppStoreBindingStats val)
Sets the value of 'storeBindingStats'

Field Description

The application's replication and persistent disk storage stats

Parameters:
val - The value to set.

lendStoreBindingStats

void lendStoreBindingStats(SrvMonAppStoreBindingStats val)
'Lends' a reference of the SrvMonAppStoreBindingStats to the message for this field.

Field Description

The application's replication and persistent disk storage stats

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.

Parameters:
val - the value to 'lend' to lend.

getStoreBindingStats

SrvMonAppStoreBindingStats getStoreBindingStats()
Gets the value of 'storeBindingStats'

Field Description

The application's replication and persistent disk storage stats

Returns:
The application's replication and persistent disk storage stats

getStoreBindingStatsTo

void getStoreBindingStatsTo(SrvMonAppStoreBindingStats val)
Copies the value of SrvMonAppStoreBindingStats into the provided value.

IF the value is not set, then the contents of the provided SrvMonAppStoreBindingStats are cleared.

Parameters:
val - the value to copy into
See Also:
SrvMonAppStoreBindingStats.copyInto(SrvMonAppStoreBindingStats)

takeStoreBindingStats

SrvMonAppStoreBindingStats takeStoreBindingStats()
'Takes' a reference to the storeBindingStats field from the message.

Field Description

The application's replication and persistent disk storage stats

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.

Returns:
a 'taken' reference to the field or null if the field is not set.

hasStoreBindingStats

boolean hasStoreBindingStats()
Checks for the presence of 'storeBindingStats'

Field Description

The application's replication and persistent disk storage stats

See Also:
getStoreBindingStats()

clearStoreBindingStats

void clearStoreBindingStats()
Clears the value of 'storeBindingStats'

Field Description

The application's replication and persistent disk storage stats

See Also:
setStoreBindingStats(SrvMonAppStoreBindingStats)

setBusBindingStats

void setBusBindingStats(SrvMonAppBusBindingStats[] val)
Sets the value of 'busBindingStats'

Field Description

The applications messaging stats for each configured bus

Parameters:
val - The value to set.

setBusBindingStatsFrom

void setBusBindingStatsFrom(XIterator<SrvMonAppBusBindingStats> val)
Sets the value of 'busBindingStats' using the values from the provided iterator.

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 'busBindingStats' accessor can copy the values without iteration.

Field Description

The applications messaging stats for each configured bus

NOTE:
Passing a null or empty list has the same affect as calling setBusBindingStats(SrvMonAppBusBindingStats[]) with a value of null.

Parameters:
val - the values to set.

lendBusBindingStatsFrom

void lendBusBindingStatsFrom(XIterator<SrvMonAppBusBindingStats> val)
Sets the value of 'busBindingStats' by lending the values from the provided iterator.

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 'busBindingStats' accessor can copy the values without iteration.

Field Description

The applications messaging stats for each configured bus

NOTE:
Passing a null or empty list has the same affect as calling setBusBindingStats(SrvMonAppBusBindingStats[]) with a value of null.

Parameters:
val - the values to set.

addBusBindingStats

void addBusBindingStats(SrvMonAppBusBindingStats val)
Adds the provided value to the list of 'busBindingStats' values.

This method is zero garbage for Xbuf generated classes, and this method is optimized such that calling this with an iterator from another 'busBindingStats' 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.

Field Description

The applications messaging stats for each configured bus

Parameters:
val - the value to add.

lendBusBindingStats

void lendBusBindingStats(SrvMonAppBusBindingStats val)
Adds the provided value to the list of 'busBindingStats' values and acquires a reference to it.

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 'busBindingStats' 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.

Field Description

The applications messaging stats for each configured bus

Parameters:
val - the value to add.

getBusBindingStatsIterator

XIterator<SrvMonAppBusBindingStats> getBusBindingStatsIterator()
Gets the value of 'busBindingStats' as iterator of values.

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 this object intends to keep beyond the lifespan. of this object (unless the element is lent to another object in which that object will acquire it then).

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 method can perform a direct copy of the underlying values without iteration.

Field Description

The applications messaging stats for each configured bus

Returns:
An iterator containing this field values.

lendBusBindingStats

void lendBusBindingStats(SrvMonAppBusBindingStats[] val)
Lends the value of 'busBindingStats'

Field Description

The applications messaging stats for each configured bus

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.

Parameters:
val - the value to 'lend' to lend.

getBusBindingStats

SrvMonAppBusBindingStats[] getBusBindingStats()
Gets the value of 'busBindingStats'

If the field is not set this method will return null.

Field Description

The applications messaging stats for each configured bus

Returns:
The applications messaging stats for each configured bus If the field is not set this method will return null.

getBusBindingStatsEmptyIfNull

SrvMonAppBusBindingStats[] getBusBindingStatsEmptyIfNull()
Gets the value of 'busBindingStats' or an empty array if the value is null or not set.

Field Description

The applications messaging stats for each configured bus

Returns:
The applications messaging stats for each configured bus or an empty array if null if not set.
See Also:
getBusBindingStats()

takeBusBindingStats

SrvMonAppBusBindingStats[] takeBusBindingStats()
Takes the value of 'busBindingStats'

Field Description

The applications messaging stats for each configured bus

NOTE:
A nested entity reference returned by getBusBindingStats() 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.

Returns:
a 'taken' reference to the field or null if the field is not set.

clearBusBindingStats

void clearBusBindingStats()
Clears the value of 'busBindingStats'

Field Description

The applications messaging stats for each configured bus

See Also:
setBusBindingStats(SrvMonAppBusBindingStats[])

setUserStats

void setUserStats(SrvMonUserStats val)
Sets the value of 'userStats'

Field Description

The application's user defined stats

Parameters:
val - The value to set.

lendUserStats

void lendUserStats(SrvMonUserStats val)
'Lends' a reference of the SrvMonUserStats to the message for this field.

Field Description

The application's user defined stats

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.

Parameters:
val - the value to 'lend' to lend.

getUserStats

SrvMonUserStats getUserStats()
Gets the value of 'userStats'

Field Description

The application's user defined stats

Returns:
The application's user defined stats

getUserStatsTo

void getUserStatsTo(SrvMonUserStats val)
Copies the value of SrvMonUserStats into the provided value.

IF the value is not set, then the contents of the provided SrvMonUserStats are cleared.

Parameters:
val - the value to copy into
See Also:
SrvMonUserStats.copyInto(SrvMonUserStats)

takeUserStats

SrvMonUserStats takeUserStats()
'Takes' a reference to the userStats field from the message.

Field Description

The application's user defined stats

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.

Returns:
a 'taken' reference to the field or null if the field is not set.

hasUserStats

boolean hasUserStats()
Checks for the presence of 'userStats'

Field Description

The application's user defined stats

See Also:
getUserStats()

clearUserStats

void clearUserStats()
Clears the value of 'userStats'

Field Description

The application's user defined stats

See Also:
setUserStats(SrvMonUserStats)


Copyright © 2016 Neeve Research, LLC. All Rights Reserved.