toString() result of this instance.
*/
private transient String string;
/**
* Constructs a @link{OpenMBeanOperationInfo} with the specified name,
* description, parameter information, open return type and impact. A
* null value for the parameter information is the same
* as passing in an empty array. A copy of the parameter array is
* taken, so later changes have no effect. The name and the
* description may not be equal to the empty string, and neither
* the name, description nor the open return type may be
* null. The value of impact must be
* one of the four valid values
* ({@link javax.management.MBeanOperationInfo#INFO},
* {@link javax.management.MBeanOperationInfo#ACTION},
* {@link javax.management.MBeanOperationInfo#ACTION_INFO} and
* {@link javax.management.MBeanOperationInfo#UNKNOWN}).
*
*
* @param name the name of the constructor.
* @param desc a description of the attribute.
* @param sig the signature of the method, as a series
* of {@link MBeanParameterInfo} objects, one for
* each parameter.
* @param type the open return type of the method.
* @param impact the impact of performing the operation.
* @throws IllegalArgumentException if the name, description or
* open return type is null,
* the name or description are equal to
* the empty string, or the impact factor
* is not one of the values enumerated
* above.
* @throws ArrayStoreException if the members of the signature array
* are not assignable to
* {@link javax.management.MBeanParameterInfo}
*/
public OpenMBeanOperationInfoSupport(String name, String desc,
OpenMBeanParameterInfo[] sig,
OpenType type, int impact)
{
super(name, desc, (MBeanParameterInfo[]) sig,
type == null ? null : type.getClassName(), impact);
if (name == null)
throw new IllegalArgumentException("The name may not be null.");
if (desc == null)
throw new IllegalArgumentException("The description may not be null.");
if (type == null)
throw new IllegalArgumentException("The type may not be null.");
if (name.length() == 0)
throw new IllegalArgumentException("The name may not be the empty string.");
if (desc.length() == 0)
throw new IllegalArgumentException("The description may not be the " +
"empty string.");
if (impact != ACTION && impact != INFO &&
impact != ACTION_INFO && impact != UNKNOWN)
throw new IllegalArgumentException("The impact factor is an invalid value.");
returnOpenType = type;
}
/**
* Compares this attribute with the supplied object. This returns
* true iff the object is an instance of {@link OpenMBeanOperationInfo}
* with an equal name, signature, open return type and impact.
*
* @param obj the object to compare.
* @return true if the object is a {@link OpenMBeanParameterInfo}
* instance,
* name.equals(object.getName()),
* signature.equals(object.getSignature()),
* returnOpenType.equals(object.getReturnOpenType()),
* and impact == object.getImpact().
*/
public boolean equals(Object obj)
{
if (!(obj instanceof OpenMBeanOperationInfo))
return false;
OpenMBeanOperationInfo o = (OpenMBeanOperationInfo) obj;
return getName().equals(o.getName()) &&
getSignature().equals(o.getSignature()) &&
returnOpenType.equals(o.getReturnOpenType()) &&
getImpact() == o.getImpact();
}
/**
* Returns the open type instance which represents the type of the
* return value.
*
* @return the open type of the return value.
*/
public OpenType getReturnOpenType()
{
return returnOpenType;
}
/**
*
* Returns the hashcode of the operation information as the sum of
* the hashcodes of the name, open return type, impact and signature
* (calculated by
* java.util.Arrays.asList(signature).hashCode()).
*
* As instances of this class are immutable, the return value * is computed just once for each instance and reused * throughout its life. *
* * @return the hashcode of the operation information. */ public int hashCode() { if (hashCode == null) hashCode = Integer.valueOf(getName().hashCode() + returnOpenType.hashCode() + Integer.valueOf(getImpact()).hashCode() + Arrays.asList(getSignature()).hashCode()); return hashCode.intValue(); } /** *
* Returns a textual representation of this instance. This
* is constructed using the class name
* (javax.management.openmbean.OpenMBeanOperationInfo)
* along with the name, signature, open return type and impact.
*
* As instances of this class are immutable, the return value * is computed just once for each instance and reused * throughout its life. *
* * @return a @link{java.lang.String} instance representing * the instance in textual form. */ public String toString() { if (string == null) { String impactString; switch (getImpact()) { case INFO: impactString = "INFO"; break; case ACTION: impactString = "ACTION"; break; case ACTION_INFO: impactString = "ACTION_INFO"; break; case UNKNOWN: impactString = "UNKNOWN"; break; default: impactString = "ERRONEOUS VALUE"; } string = getClass().getName() + "[name=" + getName() + ",signature=" + Arrays.toString(getSignature()) + ",returnOpenType=" + returnOpenType + ",impact=" + impactString + "]"; } return string; } }