org.josef.util.appserver

Class JmxUtil

java.lang.Object

org.josef.util.appserver.JmxUtil

@Status(stage=PRODUCTION,
        unitTests=ABSENT)
 @Review(by="Kees Schotanus",
        at="2009-09-28")
public final class JmxUtil
extends Object

Utility class for JMX.
Currently this class aids in invoking operations on an MBean.

Version:

1.0 $Revision: 5855 $

Author:

Kees Schotanus

Method Summary

Modifier and Type	Method and Description
static String	createErrorMessage(MBeanServerConnection connection, ObjectName object, String operation, Object[] parameters, String[] signature) Creates an error message, explaining why the supplied operation could not be executed.
static Object	invoke(MBeanServerConnection connection, ObjectName object, String operation, Object[] parameters, String[] signature) Invokes the supplied operation against the supplied object with the supplied parameters.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

invoke

public static Object invoke(MBeanServerConnection connection,
                            ObjectName object,
                            String operation,
                            Object[] parameters,
                            String[] signature)
                     throws MBeanException

Invokes the supplied operation against the supplied object with the supplied parameters.

Parameters:

connection - The MBeanServerConnection.

object - The object on which to invoke the supplied operation.

operation - The operation to invoke.

parameters - The parameters the supplied operation accepts.

signature - The signature of the supplied parameters.

Returns:

The object returned as the result of executing the invoke method.

Throws:

MBeanException - When an error occurs during the invocation of the supplied operation against the supplied object.

NullPointerException - When of the supplied parameters is null.

IllegalArgumentException - When the supplied operation is empty or when the supplied parameters and signature contain a different number of elements.

createErrorMessage

public static String createErrorMessage(MBeanServerConnection connection,
                                        ObjectName object,
                                        String operation,
                                        Object[] parameters,
                                        String[] signature)

Creates an error message, explaining why the supplied operation could not be executed.

Parameters:

connection - The MBeanServerConnection.

object - The object on which to invoke the supplied operation.

operation - The operation to invoke.

parameters - The parameters the supplied operation accepts.

signature - The signature of the supplied parameters.

Returns:

An error message, explaining why the supplied operation could not be executed.