javax.management.modelmbean
Class DescriptorSupport

java.lang.Object
  javax.management.modelmbean.DescriptorSupport

All Implemented Interfaces:

java.lang.Cloneable, Descriptor (src) , java.io.Serializable

public class DescriptorSupport

extends java.lang.Object

implements Descriptor (src)

Support class for creating descriptors.

See Also:

Descriptor (src) , Serialized Form

DescriptorSupport

public DescriptorSupport()

Default constructor.

DescriptorSupport

public DescriptorSupport(int initialSize)
                  throws MBeanException (src) 

Creates descriptor instance with a given initial size.

Parameters:

initialSize - initial size of the descriptor

Throws:

MBeanException (src) - this exception is never thrown but is declared here for Sun RI API compatibility

RuntimeOperationsException (src) - if the initialSize is zero or negative. The target exception wrapped by this exception is an instace of IllegalArgumentException class.

DescriptorSupport

public DescriptorSupport(DescriptorSupport (src)  descriptor)

Copy constructor.

Parameters:

descriptor - the descriptor to be copied

Throws:

RuntimeOperationsException (src) - if descriptor is null. The target exception wrapped by this exception is an instance of IllegalArgumentException class.

DescriptorSupport

public DescriptorSupport(java.lang.String[] fieldNames,
                         java.lang.Object[] fieldValues)
                  throws RuntimeOperationsException (src) 

Creates descriptor instance with given field names and values.if both field names and field values array contain empty arrays, an empty descriptor is created. None of the name entries in the field names array can be a null reference. Field values may contain null references.

Parameters:

fieldNames - Contains names for the descriptor fields. This array cannot contain null references. If both fieldNames and fieldValues arguments contain null or empty array references then an empty descriptor is created. The size of the fieldNames array must match the size of the fieldValues array.

fieldValues - Contains values for the descriptor fields. Null references are allowed.

Throws:

RuntimeOperationsException (src) - if array sizes don't match

DescriptorSupport

public DescriptorSupport(java.lang.String[] fields)

DescriptorSupport

public DescriptorSupport(java.lang.String xmlString)
                  throws MBeanException (src) ,
                         RuntimeOperationsException (src) ,
                         XMLParseException (src) 

Descriptor constructor taking an XML String. In this implementation, all field values will be created as Strings. If the field values are not Strings, the programmer will have to reset or convert these fields correctly.

getFieldValue

public java.lang.Object getFieldValue(java.lang.String inFieldName)

Description copied from interface: Descriptor (src)

Retrieves the value of a field.

Specified by:

getFieldValue in interface Descriptor (src)

Parameters:

inFieldName - the name of the field.

Returns:

the value of the field.

setField

public void setField(java.lang.String inFieldName,
                     java.lang.Object fieldValue)

Description copied from interface: Descriptor (src)

Sets the value of a field.

Specified by:

setField in interface Descriptor (src)

Parameters:

inFieldName - the name of the field.

fieldValue - the value of the field.

getFields

public java.lang.String[] getFields()

Returns String array of fields in the format fieldName=fieldValue. If there are no fields in the descriptor, then an empty String array is returned. If a fieldValue is not a String then the toString() method is called on it and its returned value is used as the value for the field enclosed in parenthesis.

Specified by:

getFields in interface Descriptor (src)

Returns:

an array of fieldName=fieldValue strings.

getFieldNames

public java.lang.String[] getFieldNames()

Returns string array of fields names. If the descriptor is empty, you will get an empty array.

Specified by:

getFieldNames in interface Descriptor (src)

Returns:

an array of field name strings.

getFieldValues

public java.lang.Object[] getFieldValues(java.lang.String[] fieldNames)

Returns all the field values in the descriptor as an array of Objects. The returned values are in the same order as the fieldNames String array parameter.

Specified by:

getFieldValues in interface Descriptor (src)

Parameters:

fieldNames - the array of field names to retrieve. Pass null to retrieve all fields.

Returns:

an array of field values.

setFields

public void setFields(java.lang.String[] fieldNames,
                      java.lang.Object[] fieldValues)

Sets all Fields in the list to the new value in with the same index in the fieldValue array. Array sizes must match. The field value will be validated before it is set (by calling the method isValid) If it is not valid, then an exception will be thrown. If the arrays are empty, then no change will take effect.

Specified by:

setFields in interface Descriptor (src)

Parameters:

fieldNames - an array of fieldNames to set. Neither the array or array elements can be null. The fieldName must exist.

fieldValues - an array of fieldValues to set. Neither the array or array elements can be null. The fieldValue must be valid for the corresponding fieldName.

clone

public java.lang.Object clone()

Description copied from interface: Descriptor (src)

Returns a descriptor that is a duplicate of this one.

Specified by:

clone in interface Descriptor (src)

removeField

public void removeField(java.lang.String fieldName)

Description copied from interface: Descriptor (src)

Remove a field from the descriptor.

Specified by:

removeField in interface Descriptor (src)

Parameters:

fieldName - the field to remove. No exception is thrown when the field is not in the descriptor.

isValid

public boolean isValid()
                throws RuntimeOperationsException (src) 

Returns true if all of the fields have legal values given their names. This implementation does not support interopreating with a directory or lookup service. Thus, conforming to the specification, no checking is done on the "export" field. Otherwise this implementation returns false if: - name and descriptorType fieldNames are not defined, or null, or empty, or not String - class, role, getMethod, setMethod fieldNames, if defined, are null or not String - persistPeriod, currencyTimeLimit, lastUpdatedTimeStamp, lastReturnedTimeStamp if defined, are null, or not a Numeric String or not a Numeric Value >= -1 - log fieldName, if defined, is null, or not a Boolean or not a String with value "t", "f", "true", "false". These String values must not be case sensitive. - visibility fieldName, if defined, is null, or not a Numeric String or a not Numeric Value >= 1 and <= 4 - severity fieldName, if defined, is null, or not a Numeric String or not a Numeric Value >= 1 and <= 5 - persistPolicy fieldName, if defined, is null, or not a following String : - "OnUpdate", "OnTimer", "NoMoreOftenThan", "Always", "Never". These String values must not be case sensitive.

Specified by:

isValid in interface Descriptor (src)

Returns:

true if the values are legal.

Throws:

RuntimeOperationsException (src) - If the validity checking fails for any reason, this exception will be thrown.

toXMLString

public java.lang.String toXMLString()
                             throws RuntimeOperationsException (src) 

Returns an XML String representing the descriptor.

Throws:

RuntimeOperationsException (src)

toString

public java.lang.String toString()