OpenMBeanOperationInfoSupportpublic class OpenMBeanOperationInfoSupport extends MBeanOperationInfo implements OpenMBeanOperationInfoDescribes an operation of an Open MBean. |
Fields Summary |
---|
static final long | serialVersionUID | private OpenType | returnOpenType | private transient Integer | myHashCode | private transient String | myToString |
Constructors Summary |
---|
public OpenMBeanOperationInfoSupport(String name, String description, OpenMBeanParameterInfo[] signature, OpenType returnOpenType, int impact)Constructs an {@code OpenMBeanOperationInfoSupport}
instance, which describes the operation of a class of open
MBeans, with the specified {@code name}, {@code description},
{@code signature}, {@code returnOpenType} and {@code
impact}.
The {@code signature} array parameter is internally copied,
so that subsequent changes to the array referenced by {@code
signature} have no effect on this instance.
this(name, description, signature, returnOpenType, impact,
(Descriptor) null);
| public OpenMBeanOperationInfoSupport(String name, String description, OpenMBeanParameterInfo[] signature, OpenType returnOpenType, int impact, Descriptor descriptor)Constructs an {@code OpenMBeanOperationInfoSupport}
instance, which describes the operation of a class of open
MBeans, with the specified {@code name}, {@code description},
{@code signature}, {@code returnOpenType}, {@code
impact}, and {@code descriptor}.
The {@code signature} array parameter is internally copied,
so that subsequent changes to the array referenced by {@code
signature} have no effect on this instance.
super(name,
description,
arrayCopyCast(signature),
// must prevent NPE here - we will throw IAE later on if
// returnOpenType is null
(returnOpenType == null) ? null : returnOpenType.getClassName(),
impact,
ImmutableDescriptor.union(descriptor,
// must prevent NPE here - we will throw IAE later on if
// returnOpenType is null
(returnOpenType==null) ? null :returnOpenType.getDescriptor()));
// check parameters that should not be null or empty
// (unfortunately it is not done in superclass :-( ! )
//
if (name == null || name.trim().equals("")) {
throw new IllegalArgumentException("Argument name cannot " +
"be null or empty");
}
if (description == null || description.trim().equals("")) {
throw new IllegalArgumentException("Argument description cannot " +
"be null or empty");
}
if (returnOpenType == null) {
throw new IllegalArgumentException("Argument returnOpenType " +
"cannot be null");
}
if (impact != ACTION && impact != ACTION_INFO && impact != INFO &&
impact != UNKNOWN) {
throw new IllegalArgumentException("Argument impact can only be " +
"one of ACTION, ACTION_INFO, " +
"INFO, or UNKNOWN: " + impact);
}
this.returnOpenType = returnOpenType;
|
Methods Summary |
---|
private static javax.management.MBeanParameterInfo[] | arrayCopyCast(javax.management.openmbean.OpenMBeanParameterInfo[] src)
if (src == null)
return null;
MBeanParameterInfo[] dst = new MBeanParameterInfo[src.length];
System.arraycopy(src, 0, dst, 0, src.length);
// may throw an ArrayStoreException
return dst;
| private static javax.management.openmbean.OpenMBeanParameterInfo[] | arrayCopyCast(javax.management.MBeanParameterInfo[] src)
if (src == null)
return null;
OpenMBeanParameterInfo[] dst = new OpenMBeanParameterInfo[src.length];
System.arraycopy(src, 0, dst, 0, src.length);
// may throw an ArrayStoreException
return dst;
| public boolean | equals(java.lang.Object obj)Compares the specified {@code obj} parameter with this
{@code OpenMBeanOperationInfoSupport} instance for
equality.
Returns {@code true} if and only if all of the following
statements are true:
- {@code obj} is non null,
- {@code obj} also implements the {@code
OpenMBeanOperationInfo} interface,
- their names are equal
- their signatures are equal
- their return open types are equal
- their impacts are equal
This ensures that this {@code equals} method works properly for
{@code obj} parameters which are different implementations of
the {@code OpenMBeanOperationInfo} interface.
// if obj is null, return false
//
if (obj == null) {
return false;
}
// if obj is not a OpenMBeanOperationInfo, return false
//
OpenMBeanOperationInfo other;
try {
other = (OpenMBeanOperationInfo) obj;
} catch (ClassCastException e) {
return false;
}
// Now, really test for equality between this
// OpenMBeanOperationInfo implementation and the other:
//
// their Name should be equal
if ( ! this.getName().equals(other.getName()) ) {
return false;
}
// their Signatures should be equal
if ( ! Arrays.equals(this.getSignature(), other.getSignature()) ) {
return false;
}
// their return open types should be equal
if ( ! this.getReturnOpenType().equals(other.getReturnOpenType()) ) {
return false;
}
// their impacts should be equal
if ( this.getImpact() != other.getImpact() ) {
return false;
}
// All tests for equality were successfull
//
return true;
| public javax.management.openmbean.OpenType | getReturnOpenType()Returns the open type of the values returned by the
operation described by this {@code OpenMBeanOperationInfo}
instance.
return returnOpenType;
| public int | hashCode()Returns the hash code value for this {@code
OpenMBeanOperationInfoSupport} instance.
The hash code of an {@code OpenMBeanOperationInfoSupport}
instance is the sum of the hash codes of all elements of
information used in {@code equals} comparisons (ie: its name,
return open type, impact and signature, where the signature
hashCode is calculated by a call to {@code
java.util.Arrays.asList(this.getSignature).hashCode()}).
This ensures that {@code t1.equals(t2) } implies that {@code
t1.hashCode()==t2.hashCode() } for any two {@code
OpenMBeanOperationInfoSupport} instances {@code t1} and {@code
t2}, as required by the general contract of the method {@link
Object#hashCode() Object.hashCode()}.
However, note that another instance of a class implementing
the {@code OpenMBeanOperationInfo} interface may be equal to
this {@code OpenMBeanOperationInfoSupport} instance as defined
by {@link #equals(java.lang.Object)}, but may have a different
hash code if it is calculated differently.
As {@code OpenMBeanOperationInfoSupport} instances are
immutable, the hash code for this instance is calculated once,
on the first call to {@code hashCode}, and then the same value
is returned for subsequent calls.
// Calculate the hash code value if it has not yet been done
// (ie 1st call to hashCode())
//
if (myHashCode == null) {
int value = 0;
value += this.getName().hashCode();
value += Arrays.asList(this.getSignature()).hashCode();
value += this.getReturnOpenType().hashCode();
value += this.getImpact();
myHashCode = new Integer(value);
}
// return always the same hash code for this instance (immutable)
//
return myHashCode.intValue();
| private java.lang.Object | readResolve()An object serialized in a version of the API before Descriptors were
added to this class will have an empty or null Descriptor.
For consistency with our
behavior in this version, we must replace the object with one
where the Descriptors reflect the same value of returned openType.
if (getDescriptor().getFieldNames().length == 0) {
// This constructor will construct the expected default Descriptor.
//
return new OpenMBeanOperationInfoSupport(
name, description, arrayCopyCast(getSignature()),
returnOpenType, getImpact());
} else
return this;
| public java.lang.String | toString()Returns a string representation of this {@code
OpenMBeanOperationInfoSupport} instance.
The string representation consists of the name of this class
(ie {@code
javax.management.openmbean.OpenMBeanOperationInfoSupport}), and
the name, signature, return open type and impact of the
described operation and the string representation of its descriptor.
As {@code OpenMBeanOperationInfoSupport} instances are
immutable, the string representation for this instance is
calculated once, on the first call to {@code toString}, and
then the same value is returned for subsequent calls.
// Calculate the hash code value if it has not yet been done
// (ie 1st call to toString())
//
if (myToString == null) {
myToString = new StringBuffer()
.append(this.getClass().getName())
.append("(name=")
.append(this.getName())
.append(",signature=")
.append(Arrays.asList(this.getSignature()).toString())
.append(",return=")
.append(this.getReturnOpenType().toString())
.append(",impact=")
.append(this.getImpact())
.append(",descriptor=")
.append(this.getDescriptor())
.append(")")
.toString();
}
// return always the same string representation for this
// instance (immutable)
//
return myToString;
|
|