javax.management.openmbean
public class TabularDataSupport extends Object implements TabularData, Serializable, Cloneable, Map<Object,Object>
Since: 1.5
Constructor Summary | |
---|---|
TabularDataSupport(TabularType type)
Constructs a new empty TabularDataSupport with the
specified type. | |
TabularDataSupport(TabularType type, int cap, float lf)
Constructs a new empty TabularDataSupport with the
specified type and the supplied initial capacity and load factor
being used for the underlying java.util.HashMap. |
Method Summary | |
---|---|
Object[] | calculateIndex(CompositeData val)
Calculates the index the specified CompositeData value
would have, if it was to be added to this TabularData
instance. |
void | clear()
Removes all CompositeData values from the table. |
boolean | containsKey(Object key)
Returns true iff this instance of the TabularData class
contains a CompositeData value at the specified index.
|
boolean | containsKey(Object[] key)
Returns true iff this instance of the TabularData class
contains a CompositeData value at the specified index.
|
boolean | containsValue(Object val)
Returns true iff this instance of the TabularData class
contains the specified CompositeData value. |
boolean | containsValue(CompositeData val)
Returns true iff this instance of the TabularData class
contains the specified CompositeData value.
|
Set<Entry<Object,Object>> | entrySet() Returns a set view of the mappings in this Map. |
boolean | equals(Object obj)
Compares the specified object with this object for equality.
|
Object | get(Object key)
Retrieves the value for the specified key by simply
calling get((Object[]) key) .
|
CompositeData | get(Object[] key)
Retrieves the CompositeData value for the specified
key, or null if no such mapping exists.
|
TabularType | getTabularType()
Returns the tabular type which corresponds to this instance
of TabularData.
|
int | hashCode()
Returns the hash code of the composite data type. |
boolean | isEmpty()
Returns true if this TabularData instance
contains no CompositeData values.
|
Set<Object> | keySet()
Returns a set view of the keys in this Map. |
void | put(CompositeData val)
Adds the specified CompositeData value to the
table. |
Object | put(Object key, Object val)
Adds the specified CompositeData value to the
table, ignoring the supplied key, by simply calling
put((CompositeData) val) .
|
void | putAll(CompositeData[] vals)
Adds each of the specified CompositeData values
to the table. |
void | putAll(Map<?,?> m)
Converts each value from the specified map to a member of an
array of CompositeData values and adds them using (CompositeData[]) , if possible. |
Object | remove(Object key)
Removes the value for the specified key by simply
calling remove((Object[]) key) .
|
CompositeData | remove(Object[] key)
Removes the CompositeData value located at the
specified index. |
int | size()
Returns the number of CompositeData values or rows
in the table.
|
String | toString()
Returns a textual representation of this instance. |
Collection<Object> | values()
Returns a collection (or bag) view of the values in this Map. |
101
and default load factor of 0.75
.
Parameters: type the tabular type of this tabular data instance.
Throws: IllegalArgumentException if type
is
null
.
Parameters: type the tabular type of this tabular data instance. cap the initial capacity of the underlying map. lf the load factor of the underlying map.
Throws: IllegalArgumentException if type
is
null
, or
cap
or
lf
are
negative.
null
. Possible indices are
selected by the getIndexNames method of
this instance's tabular type. The returned indices are the
values of the fields in the supplied CompositeData
instance that match the names given in the TabularType.
Parameters: val the CompositeData value whose index should be calculated.
Returns: the index the value would take on, if it were to be added.
Throws: NullPointerException if the value is null
. InvalidOpenTypeException if the value does not match the
row type of this instance.
false
if the given key can
not be cast to an java.lang.Object array; otherwise
it returns the result of (java.lang.Object[])
.
Parameters: key the key to test for.
Returns: true if the key maps to a CompositeData value.
null
or of the incorrect type, according to
the TabularType of this instance, this method returns
false.
Parameters: key the key to test for.
Returns: true if the key maps to a CompositeData value.
Parameters: val the value to test for.
Returns: true if the value exists.
null
or of the incorrect type, according to
the TabularType of this instance, this method returns
false.
Parameters: val the value to test for.
Returns: true if the value exists.
Returns a set view of the mappings in this Map. Each element in the
set is a Map.Entry. The set is backed by the map, so that changes in
one show up in the other. Modifications made while an iterator is
in progress cause undefined behavior. If the set supports removal,
these methods remove the underlying mapping from the map:
Iterator.remove
, Set.remove
,
removeAll
, retainAll
, and clear
.
Element addition, via add
or addAll
, is
not supported via this set.
Note: using the
java.util.Map.Entry#setValue(Object) will cause corruption of
the index to row mappings.
Returns: the set view of all mapping entries
See Also: java.util.Map.Entry
Parameters: obj the object to compare for equality.
Returns: true if obj
is equal to this
.
get((Object[]) key)
.
Parameters: key the key whose value should be returned.
Returns: the matching CompositeData value, or
null
if one does not exist.
Throws: NullPointerException if the key is null
. ClassCastException if the key is not an instance
of Object[]
. InvalidKeyException if the key does not match
the TabularType of this
instance.
null
if no such mapping exists.
Parameters: key the key whose value should be returned.
Returns: the matching CompositeData value, or
null
if one does not exist.
Throws: NullPointerException if the key is null
. InvalidKeyException if the key does not match
the TabularType of this
instance.
Returns: the tabular type for this instance.
Returns: the hash code of this instance.
Returns: true if the instance is devoid of rows.
Iterator.remove
, Set.remove
,
removeAll
, retainAll
, and clear
.
Element addition, via add
or addAll
, is
not supported via this set.
Returns: the set view of all keys
Parameters: val the CompositeData value to add.
Throws: NullPointerException if val
is
null
. InvalidOpenTypeException if the type of the
given value does not
match the row type. KeyAlreadyExistsException if the value has the
same calculated index
as an existing value.
put((CompositeData) val)
.
Parameters: key ignored. val the CompositeData value to add.
Returns: the CompositeData value.
Throws: NullPointerException if val
is
null
. InvalidOpenTypeException if the type of the
given value does not
match the row type. KeyAlreadyExistsException if the value has the
same calculated index
as an existing value.
null
or empty, the
method simply returns.
Parameters: vals the CompositeData values to add.
Throws: NullPointerException if a value from the array is
null
. InvalidOpenTypeException if the type of a
given value does not
match the row type. KeyAlreadyExistsException if a value has the
same calculated index
as an existing value or
of one of the other
specified values.
(CompositeData[])
, if possible. As in put, the keys are simply ignored. This method
is useful for adding the CompositeData values from a
different TabularData instance, which uses the same
TabularType but a different selection of index names, to
this one. If the map is null
or empty, the method
simply returns.
Parameters: m the map to add. Only the values are used and must all be instances of CompositeData.
Throws: NullPointerException if a value from the map is
null
. ClassCastException if a value from the map is not
an instance of CompositeData. InvalidOpenTypeException if the type of the
given value does not
match the row type. KeyAlreadyExistsException if the value has the
same calculated index
as an existing value or
of one of the other
specified values.
remove((Object[]) key)
.
Parameters: key the key whose value should be removed.
Returns: the removed value, or null
if
there is no value for the given key.
Throws: NullPointerException if the key is null
. ClassCastException if the key is not an instance
of Object[]
. InvalidOpenTypeException if the key does not match
the TabularType of this
instance.
null
is returned if the
value does not exist. Otherwise, the removed value is
returned.
Parameters: key the key of the value to remove.
Returns: the removed value, or null
if
there is no value for the given key.
Throws: NullPointerException if the key is null
. InvalidOpenTypeException if the key does not match
the TabularType of this
instance.
Returns: the number of rows in the table.
javax.management.openmbean.TabularDataSupport
)
and the result of calling toString()
on the
tabular type and underlying hash map instance.
Returns: a java.lang.String representation of the object.
Iterator.remove
,
Collection.remove
, removeAll
,
retainAll
, and clear
. Element addition, via
add
or addAll
, is not supported via this
collection.
Returns: the collection view of all values