Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## javax.management.openmbean
Interface TabularData

All Known Implementing Classes:
  TabularDataSupport

public interface TabularData

The `TabularData` interface specifies the behaviour of a specific type of complex open data objects which represent tabular data structures.

Author:
  Young Yang

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 if it were added to this instance.
`void` | `clear()` Removes all `CompositeData` values (ie rows) from this `TabularData` instance.
`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` | `equals(java.lang.Object obj)` Compares the specified obj parameter with this `TabularData` instance for equality.
`CompositeData` | `get(java.lang.Object[] key)` Returns the `CompositeData` value whose index is key, or `null` if there is no value mapping to key, in this `TabularData` instance.
`TabularType` | `getTabularType()` Returns the tabular type describing this `TabularData` instance.
`int` | `hashCode()` Returns the hash code value for this `TabularData` instance.
`boolean` | `isEmpty()` Returns `true` if the number of `CompositeData` values (ie the number of rows) contained in this `TabularData` instance is zero.
`java.util.Set` | `keySet()` Returns a set view of the keys (ie the index values) of the `CompositeData` values (ie the rows) contained in this `TabularData` instance.
`void` | `put(CompositeData value)` Adds value to this `TabularData` instance.
`void` | `putAll(CompositeData[] values)` Add all the elements in values to this `TabularData` instance.
`CompositeData` | `remove(java.lang.Object[] key)` Removes the `CompositeData` value whose index is key from this `TabularData` instance, and returns the removed value, or returns `null` if there is no value whose index is key.
`int` | `size()` Returns the number of `CompositeData` values (ie the number of rows) contained in this `TabularData` instance.
`java.lang.String` | `toString()` Returns a string representation of this `TabularData` instance.
`java.util.Collection` | `values()` Returns a collection view of the `CompositeData` values (ie the rows) contained in this `TabularData` instance.

Method Detail

### getTabularType

    public TabularType getTabularType()

  Returns the tabular type describing this `TabularData` instance.
  Returns:
    the tabular type.

### calculateIndex

    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 if 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 `TabularData` instance.
  Parameters:
    `value` - the composite data 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.
  Returns:
    the index that the specified value would have in this `TabularData` instance.
  Throws:
    `NullPointerException` - if value is `null`
    `InvalidOpenTypeException` - if value does not conform to this `TabularData` instance's row type definition.

### size

    public int size()

  Returns the number of `CompositeData` values (ie the number of rows) contained in this `TabularData` instance.
  Returns:
    the number of values contained.

### isEmpty

    public boolean isEmpty()

  Returns `true` if the number of `CompositeData` values (ie the number of rows) contained in this `TabularData` instance is zero.
  Returns:
    true if this `TabularData` is empty.

### containsKey

    public 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. If key is `null` or does not conform to this `TabularData` instance's `TabularType` definition, this method simply returns `false`.
  Parameters:
    `key` - the index value whose presence in this `TabularData` instance is to be tested.
  Returns:
    `true` if this `TabularData` indexes a row value with the specified key.

### containsValue

    public boolean containsValue(CompositeData value)

  Returns `true` if and only if this `TabularData` instance contains the specified `CompositeData` value. If value is `null` or does not conform to this `TabularData` instance's row type definition, this method simply returns `false`.
  Parameters:
    `value` - the row value whose presence in this `TabularData` instance is to be tested.
  Returns:
    `true` if this `TabularData` instance contains the specified row value.

### get

    public CompositeData get(java.lang.Object[] key)

  Returns the `CompositeData` value whose index is key, or `null` if there is no value mapping to key, in this `TabularData` instance.
  Parameters:
    `key` - the key of the row to return.
  Returns:
    the value corresponding to key.
  Throws:
    `NullPointerException` - if the key is `null`
    `InvalidKeyException` - if the key does not conform to this `TabularData` instance's * `TabularType` definition

### put

    public void put(CompositeData value)

  Adds value to this `TabularData` instance. The composite type of value must be the same as this instance's row type (ie the composite type returned by `this.getTabularType().`getRowType()``), and there must not already be an existing value in this `TabularData` instance whose index is the same as the one calculated for the value to be added. The index for value is calculated according to this `TabularData` instance's `TabularType` definition (see `TabularType.`getIndexNames()``).
  Parameters:
    `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.
  Throws:
    `NullPointerException` - if value is `null`
    `InvalidOpenTypeException` - if value does not conform to this `TabularData` instance's row type definition.
    `KeyAlreadyExistsException` - if the index for value, calculated according to this `TabularData` instance's `TabularType` definition already maps to an existing value in the underlying HashMap.

### remove

    public CompositeData remove(java.lang.Object[] key)

  Removes the `CompositeData` value whose index is key from this `TabularData` instance, and returns the removed value, or returns `null` if there is no value whose index is key.
  Parameters:
    `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.
  Returns:
    previous value associated with specified key, or `null` if there was no mapping for key.
  Throws:
    `NullPointerException` - if the key is `null`
    `InvalidKeyException` - if the key does not conform to this `TabularData` instance's `TabularType` definition

### putAll

    public void putAll(CompositeData[] values)

  Add all the elements in values to this `TabularData` instance. If any element in values does not satisfy the constraints defined in ``put``, or if any two elements in values have the same index calculated according to this `TabularData` instance's `TabularType` definition, then an exception describing the failure is thrown and no element of values is added, thus leaving this `TabularData` instance unchanged.
  Parameters:
    `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 anything.
  Throws:
    `NullPointerException` - if an element of values is `null`
    `InvalidOpenTypeException` - if an element of values does not conform to this `TabularData` instance's row type 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 index.

### clear

    public void clear()

  Removes all `CompositeData` values (ie rows) from this `TabularData` instance.

### keySet

    public java.util.Set keySet()

  Returns a set view of the keys (ie the index values) of the `CompositeData` values (ie the rows) contained in this `TabularData` instance. The returned Set can then be used to iterate over the keys.
  Returns:
    a set view of the index values used in this `TabularData` instance.

### values

    public java.util.Collection values()

  Returns a collection view of the `CompositeData` values (ie the rows) contained in this `TabularData` instance. The returned collection can then be used to iterate over the values.
  Returns:
    a collection view of the rows contained in this `TabularData` instance.

### equals

    public boolean equals(java.lang.Object obj)

  Compares the specified obj parameter with this `TabularData` instance for equality.

  Returns `true` if and only if all of the following statements are true:

  - obj is non null,
  - obj also implements the `TabularData` interface,
  - their row types are equal
  - their contents (ie index to value mappings) are equal
  This ensures that this `equals` method works properly for obj parameters which are different implementations of the `TabularData` interface.
  Overrides:
    `equals` in class `java.lang.Object`
  Parameters:
    `obj` - the object to be compared for equality with this `TabularData` instance;
  Returns:
    `true` if the specified object is equal to this `TabularData` instance.

### hashCode

    public int hashCode()

  Returns the hash code value for this `TabularData` instance.

  The hash code of a `TabularData` 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 index to value mappings).

  This ensures that `t1.equals(t2)` implies that `t1.hashCode()==t2.hashCode()` for any two `TabularDataSupport` instances `t1` and `t2`, as required by the general contract of the method `Object.hashCode` .

  Overrides:
    `hashCode` in class `java.lang.Object`
  Returns:
    the hash code value for this `TabularDataSupport` instance

### toString

    public java.lang.String toString()

  Returns a string representation of this `TabularData` instance.

  The string representation consists of the name of the implementing class, and the tabular type of this instance.

  Overrides:
    `toString` in class `java.lang.Object`
  Returns:
    a string representation of this `TabularData` instance

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD