org.jolokia.handler

Class ExecHandler

java.lang.Object

org.jolokia.handler.JsonRequestHandler<JmxExecRequest>

org.jolokia.handler.ExecHandler

public class ExecHandler
extends JsonRequestHandler<JmxExecRequest>

Handler for dealing with execute requests.

Since:

Jun 12, 2009

Author:

roland

Constructor Summary

Constructors

Constructor and Description
ExecHandler(Restrictor pRestrictor, Converters pConverters) Constructor

Method Summary

Modifier and Type	Method and Description
protected void	checkForRestriction(JmxExecRequest pRequest) Check whether there is a restriction on the type to apply.
Object	doHandleRequest(MBeanServerConnection server, JmxExecRequest request) Execute an JMX operation.
RequestType	getType() The type of request which can be served by this handler

Methods inherited from class org.jolokia.handler.JsonRequestHandler

checkForModifiedSince, checkType, doHandleRequest, getRestrictor, handleAllServersAtOnce, handleRequest, handleRequest, useReturnValueWithPath

Methods inherited from class java.lang.Object

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

Constructor Detail

ExecHandler

public ExecHandler(Restrictor pRestrictor,
                   Converters pConverters)

Constructor

Parameters:

pRestrictor - restrictor for checking access restrictions

pConverters - converters for serialization

Method Detail

getType

public RequestType getType()

The type of request which can be served by this handler

Specified by:

getType in class JsonRequestHandler<JmxExecRequest>

Returns:

the request typ of this handler

checkForRestriction

protected void checkForRestriction(JmxExecRequest pRequest)

Check whether there is a restriction on the type to apply. This method should be overwritten by specific handlers if they support a more sophisticated check than only for the type

Specified by:

checkForRestriction in class JsonRequestHandler<JmxExecRequest>

Parameters:

pRequest - request to check

doHandleRequest

public Object doHandleRequest(MBeanServerConnection server,
                              JmxExecRequest request)
                       throws InstanceNotFoundException,
                              AttributeNotFoundException,
                              ReflectionException,
                              MBeanException,
                              IOException

Execute an JMX operation. The operation name is taken from the request, as well as the arguments to use. If the operation is given in the format "op(type1,type2,...)" (e.g "getText(java.lang.String,int)" then the argument types are taken into account as well. This way, overloaded JMX operation can be used. If an overloaded JMX operation is called without specifying the argument types, then an exception is raised.

Specified by:

doHandleRequest in class JsonRequestHandler<JmxExecRequest>

Parameters:

server - server to try

request - request to process from where the operation and its arguments are extracted.

Returns:

the return value of the operation call

Throws:

InstanceNotFoundException

AttributeNotFoundException

ReflectionException

MBeanException

IOException