com.neeve.server.mon.cnc
Interface ISrvMonOptionDescription

All Superinterfaces:
IRogValidatable
All Known Implementing Classes:
SrvMonOptionDescription

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

Descripes a command option


Method Summary
 void addValidValues(String val)
          Adds the provided value to the list of 'validValues' values.
 void clearDefaultValue()
          Clears the value of 'defaultValue' Field Description The default value for an option when not specified ... or not set if no default
 void clearDescription()
          Clears the value of 'description' Field Description The command description
 void clearDisplayName()
          Clears the value of 'displayName' Field Description The display name for the argument If a display name is not provided then the name should be used by tools.
 void clearLongForm()
          Clears the value of 'longForm' Field Description The long form of the command. e.g.
 void clearRequired()
          Clears the value of 'required' Field Description Whether or not the option is required
 void clearShortForm()
          Clears the value of 'shortForm' Field Description The short form of the command. e.g.
 void clearType()
          Clears the value of 'type' Field Description Describes the type of the argument
 void clearValidValues()
          Clears the value of 'validValues' Field Description When set restricts the set of valid values for the command
 String getDefaultValue()
          Gets the value of 'defaultValue' Field Description The default value for an option when not specified ... or not set if no default
<T extends XString>
T
getDefaultValueTo(XString.Factory<T> factory)
          Copies the value of this String field into a new XString from the given factory.
 void getDefaultValueTo(XString val)
          Copies the value of 'defaultValue' into the provided XString.
 XString getDefaultValueUnsafe()
          Gets the raw value of 'defaultValue'.
 String getDescription()
          Gets the value of 'description' Field Description The command description
<T extends XString>
T
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' Field Description The display name for the argument If a display name is not provided then the name should be used by tools.
<T extends XString>
T
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 getLongForm()
          Gets the value of 'longForm' Field Description The long form of the command. e.g.
<T extends XString>
T
getLongFormTo(XString.Factory<T> factory)
          Copies the value of this String field into a new XString from the given factory.
 void getLongFormTo(XString val)
          Copies the value of 'longForm' into the provided XString.
 XString getLongFormUnsafe()
          Gets the raw value of 'longForm'.
 boolean getRequired()
          Gets the value of 'required' Field Description Whether or not the option is required
 char getShortForm()
          Gets the value of 'shortForm' Field Description The short form of the command. e.g.
 SrvMonOptionType getType()
          Gets the value of 'type' Field Description Describes the type of the argument
 String[] getValidValues()
          Gets the value of 'validValues' If the field is not set this method will return null.
 String[] getValidValuesEmptyIfNull()
          Gets the value of 'validValues' or an empty array if the value is null or not set.
 XStringIterator getValidValuesIterator()
          Gets the value of 'validValues' as iterator of values.
 boolean hasDefaultValue()
          Checks for the presence of 'defaultValue' Field Description The default value for an option when not specified ... or not set if no default
 boolean hasDescription()
          Checks for the presence of 'description' Field Description The command description
 boolean hasDisplayName()
          Checks for the presence of 'displayName' Field Description The display name for the argument If a display name is not provided then the name should be used by tools.
 boolean hasLongForm()
          Checks for the presence of 'longForm' Field Description The long form of the command. e.g.
 boolean hasRequired()
          Checks for the presence of 'required' Field Description Whether or not the option is required
 boolean hasShortForm()
          Checks for the presence of 'shortForm' Field Description The short form of the command. e.g.
 boolean hasType()
          Checks for the presence of 'type' Field Description Describes the type of the argument
 void lendDefaultValue(XString val)
          Sets the value of 'defaultValue' Field Description The default value for an option when not specified ... or not set if no default
 void lendDescription(XString val)
          Sets the value of 'description' Field Description The command description
 void lendDisplayName(XString val)
          Sets the value of 'displayName' Field Description The display name for the argument If a display name is not provided then the name should be used by tools.
 void lendLongForm(XString val)
          Sets the value of 'longForm' Field Description The long form of the command. e.g.
 void setDefaultValue(String val)
          Sets the value of 'defaultValue' Field Description The default value for an option when not specified ... or not set if no default
 void setDefaultValueFrom(long val)
          Sets the value of this String field to the given numeric value.
 void setDefaultValueFrom(XString val)
          Copies the provided XString value into this object's 'defaultValue'.
 void setDescription(String val)
          Sets the value of 'description' Field Description The command 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' Field Description The display name for the argument If a display name is not provided then the name should be used by tools.
 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 setLongForm(String val)
          Sets the value of 'longForm' Field Description The long form of the command. e.g.
 void setLongFormFrom(long val)
          Sets the value of this String field to the given numeric value.
 void setLongFormFrom(XString val)
          Copies the provided XString value into this object's 'longForm'.
 void setRequired(boolean val)
          Sets the value of 'required' Field Description Whether or not the option is required
 void setShortForm(char val)
          Sets the value of 'shortForm' Field Description The short form of the command. e.g.
 void setType(SrvMonOptionType val)
          Sets the value of 'type' Field Description Describes the type of the argument
 void setValidValues(String[] val)
          Sets the value of 'validValues' Field Description When set restricts the set of valid values for the command
 void setValidValuesFrom(XIterator<String> val)
          Sets the value of 'validValues' using the values from the provided iterator.
 
Methods inherited from interface com.neeve.rog.IRogValidatable
getValidationErrors, isValid
 

Method Detail

setShortForm

void setShortForm(char val)
Sets the value of 'shortForm'

Field Description

The short form of the command. e.g. 'o' for -o

Parameters:
val - The value to set.

getShortForm

char getShortForm()
Gets the value of 'shortForm'

Field Description

The short form of the command. e.g. 'o' for -o

Returns:
The short form of the command. e.g. 'o' for -o

clearShortForm

void clearShortForm()
Clears the value of 'shortForm'

Field Description

The short form of the command. e.g. 'o' for -o

See Also:
setShortForm(char)

hasShortForm

boolean hasShortForm()
Checks for the presence of 'shortForm'

Field Description

The short form of the command. e.g. 'o' for -o

See Also:
getShortForm()

setRequired

void setRequired(boolean val)
Sets the value of 'required'

Field Description

Whether or not the option is required

Parameters:
val - The value to set.

getRequired

boolean getRequired()
Gets the value of 'required'

Field Description

Whether or not the option is required

Returns:
Whether or not the option is required

clearRequired

void clearRequired()
Clears the value of 'required'

Field Description

Whether or not the option is required

See Also:
setRequired(boolean)

hasRequired

boolean hasRequired()
Checks for the presence of 'required'

Field Description

Whether or not the option is required

See Also:
getRequired()

setType

void setType(SrvMonOptionType val)
Sets the value of 'type'

Field Description

Describes the type of the argument

Parameters:
val - The value to set.

getType

SrvMonOptionType getType()
Gets the value of 'type'

Field Description

Describes the type of the argument

Returns:
Describes the type of the argument

clearType

void clearType()
Clears the value of 'type'

Field Description

Describes the type of the argument

See Also:
setType(SrvMonOptionType)

hasType

boolean hasType()
Checks for the presence of 'type'

Field Description

Describes the type of the argument

See Also:
getType()

setLongForm

void setLongForm(String val)
Sets the value of 'longForm'

Field Description

The long form of the command. e.g. 'option' for -option

Parameters:
val - The value to set.

getLongForm

String getLongForm()
Gets the value of 'longForm'

Field Description

The long form of the command. e.g. 'option' for -option

Returns:
The long form of the command. e.g. 'option' for -option

lendLongForm

void lendLongForm(XString val)
Sets the value of 'longForm'

Field Description

The long form of the command. e.g. 'option' for -option

Parameters:
val - The value to set.

setLongFormFrom

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

Field Description

The long form of the command. e.g. 'option' for -option

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


getLongFormTo

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

Field Description

The long form of the command. e.g. 'option' for -option

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

setLongFormFrom

void setLongFormFrom(XString val)
Copies the provided XString value into this object's 'longForm'.

Field Description

The long form of the command. e.g. 'option' for -option

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


getLongFormTo

void getLongFormTo(XString val)
Copies the value of 'longForm' into the provided XString.

Field Description

The long form of the command. e.g. 'option' for -option

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

See Also:
getLongForm()

getLongFormUnsafe

XString getLongFormUnsafe()
Gets the raw value of 'longForm'.

Field Description

The long form of the command. e.g. 'option' for -option

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

clearLongForm

void clearLongForm()
Clears the value of 'longForm'

Field Description

The long form of the command. e.g. 'option' for -option

See Also:
setLongForm(String)

hasLongForm

boolean hasLongForm()
Checks for the presence of 'longForm'

Field Description

The long form of the command. e.g. 'option' for -option

See Also:
getLongForm()

setDefaultValue

void setDefaultValue(String val)
Sets the value of 'defaultValue'

Field Description

The default value for an option when not specified ... or not set if no default

Parameters:
val - The value to set.

getDefaultValue

String getDefaultValue()
Gets the value of 'defaultValue'

Field Description

The default value for an option when not specified ... or not set if no default

Returns:
The default value for an option when not specified ... or not set if no default

lendDefaultValue

void lendDefaultValue(XString val)
Sets the value of 'defaultValue'

Field Description

The default value for an option when not specified ... or not set if no default

Parameters:
val - The value to set.

setDefaultValueFrom

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

Field Description

The default value for an option when not specified ... or not set if no default

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


getDefaultValueTo

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

Field Description

The default value for an option when not specified ... or not set if no default

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

setDefaultValueFrom

void setDefaultValueFrom(XString val)
Copies the provided XString value into this object's 'defaultValue'.

Field Description

The default value for an option when not specified ... or not set if no default

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


getDefaultValueTo

void getDefaultValueTo(XString val)
Copies the value of 'defaultValue' into the provided XString.

Field Description

The default value for an option when not specified ... or not set if no default

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

See Also:
getDefaultValue()

getDefaultValueUnsafe

XString getDefaultValueUnsafe()
Gets the raw value of 'defaultValue'.

Field Description

The default value for an option when not specified ... or not set if no default

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

clearDefaultValue

void clearDefaultValue()
Clears the value of 'defaultValue'

Field Description

The default value for an option when not specified ... or not set if no default

See Also:
setDefaultValue(String)

hasDefaultValue

boolean hasDefaultValue()
Checks for the presence of 'defaultValue'

Field Description

The default value for an option when not specified ... or not set if no default

See Also:
getDefaultValue()

setValidValues

void setValidValues(String[] val)
Sets the value of 'validValues'

Field Description

When set restricts the set of valid values for the command

Parameters:
val - The value to set.

setValidValuesFrom

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

Field Description

When set restricts the set of valid values for the command

NOTE:
Passing a null or empty iterator has the same affect as calling setValidValues(String[]) with a value of null.

Parameters:
val - the values to set.

addValidValues

void addValidValues(String val)
Adds the provided value to the list of 'validValues' values.

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

When set restricts the set of valid values for the command

Parameters:
val - the value to add.

getValidValuesIterator

XStringIterator getValidValuesIterator()
Gets the value of 'validValues' 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.

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.

Field Description

When set restricts the set of valid values for the command

Returns:
An XStringIterator containing this field values.

getValidValues

String[] getValidValues()
Gets the value of 'validValues'

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

Field Description

When set restricts the set of valid values for the command

Returns:
When set restricts the set of valid values for the command If the field is not set this method will return null.

getValidValuesEmptyIfNull

String[] getValidValuesEmptyIfNull()
Gets the value of 'validValues' or an empty array if the value is null or not set.

Field Description

When set restricts the set of valid values for the command

Returns:
When set restricts the set of valid values for the command or an empty array if null if not set.
See Also:
getValidValues()

clearValidValues

void clearValidValues()
Clears the value of 'validValues'

Field Description

When set restricts the set of valid values for the command

See Also:
setValidValues(String[])

setDescription

void setDescription(String val)
Sets the value of 'description'

Field Description

The command description

Parameters:
val - The value to set.

getDescription

String getDescription()
Gets the value of 'description'

Field Description

The command description

Returns:
The command description

lendDescription

void lendDescription(XString val)
Sets the value of 'description'

Field Description

The command description

Parameters:
val - The value to set.

setDescriptionFrom

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

Field Description

The command description

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.


getDescriptionTo

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

Field Description

The command description

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

setDescriptionFrom

void setDescriptionFrom(XString val)
Copies the provided XString value into this object's 'description'.

Field Description

The command description

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.


getDescriptionTo

void getDescriptionTo(XString val)
Copies the value of 'description' into the provided XString.

Field Description

The command description

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.

See Also:
getDescription()

getDescriptionUnsafe

XString getDescriptionUnsafe()
Gets the raw value of 'description'.

Field Description

The command description

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

clearDescription

void clearDescription()
Clears the value of 'description'

Field Description

The command description

See Also:
setDescription(String)

hasDescription

boolean hasDescription()
Checks for the presence of 'description'

Field Description

The command description

See Also:
getDescription()

setDisplayName

void setDisplayName(String val)
Sets the value of 'displayName'

Field Description

The display name for the argument

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.

Parameters:
val - The value to set.

getDisplayName

String getDisplayName()
Gets the value of 'displayName'

Field Description

The display name for the argument

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.

Returns:
The display name for the argument

lendDisplayName

void lendDisplayName(XString val)
Sets the value of 'displayName'

Field Description

The display name for the argument

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.

Parameters:
val - The value to set.

setDisplayNameFrom

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

Field Description

The display name for the argument

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.


getDisplayNameTo

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

Field Description

The display name for the argument

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;

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

setDisplayNameFrom

void setDisplayNameFrom(XString val)
Copies the provided XString value into this object's 'displayName'.

Field Description

The display name for the argument

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.


getDisplayNameTo

void getDisplayNameTo(XString val)
Copies the value of 'displayName' into the provided XString.

Field Description

The display name for the argument

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.

See Also:
getDisplayName()

getDisplayNameUnsafe

XString getDisplayNameUnsafe()
Gets the raw value of 'displayName'.

Field Description

The display name for the argument

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.

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

clearDisplayName

void clearDisplayName()
Clears the value of 'displayName'

Field Description

The display name for the argument

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.

See Also:
setDisplayName(String)

hasDisplayName

boolean hasDisplayName()
Checks for the presence of 'displayName'

Field Description

The display name for the argument

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.

See Also:
getDisplayName()


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