01: /**
02: * Copyright (C) The MX4J Contributors.
03: * All rights reserved.
04: *
05: * This software is distributed under the terms of the MX4J License version 1.0.
06: * See the terms of the MX4J License in the documentation provided with this software.
07: */package javax.management.openmbean;
08:
09: import java.util.Collection;
10: import java.util.Set;
11:
12: /**
13: *
14: * @version $Revision: 1.6 $
15: */
16:
17: /**
18: * The TabularData interface specifies the behaviour of a specific type of complex open data objects which represent tabular data structures
19: */
20: public interface TabularData {
21: /**
22: * <p>Calculates the index that would be used in this TabularData instance to refer to the specified CompositeData value parameter, if it were added.
23: * 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
24: *
25: * @param index the CompositeData value whose index in this TabularData instance is to be calculated. It must be of the same composite type as this instances' rowType and cannot be null.
26: * @return object[] value that the specified value would have in this TabulatData instance
27: * @throws NullPointerException if index is null
28: * @throws InvalidOpenTypeException if index does not conform to this TabularData instance's rowType
29: */
30: public Object[] calculateIndex(CompositeData index);
31:
32: public void clear();
33:
34: public boolean containsKey(Object[] key)
35: throws InvalidOpenTypeException;
36:
37: public boolean containsValue(CompositeData value);
38:
39: public boolean equals(Object object);
40:
41: public CompositeData get(Object[] key) throws InvalidKeyException;
42:
43: /**
44: * @return the tabularType that desribes this particular instance
45: */
46: public TabularType getTabularType();
47:
48: public int hashCode();
49:
50: public boolean isEmpty();
51:
52: public Set keySet();
53:
54: public void put(CompositeData value)
55: throws InvalidOpenTypeException, KeyAlreadyExistsException;
56:
57: public void putAll(CompositeData[] values)
58: throws InvalidOpenTypeException, KeyAlreadyExistsException;
59:
60: public CompositeData remove(Object[] key)
61: throws InvalidKeyException;
62:
63: public int size();
64:
65: public String toString();
66:
67: public Collection values();
68: }
|