com.neeve.server.mon
Interface ISrvMonAppInfo

All Superinterfaces:
IRogValidatable
All Known Implementing Classes:
SrvMonAppInfo

@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 ISrvMonAppInfo
extends IRogValidatable

Holds information about an application.


Method Summary
 void addBusBindingsInfo(SrvMonAppBusBindingInfo val)
          Adds the provided value to the list of 'busBindingsInfo' values.
 void addClientsInfo(SrvMonAppClientInfo val)
          Adds the provided value to the list of 'clientsInfo' values.
 void addFlowsInfo(SrvMonAppFlowInfo val)
          Adds the provided value to the list of 'flowsInfo' values.
 void clearBusBindingsInfo()
          Clears the value of 'busBindingsInfo' Field Description Holds information about a app's message bus bindings.
 void clearClientsInfo()
          Clears the value of 'clientsInfo' Field Description Holds information about a app's connected clients.
 void clearFlowsInfo()
          Clears the value of 'flowsInfo' Field Description Holds information about a app's active message flows.
 void clearHAPolicy()
          Clears the value of 'HAPolicy' Field Description The application's HAPolicy.
 void clearJarVersion()
          Deprecated. - No Reason Given
 void clearJarVersionString()
          Clears the value of 'jarVersionString' Field Description The jar version of the application (if specified/known)
 void clearLoadedTime()
          Clears the value of 'loadedTime' Field Description The time at which the app was last loaded
 void clearName()
          Clears the value of 'name' Field Description The application's name.
 void clearRole()
          Clears the value of 'role' Field Description The application's current HA role.
 void clearState()
          Clears the value of 'state' Field Description The application's current state.
 void clearVersion()
          Clears the value of 'version' Field Description The application version if (if specified/known).
 SrvMonAppBusBindingInfo[] getBusBindingsInfo()
          Gets the value of 'busBindingsInfo' If the field is not set this method will return null.
 SrvMonAppBusBindingInfo[] getBusBindingsInfoEmptyIfNull()
          Gets the value of 'busBindingsInfo' or an empty array if the value is null or not set.
 XIterator<SrvMonAppBusBindingInfo> getBusBindingsInfoIterator()
          Gets the value of 'busBindingsInfo' as iterator of values.
 SrvMonAppClientInfo[] getClientsInfo()
          Gets the value of 'clientsInfo' If the field is not set this method will return null.
 SrvMonAppClientInfo[] getClientsInfoEmptyIfNull()
          Gets the value of 'clientsInfo' or an empty array if the value is null or not set.
 XIterator<SrvMonAppClientInfo> getClientsInfoIterator()
          Gets the value of 'clientsInfo' as iterator of values.
 SrvMonAppFlowInfo[] getFlowsInfo()
          Gets the value of 'flowsInfo' If the field is not set this method will return null.
 SrvMonAppFlowInfo[] getFlowsInfoEmptyIfNull()
          Gets the value of 'flowsInfo' or an empty array if the value is null or not set.
 XIterator<SrvMonAppFlowInfo> getFlowsInfoIterator()
          Gets the value of 'flowsInfo' as iterator of values.
 SrvMonAppHAPolicy getHAPolicy()
          Gets the value of 'HAPolicy' Field Description The application's HAPolicy.
 int getJarVersion()
          Deprecated. - No Reason Given
 String getJarVersionString()
          Gets the value of 'jarVersionString' Field Description The jar version of the application (if specified/known)
<T extends XString>
T
getJarVersionStringTo(XString.Factory<T> factory)
          Copies the value of this String field into a new XString from the given factory.
 void getJarVersionStringTo(XString val)
          Copies the value of 'jarVersionString' into the provided XString.
 XString getJarVersionStringUnsafe()
          Gets the raw value of 'jarVersionString'.
 Date getLoadedTime()
          Gets the value of 'loadedTime' Field Description The time at which the app was last loaded
 long getLoadedTimeAsTimestamp()
          Retrieves the date as a timestamp (a zero garbage operation for XBuf encoding).
 String getName()
          Gets the value of 'name' Field Description The application's name.
<T extends XString>
T
getNameTo(XString.Factory<T> factory)
          Copies the value of this String field into a new XString from the given factory.
 void getNameTo(XString val)
          Copies the value of 'name' into the provided XString.
 XString getNameUnsafe()
          Gets the raw value of 'name'.
 SrvMonAppRole getRole()
          Gets the value of 'role' Field Description The application's current HA role.
 SrvMonAppState getState()
          Gets the value of 'state' Field Description The application's current state.
 int getVersion()
          Gets the value of 'version' Field Description The application version if (if specified/known).
 boolean hasHAPolicy()
          Checks for the presence of 'HAPolicy' Field Description The application's HAPolicy.
 boolean hasJarVersion()
          Deprecated. - No Reason Given
 boolean hasJarVersionString()
          Checks for the presence of 'jarVersionString' Field Description The jar version of the application (if specified/known)
 boolean hasLoadedTime()
          Checks for the presence of 'loadedTime' Field Description The time at which the app was last loaded
 boolean hasName()
          Checks for the presence of 'name' Field Description The application's name.
 boolean hasRole()
          Checks for the presence of 'role' Field Description The application's current HA role.
 boolean hasState()
          Checks for the presence of 'state' Field Description The application's current state.
 boolean hasVersion()
          Checks for the presence of 'version' Field Description The application version if (if specified/known).
 void lendBusBindingsInfo(SrvMonAppBusBindingInfo val)
          Adds the provided value to the list of 'busBindingsInfo' values and acquires a reference to it.
 void lendBusBindingsInfo(SrvMonAppBusBindingInfo[] val)
          Lends the value of 'busBindingsInfo' Field Description Holds information about a app's message bus bindings.
 void lendBusBindingsInfoFrom(XIterator<SrvMonAppBusBindingInfo> val)
          Sets the value of 'busBindingsInfo' by lending the values from the provided iterator.
 void lendClientsInfo(SrvMonAppClientInfo val)
          Adds the provided value to the list of 'clientsInfo' values and acquires a reference to it.
 void lendClientsInfo(SrvMonAppClientInfo[] val)
          Lends the value of 'clientsInfo' Field Description Holds information about a app's connected clients.
 void lendClientsInfoFrom(XIterator<SrvMonAppClientInfo> val)
          Sets the value of 'clientsInfo' by lending the values from the provided iterator.
 void lendFlowsInfo(SrvMonAppFlowInfo val)
          Adds the provided value to the list of 'flowsInfo' values and acquires a reference to it.
 void lendFlowsInfo(SrvMonAppFlowInfo[] val)
          Lends the value of 'flowsInfo' Field Description Holds information about a app's active message flows.
 void lendFlowsInfoFrom(XIterator<SrvMonAppFlowInfo> val)
          Sets the value of 'flowsInfo' by lending the values from the provided iterator.
 void lendJarVersionString(XString val)
          Sets the value of 'jarVersionString' Field Description The jar version of the application (if specified/known)
 void lendName(XString val)
          Sets the value of 'name' Field Description The application's name.
 void setBusBindingsInfo(SrvMonAppBusBindingInfo[] val)
          Sets the value of 'busBindingsInfo' Field Description Holds information about a app's message bus bindings.
 void setBusBindingsInfoFrom(XIterator<SrvMonAppBusBindingInfo> val)
          Sets the value of 'busBindingsInfo' using the values from the provided iterator.
 void setClientsInfo(SrvMonAppClientInfo[] val)
          Sets the value of 'clientsInfo' Field Description Holds information about a app's connected clients.
 void setClientsInfoFrom(XIterator<SrvMonAppClientInfo> val)
          Sets the value of 'clientsInfo' using the values from the provided iterator.
 void setFlowsInfo(SrvMonAppFlowInfo[] val)
          Sets the value of 'flowsInfo' Field Description Holds information about a app's active message flows.
 void setFlowsInfoFrom(XIterator<SrvMonAppFlowInfo> val)
          Sets the value of 'flowsInfo' using the values from the provided iterator.
 void setHAPolicy(SrvMonAppHAPolicy val)
          Sets the value of 'HAPolicy' Field Description The application's HAPolicy.
 void setJarVersion(int val)
          Deprecated. - No Reason Given
 void setJarVersionString(String val)
          Sets the value of 'jarVersionString' Field Description The jar version of the application (if specified/known)
 void setJarVersionStringFrom(long val)
          Sets the value of this String field to the given numeric value.
 void setJarVersionStringFrom(XString val)
          Copies the provided XString value into this object's 'jarVersionString'.
 void setLoadedTime(Date val)
          Sets the value of 'loadedTime' Field Description The time at which the app was last loaded
 void setLoadedTimeAsTimestamp(long val)
          Sets the date value as a timestamp.
 void setName(String val)
          Sets the value of 'name' Field Description The application's name.
 void setNameFrom(long val)
          Sets the value of this String field to the given numeric value.
 void setNameFrom(XString val)
          Copies the provided XString value into this object's 'name'.
 void setRole(SrvMonAppRole val)
          Sets the value of 'role' Field Description The application's current HA role.
 void setState(SrvMonAppState val)
          Sets the value of 'state' Field Description The application's current state.
 void setVersion(int val)
          Sets the value of 'version' Field Description The application version if (if specified/known).
 SrvMonAppBusBindingInfo[] takeBusBindingsInfo()
          Takes the value of 'busBindingsInfo' Field Description Holds information about a app's message bus bindings.
 SrvMonAppClientInfo[] takeClientsInfo()
          Takes the value of 'clientsInfo' Field Description Holds information about a app's connected clients.
 SrvMonAppFlowInfo[] takeFlowsInfo()
          Takes the value of 'flowsInfo' Field Description Holds information about a app's active message flows.
 
Methods inherited from interface com.neeve.rog.IRogValidatable
getValidationErrors, isValid
 

Method Detail

setVersion

void setVersion(int val)
Sets the value of 'version'

Field Description

The application version if (if specified/known). Typically this will come from the app's @AppVersion

Parameters:
val - The value to set.

getVersion

int getVersion()
Gets the value of 'version'

Field Description

The application version if (if specified/known). Typically this will come from the app's @AppVersion

Returns:
The application version if (if specified/known). Typically this will come from the app's @AppVersion

clearVersion

void clearVersion()
Clears the value of 'version'

Field Description

The application version if (if specified/known). Typically this will come from the app's @AppVersion

See Also:
setVersion(int)

hasVersion

boolean hasVersion()
Checks for the presence of 'version'

Field Description

The application version if (if specified/known). Typically this will come from the app's @AppVersion

See Also:
getVersion()

setJarVersion

@Deprecated
void setJarVersion(int val)
Deprecated. - No Reason Given

Sets the value of 'jarVersion'

Field Description

The jar version of the application (if specified/known)

Parameters:
val - The value to set.

getJarVersion

@Deprecated
int getJarVersion()
Deprecated. - No Reason Given

Gets the value of 'jarVersion'

Field Description

The jar version of the application (if specified/known)

Returns:
The jar version of the application (if specified/known)

clearJarVersion

@Deprecated
void clearJarVersion()
Deprecated. - No Reason Given

Clears the value of 'jarVersion'

Field Description

The jar version of the application (if specified/known)

See Also:
setJarVersion(int)

hasJarVersion

@Deprecated
boolean hasJarVersion()
Deprecated. - No Reason Given

Checks for the presence of 'jarVersion'

Field Description

The jar version of the application (if specified/known)

See Also:
getJarVersion()

setState

void setState(SrvMonAppState val)
Sets the value of 'state'

Field Description

The application's current state.

Parameters:
val - The value to set.

getState

SrvMonAppState getState()
Gets the value of 'state'

Field Description

The application's current state.

Returns:
The application's current state.

clearState

void clearState()
Clears the value of 'state'

Field Description

The application's current state.

See Also:
setState(SrvMonAppState)

hasState

boolean hasState()
Checks for the presence of 'state'

Field Description

The application's current state.

See Also:
getState()

setRole

void setRole(SrvMonAppRole val)
Sets the value of 'role'

Field Description

The application's current HA role.

Parameters:
val - The value to set.

getRole

SrvMonAppRole getRole()
Gets the value of 'role'

Field Description

The application's current HA role.

Returns:
The application's current HA role.

clearRole

void clearRole()
Clears the value of 'role'

Field Description

The application's current HA role.

See Also:
setRole(SrvMonAppRole)

hasRole

boolean hasRole()
Checks for the presence of 'role'

Field Description

The application's current HA role.

See Also:
getRole()

setHAPolicy

void setHAPolicy(SrvMonAppHAPolicy val)
Sets the value of 'HAPolicy'

Field Description

The application's HAPolicy.

Parameters:
val - The value to set.

getHAPolicy

SrvMonAppHAPolicy getHAPolicy()
Gets the value of 'HAPolicy'

Field Description

The application's HAPolicy.

Returns:
The application's HAPolicy.

clearHAPolicy

void clearHAPolicy()
Clears the value of 'HAPolicy'

Field Description

The application's HAPolicy.

See Also:
setHAPolicy(SrvMonAppHAPolicy)

hasHAPolicy

boolean hasHAPolicy()
Checks for the presence of 'HAPolicy'

Field Description

The application's HAPolicy.

See Also:
getHAPolicy()

setLoadedTime

void setLoadedTime(Date val)
Sets the value of 'loadedTime'

Field Description

The time at which the app was last loaded

Parameters:
val - The value to set.

getLoadedTime

Date getLoadedTime()
Gets the value of 'loadedTime'

Field Description

The time at which the app was last loaded

Returns:
The time at which the app was last loaded

setLoadedTimeAsTimestamp

void setLoadedTimeAsTimestamp(long val)
Sets the date value as a timestamp.

Field Description

The time at which the app was last loaded

Parameters:
val - The date value in milliseconds from the epoch

getLoadedTimeAsTimestamp

long getLoadedTimeAsTimestamp()
Retrieves the date as a timestamp (a zero garbage operation for XBuf encoding).

Field Description

The time at which the app was last loaded

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.

Returns:
The data as a timestamp in milliseconds from the epoch or -1 if null or not set

clearLoadedTime

void clearLoadedTime()
Clears the value of 'loadedTime'

Field Description

The time at which the app was last loaded

See Also:
setLoadedTime(Date)

hasLoadedTime

boolean hasLoadedTime()
Checks for the presence of 'loadedTime'

Field Description

The time at which the app was last loaded

See Also:
getLoadedTime()

setName

void setName(String val)
Sets the value of 'name'

Field Description

The application's name.

Parameters:
val - The value to set.

getName

String getName()
Gets the value of 'name'

Field Description

The application's name.

Returns:
The application's name.

lendName

void lendName(XString val)
Sets the value of 'name'

Field Description

The application's name.

Parameters:
val - The value to set.

setNameFrom

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

Field Description

The application's name.

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


getNameTo

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

Field Description

The application's 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

setNameFrom

void setNameFrom(XString val)
Copies the provided XString value into this object's 'name'.

Field Description

The application's name.

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


getNameTo

void getNameTo(XString val)
Copies the value of 'name' into the provided XString.

Field Description

The application's name.

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

See Also:
getName()

getNameUnsafe

XString getNameUnsafe()
Gets the raw value of 'name'.

Field Description

The application's 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:
getName()

clearName

void clearName()
Clears the value of 'name'

Field Description

The application's name.

See Also:
setName(String)

hasName

boolean hasName()
Checks for the presence of 'name'

Field Description

The application's name.

See Also:
getName()

setClientsInfo

void setClientsInfo(SrvMonAppClientInfo[] val)
Sets the value of 'clientsInfo'

Field Description

Holds information about a app's connected clients.

Parameters:
val - The value to set.

setClientsInfoFrom

void setClientsInfoFrom(XIterator<SrvMonAppClientInfo> val)
Sets the value of 'clientsInfo' 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 'clientsInfo' accessor can copy the values without iteration.

Field Description

Holds information about a app's connected clients.

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

Parameters:
val - the values to set.

lendClientsInfoFrom

void lendClientsInfoFrom(XIterator<SrvMonAppClientInfo> val)
Sets the value of 'clientsInfo' 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 'clientsInfo' accessor can copy the values without iteration.

Field Description

Holds information about a app's connected clients.

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

Parameters:
val - the values to set.

addClientsInfo

void addClientsInfo(SrvMonAppClientInfo val)
Adds the provided value to the list of 'clientsInfo' values.

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

Holds information about a app's connected clients.

Parameters:
val - the value to add.

lendClientsInfo

void lendClientsInfo(SrvMonAppClientInfo val)
Adds the provided value to the list of 'clientsInfo' 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 'clientsInfo' 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

Holds information about a app's connected clients.

Parameters:
val - the value to add.

getClientsInfoIterator

XIterator<SrvMonAppClientInfo> getClientsInfoIterator()
Gets the value of 'clientsInfo' 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

Holds information about a app's connected clients.

Returns:
An iterator containing this field values.

lendClientsInfo

void lendClientsInfo(SrvMonAppClientInfo[] val)
Lends the value of 'clientsInfo'

Field Description

Holds information about a app's connected clients.

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.

getClientsInfo

SrvMonAppClientInfo[] getClientsInfo()
Gets the value of 'clientsInfo'

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

Field Description

Holds information about a app's connected clients.

Returns:
Holds information about a app's connected clients. If the field is not set this method will return null.

getClientsInfoEmptyIfNull

SrvMonAppClientInfo[] getClientsInfoEmptyIfNull()
Gets the value of 'clientsInfo' or an empty array if the value is null or not set.

Field Description

Holds information about a app's connected clients.

Returns:
Holds information about a app's connected clients. or an empty array if null if not set.
See Also:
getClientsInfo()

takeClientsInfo

SrvMonAppClientInfo[] takeClientsInfo()
Takes the value of 'clientsInfo'

Field Description

Holds information about a app's connected clients.

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

clearClientsInfo

void clearClientsInfo()
Clears the value of 'clientsInfo'

Field Description

Holds information about a app's connected clients.

See Also:
setClientsInfo(SrvMonAppClientInfo[])

setBusBindingsInfo

void setBusBindingsInfo(SrvMonAppBusBindingInfo[] val)
Sets the value of 'busBindingsInfo'

Field Description

Holds information about a app's message bus bindings.

Parameters:
val - The value to set.

setBusBindingsInfoFrom

void setBusBindingsInfoFrom(XIterator<SrvMonAppBusBindingInfo> val)
Sets the value of 'busBindingsInfo' 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 'busBindingsInfo' accessor can copy the values without iteration.

Field Description

Holds information about a app's message bus bindings.

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

Parameters:
val - the values to set.

lendBusBindingsInfoFrom

void lendBusBindingsInfoFrom(XIterator<SrvMonAppBusBindingInfo> val)
Sets the value of 'busBindingsInfo' 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 'busBindingsInfo' accessor can copy the values without iteration.

Field Description

Holds information about a app's message bus bindings.

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

Parameters:
val - the values to set.

addBusBindingsInfo

void addBusBindingsInfo(SrvMonAppBusBindingInfo val)
Adds the provided value to the list of 'busBindingsInfo' values.

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

Holds information about a app's message bus bindings.

Parameters:
val - the value to add.

lendBusBindingsInfo

void lendBusBindingsInfo(SrvMonAppBusBindingInfo val)
Adds the provided value to the list of 'busBindingsInfo' 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 'busBindingsInfo' 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

Holds information about a app's message bus bindings.

Parameters:
val - the value to add.

getBusBindingsInfoIterator

XIterator<SrvMonAppBusBindingInfo> getBusBindingsInfoIterator()
Gets the value of 'busBindingsInfo' 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

Holds information about a app's message bus bindings.

Returns:
An iterator containing this field values.

lendBusBindingsInfo

void lendBusBindingsInfo(SrvMonAppBusBindingInfo[] val)
Lends the value of 'busBindingsInfo'

Field Description

Holds information about a app's message bus bindings.

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.

getBusBindingsInfo

SrvMonAppBusBindingInfo[] getBusBindingsInfo()
Gets the value of 'busBindingsInfo'

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

Field Description

Holds information about a app's message bus bindings.

Returns:
Holds information about a app's message bus bindings. If the field is not set this method will return null.

getBusBindingsInfoEmptyIfNull

SrvMonAppBusBindingInfo[] getBusBindingsInfoEmptyIfNull()
Gets the value of 'busBindingsInfo' or an empty array if the value is null or not set.

Field Description

Holds information about a app's message bus bindings.

Returns:
Holds information about a app's message bus bindings. or an empty array if null if not set.
See Also:
getBusBindingsInfo()

takeBusBindingsInfo

SrvMonAppBusBindingInfo[] takeBusBindingsInfo()
Takes the value of 'busBindingsInfo'

Field Description

Holds information about a app's message bus bindings.

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

clearBusBindingsInfo

void clearBusBindingsInfo()
Clears the value of 'busBindingsInfo'

Field Description

Holds information about a app's message bus bindings.

See Also:
setBusBindingsInfo(SrvMonAppBusBindingInfo[])

setFlowsInfo

void setFlowsInfo(SrvMonAppFlowInfo[] val)
Sets the value of 'flowsInfo'

Field Description

Holds information about a app's active message flows.

Parameters:
val - The value to set.

setFlowsInfoFrom

void setFlowsInfoFrom(XIterator<SrvMonAppFlowInfo> val)
Sets the value of 'flowsInfo' 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 'flowsInfo' accessor can copy the values without iteration.

Field Description

Holds information about a app's active message flows.

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

Parameters:
val - the values to set.

lendFlowsInfoFrom

void lendFlowsInfoFrom(XIterator<SrvMonAppFlowInfo> val)
Sets the value of 'flowsInfo' 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 'flowsInfo' accessor can copy the values without iteration.

Field Description

Holds information about a app's active message flows.

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

Parameters:
val - the values to set.

addFlowsInfo

void addFlowsInfo(SrvMonAppFlowInfo val)
Adds the provided value to the list of 'flowsInfo' values.

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

Holds information about a app's active message flows.

Parameters:
val - the value to add.

lendFlowsInfo

void lendFlowsInfo(SrvMonAppFlowInfo val)
Adds the provided value to the list of 'flowsInfo' 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 'flowsInfo' 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

Holds information about a app's active message flows.

Parameters:
val - the value to add.

getFlowsInfoIterator

XIterator<SrvMonAppFlowInfo> getFlowsInfoIterator()
Gets the value of 'flowsInfo' 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

Holds information about a app's active message flows.

Returns:
An iterator containing this field values.

lendFlowsInfo

void lendFlowsInfo(SrvMonAppFlowInfo[] val)
Lends the value of 'flowsInfo'

Field Description

Holds information about a app's active message flows.

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.

getFlowsInfo

SrvMonAppFlowInfo[] getFlowsInfo()
Gets the value of 'flowsInfo'

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

Field Description

Holds information about a app's active message flows.

Returns:
Holds information about a app's active message flows. If the field is not set this method will return null.

getFlowsInfoEmptyIfNull

SrvMonAppFlowInfo[] getFlowsInfoEmptyIfNull()
Gets the value of 'flowsInfo' or an empty array if the value is null or not set.

Field Description

Holds information about a app's active message flows.

Returns:
Holds information about a app's active message flows. or an empty array if null if not set.
See Also:
getFlowsInfo()

takeFlowsInfo

SrvMonAppFlowInfo[] takeFlowsInfo()
Takes the value of 'flowsInfo'

Field Description

Holds information about a app's active message flows.

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

clearFlowsInfo

void clearFlowsInfo()
Clears the value of 'flowsInfo'

Field Description

Holds information about a app's active message flows.

See Also:
setFlowsInfo(SrvMonAppFlowInfo[])

setJarVersionString

void setJarVersionString(String val)
Sets the value of 'jarVersionString'

Field Description

The jar version of the application (if specified/known)

Parameters:
val - The value to set.

getJarVersionString

String getJarVersionString()
Gets the value of 'jarVersionString'

Field Description

The jar version of the application (if specified/known)

Returns:
The jar version of the application (if specified/known)

lendJarVersionString

void lendJarVersionString(XString val)
Sets the value of 'jarVersionString'

Field Description

The jar version of the application (if specified/known)

Parameters:
val - The value to set.

setJarVersionStringFrom

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

Field Description

The jar version of the application (if specified/known)

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


getJarVersionStringTo

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

Field Description

The jar version of the application (if specified/known)

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

setJarVersionStringFrom

void setJarVersionStringFrom(XString val)
Copies the provided XString value into this object's 'jarVersionString'.

Field Description

The jar version of the application (if specified/known)

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


getJarVersionStringTo

void getJarVersionStringTo(XString val)
Copies the value of 'jarVersionString' into the provided XString.

Field Description

The jar version of the application (if specified/known)

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

See Also:
getJarVersionString()

getJarVersionStringUnsafe

XString getJarVersionStringUnsafe()
Gets the raw value of 'jarVersionString'.

Field Description

The jar version of the application (if specified/known)

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:
getJarVersionString()

clearJarVersionString

void clearJarVersionString()
Clears the value of 'jarVersionString'

Field Description

The jar version of the application (if specified/known)

See Also:
setJarVersionString(String)

hasJarVersionString

boolean hasJarVersionString()
Checks for the presence of 'jarVersionString'

Field Description

The jar version of the application (if specified/known)

See Also:
getJarVersionString()


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