< prev index next >

src/java.management/share/classes/javax/management/openmbean/OpenMBeanAttributeInfo.java

Print this page

        

*** 51,133 **** // Re-declares the methods that are in class MBeanAttributeInfo of JMX 1.0 // (these will be removed when MBeanAttributeInfo is made a parent interface of this interface) /** ! * Returns <tt>true</tt> if the attribute described by this <tt>OpenMBeanAttributeInfo</tt> instance is readable, ! * <tt>false</tt> otherwise. * * @return true if the attribute is readable. */ public boolean isReadable() ; /** ! * Returns <tt>true</tt> if the attribute described by this <tt>OpenMBeanAttributeInfo</tt> instance is writable, ! * <tt>false</tt> otherwise. * * @return true if the attribute is writable. */ public boolean isWritable() ; /** ! * Returns <tt>true</tt> if the attribute described by this <tt>OpenMBeanAttributeInfo</tt> instance ! * is accessed through a <tt>is<i>XXX</i></tt> getter (applies only to <tt>boolean</tt> and <tt>Boolean</tt> values), ! * <tt>false</tt> otherwise. * ! * @return true if the attribute is accessed through <tt>is<i>XXX</i></tt>. */ public boolean isIs() ; // commodity methods // /** ! * Compares the specified <var>obj</var> parameter with this <code>OpenMBeanAttributeInfo</code> instance for equality. * <p> ! * Returns <tt>true</tt> if and only if all of the following statements are true: * <ul> * <li><var>obj</var> is non null,</li> ! * <li><var>obj</var> also implements the <code>OpenMBeanAttributeInfo</code> interface,</li> * <li>their names are equal</li> * <li>their open types are equal</li> * <li>their access properties (isReadable, isWritable and isIs) are equal</li> * <li>their default, min, max and legal values are equal.</li> * </ul> ! * This ensures that this <tt>equals</tt> method works properly for <var>obj</var> parameters which are ! * different implementations of the <code>OpenMBeanAttributeInfo</code> interface. * <br>&nbsp; ! * @param obj the object to be compared for equality with this <code>OpenMBeanAttributeInfo</code> instance; * ! * @return <code>true</code> if the specified object is equal to this <code>OpenMBeanAttributeInfo</code> instance. */ public boolean equals(Object obj); /** ! * Returns the hash code value for this <code>OpenMBeanAttributeInfo</code> instance. * <p> ! * The hash code of an <code>OpenMBeanAttributeInfo</code> instance is the sum of the hash codes ! * of all elements of information used in <code>equals</code> comparisons * (ie: its name, its <i>open type</i>, and its default, min, max and legal values). * <p> ! * This ensures that <code> t1.equals(t2) </code> implies that <code> t1.hashCode()==t2.hashCode() </code> ! * for any two <code>OpenMBeanAttributeInfo</code> instances <code>t1</code> and <code>t2</code>, * as required by the general contract of the method * {@link Object#hashCode() Object.hashCode()}. * ! * @return the hash code value for this <code>OpenMBeanAttributeInfo</code> instance */ public int hashCode(); /** ! * Returns a string representation of this <code>OpenMBeanAttributeInfo</code> instance. * <p> ! * The string representation consists of the name of this class (ie <code>javax.management.openmbean.OpenMBeanAttributeInfo</code>), * the string representation of the name and open type of the described attribute, * and the string representation of its default, min, max and legal values. * ! * @return a string representation of this <code>OpenMBeanAttributeInfo</code> instance */ public String toString(); // methods specific to open MBeans are inherited from --- 51,136 ---- // Re-declares the methods that are in class MBeanAttributeInfo of JMX 1.0 // (these will be removed when MBeanAttributeInfo is made a parent interface of this interface) /** ! * Returns {@code true} if the attribute described by this {@code OpenMBeanAttributeInfo} ! * instance is readable, {@code false} otherwise. * * @return true if the attribute is readable. */ public boolean isReadable() ; /** ! * Returns {@code true} if the attribute described by this {@code OpenMBeanAttributeInfo} ! * instance is writable, {@code false} otherwise. * * @return true if the attribute is writable. */ public boolean isWritable() ; /** ! * Returns {@code true} if the attribute described by this {@code OpenMBeanAttributeInfo} instance ! * is accessed through a <code>is<i>XXX</i></code> getter ! * (applies only to {@code boolean} and {@code Boolean} values), ! * {@code false} otherwise. * ! * @return true if the attribute is accessed through <code>is<i>XXX</i></code>. */ public boolean isIs() ; // commodity methods // /** ! * Compares the specified <var>obj</var> parameter with this ! * {@code OpenMBeanAttributeInfo} instance for equality. * <p> ! * Returns {@code true} if and only if all of the following statements are true: * <ul> * <li><var>obj</var> is non null,</li> ! * <li><var>obj</var> also implements the {@code OpenMBeanAttributeInfo} interface,</li> * <li>their names are equal</li> * <li>their open types are equal</li> * <li>their access properties (isReadable, isWritable and isIs) are equal</li> * <li>their default, min, max and legal values are equal.</li> * </ul> ! * This ensures that this {@code equals} method works properly for <var>obj</var> parameters which are ! * different implementations of the {@code OpenMBeanAttributeInfo} interface. * <br>&nbsp; ! * @param obj the object to be compared for equality with this {@code OpenMBeanAttributeInfo} instance; * ! * @return {@code true} if the specified object is equal to this {@code OpenMBeanAttributeInfo} instance. */ public boolean equals(Object obj); /** ! * Returns the hash code value for this {@code OpenMBeanAttributeInfo} instance. * <p> ! * The hash code of an {@code OpenMBeanAttributeInfo} instance is the sum of the hash codes ! * of all elements of information used in {@code equals} comparisons * (ie: its name, its <i>open type</i>, and its default, min, max and legal values). * <p> ! * This ensures that {@code t1.equals(t2)} implies that {@code t1.hashCode()==t2.hashCode()} ! * for any two {@code OpenMBeanAttributeInfo} instances {@code t1} and {@code t2}, * as required by the general contract of the method * {@link Object#hashCode() Object.hashCode()}. * ! * @return the hash code value for this {@code OpenMBeanAttributeInfo} instance */ public int hashCode(); /** ! * Returns a string representation of this {@code OpenMBeanAttributeInfo} instance. * <p> ! * The string representation consists of the name of this class ! * (ie {@code javax.management.openmbean.OpenMBeanAttributeInfo}), * the string representation of the name and open type of the described attribute, * and the string representation of its default, min, max and legal values. * ! * @return a string representation of this {@code OpenMBeanAttributeInfo} instance */ public String toString(); // methods specific to open MBeans are inherited from
< prev index next >