19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 20 * 21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 22 * or visit www.oracle.com if you need additional information or have any 23 * questions. 24 */ 25 26 27 package javax.management.openmbean; 28 29 30 // java import 31 // 32 import java.util.Collection; 33 34 // jmx import 35 // 36 37 38 /** 39 * The <tt>CompositeData</tt> interface specifies the behavior of a specific type of complex <i>open data</i> objects 40 * which represent <i>composite data</i> structures. 41 * 42 * 43 * @since 1.5 44 */ 45 public interface CompositeData { 46 47 48 /** 49 * Returns the <i>composite type </i> of this <i>composite data</i> instance. 50 * 51 * @return the type of this CompositeData. 52 */ 53 public CompositeType getCompositeType(); 54 55 /** 56 * Returns the value of the item whose name is <tt>key</tt>. 57 * 58 * @param key the name of the item. 59 * 60 * @return the value associated with this key. 61 * 62 * @throws IllegalArgumentException if <tt>key</tt> is a null or empty String. 63 * 64 * @throws InvalidKeyException if <tt>key</tt> is not an existing item name for this <tt>CompositeData</tt> instance. 65 */ 66 public Object get(String key) ; 67 68 /** 69 * Returns an array of the values of the items whose names are specified by <tt>keys</tt>, in the same order as <tt>keys</tt>. 70 * 71 * @param keys the names of the items. 72 * 73 * @return the values corresponding to the keys. 74 * 75 * @throws IllegalArgumentException if an element in <tt>keys</tt> is a null or empty String. 76 * 77 * @throws InvalidKeyException if an element in <tt>keys</tt> is not an existing item name for this <tt>CompositeData</tt> instance. 78 */ 79 public Object[] getAll(String[] keys) ; 80 81 /** 82 * Returns <tt>true</tt> if and only if this <tt>CompositeData</tt> instance contains 83 * an item whose name is <tt>key</tt>. 84 * If <tt>key</tt> is a null or empty String, this method simply returns false. 85 * 86 * @param key the key to be tested. 87 * 88 * @return true if this <tt>CompositeData</tt> contains the key. 89 */ 90 public boolean containsKey(String key) ; 91 92 /** 93 * Returns <tt>true</tt> if and only if this <tt>CompositeData</tt> instance contains an item 94 * whose value is <tt>value</tt>. 95 * 96 * @param value the value to be tested. 97 * 98 * @return true if this <tt>CompositeData</tt> contains the value. 99 */ 100 public boolean containsValue(Object value) ; 101 102 /** 103 * Returns an unmodifiable Collection view of the item values contained in this <tt>CompositeData</tt> instance. 104 * The returned collection's iterator will return the values in the ascending lexicographic order of the corresponding 105 * item names. 106 * 107 * @return the values. 108 */ 109 public Collection<?> values() ; 110 111 /** 112 * Compares the specified <var>obj</var> parameter with this 113 * <code>CompositeData</code> instance for equality. 114 * <p> 115 * Returns <tt>true</tt> if and only if all of the following statements are true: 116 * <ul> 117 * <li><var>obj</var> is non null,</li> 118 * <li><var>obj</var> also implements the <code>CompositeData</code> interface,</li> 119 * <li>their composite types are equal</li> 120 * <li>their contents, i.e. (name, value) pairs are equal. If a value contained in 121 * the content is an array, the value comparison is done as if by calling 122 * the {@link java.util.Arrays#deepEquals(Object[], Object[]) deepEquals} method 123 * for arrays of object reference types or the appropriate overloading of 124 * {@code Arrays.equals(e1,e2)} for arrays of primitive types</li> 125 * </ul> 126 * <p> 127 * This ensures that this <tt>equals</tt> method works properly for 128 * <var>obj</var> parameters which are different implementations of the 129 * <code>CompositeData</code> interface, with the restrictions mentioned in the 130 * {@link java.util.Collection#equals(Object) equals} 131 * method of the <tt>java.util.Collection</tt> interface. 132 * 133 * @param obj the object to be compared for equality with this 134 * <code>CompositeData</code> instance. 135 * @return <code>true</code> if the specified object is equal to this 136 * <code>CompositeData</code> instance. 137 */ 138 public boolean equals(Object obj) ; 139 140 /** 141 * Returns the hash code value for this <code>CompositeData</code> instance. 142 * <p> 143 * The hash code of a <code>CompositeData</code> instance is the sum of the hash codes 144 * of all elements of information used in <code>equals</code> comparisons 145 * (ie: its <i>composite type</i> and all the item values). 146 * <p> 147 * This ensures that <code> t1.equals(t2) </code> implies that <code> t1.hashCode()==t2.hashCode() </code> 148 * for any two <code>CompositeData</code> instances <code>t1</code> and <code>t2</code>, 149 * as required by the general contract of the method 150 * {@link Object#hashCode() Object.hashCode()}. 151 * <p> 152 * Each item value's hash code is added to the returned hash code. 153 * If an item value is an array, 154 * its hash code is obtained as if by calling the 155 * {@link java.util.Arrays#deepHashCode(Object[]) deepHashCode} method 156 * for arrays of object reference types or the appropriate overloading 157 * of {@code Arrays.hashCode(e)} for arrays of primitive types. 158 * 159 * @return the hash code value for this <code>CompositeData</code> instance 160 */ 161 public int hashCode() ; 162 163 /** 164 * Returns a string representation of this <code>CompositeData</code> instance. 165 * <p> 166 * The string representation consists of the name of the implementing class, 167 * the string representation of the composite type of this instance, and the string representation of the contents 168 * (ie list the itemName=itemValue mappings). 169 * 170 * @return a string representation of this <code>CompositeData</code> instance 171 */ 172 public String toString() ; 173 174 } | 19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 20 * 21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 22 * or visit www.oracle.com if you need additional information or have any 23 * questions. 24 */ 25 26 27 package javax.management.openmbean; 28 29 30 // java import 31 // 32 import java.util.Collection; 33 34 // jmx import 35 // 36 37 38 /** 39 * The {@code CompositeData} interface specifies 40 * the behavior of a specific type of complex <i>open data</i> objects 41 * which represent <i>composite data</i> structures. 42 * 43 * 44 * @since 1.5 45 */ 46 public interface CompositeData { 47 48 49 /** 50 * Returns the <i>composite type </i> of this <i>composite data</i> instance. 51 * 52 * @return the type of this CompositeData. 53 */ 54 public CompositeType getCompositeType(); 55 56 /** 57 * Returns the value of the item whose name is {@code key}. 58 * 59 * @param key the name of the item. 60 * 61 * @return the value associated with this key. 62 * 63 * @throws IllegalArgumentException if {@code key} is a null or empty String. 64 * 65 * @throws InvalidKeyException if {@code key} is not an 66 * existing item name for this {@code CompositeData} instance. 67 */ 68 public Object get(String key) ; 69 70 /** 71 * Returns an array of the values of the items whose names 72 * are specified by {@code keys}, in the same order as {@code keys}. 73 * 74 * @param keys the names of the items. 75 * 76 * @return the values corresponding to the keys. 77 * 78 * @throws IllegalArgumentException if an element in {@code keys} is a null or empty String. 79 * 80 * @throws InvalidKeyException if an element in {@code keys} 81 * is not an existing item name for this {@code CompositeData} instance. 82 */ 83 public Object[] getAll(String[] keys) ; 84 85 /** 86 * Returns {@code true} if and only if this {@code CompositeData} instance contains 87 * an item whose name is {@code key}. 88 * If {@code key} is a null or empty String, this method simply returns false. 89 * 90 * @param key the key to be tested. 91 * 92 * @return true if this {@code CompositeData} contains the key. 93 */ 94 public boolean containsKey(String key) ; 95 96 /** 97 * Returns {@code true} if and only if this {@code CompositeData} instance contains an item 98 * whose value is {@code value}. 99 * 100 * @param value the value to be tested. 101 * 102 * @return true if this {@code CompositeData} contains the value. 103 */ 104 public boolean containsValue(Object value) ; 105 106 /** 107 * Returns an unmodifiable Collection view of the item values 108 * contained in this {@code CompositeData} instance. 109 * The returned collection's iterator will return the values 110 * in the ascending lexicographic order of the corresponding 111 * item names. 112 * 113 * @return the values. 114 */ 115 public Collection<?> values() ; 116 117 /** 118 * Compares the specified <var>obj</var> parameter with this 119 * {@code CompositeData} instance for equality. 120 * <p> 121 * Returns {@code true} if and only if all of the following statements are true: 122 * <ul> 123 * <li><var>obj</var> is non null,</li> 124 * <li><var>obj</var> also implements the {@code CompositeData} interface,</li> 125 * <li>their composite types are equal</li> 126 * <li>their contents, i.e. (name, value) pairs are equal. If a value contained in 127 * the content is an array, the value comparison is done as if by calling 128 * the {@link java.util.Arrays#deepEquals(Object[], Object[]) deepEquals} method 129 * for arrays of object reference types or the appropriate overloading of 130 * {@code Arrays.equals(e1,e2)} for arrays of primitive types</li> 131 * </ul> 132 * <p> 133 * This ensures that this {@code equals} method works properly for 134 * <var>obj</var> parameters which are different implementations of the 135 * {@code CompositeData} interface, with the restrictions mentioned in the 136 * {@link java.util.Collection#equals(Object) equals} 137 * method of the {@code java.util.Collection} interface. 138 * 139 * @param obj the object to be compared for equality with this 140 * {@code CompositeData} instance. 141 * @return {@code true} if the specified object is equal to this 142 * {@code CompositeData} instance. 143 */ 144 public boolean equals(Object obj) ; 145 146 /** 147 * Returns the hash code value for this {@code CompositeData} instance. 148 * <p> 149 * The hash code of a {@code CompositeData} instance is the sum of the hash codes 150 * of all elements of information used in {@code equals} comparisons 151 * (ie: its <i>composite type</i> and all the item values). 152 * <p> 153 * This ensures that {@code t1.equals(t2)} implies that {@code t1.hashCode()==t2.hashCode()} 154 * for any two {@code CompositeData} instances {@code t1} and {@code t2}, 155 * as required by the general contract of the method 156 * {@link Object#hashCode() Object.hashCode()}. 157 * <p> 158 * Each item value's hash code is added to the returned hash code. 159 * If an item value is an array, 160 * its hash code is obtained as if by calling the 161 * {@link java.util.Arrays#deepHashCode(Object[]) deepHashCode} method 162 * for arrays of object reference types or the appropriate overloading 163 * of {@code Arrays.hashCode(e)} for arrays of primitive types. 164 * 165 * @return the hash code value for this {@code CompositeData} instance 166 */ 167 public int hashCode() ; 168 169 /** 170 * Returns a string representation of this {@code CompositeData} instance. 171 * <p> 172 * The string representation consists of the name of the implementing class, 173 * the string representation of the composite type of this instance, 174 * and the string representation of the contents 175 * (ie list the itemName=itemValue mappings). 176 * 177 * @return a string representation of this {@code CompositeData} instance 178 */ 179 public String toString() ; 180 181 } |