Customization hook: cache the MBeanInfo built for this object.

  Customization hook: cache the MBeanInfo built for this object.

Subclasses may redefine this method in order to implement their own caching policy. The default implementation stores info in this instance. A subclass can define other policies, such as not saving info (so it is reconstructed every time StandardMBean.getMBeanInfo() is called) or sharing a unique MBeanInfo object when several StandardMBean instances have equal MBeanInfo values.
Parameters:
- info - the new MBeanInfo to cache. Any previously cached value is discarded. This parameter may be null, in which case there is no new cached value.

  Customization hook: Return the MBeanInfo cached for this object.

  Customization hook: Return the MBeanInfo cached for this object.

Subclasses may redefine this method in order to implement their own caching policy. The default implementation stores one MBeanInfo object per instance.
Returns: The cached MBeanInfo, or null if no MBeanInfo is cached.
See Also: StandardMBean.cacheMBeanInfo(MBeanInfo),

  Customization hook: Get the className that will be used in the MBeanInfo returned by this MBean.

  Customization hook:
Get the className that will be used in the MBeanInfo returned by
this MBean.


Subclasses may redefine this method in order to supply their
custom class name. The default implementation returns
info.getClassName().
Returns: the class name for the new MBeanInfo.
Parameters:
- info - The default MBeanInfo derived by reflection.

  Customization hook: Get the MBeanConstructorInfo[] that will be used in the MBeanInfo returned by this MBean.

  Customization hook:
Get the MBeanConstructorInfo[] that will be used in the MBeanInfo
returned by this MBean.


By default, this method returns null if the wrapped
implementation is not this. Indeed, if the wrapped
implementation is not this object itself, it will not be possible
to recreate a wrapped implementation by calling the implementation
constructors through MBeanServer.createMBean(...).

Otherwise, if the wrapped implementation is this,
ctors is returned.


Subclasses may redefine this method in order to modify this
behavior, if needed.
Returns: the MBeanConstructorInfo[] for the new MBeanInfo.
Parameters:
- ctors - The default MBeanConstructorInfo[] derived by reflection.
- impl - The wrapped implementation. If null is passed, the wrapped implementation is ignored and ctors is returned.

  Customization hook: Get the description that will be used in the MBeanAttributeInfo returned by this MBean.

  Customization hook: Get the description that will be used in the MBeanAttributeInfo returned by this MBean.

Subclasses may redefine this method in order to supply their custom description. The default implementation returns getDescription((MBeanFeatureInfo) info).
Returns: the description for the given MBeanAttributeInfo.
Parameters:
- info - The default MBeanAttributeInfo derived by reflection.

  Customization hook: Get the description that will be used in the MBeanConstructorInfo returned by this MBean.

  Customization hook:
Get the description that will be used in the MBeanConstructorInfo
returned by this MBean.


Subclasses may redefine this method in order to supply their
custom description.
The default implementation returns getDescription((MBeanFeatureInfo) info).
Returns: the description for the given MBeanConstructorInfo.
Parameters:
- info - The default MBeanConstructorInfo derived by reflection.

  Customization hook: Get the description that will be used for the sequence MBeanParameterInfo of the MBeanConstructorInfo returned by this MBean.

  Customization hook:
Get the description that will be used for the sequence
MBeanParameterInfo of the MBeanConstructorInfo returned by this MBean.


Subclasses may redefine this method in order to supply their
custom description. The default implementation returns
param.getDescription().
Returns: the description for the given MBeanParameterInfo.
Parameters:
- ctor - The default MBeanConstructorInfo derived by reflection.
- param - The default MBeanParameterInfo derived by reflection.
- sequence - The sequence number of the parameter considered ("0" for the first parameter, "1" for the second parameter, etc...).

  Customization hook: Get the description that will be used in the MBeanFeatureInfo returned by this MBean.

 

Customization hook: Get the description that will be used in the MBeanFeatureInfo returned by this MBean.

Subclasses may redefine this method in order to supply their custom description. The default implementation returns info.getDescription().

This method is called by StandardMBean.getDescription(MBeanAttributeInfo), StandardMBean.getDescription(MBeanOperationInfo), StandardMBean.getDescription(MBeanConstructorInfo).

Returns: the description for the given MBeanFeatureInfo.
Parameters:
- info - The default MBeanFeatureInfo derived by reflection.

  Customization hook: Get the description that will be used in the MBeanInfo returned by this MBean.

  Customization hook:
Get the description that will be used in the MBeanInfo returned by
this MBean.


Subclasses may redefine this method in order to supply their
custom MBean description. The default implementation returns
info.getDescription().
Returns: the description for the new MBeanInfo.
Parameters:
- info - The default MBeanInfo derived by reflection.

  Customization hook: Get the description that will be used in the MBeanOperationInfo returned by this MBean.

  Customization hook:
Get the description that will be used in the MBeanOperationInfo
returned by this MBean.


Subclasses may redefine this method in order to supply their
custom description. The default implementation returns
getDescription((MBeanFeatureInfo) info).
Returns: the description for the given MBeanOperationInfo.
Parameters:
- info - The default MBeanOperationInfo derived by reflection.

  Customization hook: Get the description that will be used for the sequence MBeanParameterInfo of the MBeanOperationInfo returned by this MBean.

  Customization hook:
Get the description that will be used for the sequence
MBeanParameterInfo of the MBeanOperationInfo returned by this MBean.


Subclasses may redefine this method in order to supply their
custom description. The default implementation returns
param.getDescription().
Returns: the description for the given MBeanParameterInfo.
Parameters:
- op - The default MBeanOperationInfo derived by reflection.
- param - The default MBeanParameterInfo derived by reflection.
- sequence - The sequence number of the parameter considered ("0" for the first parameter, "1" for the second parameter, etc...).

  Get the Descriptor that will be used in the MBeanInfo returned by this MBean.

 

Get the Descriptor that will be used in the MBeanInfo returned by this MBean.

Subclasses may redefine this method in order to supply their custom descriptor.

The default implementation of this method returns a Descriptor that contains at least the field interfaceClassName, with value StandardMBean.getMBeanInterface().getName(). It may also contain the field immutableInfo, with a value that is the string "true" if the implementation can determine that the MBeanInfo returned by StandardMBean.getMBeanInfo() will always be the same. It may contain other fields: fields defined by the JMX specification must have appropriate values, and other fields must follow the conventions for non-standard field names.

Returns: the Descriptor for the new MBeanInfo.
Parameters:
- info - The default MBeanInfo derived by reflection.

  Customization hook: Get the impact flag of the operation that will be used in the MBeanOperationInfo returned by this MBean.

  Customization hook:
Get the impact flag of the operation that will be used in
the MBeanOperationInfo returned by this MBean.


Subclasses may redefine this method in order to supply their
custom impact flag. The default implementation returns
info.getImpact().
Returns: the impact flag for the given MBeanOperationInfo.
Parameters:
- info - The default MBeanOperationInfo derived by reflection.

  Get the implementation of this Standard MBean (or MXBean).

  Get the implementation of this Standard MBean (or MXBean).
Returns: The implementation of this Standard MBean (or MXBean).
See Also: StandardMBean.setImplementation(java.lang.Object),

  Get the class of the implementation of this Standard MBean (or MXBean).

  Get the class of the implementation of this Standard MBean (or MXBean).
Returns: The class of the implementation of this Standard MBean (or MXBean).

  Get the MBeanInfo for this MBean.

  Get the MBeanInfo for this MBean.

This method implements DynamicMBean.getMBeanInfo().

This method first calls StandardMBean.getCachedMBeanInfo() in order to retrieve the cached MBeanInfo for this MBean, if any. If the MBeanInfo returned by StandardMBean.getCachedMBeanInfo() is not null, then it is returned.
Otherwise, this method builds a default MBeanInfo for this MBean, using the Management Interface specified for this MBean.

While building the MBeanInfo, this method calls the customization hooks that make it possible for subclasses to supply their custom descriptions, parameter names, etc...
Finally, it calls cacheMBeanInfo() in order to cache the new MBeanInfo.
Returns: The cached MBeanInfo for that MBean, if not null, or a newly built MBeanInfo if none was cached.

  Get the Management Interface of this Standard MBean (or MXBean).

  Get the Management Interface of this Standard MBean (or MXBean).
Returns: The management interface of this Standard MBean (or MXBean).

  Customization hook: Get the MBeanNotificationInfo[] that will be used in the MBeanInfo returned by this MBean.

  Customization hook:
Get the MBeanNotificationInfo[] that will be used in the MBeanInfo
returned by this MBean.


Subclasses may redefine this method in order to supply their
custom notifications.
Returns: the MBeanNotificationInfo[] for the new MBeanInfo.
Parameters:
- info - The default MBeanInfo derived by reflection.

  Customization hook: Get the name that will be used for the sequence MBeanParameterInfo of the MBeanConstructorInfo returned by this MBean.

  Customization hook:
Get the name that will be used for the sequence
MBeanParameterInfo of the MBeanConstructorInfo returned by this MBean.


Subclasses may redefine this method in order to supply their
custom parameter name. The default implementation returns
param.getName().
Returns: the name for the given MBeanParameterInfo.
Parameters:
- ctor - The default MBeanConstructorInfo derived by reflection.
- param - The default MBeanParameterInfo derived by reflection.
- sequence - The sequence number of the parameter considered ("0" for the first parameter, "1" for the second parameter, etc...).

  Customization hook: Get the name that will be used for the sequence MBeanParameterInfo of the MBeanOperationInfo returned by this MBean.

  Customization hook:
Get the name that will be used for the sequence
MBeanParameterInfo of the MBeanOperationInfo returned by this MBean.


Subclasses may redefine this method in order to supply their
custom parameter name. The default implementation returns
param.getName().
Returns: the name to use for the given MBeanParameterInfo.
Parameters:
- op - The default MBeanOperationInfo derived by reflection.
- param - The default MBeanParameterInfo derived by reflection.
- sequence - The sequence number of the parameter considered ("0" for the first parameter, "1" for the second parameter, etc...).

  Return true if subclass is known to preserve the immutability of the MBeanInfo.

  Return true if subclass is known to preserve the immutability
of the MBeanInfo. The subclass is considered to have
an immutable MBeanInfo if it does not override any of the
getMBeanInfo, getCachedMBeanInfo, cacheMBeanInfo and getNotificationInfo
methods.

  Allows the MBean to perform any operations needed after having been unregistered in the MBean server.

 

Allows the MBean to perform any operations needed after having been unregistered in the MBean server.

The default implementation of this method does nothing for Standard MBeans. For MXBeans, it removes any information that was recorded by the preRegister method.

It is good practice for a subclass that overrides this method to call the overridden method via super.postRegister(...). This is necessary if this object is an MXBean that is referenced by attributes or operations in other MXBeans.

Since: 1.6

  Allows the MBean to perform any operations needed after having been registered in the MBean server or after the registration has failed.

 

Allows the MBean to perform any operations needed after having been registered in the MBean server or after the registration has failed.

The default implementation of this method does nothing for Standard MBeans. For MXBeans, it undoes any work done by preRegister if registration fails.

It is good practice for a subclass that overrides this method to call the overridden method via super.postRegister(...). This is necessary if this object is an MXBean that is referenced by attributes or operations in other MXBeans.

Parameters:
- registrationDone - Indicates whether or not the MBean has been successfully registered in the MBean server. The value false means that the registration phase has failed.
Since: 1.6

  Allows the MBean to perform any operations it needs before being unregistered by the MBean server.

 

Allows the MBean to perform any operations it needs before being unregistered by the MBean server.

The default implementation of this method does nothing.

It is good practice for a subclass that overrides this method to call the overridden method via super.preDeegister(...).

Throws:
- Exception - no checked exceptions are throw by this method but {@code Exception} is declared so that subclasses can override this method and throw their own exceptions.
Since: 1.6

  Allows the MBean to perform any operations it needs before being registered in the MBean server.

 

Allows the MBean to perform any operations it needs before being registered in the MBean server. If the name of the MBean is not specified, the MBean can provide a name for its registration. If any exception is raised, the MBean will not be registered in the MBean server.

The default implementation of this method returns the name parameter. It does nothing else for Standard MBeans. For MXBeans, it records the MBeanServer and ObjectName parameters so they can be used to translate inter-MXBean references.

It is good practice for a subclass that overrides this method to call the overridden method via super.preRegister(...). This is necessary if this object is an MXBean that is referenced by attributes or operations in other MXBeans.

Returns: The name under which the MBean is to be registered. This value must not be null. If the name parameter is not null, it will usually but not necessarily be the returned value.
Parameters:
- server - The MBean server in which the MBean will be registered.
- name - The object name of the MBean. This name is null if the name parameter to one of the createMBean or registerMBean methods in the {@link MBeanServer} interface is null. In that case, this method must return a non-null ObjectName for the new MBean.
Throws:
- IllegalArgumentException - if this is an MXBean and {@code name} is null.
- InstanceAlreadyExistsException - if this is an MXBean and it has already been registered under another name (in this MBean Server or another).
- Exception - no other checked exceptions are thrown by this method but {@code Exception} is declared so that subclasses can override the method and throw their own exceptions.
Since: 1.6

  Replace the implementation object wrapped in this object.

 

Replace the implementation object wrapped in this object.

Parameters:
- implementation - The new implementation of this Standard MBean (or MXBean). The implementation object must implement the Standard MBean (or MXBean) interface that was supplied when this StandardMBean was constructed.
Throws:
- IllegalArgumentException - if the given implementation is null.
- NotCompliantMBeanException - if the given implementation does not implement the Standard MBean (or MXBean) interface that was supplied at construction.
See Also: StandardMBean.getImplementation(),