@Generated(value="com.neeve.adm.AdmXbufGenerator", date="Fri Dec 05 13:32:50 UTC 2025") @AdmGenerated(encoding="Xbuf", compatLevel="4.1.0", admVersion="Unknown Version", date="12/5/25 1:32 PM", buildInfo="nvx-talon-3.16.63 (nvx-codegen-plugin)") @AdmFactoryInfo(factoryClass=SrvMonCncFactory.class, vfid=36, ofid=36, typeId=302) public final class SrvMonOptionDescription extends Object implements com.neeve.xbuf.IXbufDesyncer, UtlPool.Item<SrvMonOptionDescription>, ISrvMonOptionDescription
| ADM Type | Embedded Entity |
| Factory | SrvMonCncFactory |
| ADM Field Summary |
|---|
| Field | Type | Id | Description |
|---|---|---|---|
| defaultValue | String | 19 | The default value for an option when not specified ... or not set if no default. |
| description | String | 22 | The command description. |
| displayName | String | 23 |
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. |
| longForm | String | 17 | The long form of the command. e.g. 'option' for -option. |
| required | Boolean | 18 | Whether or not the option is required. |
| shortForm | Char | 16 | The short form of the command. e.g. 'o' for -o. |
| type | SrvMonOptionType |
20 | Describes the type of the argument. |
| validValues | String[] | 21 | When set, restricts the set of valid values for the command. |
| Modifier and Type | Class and Description |
|---|---|
static class |
SrvMonOptionDescription.Field
The SrvMonOptionDescription xbuf field (used internally when this entity is used as a field of another entity).
|
static class |
SrvMonOptionDescription.ListField
The SrvMonOptionDescription list field (used internally when this entity is used as an array field of another entity).
|
| Modifier and Type | Field and Description |
|---|---|
static SrvMonOptionDescription[] |
EMPTY_ARRAY
A preallocated empty array used to avoid garbage when returning empty arrays of this type.
|
| Constructor and Description |
|---|
SrvMonOptionDescription() |
SrvMonOptionDescription(int initialBackingBufferSize) |
| Modifier and Type | Method and Description |
|---|---|
SrvMonOptionDescription |
acquire() |
void |
addValidValues(String val)
Adds the provided value to the list of 'validValues' values.
|
void |
clearContent() |
void |
clearDefaultValue()
Clears the value of 'defaultValue'.
|
void |
clearDescription()
Clears the value of 'description'.
|
void |
clearDisplayName()
Clears the value of 'displayName'.
|
void |
clearLongForm()
Clears the value of 'longForm'.
|
void |
clearRequired()
Clears the value of 'required'.
|
void |
clearShortForm()
Clears the value of 'shortForm'.
|
void |
clearType()
Clears the value of 'type'.
|
void |
clearValidValues()
Clears the value of 'validValues'.
|
void |
clearXRogType() |
Object |
clone()
Creates a clone of this object.
|
SrvMonOptionDescription |
copy()
Creates a copy of this SrvMonOptionDescription.
|
void |
copyInto(SrvMonOptionDescription copy)
Copies the contents of this SrvMonOptionDescription into the target.
|
static SrvMonOptionDescription |
create() |
static SrvMonOptionDescription |
createFrom(byte[] serializedContainer) |
static SrvMonOptionDescription |
createFrom(byte[] serializedContainer,
com.neeve.xbuf.XbufDesyncPolicy desyncPolicy) |
static SrvMonOptionDescription |
createFromSerializedXbufContainer(byte[] serializedContainer) |
static SrvMonOptionDescription |
createFromSerializedXbufContainer(byte[] serializedContainer,
com.neeve.xbuf.XbufDesyncPolicy desyncPolicy) |
static com.neeve.xbuf.XbufSchema |
createSchema() |
static com.neeve.xbuf.XbufRepeatedStringFieldBuffer |
createValidValuesFieldBuffer(int initialBufferLength,
boolean isNative)
Returns a wrapped buffer that can be used for doing an efficient bulk
copy from an XIterator returned for this field.
|
SrvMonOptionDescription |
deserializeFromByteArray(byte[] array) |
SrvMonOptionDescription |
deserializeFromByteArray(byte[] array,
com.neeve.xbuf.XbufDesyncPolicy desyncPolicy) |
SrvMonOptionDescription |
deserializeFromByteBuffer(ByteBuffer buffer) |
SrvMonOptionDescription |
deserializeFromByteBuffer(ByteBuffer buffer,
com.neeve.xbuf.XbufDesyncPolicy desyncPolicy) |
SrvMonOptionDescription |
deserializeFromIOElasticBuffer(com.neeve.io.IOElasticBuffer buffer,
int offset,
int length) |
SrvMonOptionDescription |
deserializeFromIOElasticBuffer(com.neeve.io.IOElasticBuffer buffer,
int offset,
int length,
com.neeve.xbuf.XbufDesyncPolicy desyncPolicy) |
SrvMonOptionDescription |
deserializeFromNative(long address,
int offset,
int length) |
SrvMonOptionDescription |
deserializeFromNative(long address,
int offset,
int length,
com.neeve.xbuf.XbufDesyncPolicy desyncPolicy) |
int |
desync(PktBuffer buffer,
int pos,
boolean frameOnly)
Desync fields from a buffer
|
void |
desyncFieldBitmask() |
void |
dispose() |
PktBuffer |
getBackingBuffer() |
String |
getDefaultValue()
Gets the value of 'defaultValue'.
|
com.neeve.xbuf.XbufStringField |
getDefaultValueField() |
static int |
getDefaultValueFieldId() |
<T extends XString> |
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'.
|
com.neeve.xbuf.XbufStringField |
getDescriptionField() |
static int |
getDescriptionFieldId() |
<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'.
|
static com.neeve.xbuf.XbufDesyncPolicy |
getDesyncPolicy() |
String |
getDisplayName()
Gets the value of 'displayName'.
|
com.neeve.xbuf.XbufStringField |
getDisplayNameField() |
static int |
getDisplayNameFieldId() |
<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'.
|
boolean |
getIsReadOnly() |
String |
getLongForm()
Gets the value of 'longForm'.
|
com.neeve.xbuf.XbufStringField |
getLongFormField() |
static int |
getLongFormFieldId() |
<T extends XString> |
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'.
|
int |
getOwnerCount() |
UtlPool<SrvMonOptionDescription> |
getPool()
Get a pool item's pool.
|
boolean |
getRequired()
Gets the value of 'required'.
|
Boolean |
getRequiredAsObject()
Gets the value of 'required'.
|
com.neeve.xbuf.XbufVariableBooleanField |
getRequiredField() |
static int |
getRequiredFieldId() |
int |
getSerializeToNativeLength() |
char |
getShortForm()
Gets the value of 'shortForm'.
|
Character |
getShortFormAsObject()
Gets the value of 'shortForm'.
|
com.neeve.xbuf.XbufVariableCharField |
getShortFormField() |
static int |
getShortFormFieldId() |
SrvMonOptionType |
getType()
Gets the value of 'type'.
|
com.neeve.xbuf.XbufVariableEnumField<SrvMonOptionType> |
getTypeField() |
static int |
getTypeFieldId() |
void |
getValidationErrors(List<XString> results,
String errorPrefix)
Collects validation errors into the provided list.
|
String[] |
getValidValues()
Gets the value of 'validValues'.
|
String[] |
getValidValuesEmptyIfNull()
Gets the value of 'validValues' or an empty array if the value is
null or not set. |
static int |
getValidValuesFieldId() |
XStringIterator |
getValidValuesIterator()
Gets the value of 'validValues' as iterator of values.
|
short |
getXRogType() |
Short |
getXRogTypeAsObject() |
com.neeve.xbuf.XbufVariableShortField |
getXRogTypeField() |
static int |
getXRogTypeFieldId() |
boolean |
hasDefaultValue()
Checks for the presence of 'defaultValue'.
|
boolean |
hasDescription()
Checks for the presence of 'description'.
|
boolean |
hasDisplayName()
Checks for the presence of 'displayName'.
|
boolean |
hasLongForm()
Checks for the presence of 'longForm'.
|
boolean |
hasRequired()
Checks for the presence of 'required'.
|
boolean |
hasShortForm()
Checks for the presence of 'shortForm'.
|
boolean |
hasType()
Checks for the presence of 'type'.
|
boolean |
hasXRogType() |
SrvMonOptionDescription |
init()
Initialize an item.
|
boolean |
isBufferBacked() |
boolean |
isDirty() |
boolean |
isReferenceCounted() |
boolean |
isValid()
Tests if this object has any validation errors.
|
void |
lendDefaultValue(XString val)
Lends the value of 'defaultValue' to this object.
|
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 |
lendLongForm(XString val)
Lends the value of 'longForm' to this object.
|
static void |
optimizeFor(int val) |
byte[] |
serializeToByteArray() |
ByteBuffer |
serializeToByteBuffer() |
com.neeve.io.IOBuffer |
serializeToIOBuffer(boolean useNative) |
int |
serializeToNative(long address,
int addressOffset) |
void |
setAsReadOnly() |
void |
setDefaultValue(String val)
Sets the value of 'defaultValue'.
|
void |
setDefaultValueFrom(long val)
Sets the value of this String field to the given numeric value.
|
void |
setDefaultValueFrom(com.neeve.xbuf.XbufStringField val) |
void |
setDefaultValueFrom(XString val)
Copies the provided XString value into this object's 'defaultValue'.
|
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(com.neeve.xbuf.XbufStringField val) |
void |
setDescriptionFrom(XString val)
Copies the provided XString value into this object's 'description'.
|
static void |
setDesyncPolicy(com.neeve.xbuf.XbufDesyncPolicy val) |
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(com.neeve.xbuf.XbufStringField val) |
void |
setDisplayNameFrom(XString val)
Copies the provided XString value into this object's 'displayName'.
|
static void |
setFieldInterest(List<Integer> fieldIds) |
void |
setLongForm(String val)
Sets the value of 'longForm'.
|
void |
setLongFormFrom(long val)
Sets the value of this String field to the given numeric value.
|
void |
setLongFormFrom(com.neeve.xbuf.XbufStringField val) |
void |
setLongFormFrom(XString val)
Copies the provided XString value into this object's 'longForm'.
|
SrvMonOptionDescription |
setPool(UtlPool<SrvMonOptionDescription> pool)
Set a pool item's pool.
|
void |
setPreserializedFields(PktBuffer buffer) |
void |
setRequired(boolean val)
Sets the value of 'required'.
|
void |
setRequiredAsObject(Boolean val)
Sets the value of 'required'.
|
void |
setRequiredFrom(com.neeve.xbuf.XbufVariableBooleanField val) |
void |
setShortForm(char val)
Sets the value of 'shortForm'.
|
void |
setShortFormAsObject(Character val)
Sets the value of 'shortForm'.
|
void |
setShortFormFrom(com.neeve.xbuf.XbufVariableCharField val) |
void |
setType(SrvMonOptionType val)
Sets the value of 'type'.
|
void |
setTypeFrom(com.neeve.xbuf.XbufVariableEnumField<SrvMonOptionType> val) |
void |
setValidValues(String[] val)
Sets the value of 'validValues'.
|
void |
setValidValuesFrom(XIterator<String> val)
Sets the value of 'validValues' using the values from the provided iterator.
|
void |
setXRogType(short val) |
void |
setXRogTypeAsObject(Short val) |
void |
setXRogTypeFrom(com.neeve.xbuf.XbufVariableShortField val) |
void |
sync() |
void |
syncFieldBitmask() |
String |
toString() |
public static final SrvMonOptionDescription[] EMPTY_ARRAY
public SrvMonOptionDescription()
public SrvMonOptionDescription(int initialBackingBufferSize)
public static SrvMonOptionDescription create()
public static SrvMonOptionDescription createFromSerializedXbufContainer(byte[] serializedContainer, com.neeve.xbuf.XbufDesyncPolicy desyncPolicy)
public static SrvMonOptionDescription createFromSerializedXbufContainer(byte[] serializedContainer)
public static SrvMonOptionDescription createFrom(byte[] serializedContainer, com.neeve.xbuf.XbufDesyncPolicy desyncPolicy)
public static SrvMonOptionDescription createFrom(byte[] serializedContainer)
public static final void setDesyncPolicy(com.neeve.xbuf.XbufDesyncPolicy val)
public static final com.neeve.xbuf.XbufDesyncPolicy getDesyncPolicy()
public final void clearContent()
public final void syncFieldBitmask()
public final void desyncFieldBitmask()
public final PktBuffer getBackingBuffer()
public static final void optimizeFor(int val)
public final void setAsReadOnly()
public final boolean getIsReadOnly()
public final void setPreserializedFields(PktBuffer buffer)
public static final int getXRogTypeFieldId()
public final void setXRogType(short val)
public final void setXRogTypeAsObject(Short val)
public final short getXRogType()
public final Short getXRogTypeAsObject()
public final void setXRogTypeFrom(com.neeve.xbuf.XbufVariableShortField val)
public final com.neeve.xbuf.XbufVariableShortField getXRogTypeField()
public final boolean hasXRogType()
public final void clearXRogType()
public static final int getShortFormFieldId()
public final void setShortForm(char val)
ISrvMonOptionDescriptionsetShortForm in interface ISrvMonOptionDescriptionval - The value to set.public final void setShortFormAsObject(Character val)
ISrvMonOptionDescriptionsetShortFormAsObject in interface ISrvMonOptionDescriptionval - The value to set.public final char getShortForm()
ISrvMonOptionDescriptiongetShortForm in interface ISrvMonOptionDescriptionpublic final Character getShortFormAsObject()
ISrvMonOptionDescriptiongetShortFormAsObject in interface ISrvMonOptionDescriptionpublic final void setShortFormFrom(com.neeve.xbuf.XbufVariableCharField val)
public final com.neeve.xbuf.XbufVariableCharField getShortFormField()
public final boolean hasShortForm()
ISrvMonOptionDescriptionhasShortForm in interface ISrvMonOptionDescriptionISrvMonOptionDescription.getShortForm()public final void clearShortForm()
ISrvMonOptionDescriptionclearShortForm in interface ISrvMonOptionDescriptionISrvMonOptionDescription.setShortForm(char)public static final int getRequiredFieldId()
public final void setRequired(boolean val)
ISrvMonOptionDescriptionsetRequired in interface ISrvMonOptionDescriptionval - The value to set.public final void setRequiredAsObject(Boolean val)
ISrvMonOptionDescriptionsetRequiredAsObject in interface ISrvMonOptionDescriptionval - The value to set.public final boolean getRequired()
ISrvMonOptionDescriptiongetRequired in interface ISrvMonOptionDescriptionpublic final Boolean getRequiredAsObject()
ISrvMonOptionDescriptiongetRequiredAsObject in interface ISrvMonOptionDescriptionpublic final void setRequiredFrom(com.neeve.xbuf.XbufVariableBooleanField val)
public final com.neeve.xbuf.XbufVariableBooleanField getRequiredField()
public final boolean hasRequired()
ISrvMonOptionDescriptionhasRequired in interface ISrvMonOptionDescriptionISrvMonOptionDescription.getRequired()public final void clearRequired()
ISrvMonOptionDescriptionclearRequired in interface ISrvMonOptionDescriptionISrvMonOptionDescription.setRequired(boolean)public static final int getTypeFieldId()
public final void setType(SrvMonOptionType val)
ISrvMonOptionDescriptionsetType in interface ISrvMonOptionDescriptionval - The value to set.public final void setTypeFrom(com.neeve.xbuf.XbufVariableEnumField<SrvMonOptionType> val)
public final com.neeve.xbuf.XbufVariableEnumField<SrvMonOptionType> getTypeField()
public final SrvMonOptionType getType()
ISrvMonOptionDescriptiongetType in interface ISrvMonOptionDescriptionpublic final boolean hasType()
ISrvMonOptionDescriptionhasType in interface ISrvMonOptionDescriptionISrvMonOptionDescription.getType()public final void clearType()
ISrvMonOptionDescriptionclearType in interface ISrvMonOptionDescriptionISrvMonOptionDescription.setType(SrvMonOptionType)public static final int getLongFormFieldId()
public final void setLongForm(String val)
ISrvMonOptionDescriptionsetLongForm in interface ISrvMonOptionDescriptionval - The value to set.public final String getLongForm()
ISrvMonOptionDescriptiongetLongForm in interface ISrvMonOptionDescriptionpublic final void lendLongForm(XString val)
ISrvMonOptionDescriptionThis method is equivalent to setLongForm 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.
lendLongForm in interface ISrvMonOptionDescriptionval - The value to set.public final void setLongFormFrom(long val)
ISrvMonOptionDescription
NOTE:
This is the same as calling ISrvMonOptionDescription.setLongForm(String).
with Long.valueOf(val).toString(), except that using this method is a zero garbage
operation for Xbuf encoding.
setLongFormFrom in interface ISrvMonOptionDescriptionpublic final <T extends XString> T getLongFormTo(XString.Factory<T> factory)
ISrvMonOptionDescription
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;
getLongFormTo in interface ISrvMonOptionDescriptionfactory - The factory from which to get the XString to copy into and returnnull.public final void setLongFormFrom(XString val)
ISrvMonOptionDescription
NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this setter
can be more efficient than ISrvMonOptionDescription.setLongForm(String)
because it avoids encoding the value into a String if the given XString is already encoded.
setLongFormFrom in interface ISrvMonOptionDescriptionpublic final void getLongFormTo(XString val)
ISrvMonOptionDescription
NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this getter
can be more efficient than ISrvMonOptionDescription.getLongForm() bec
because it can avoid decoding the value into an String.
getLongFormTo in interface ISrvMonOptionDescriptionISrvMonOptionDescription.getLongForm()public final XString getLongFormUnsafe()
ISrvMonOptionDescription
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.
getLongFormUnsafe in interface ISrvMonOptionDescriptionISrvMonOptionDescription.getLongForm()public final void setLongFormFrom(com.neeve.xbuf.XbufStringField val)
public final com.neeve.xbuf.XbufStringField getLongFormField()
public final boolean hasLongForm()
ISrvMonOptionDescriptionhasLongForm in interface ISrvMonOptionDescriptionISrvMonOptionDescription.getLongForm()public final void clearLongForm()
ISrvMonOptionDescriptionclearLongForm in interface ISrvMonOptionDescriptionISrvMonOptionDescription.setLongForm(String)public static final int getDefaultValueFieldId()
public final void setDefaultValue(String val)
ISrvMonOptionDescriptionsetDefaultValue in interface ISrvMonOptionDescriptionval - The value to set.public final String getDefaultValue()
ISrvMonOptionDescriptiongetDefaultValue in interface ISrvMonOptionDescriptionpublic final void lendDefaultValue(XString val)
ISrvMonOptionDescriptionThis method is equivalent to setDefaultValue 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.
lendDefaultValue in interface ISrvMonOptionDescriptionval - The value to set.public final void setDefaultValueFrom(long val)
ISrvMonOptionDescription
NOTE:
This is the same as calling ISrvMonOptionDescription.setDefaultValue(String).
with Long.valueOf(val).toString(), except that using this method is a zero garbage
operation for Xbuf encoding.
setDefaultValueFrom in interface ISrvMonOptionDescriptionpublic final <T extends XString> T getDefaultValueTo(XString.Factory<T> factory)
ISrvMonOptionDescription
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;
getDefaultValueTo in interface ISrvMonOptionDescriptionfactory - The factory from which to get the XString to copy into and returnnull.public final void setDefaultValueFrom(XString val)
ISrvMonOptionDescription
NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this setter
can be more efficient than ISrvMonOptionDescription.setDefaultValue(String)
because it avoids encoding the value into a String if the given XString is already encoded.
setDefaultValueFrom in interface ISrvMonOptionDescriptionpublic final void getDefaultValueTo(XString val)
ISrvMonOptionDescription
NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this getter
can be more efficient than ISrvMonOptionDescription.getDefaultValue() bec
because it can avoid decoding the value into an String.
getDefaultValueTo in interface ISrvMonOptionDescriptionISrvMonOptionDescription.getDefaultValue()public final XString getDefaultValueUnsafe()
ISrvMonOptionDescription
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.
getDefaultValueUnsafe in interface ISrvMonOptionDescriptionISrvMonOptionDescription.getDefaultValue()public final void setDefaultValueFrom(com.neeve.xbuf.XbufStringField val)
public final com.neeve.xbuf.XbufStringField getDefaultValueField()
public final boolean hasDefaultValue()
ISrvMonOptionDescriptionhasDefaultValue in interface ISrvMonOptionDescriptionISrvMonOptionDescription.getDefaultValue()public final void clearDefaultValue()
ISrvMonOptionDescriptionclearDefaultValue in interface ISrvMonOptionDescriptionISrvMonOptionDescription.setDefaultValue(String)public static final int getValidValuesFieldId()
public static final com.neeve.xbuf.XbufRepeatedStringFieldBuffer createValidValuesFieldBuffer(int initialBufferLength,
boolean isNative)
For example the following would result in a bulk transfer from this message
XbufRepeatedStringFieldBuffer preallocated = SrvMonOptionDescription.createValidValuesFieldBuffer(1024, true); // The following would then result in a buffer copy without any iteration: preallocated.setValue(inboundMessage.getValidValuesIterator()); // The preallocated bulk copied values can then be transfered to an outbound message: outboundMessage.setValidValues.setValueFrom(preallocated);
Bulk transfer from the backing buffer may only possible between two fields with the same id (protobuf tag) because the bulk transfered bytes are in protobuf wire format which for most repeated fields encode the field's tag for each element.
initialBufferLength - the initial size of the underlying backing buffer.isNative - Whether the backing buffer should be a native or heap buffer.public final void setValidValues(String[] val)
ISrvMonOptionDescriptionsetValidValues in interface ISrvMonOptionDescriptionval - The value to set.public final void setValidValuesFrom(XIterator<String> val)
ISrvMonOptionDescription
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.
NOTE:
Passing a null or empty iterator has the same affect as calling ISrvMonOptionDescription.setValidValues(String[]) with
a value of null.
setValidValuesFrom in interface ISrvMonOptionDescriptionval - the values to set.public final void addValidValues(String val)
ISrvMonOptionDescriptionThis 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.
addValidValues in interface ISrvMonOptionDescriptionval - the value to add.public final String[] getValidValues()
ISrvMonOptionDescription
If the field is not set this method will return null.
getValidValues in interface ISrvMonOptionDescriptionnull.public final String[] getValidValuesEmptyIfNull()
ISrvMonOptionDescriptionnull or not set.
getValidValuesEmptyIfNull in interface ISrvMonOptionDescriptionnull if not set.ISrvMonOptionDescription.getValidValues()public final XStringIterator getValidValuesIterator()
ISrvMonOptionDescriptionThis 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.
getValidValuesIterator in interface ISrvMonOptionDescriptionpublic final void clearValidValues()
ISrvMonOptionDescriptionclearValidValues in interface ISrvMonOptionDescriptionISrvMonOptionDescription.setValidValues(String[])public static final int getDescriptionFieldId()
public final void setDescription(String val)
ISrvMonOptionDescriptionsetDescription in interface ISrvMonOptionDescriptionval - The value to set.public final String getDescription()
ISrvMonOptionDescriptiongetDescription in interface ISrvMonOptionDescriptionpublic final void lendDescription(XString val)
ISrvMonOptionDescriptionThis 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.
lendDescription in interface ISrvMonOptionDescriptionval - The value to set.public final void setDescriptionFrom(long val)
ISrvMonOptionDescription
NOTE:
This is the same as calling ISrvMonOptionDescription.setDescription(String).
with Long.valueOf(val).toString(), except that using this method is a zero garbage
operation for Xbuf encoding.
setDescriptionFrom in interface ISrvMonOptionDescriptionpublic final <T extends XString> T getDescriptionTo(XString.Factory<T> factory)
ISrvMonOptionDescription
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;
getDescriptionTo in interface ISrvMonOptionDescriptionfactory - The factory from which to get the XString to copy into and returnnull.public final void setDescriptionFrom(XString val)
ISrvMonOptionDescription
NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this setter
can be more efficient than ISrvMonOptionDescription.setDescription(String)
because it avoids encoding the value into a String if the given XString is already encoded.
setDescriptionFrom in interface ISrvMonOptionDescriptionpublic final void getDescriptionTo(XString val)
ISrvMonOptionDescription
NOTE:
This is a Zero Garbage operation for XBuf encoded objects. Additionally, this getter
can be more efficient than ISrvMonOptionDescription.getDescription() bec
because it can avoid decoding the value into an String.
getDescriptionTo in interface ISrvMonOptionDescriptionISrvMonOptionDescription.getDescription()public final XString getDescriptionUnsafe()
ISrvMonOptionDescription
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.
getDescriptionUnsafe in interface ISrvMonOptionDescriptionISrvMonOptionDescription.getDescription()public final void setDescriptionFrom(com.neeve.xbuf.XbufStringField val)
public final com.neeve.xbuf.XbufStringField getDescriptionField()
public final boolean hasDescription()
ISrvMonOptionDescriptionhasDescription in interface ISrvMonOptionDescriptionISrvMonOptionDescription.getDescription()public final void clearDescription()
ISrvMonOptionDescriptionclearDescription in interface ISrvMonOptionDescriptionISrvMonOptionDescription.setDescription(String)public static final int getDisplayNameFieldId()
public final void setDisplayName(String val)
ISrvMonOptionDescriptionIf 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 in interface ISrvMonOptionDescriptionval - The value to set.public final String getDisplayName()
ISrvMonOptionDescriptionIf 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 in interface ISrvMonOptionDescriptionpublic final void lendDisplayName(XString val)
ISrvMonOptionDescriptionThis 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.
lendDisplayName in interface ISrvMonOptionDescriptionval - The value to set.public final void setDisplayNameFrom(long val)
ISrvMonOptionDescriptionIf 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 ISrvMonOptionDescription.setDisplayName(String).
with Long.valueOf(val).toString(), except that using this method is a zero garbage
operation for Xbuf encoding.
setDisplayNameFrom in interface ISrvMonOptionDescriptionpublic final <T extends XString> T getDisplayNameTo(XString.Factory<T> factory)
ISrvMonOptionDescriptionIf 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;
getDisplayNameTo in interface ISrvMonOptionDescriptionfactory - The factory from which to get the XString to copy into and returnnull.public final void setDisplayNameFrom(XString val)
ISrvMonOptionDescriptionIf 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 ISrvMonOptionDescription.setDisplayName(String)
because it avoids encoding the value into a String if the given XString is already encoded.
setDisplayNameFrom in interface ISrvMonOptionDescriptionpublic final void getDisplayNameTo(XString val)
ISrvMonOptionDescriptionIf 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 ISrvMonOptionDescription.getDisplayName() bec
because it can avoid decoding the value into an String.
getDisplayNameTo in interface ISrvMonOptionDescriptionISrvMonOptionDescription.getDisplayName()public final XString getDisplayNameUnsafe()
ISrvMonOptionDescriptionIf 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.
getDisplayNameUnsafe in interface ISrvMonOptionDescriptionISrvMonOptionDescription.getDisplayName()public final void setDisplayNameFrom(com.neeve.xbuf.XbufStringField val)
public final com.neeve.xbuf.XbufStringField getDisplayNameField()
public final boolean hasDisplayName()
ISrvMonOptionDescriptionIf 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.
hasDisplayName in interface ISrvMonOptionDescriptionISrvMonOptionDescription.getDisplayName()public final void clearDisplayName()
ISrvMonOptionDescriptionIf 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.
clearDisplayName in interface ISrvMonOptionDescriptionISrvMonOptionDescription.setDisplayName(String)public final boolean isDirty()
public static final com.neeve.xbuf.XbufSchema createSchema()
public final byte[] serializeToByteArray()
public final ByteBuffer serializeToByteBuffer()
public final com.neeve.io.IOBuffer serializeToIOBuffer(boolean useNative)
public final boolean isBufferBacked()
public final int getSerializeToNativeLength()
public final int serializeToNative(long address,
int addressOffset)
public final SrvMonOptionDescription deserializeFromIOElasticBuffer(com.neeve.io.IOElasticBuffer buffer, int offset, int length, com.neeve.xbuf.XbufDesyncPolicy desyncPolicy)
public final SrvMonOptionDescription deserializeFromIOElasticBuffer(com.neeve.io.IOElasticBuffer buffer, int offset, int length)
public final SrvMonOptionDescription deserializeFromByteArray(byte[] array, com.neeve.xbuf.XbufDesyncPolicy desyncPolicy)
public final SrvMonOptionDescription deserializeFromByteArray(byte[] array)
public final SrvMonOptionDescription deserializeFromByteBuffer(ByteBuffer buffer, com.neeve.xbuf.XbufDesyncPolicy desyncPolicy)
public final SrvMonOptionDescription deserializeFromByteBuffer(ByteBuffer buffer)
public final SrvMonOptionDescription deserializeFromNative(long address, int offset, int length, com.neeve.xbuf.XbufDesyncPolicy desyncPolicy)
public final SrvMonOptionDescription deserializeFromNative(long address, int offset, int length)
public final void sync()
public final int desync(PktBuffer buffer, int pos, boolean frameOnly)
com.neeve.xbuf.IXbufDesyncerdesync in interface com.neeve.xbuf.IXbufDesyncerbuffer - The buffer to desync frompos - The position in the container's backing buffer to desync
fromframeOnly - Whether to frame the field on the underlying buffer.
See XbufField.desync(PktBuffer, int, boolean) for more
informationpublic final SrvMonOptionDescription init()
UtlPool.ItemThis method is invoked by an item pool very time an item is put into the pool. The method should wipe the contents of the item so as to present a fresh instance of the item to the caller when retrieved from the pool.
init in interface UtlPool.Item<SrvMonOptionDescription>public final SrvMonOptionDescription setPool(UtlPool<SrvMonOptionDescription> pool)
UtlPool.ItemThis method is invoked by an item pool at the time an item is added to the pool. The intent is to record the item's source pool in the item so it can be disposed back into the pool when the user is done working with it.
setPool in interface UtlPool.Item<SrvMonOptionDescription>public final UtlPool<SrvMonOptionDescription> getPool()
UtlPool.Item
This method should return the pool set using UtlPool.Item.setPool(com.neeve.util.UtlPool<T>)
getPool in interface UtlPool.Item<SrvMonOptionDescription>UtlPool.Item.setPool(com.neeve.util.UtlPool<T>)public final boolean isReferenceCounted()
public final SrvMonOptionDescription acquire()
public final int getOwnerCount()
public final void dispose()
public final Object clone()
This method differs from the copy() method in that:
public final SrvMonOptionDescription copy()
The copy copies primitive, enum and embedded entity fields into the returned copy. Each embedded entity field is cloned so that modifications made to the copy's embedded entity fields do not affect this SrvMonOptionDescription's embedded entity fields.
The returned copy will be writeable even if this SrvMonOptionDescription is read only.
public final void copyInto(SrvMonOptionDescription copy)
The copy clears the target's contents and copies primitive, enum and embedded entity fields into the provided copy. Each embedded entity field is cloned so that modifications made to the copy's embedded entity fields do not affect this SrvMonOptionDescription's embedded entity fields.
The returned copy will be writeable even if this SrvMonOptionDescription is read only.
copy - The target into which to copy.public final boolean isValid()
IRogValidatableisValid in interface IRogValidatablepublic final void getValidationErrors(List<XString> results, String errorPrefix)
IRogValidatablegetValidationErrors in interface IRogValidatableresults - A results list into which validation errors will be collected.errorPrefix - The bean path prefix to use when identifying invalid fields or null if validating a top level entity.Copyright © 2019 Neeve Research, LLC. All Rights Reserved.