|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--javax.management.openmbean.TabularDataSupport
The TabularDataSupport class is the open data class which implements the TabularData and the Map interfaces, and which is internally based on a hash map data structure
Inner classes inherited from class java.util.Map |
---|
java.util.Map.Entry |
Constructor Summary | |
---|---|
TabularDataSupport(TabularType tabularType)
Creates an empty TabularDataSupport instance whose open-type is tabularType, and whose underlying HashMap has a default initial capacity (101) and default load factor (0.75). |
|
TabularDataSupport(TabularType tabularType,
int initialCapacity,
float loadFactor)
Creates an empty TabularDataSupport instance whose open-type is tabularType, and whose underlying HashMap has the specified initial capacity and load factor |
Method Summary | |
---|---|
java.lang.Object[] |
calculateIndex(CompositeData value)
Calculates the index that would be used in this TabularData instance to refer to the specified composite data value parameter is it were added to this instance.This method checks for the type validity of the specified value, but does not check if the calculated index is already used to refer to a value, in this tabular data instance |
void |
clear()
clears this instances internal map |
java.lang.Object |
clone()
Returns a clone of this TabularDataSupport instance: the clone is obtained by calling super.clone(), and then cloning the underlying map. |
boolean |
containsKey(java.lang.Object key)
returns true if and only if this tabularData instance contains a compositeData value (i.e. |
boolean |
containsKey(java.lang.Object[] key)
Returns true if and only if this TabularData instance contains a CompositeData value (ie a row) whose index is the specified key. |
boolean |
containsValue(CompositeData value)
Returns true if and only if this TabularData instance contains the specified CompositeData value. |
boolean |
containsValue(java.lang.Object value)
Returns true if and only if this TabularData instance contains the specified value. |
java.util.Set |
entrySet()
Returns a collection view of the index to row mappings contained in this TabularDataSupport instance. |
boolean |
equals(java.lang.Object obj)
Compares the specified obj parameter with this TabularDataSupport instance for equality |
java.lang.Object |
get(java.lang.Object key)
This method simply calls get((Object[]) key). |
CompositeData |
get(java.lang.Object[] key)
This method validates the key Object[] parameter. |
TabularType |
getTabularType()
get the TabularType that this instance contains |
int |
hashCode()
The hash code of a TabularDataSupport instance is the sum of the hash codes of all elements of information used in equals comparisons (ie: its tabular type and its content, where the content is defined as all the CompositeData values). |
boolean |
isEmpty()
|
java.util.Set |
keySet()
Returns a set view of the keys contained in the underlying map of this TabularDataSupport instance, and used to index the rows. |
void |
put(CompositeData value)
Adds "value" to this TabularData instance, if value's composite type is the same as this instance's row type (ie the composite type returned by this.getTabularType().getRowType()), and if there is not already an existing value in this TabularData instance whose index is the same as the one calculated for the value to be added. |
java.lang.Object |
put(java.lang.Object key,
java.lang.Object value)
This method simply calls put((CompositeData) value) and therefore ignores its key parameter which can be null |
void |
putAll(CompositeData[] values)
Adds all the elements in values to this TabularData instance. |
void |
putAll(java.util.Map t)
Add all the values contained in the specified map t to this TabularData instance. |
java.lang.Object |
remove(java.lang.Object key)
This method simply calls remove((Object[]) key). |
CompositeData |
remove(java.lang.Object[] key)
Method validates the key checking for null, zero length and if items in the key are invalid as returned by @see OpenType isValue(Object obj) |
int |
size()
|
java.lang.String |
toString()
The string representation consists of the name of this class (ie com.sun.jdmk.TabularDataSupport), the string representation of the tabular type of this instance, and the string representation of the contents (ie list the key=value mappings as returned by a call to dataMap.toString()) |
java.util.Collection |
values()
Returns a collection view of the rows contained in this TabularDataSupport instance. |
Methods inherited from class java.lang.Object |
---|
finalize, getClass, notify, notifyAll, wait, wait, wait |
Constructor Detail |
public TabularDataSupport(TabularType tabularType)
tabularType
- the TabularTypeBackUP describing this TabularData instance, cannot be nullpublic TabularDataSupport(TabularType tabularType, int initialCapacity, float loadFactor)
tabularType
- - the tabular type describing this instance, cannot be null;initialCapacity
- - the initial capacity of the MaploadFactor
- - the load factor of the Mapjava.lang.IllegalArgumentException
- if the initialCapacity is less than zero, the load factor is negative or the tabularType is nullMethod Detail |
public TabularType getTabularType()
getTabularType
in interface TabularData
public java.lang.Object[] calculateIndex(CompositeData value)
Calculates the index that would be used in this TabularData instance to refer to the specified composite data value parameter is it were added to this instance.This method checks for the type validity of the specified value, but does not check if the calculated index is already used to refer to a value, in this tabular data instance
calculateIndex
in interface TabularData
value
- - the CompositeData value whose index in this TabularData instance is to be calculated, must be of the same composite type as this instance's row type;
must not be null.NullPointerException
- if value is nullInvalidOpenTypeException
- if value does not conform to this tabular data instances' row type definitionpublic boolean containsKey(java.lang.Object key)
containsKey
in interface java.util.Map
key
- - the index valuepublic boolean containsKey(java.lang.Object[] key)
containsKey
in interface TabularData
key
- the index value whose presence in this TabularData instance is to be testedpublic boolean containsValue(CompositeData value)
containsValue
in interface TabularData
value
- - the row value whose presence in this TabularData instance is to be testedpublic boolean containsValue(java.lang.Object value)
containsValue
in interface java.util.Map
value
- - the row value whose presence in this TabularData instance is to be testedpublic java.lang.Object get(java.lang.Object key)
get
in interface java.util.Map
key
- - the key for which to lookup the valuepublic CompositeData get(java.lang.Object[] key)
get
in interface TabularData
key
- - the Object[] key stored as a key in this instanceNullPointerException
- if key is null or emptyInvalidKeyException
- if an item in the array returns false for call OpenType isValue(Object o)public java.lang.Object put(java.lang.Object key, java.lang.Object value)
put
in interface java.util.Map
java.lang.ClassCastException
- if value is not an instanceof CompositeDatapublic void put(CompositeData value)
put
in interface TabularData
value
- - the composite data value to be added as a new row to this TabularData instance; must be of the same composite type as this instance's row type; must not be null.NullPointerException
- if value is nullInvalidOpenTypeException
- if value does not conform to this TabularData instance's row type definitionKeyAlreadyExistsException
- if the underlying HashMap already contains the calculated keypublic java.lang.Object remove(java.lang.Object key)
remove
in interface java.util.Map
key
- - the Object to remove note no checks are done if key can be cast to Object[] hence if not a ClassCastException will be thrownjava.lang.ClassCastException
- if key cannot be cast to an Object[]public CompositeData remove(java.lang.Object[] key)
remove
in interface TabularData
key
- - the index of the value to get in this TabularData instance; must be valid with this TabularData instance's row type definition; must not be null.NullPointerException
- if key is nullInvalidKeyException
- if the key does not conform to this TabularData instance's TabularType definitionpublic void putAll(java.util.Map t)
putAll
in interface java.util.Map
t
- - the map whose values are to be added as new rows to this TabularData instance; if t is null or empty, this method returns without doing anythingNullPointerException
- - if a "value" in t is nulljava.lang.ClassCastException
- - if a value in t is not an instanceof CompositeData this is a wrapper around the RuntimeException ArrayStoreException
which is generated when an attempt has been made to store the wrong type of object into an array of objects.InvalidOpenTypeException
- - if a value in t does not conform to this TabularData instance's row type definitionKeyAlreadyExistsException
- - if the index for a value in t, calculated according to this TabularData instance's TabularType definition
already maps to an existing value in this instance, or two values in t have the same index.public void putAll(CompositeData[] values)
putAll
in interface TabularData
values
- - the array of composite data values to be added as new rows to this TabularData instance; if values is null or empty, this method returns without doing anythingNullPointerException
- - if an element of values is nullInvalidOpenTypeException
- - if an element of values does not conform to this TabularData instance's row type definition (ie its TabularType definition)KeyAlreadyExistsException
- - if the index for an element of values, calculated according to this TabularData instance's TabularType definition already
maps to an existing value in this instance, or two elements of values have the same indexpublic void clear()
clear
in interface TabularData
public int size()
size
in interface TabularData
public boolean isEmpty()
isEmpty
in interface TabularData
public java.util.Set keySet()
keySet
in interface TabularData
public java.util.Collection values()
values
in interface TabularData
public java.util.Set entrySet()
NOTE Do not use the SetValue method of Map.Entry elements contained in the returned collection view. Doing so would corrupt the index to row mappings contained in this TabularDataSupport instance
entrySet
in interface java.util.Map
public java.lang.Object clone()
clone
in class java.lang.Object
public boolean equals(java.lang.Object obj)
equals
in interface TabularData
equals
in class java.lang.Object
public int hashCode()
hashCode
in interface TabularData
hashCode
in class java.lang.Object
public java.lang.String toString()
toString
in interface TabularData
toString
in class java.lang.Object
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |