APIdia Launch Partner
Top Description Fields Constructors Methods
javax.management

public Class MBeanOperationInfo

extends MBeanFeatureInfo
implements Cloneable
Class Inheritance
All Implemented Interfaces
java.lang.Cloneable
Known Direct Subclasses
javax.management.modelmbean.ModelMBeanOperationInfo, javax.management.openmbean.OpenMBeanOperationInfoSupport
Imports
com.sun.jmx.mbeanserver.Introspector, java.lang.annotation.Annotation, java.lang.reflect.Method, java.util.Arrays, .Objects

Describes a management operation exposed by an MBean. Instances of this class are immutable. Subclasses may be mutable but this is not recommended.
Since
1.5

Field Summary

Modifier and TypeField and Description
public static final int
ACTION

Indicates that the operation is write-like: it has an effect but does not return any information from the MBean.

public static final int
ACTION_INFO

Indicates that the operation is both read-like and write-like: it has an effect, and it also returns information from the MBean.

private final transient boolean
private final int
public static final int
INFO

Indicates that the operation is read-like: it returns information but does not change any state.

pack-priv static final MBeanOperationInfo[]
pack-priv static final long
private final MBeanParameterInfo[]
private final String
public static final int
UNKNOWN

Indicates that the impact of the operation is unknown or cannot be expressed using one of the other values.

Inherited from javax.management.MBeanFeatureInfo:
descriptionname

Constructor Summary

AccessConstructor and Description
public
MBeanOperationInfo(String
A human readable description of the operation.
description
,
Method
The java.lang.reflect.Method object describing the MBean operation.
method
)

Constructs an MBeanOperationInfo object.

public
MBeanOperationInfo(String
The name of the method.
name
,
String
A human readable description of the operation.
description
,
MBeanParameterInfo[]
MBeanParameterInfo objects describing the parameters(arguments) of the method. This may be null with the same effect as a zero-length array.
signature
,
String
The type of the method's return value.
type
,
int
The impact of the method, one of INFO, ACTION, ACTION_INFO, UNKNOWN.
impact
)

Constructs an MBeanOperationInfo object.

public
MBeanOperationInfo(String
The name of the method.
name
,
String
A human readable description of the operation.
description
,
MBeanParameterInfo[]
MBeanParameterInfo objects describing the parameters(arguments) of the method. This may be null with the same effect as a zero-length array.
signature
,
String
The type of the method's return value.
type
,
int
The impact of the method, one of INFO, ACTION, ACTION_INFO, UNKNOWN.
impact
,
Descriptor
The descriptor for the operation. This may be null which is equivalent to an empty descriptor.
descriptor
)

Constructs an MBeanOperationInfo object.

Method Summary

Modifier and TypeMethod and Description
public Object
clone()

Overrides java.lang.Object.clone.

Returns a shallow clone of this instance.

public boolean

Returns:

true if and only if o is an MBeanOperationInfo such that its getName(), getReturnType(), getDescription(), getImpact(), getDescriptor() and getSignature() values are equal (not necessarily identical) to those of this MBeanConstructorInfo. Two signature arrays are equal if their elements are pairwise equal.
equals
(Object
the object to compare to.
o
)

Overrides javax.management.MBeanFeatureInfo.equals.

Compare this MBeanOperationInfo to another.

private MBeanParameterInfo[]
public int

Returns:

the impact code.
getImpact
()

Returns the impact of the method, one of INFO, ACTION, ACTION_INFO, UNKNOWN.

public String

Returns:

the return type.
getReturnType
()

Returns the type of the method's return value.

public MBeanParameterInfo[]

Returns:

An array of MBeanParameterInfo objects.
getSignature
()

Returns the list of parameters for this operation.

public int
hashCode()

Overrides javax.management.MBeanFeatureInfo.hashCode.

Returns a hash code value for this object.

private static MBeanParameterInfo[]
pack-priv static MBeanParameterInfo[]
parameters(Class<?>[] classes, Annotation[][] annots)

public String
toString()

Overrides java.lang.Object.toString.

Returns a string representation of the object.

Inherited from javax.management.MBeanFeatureInfo:
getDescriptiongetDescriptorgetName

Field Detail

ACTIONback to summary
public static final int ACTION

Indicates that the operation is write-like: it has an effect but does not return any information from the MBean.

ACTION_INFOback to summary
public static final int ACTION_INFO

Indicates that the operation is both read-like and write-like: it has an effect, and it also returns information from the MBean.

arrayGettersSafeback to summary
private final transient boolean arrayGettersSafe
See Also
MBeanInfo#arrayGettersSafe
impactback to summary
private final int impact
INFOback to summary
public static final int INFO

Indicates that the operation is read-like: it returns information but does not change any state.

NO_OPERATIONSback to summary
pack-priv static final MBeanOperationInfo[] NO_OPERATIONS
serialVersionUIDback to summary
pack-priv static final long serialVersionUID

Hides javax.management.MBeanFeatureInfo.serialVersionUID.

signatureback to summary
private final MBeanParameterInfo[] signature
typeback to summary
private final String type
UNKNOWNback to summary
public static final int UNKNOWN

Indicates that the impact of the operation is unknown or cannot be expressed using one of the other values.

Constructor Detail

MBeanOperationInfoback to summary
public MBeanOperationInfo(String description, Method method)

Constructs an MBeanOperationInfo object. The Descriptor of the constructed object will include fields contributed by any annotations on the Method object that contain the DescriptorKey meta-annotation.

Parameters
description:String

A human readable description of the operation.

method:Method

The java.lang.reflect.Method object describing the MBean operation.

MBeanOperationInfoback to summary
public MBeanOperationInfo(String name, String description, MBeanParameterInfo[] signature, String type, int impact)

Constructs an MBeanOperationInfo object.

Parameters
name:String

The name of the method.

description:String

A human readable description of the operation.

signature:MBeanParameterInfo[]

MBeanParameterInfo objects describing the parameters(arguments) of the method. This may be null with the same effect as a zero-length array.

type:String

The type of the method's return value.

impact:int

The impact of the method, one of INFO, ACTION, ACTION_INFO, UNKNOWN.

MBeanOperationInfoback to summary
public MBeanOperationInfo(String name, String description, MBeanParameterInfo[] signature, String type, int impact, Descriptor descriptor)

Constructs an MBeanOperationInfo object.

Parameters
name:String

The name of the method.

description:String

A human readable description of the operation.

signature:MBeanParameterInfo[]

MBeanParameterInfo objects describing the parameters(arguments) of the method. This may be null with the same effect as a zero-length array.

type:String

The type of the method's return value.

impact:int

The impact of the method, one of INFO, ACTION, ACTION_INFO, UNKNOWN.

descriptor:Descriptor

The descriptor for the operation. This may be null which is equivalent to an empty descriptor.

Exceptions
IllegalArgumentException:
if impact is not one of ACTION, ACTION_INFO, INFO or UNKNOWN.
Since
1.6

Method Detail

cloneback to summary
public Object clone()

Overrides java.lang.Object.clone.

Returns a shallow clone of this instance. The clone is obtained by simply calling super.clone(), thus calling the default native shallow cloning mechanism implemented by Object.clone(). No deeper cloning of any internal field is made.

Since this class is immutable, cloning is chiefly of interest to subclasses.

Annotations
@Override
equalsback to summary
public boolean equals(Object o)

Overrides javax.management.MBeanFeatureInfo.equals.

Compare this MBeanOperationInfo to another.

Parameters
o:Object

the object to compare to.

Returns:boolean

true if and only if o is an MBeanOperationInfo such that its getName(), getReturnType(), getDescription(), getImpact(), getDescriptor() and getSignature() values are equal (not necessarily identical) to those of this MBeanConstructorInfo. Two signature arrays are equal if their elements are pairwise equal.

Annotations
@Override
fastGetSignatureback to summary
private MBeanParameterInfo[] fastGetSignature()
getImpactback to summary
public int getImpact()

Returns the impact of the method, one of INFO, ACTION, ACTION_INFO, UNKNOWN.

Returns:int

the impact code.

getReturnTypeback to summary
public String getReturnType()

Returns the type of the method's return value.

Returns:String

the return type.

getSignatureback to summary
public MBeanParameterInfo[] getSignature()

Returns the list of parameters for this operation. Each parameter is described by an MBeanParameterInfo object.

The returned array is a shallow copy of the internal array, which means that it is a copy of the internal array of references to the MBeanParameterInfo objects but that each referenced MBeanParameterInfo object is not copied.

Returns:MBeanParameterInfo[]

An array of MBeanParameterInfo objects.

hashCodeback to summary
public int hashCode()

Overrides javax.management.MBeanFeatureInfo.hashCode.

Doc from java.lang.Object.hashCode.

Returns a hash code value for this object. This method is supported for the benefit of hash tables such as those provided by java.util.HashMap.

The general contract of hashCode is:

  • Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
  • If two objects are equal according to the equals method, then calling the hashCode method on each of the two objects must produce the same integer result.
  • It is not required that if two objects are unequal according to the equals method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.
Annotations
@Override
methodSignatureback to summary
private static MBeanParameterInfo[] methodSignature(Method method)
parametersback to summary
pack-priv static MBeanParameterInfo[] parameters(Class<?>[] classes, Annotation[][] annots)
toStringback to summary
public String toString()

Overrides java.lang.Object.toString.

Doc from java.lang.Object.toString.

Returns a string representation of the object. Satisfying this method's contract implies a non-null result must be returned.

Annotations
@Override