1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122
/* * @(#)OpenMBeanConstructorInfo.java 3.20 05/11/17 * * Copyright 2006 Sun Microsystems, Inc. All rights reserved. * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms. */ package javax.management.openmbean; // java import // // jmx import // import javax.management.MBeanParameterInfo; /** * <p>Describes a constructor of an Open MBean.</p> * * <p>This interface declares the same methods as the class {@link * javax.management.MBeanConstructorInfo}. A class implementing this * interface (typically {@link OpenMBeanConstructorInfoSupport}) * should extend {@link javax.management.MBeanConstructorInfo}.</p> * * <p>The {@link #getSignature()} method should return at runtime an * array of instances of a subclass of {@link MBeanParameterInfo} * which implements the {@link OpenMBeanParameterInfo} interface * (typically {@link OpenMBeanParameterInfoSupport}).</p> * * * @version 3.20 05/11/17 * @author Sun Microsystems, Inc. * * @since 1.5 * @since.unbundled JMX 1.1 */ public interface OpenMBeanConstructorInfo { // Re-declares the methods that are in class MBeanConstructorInfo of JMX 1.0 // (methods will be removed when MBeanConstructorInfo is made a parent interface of this interface) /** * Returns a human readable description of the constructor * described by this <tt>OpenMBeanConstructorInfo</tt> instance. * * @return the description. */ public String getDescription() ; /** * Returns the name of the constructor * described by this <tt>OpenMBeanConstructorInfo</tt> instance. * * @return the name. */ public String getName() ; /** * Returns an array of <tt>OpenMBeanParameterInfo</tt> instances * describing each parameter in the signature of the constructor * described by this <tt>OpenMBeanConstructorInfo</tt> instance. * * @return the signature. */ public MBeanParameterInfo[] getSignature() ; // commodity methods // /** * Compares the specified <var>obj</var> parameter with this <code>OpenMBeanConstructorInfo</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>OpenMBeanConstructorInfo</code> interface,</li> * <li>their names are equal</li> * <li>their signatures 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>OpenMBeanConstructorInfo</code> interface. * <br> * @param obj the object to be compared for equality with this <code>OpenMBeanConstructorInfo</code> instance; * * @return <code>true</code> if the specified object is equal to this <code>OpenMBeanConstructorInfo</code> instance. */ public boolean equals(Object obj); /** * Returns the hash code value for this <code>OpenMBeanConstructorInfo</code> instance. * <p> * The hash code of an <code>OpenMBeanConstructorInfo</code> instance is the sum of the hash codes * of all elements of information used in <code>equals</code> comparisons * (ie: its name and signature, where the signature hashCode is calculated by a call to * <tt>java.util.Arrays.asList(this.getSignature).hashCode()</tt>). * <p> * This ensures that <code> t1.equals(t2) </code> implies that <code> t1.hashCode()==t2.hashCode() </code> * for any two <code>OpenMBeanConstructorInfo</code> instances <code>t1</code> and <code>t2</code>, * as required by the general contract of the method * {@link Object#hashCode() Object.hashCode()}. * <p> * * @return the hash code value for this <code>OpenMBeanConstructorInfo</code> instance */ public int hashCode(); /** * Returns a string representation of this <code>OpenMBeanConstructorInfo</code> instance. * <p> * The string representation consists of the name of this class (ie <code>javax.management.openmbean.OpenMBeanConstructorInfo</code>), * and the name and signature of the described constructor. * * @return a string representation of this <code>OpenMBeanConstructorInfo</code> instance */ public String toString(); }