@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 ISrvMonCommandDescription extends IRogValidatable
ADM Type | Embedded Entity |
Factory | SrvMonCncFactory |
ADM Field Summary |
---|
Field | Type | Id | Description |
---|---|---|---|
additionalArgs | Boolean | 6 | Whether or not this command will accept all arguments not otherwise described as an additional string argument (varargs). |
additionalArgsDescription | String | 9 | The description that describes how additional arguments should be specified. |
additionalArgsDisplayName | String | 10 | The display name to user for additional arguments. |
aliases | String[] | 2 | The command alias. |
arguments | SrvMonArgumentDescription[] | 4 | The available arguments to the command. |
description | String | 3 | The command description. |
displayName | String | 8 |
The display name for the command.
If a display name is not provided then the name should be used by tools. The display name is for display purposes only and cannot be used to invoke a command. |
group | String[] | 11 | The group hierarchy this command belongs to. |
hidden | Boolean | 12 | Whether or not the command is hidden/internal. |
name | String | 1 | The command name. |
options | SrvMonOptionDescription[] | 5 | The command options. |
returnType | SrvMonReturnType |
7 | The return type of this command. |
Modifier and Type | Method and Description |
---|---|
void |
addAliases(String val)
Adds the provided value to the list of 'aliases' values.
|
void |
addArguments(SrvMonArgumentDescription val)
Adds the provided value to the list of 'arguments' values.
|
void |
addGroup(String val)
Adds the provided value to the list of 'group' values.
|
void |
addOptions(SrvMonOptionDescription val)
Adds the provided value to the list of 'options' values.
|
void |
clearAdditionalArgs()
Clears the value of 'additionalArgs'.
|
void |
clearAdditionalArgsDescription()
Clears the value of 'additionalArgsDescription'.
|
void |
clearAdditionalArgsDisplayName()
Clears the value of 'additionalArgsDisplayName'.
|
void |
clearAliases()
Clears the value of 'aliases'.
|
void |
clearArguments()
Clears the value of 'arguments'.
|
void |
clearDescription()
Clears the value of 'description'.
|
void |
clearDisplayName()
Clears the value of 'displayName'.
|
void |
clearGroup()
Clears the value of 'group'.
|
void |
clearHidden()
Clears the value of 'hidden'.
|
void |
clearName()
Clears the value of 'name'.
|
void |
clearOptions()
Clears the value of 'options'.
|
void |
clearReturnType()
Clears the value of 'returnType'.
|
boolean |
getAdditionalArgs()
Gets the value of 'additionalArgs'.
|
String |
getAdditionalArgsDescription()
Gets the value of 'additionalArgsDescription'.
|
<T extends XString> |
getAdditionalArgsDescriptionTo(XString.Factory<T> factory)
Copies the value of this String field into a new XString from the given factory.
|
void |
getAdditionalArgsDescriptionTo(XString val)
Copies the value of 'additionalArgsDescription' into the provided XString.
|
XString |
getAdditionalArgsDescriptionUnsafe()
Gets the raw value of 'additionalArgsDescription'.
|
String |
getAdditionalArgsDisplayName()
Gets the value of 'additionalArgsDisplayName'.
|
<T extends XString> |
getAdditionalArgsDisplayNameTo(XString.Factory<T> factory)
Copies the value of this String field into a new XString from the given factory.
|
void |
getAdditionalArgsDisplayNameTo(XString val)
Copies the value of 'additionalArgsDisplayName' into the provided XString.
|
XString |
getAdditionalArgsDisplayNameUnsafe()
Gets the raw value of 'additionalArgsDisplayName'.
|
String[] |
getAliases()
Gets the value of 'aliases'.
|
String[] |
getAliasesEmptyIfNull()
Gets the value of 'aliases' or an empty array if the value is
null or not set. |
XStringIterator |
getAliasesIterator()
Gets the value of 'aliases' as iterator of values.
|
SrvMonArgumentDescription[] |
getArguments()
Gets the value of 'arguments'.
|
SrvMonArgumentDescription[] |
getArgumentsEmptyIfNull()
Gets the value of 'arguments' or an empty array if the value is
null or not set. |
XIterator<SrvMonArgumentDescription> |
getArgumentsIterator()
Gets the value of 'arguments' as iterator of values.
|
String |
getDescription()
Gets the value of 'description'.
|
<T extends XString> |
getDescriptionTo(XString.Factory<T> factory)
Copies the value of this String field into a new XString from the given factory.
|
void |
getDescriptionTo(XString val)
Copies the value of 'description' into the provided XString.
|
XString |
getDescriptionUnsafe()
Gets the raw value of 'description'.
|
String |
getDisplayName()
Gets the value of 'displayName'.
|
<T extends XString> |
getDisplayNameTo(XString.Factory<T> factory)
Copies the value of this String field into a new XString from the given factory.
|
void |
getDisplayNameTo(XString val)
Copies the value of 'displayName' into the provided XString.
|
XString |
getDisplayNameUnsafe()
Gets the raw value of 'displayName'.
|
String[] |
getGroup()
Gets the value of 'group'.
|
String[] |
getGroupEmptyIfNull()
Gets the value of 'group' or an empty array if the value is
null or not set. |
XStringIterator |
getGroupIterator()
Gets the value of 'group' as iterator of values.
|
boolean |
getHidden()
Gets the value of 'hidden'.
|
String |
getName()
Gets the value of 'name'.
|
<T extends XString> |
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'.
|
SrvMonOptionDescription[] |
getOptions()
Gets the value of 'options'.
|
SrvMonOptionDescription[] |
getOptionsEmptyIfNull()
Gets the value of 'options' or an empty array if the value is
null or not set. |
XIterator<SrvMonOptionDescription> |
getOptionsIterator()
Gets the value of 'options' as iterator of values.
|
SrvMonReturnType |
getReturnType()
Gets the value of 'returnType'.
|
boolean |
hasAdditionalArgs()
Checks for the presence of 'additionalArgs'.
|
boolean |
hasAdditionalArgsDescription()
Checks for the presence of 'additionalArgsDescription'.
|
boolean |
hasAdditionalArgsDisplayName()
Checks for the presence of 'additionalArgsDisplayName'.
|
boolean |
hasDescription()
Checks for the presence of 'description'.
|
boolean |
hasDisplayName()
Checks for the presence of 'displayName'.
|
boolean |
hasHidden()
Checks for the presence of 'hidden'.
|
boolean |
hasName()
Checks for the presence of 'name'.
|
boolean |
hasReturnType()
Checks for the presence of 'returnType'.
|
void |
lendAdditionalArgsDescription(XString val)
Lends the value of 'additionalArgsDescription' to this object.
|
void |
lendAdditionalArgsDisplayName(XString val)
Lends the value of 'additionalArgsDisplayName' to this object.
|
void |
lendArguments(SrvMonArgumentDescription val)
Adds the provided value to the list of 'arguments' values and acquires a reference to it.
|
void |
lendArguments(SrvMonArgumentDescription[] val)
Lends the value of 'arguments'.
|
void |
lendArgumentsFrom(XIterator<SrvMonArgumentDescription> val)
Sets the value of 'arguments' by lending the values from the provided iterator.
|
void |
lendDescription(XString val)
Lends the value of 'description' to this object.
|
void |
lendDisplayName(XString val)
Lends the value of 'displayName' to this object.
|
void |
lendName(XString val)
Lends the value of 'name' to this object.
|
void |
lendOptions(SrvMonOptionDescription val)
Adds the provided value to the list of 'options' values and acquires a reference to it.
|
void |
lendOptions(SrvMonOptionDescription[] val)
Lends the value of 'options'.
|
void |
lendOptionsFrom(XIterator<SrvMonOptionDescription> val)
Sets the value of 'options' by lending the values from the provided iterator.
|
void |
setAdditionalArgs(boolean val)
Sets the value of 'additionalArgs'.
|
void |
setAdditionalArgsDescription(String val)
Sets the value of 'additionalArgsDescription'.
|
void |
setAdditionalArgsDescriptionFrom(long val)
Sets the value of this String field to the given numeric value.
|
void |
setAdditionalArgsDescriptionFrom(XString val)
Copies the provided XString value into this object's 'additionalArgsDescription'.
|
void |
setAdditionalArgsDisplayName(String val)
Sets the value of 'additionalArgsDisplayName'.
|
void |
setAdditionalArgsDisplayNameFrom(long val)
Sets the value of this String field to the given numeric value.
|
void |
setAdditionalArgsDisplayNameFrom(XString val)
Copies the provided XString value into this object's 'additionalArgsDisplayName'.
|
void |
setAliases(String[] val)
Sets the value of 'aliases'.
|
void |
setAliasesFrom(XIterator<String> val)
Sets the value of 'aliases' using the values from the provided iterator.
|
void |
setArguments(SrvMonArgumentDescription[] val)
Sets the value of 'arguments'.
|
void |
setArgumentsFrom(XIterator<SrvMonArgumentDescription> val)
Sets the value of 'arguments' using the values from the provided iterator.
|
void |
setDescription(String val)
Sets the value of 'description'.
|
void |
setDescriptionFrom(long val)
Sets the value of this String field to the given numeric value.
|
void |
setDescriptionFrom(XString val)
Copies the provided XString value into this object's 'description'.
|
void |
setDisplayName(String val)
Sets the value of 'displayName'.
|
void |
setDisplayNameFrom(long val)
Sets the value of this String field to the given numeric value.
|
void |
setDisplayNameFrom(XString val)
Copies the provided XString value into this object's 'displayName'.
|
void |
setGroup(String[] val)
Sets the value of 'group'.
|
void |
setGroupFrom(XIterator<String> val)
Sets the value of 'group' using the values from the provided iterator.
|
void |
setHidden(boolean val)
Sets the value of 'hidden'.
|
void |
setName(String val)
Sets the value of '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 |
setOptions(SrvMonOptionDescription[] val)
Sets the value of 'options'.
|
void |
setOptionsFrom(XIterator<SrvMonOptionDescription> val)
Sets the value of 'options' using the values from the provided iterator.
|
void |
setReturnType(SrvMonReturnType val)
Sets the value of 'returnType'.
|
SrvMonArgumentDescription[] |
takeArguments()
Takes the value of 'arguments'.
|
SrvMonOptionDescription[] |
takeOptions()
Takes the value of 'options'.
|
getValidationErrors, isValid
void setAdditionalArgs(boolean val)
val
- The value to set.boolean getAdditionalArgs()
void clearAdditionalArgs()
setAdditionalArgs(boolean)
boolean hasAdditionalArgs()
getAdditionalArgs()
void setReturnType(SrvMonReturnType val)
val
- The value to set.SrvMonReturnType getReturnType()
void clearReturnType()
setReturnType(SrvMonReturnType)
boolean hasReturnType()
getReturnType()
void setHidden(boolean val)
val
- The value to set.boolean getHidden()
void clearHidden()
setHidden(boolean)
boolean hasHidden()
getHidden()
void setName(String val)
val
- The value to set.String getName()
void lendName(XString val)
This method is equivalent to setName 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 setNameFrom(long val)
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.
<T extends XString> T getNameTo(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 setNameFrom(XString val)
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.
void getNameTo(XString val)
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
.
getName()
XString getNameUnsafe()
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.
getName()
void clearName()
setName(String)
boolean hasName()
getName()
void setAliases(String[] val)
val
- The value to set.void setAliasesFrom(XIterator<String> 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 'aliases' accessor can copy the values without iteration.
NOTE:
Passing a null
or empty iterator has the same affect as calling setAliases(String[])
with
a value of null
.
val
- the values to set.void addAliases(String val)
This method is zero garbage for Xbuf generated classes, and this method is optimized such that calling this with an iterator from another 'aliases' 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.XStringIterator getAliasesIterator()
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.
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(com.neeve.lang.XStringIterator)
method
can perform a direct copy of the underlying values without iteration.
String[] getAliases()
If the field is not set this method will return null
.
null
.String[] getAliasesEmptyIfNull()
null
or not set.
null
if not set.getAliases()
void clearAliases()
setAliases(String[])
void setDescription(String val)
val
- The value to set.String getDescription()
void lendDescription(XString val)
This method is equivalent to setDescription 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 setDescriptionFrom(long val)
NOTE:
This is the same as calling setDescription(String)
.
with Long.valueOf(val).toString(), except that using this method is a zero garbage
operation for Xbuf encoding.
<T extends XString> T getDescriptionTo(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 setDescriptionFrom(XString val)
NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this setter
can be more efficient than setDescription(String)
because it avoids encoding the value into a String
if the given XString
is already encoded.
void getDescriptionTo(XString val)
NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this getter
can be more efficient than getDescription()
bec
because it can avoid decoding the value into an String
.
getDescription()
XString getDescriptionUnsafe()
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.
getDescription()
void clearDescription()
setDescription(String)
boolean hasDescription()
getDescription()
void setArguments(SrvMonArgumentDescription[] val)
val
- The value to set.void setArgumentsFrom(XIterator<SrvMonArgumentDescription> 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 'arguments' accessor can copy the values without iteration.
NOTE:
Passing a null
or empty list has the same affect as calling setArguments(SrvMonArgumentDescription[])
with
a value of null
.
val
- the values to set.void lendArgumentsFrom(XIterator<SrvMonArgumentDescription> 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 'arguments' accessor can copy the values without iteration.
NOTE:
Passing a null
or empty list has the same affect as calling setArguments(SrvMonArgumentDescription[])
with
a value of null
.
val
- the values to set.void addArguments(SrvMonArgumentDescription val)
This method is zero garbage for Xbuf generated classes, and this method is optimized such that calling this with an iterator from another 'arguments' 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 lendArguments(SrvMonArgumentDescription 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 'arguments' 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<SrvMonArgumentDescription> getArgumentsIterator()
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 lendArguments(SrvMonArgumentDescription[] 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.SrvMonArgumentDescription[] getArguments()
If the field is not set this method will return null
.
null
.SrvMonArgumentDescription[] getArgumentsEmptyIfNull()
null
or not set.
null
if not set.getArguments()
SrvMonArgumentDescription[] takeArguments()
NOTE:
A nested entity reference returned by getArguments()
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 clearArguments()
void setOptions(SrvMonOptionDescription[] val)
val
- The value to set.void setOptionsFrom(XIterator<SrvMonOptionDescription> 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 'options' accessor can copy the values without iteration.
NOTE:
Passing a null
or empty list has the same affect as calling setOptions(SrvMonOptionDescription[])
with
a value of null
.
val
- the values to set.void lendOptionsFrom(XIterator<SrvMonOptionDescription> 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 'options' accessor can copy the values without iteration.
NOTE:
Passing a null
or empty list has the same affect as calling setOptions(SrvMonOptionDescription[])
with
a value of null
.
val
- the values to set.void addOptions(SrvMonOptionDescription val)
This method is zero garbage for Xbuf generated classes, and this method is optimized such that calling this with an iterator from another 'options' 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 lendOptions(SrvMonOptionDescription 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 'options' 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<SrvMonOptionDescription> getOptionsIterator()
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 lendOptions(SrvMonOptionDescription[] 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.SrvMonOptionDescription[] getOptions()
If the field is not set this method will return null
.
null
.SrvMonOptionDescription[] getOptionsEmptyIfNull()
null
or not set.
null
if not set.getOptions()
SrvMonOptionDescription[] takeOptions()
NOTE:
A nested entity reference returned by getOptions()
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 clearOptions()
void setDisplayName(String val)
If a display name is not provided then the name should be used by tools. The display name is for display purposes only and cannot be used to invoke a command.
val
- The value to set.String getDisplayName()
If a display name is not provided then the name should be used by tools. The display name is for display purposes only and cannot be used to invoke a command.
void lendDisplayName(XString val)
This method is equivalent to setDisplayName 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.
If a display name is not provided then the name should be used by tools. The display name is for display purposes only and cannot be used to invoke a command.
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 setDisplayNameFrom(long val)
If a display name is not provided then the name should be used by tools. The display name is for display purposes only and cannot be used to invoke a command.
NOTE:
This is the same as calling setDisplayName(String)
.
with Long.valueOf(val).toString(), except that using this method is a zero garbage
operation for Xbuf encoding.
<T extends XString> T getDisplayNameTo(XString.Factory<T> factory)
If a display name is not provided then the name should be used by tools. The display name is for display purposes only and cannot be used to invoke a command.
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 setDisplayNameFrom(XString val)
If a display name is not provided then the name should be used by tools. The display name is for display purposes only and cannot be used to invoke a command.
NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this setter
can be more efficient than setDisplayName(String)
because it avoids encoding the value into a String
if the given XString
is already encoded.
void getDisplayNameTo(XString val)
If a display name is not provided then the name should be used by tools. The display name is for display purposes only and cannot be used to invoke a command.
NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this getter
can be more efficient than getDisplayName()
bec
because it can avoid decoding the value into an String
.
getDisplayName()
XString getDisplayNameUnsafe()
If a display name is not provided then the name should be used by tools. The display name is for display purposes only and cannot be used to invoke a command.
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.
getDisplayName()
void clearDisplayName()
If a display name is not provided then the name should be used by tools. The display name is for display purposes only and cannot be used to invoke a command.
setDisplayName(String)
boolean hasDisplayName()
If a display name is not provided then the name should be used by tools. The display name is for display purposes only and cannot be used to invoke a command.
getDisplayName()
void setAdditionalArgsDescription(String val)
val
- The value to set.String getAdditionalArgsDescription()
void lendAdditionalArgsDescription(XString val)
This method is equivalent to setAdditionalArgsDescription 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 setAdditionalArgsDescriptionFrom(long val)
NOTE:
This is the same as calling setAdditionalArgsDescription(String)
.
with Long.valueOf(val).toString(), except that using this method is a zero garbage
operation for Xbuf encoding.
<T extends XString> T getAdditionalArgsDescriptionTo(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 setAdditionalArgsDescriptionFrom(XString val)
NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this setter
can be more efficient than setAdditionalArgsDescription(String)
because it avoids encoding the value into a String
if the given XString
is already encoded.
void getAdditionalArgsDescriptionTo(XString val)
NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this getter
can be more efficient than getAdditionalArgsDescription()
bec
because it can avoid decoding the value into an String
.
getAdditionalArgsDescription()
XString getAdditionalArgsDescriptionUnsafe()
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.
getAdditionalArgsDescription()
void clearAdditionalArgsDescription()
setAdditionalArgsDescription(String)
boolean hasAdditionalArgsDescription()
getAdditionalArgsDescription()
void setAdditionalArgsDisplayName(String val)
val
- The value to set.String getAdditionalArgsDisplayName()
void lendAdditionalArgsDisplayName(XString val)
This method is equivalent to setAdditionalArgsDisplayName 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 setAdditionalArgsDisplayNameFrom(long val)
NOTE:
This is the same as calling setAdditionalArgsDisplayName(String)
.
with Long.valueOf(val).toString(), except that using this method is a zero garbage
operation for Xbuf encoding.
<T extends XString> T getAdditionalArgsDisplayNameTo(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 setAdditionalArgsDisplayNameFrom(XString val)
NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this setter
can be more efficient than setAdditionalArgsDisplayName(String)
because it avoids encoding the value into a String
if the given XString
is already encoded.
void getAdditionalArgsDisplayNameTo(XString val)
NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this getter
can be more efficient than getAdditionalArgsDisplayName()
bec
because it can avoid decoding the value into an String
.
getAdditionalArgsDisplayName()
XString getAdditionalArgsDisplayNameUnsafe()
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.
getAdditionalArgsDisplayName()
void clearAdditionalArgsDisplayName()
setAdditionalArgsDisplayName(String)
boolean hasAdditionalArgsDisplayName()
getAdditionalArgsDisplayName()
void setGroup(String[] val)
val
- The value to set.void setGroupFrom(XIterator<String> 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 'group' accessor can copy the values without iteration.
NOTE:
Passing a null
or empty iterator has the same affect as calling setGroup(String[])
with
a value of null
.
val
- the values to set.void addGroup(String val)
This method is zero garbage for Xbuf generated classes, and this method is optimized such that calling this with an iterator from another 'group' 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.XStringIterator getGroupIterator()
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.
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(com.neeve.lang.XStringIterator)
method
can perform a direct copy of the underlying values without iteration.
String[] getGroup()
If the field is not set this method will return null
.
null
.String[] getGroupEmptyIfNull()
null
or not set.
null
if not set.getGroup()
void clearGroup()
setGroup(String[])
Copyright © 2019 Neeve Research, LLC. All Rights Reserved.