org.jolokia.handler

Class VersionHandler

java.lang.Object

org.jolokia.handler.JsonRequestHandler<JmxVersionRequest>

org.jolokia.handler.VersionHandler

public class VersionHandler
extends JsonRequestHandler<JmxVersionRequest>

Get the version of this agent as well as the protocol version

Since:

Jun 12, 2009

Author:

roland

Constructor Summary

Constructors

Constructor and Description
VersionHandler(Configuration pConfig, Restrictor pRestrictor, ServerHandle pServerHandle) Constructor

Method Summary

Modifier and Type	Method and Description
protected void	checkForRestriction(JmxVersionRequest pRequest) Check whether there is a restriction on the type to apply.
Object	doHandleRequest(MBeanServerConnection server, JmxVersionRequest request) Abstract method to be subclassed by a concrete handler for performing the request.
Object	doHandleRequest(MBeanServerExecutor serverManager, JmxVersionRequest request) Default implementation fo handling a request for multiple servers at once.
RequestType	getType() The type of request which can be served by this handler
boolean	handleAllServersAtOnce(JmxVersionRequest pRequest) Override this if you want all servers as list in the argument, e.g.

Methods inherited from class org.jolokia.handler.JsonRequestHandler

checkForModifiedSince, checkType, getRestrictor, handleRequest, handleRequest, useReturnValueWithPath

Methods inherited from class java.lang.Object

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

Constructor Detail

VersionHandler

public VersionHandler(Configuration pConfig,
                      Restrictor pRestrictor,
                      ServerHandle pServerHandle)

Constructor

Parameters:

pConfig - configuration holding additional meta data. Might be null.

pRestrictor - access restrictions

pServerHandle - a server handle as obtained from a ServerDetector

Method Detail

getType

public RequestType getType()

The type of request which can be served by this handler

Specified by:

getType in class JsonRequestHandler<JmxVersionRequest>

Returns:

the request typ of this handler

checkForRestriction

protected void checkForRestriction(JmxVersionRequest 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<JmxVersionRequest>

Parameters:

pRequest - request to check

handleAllServersAtOnce

public boolean handleAllServersAtOnce(JmxVersionRequest pRequest)

Override this if you want all servers as list in the argument, e.g. to query each server on your own. By default, dispatching of the servers are done for you

Overrides:

handleAllServersAtOnce in class JsonRequestHandler<JmxVersionRequest>

Parameters:

pRequest - request to decide on whether to handle all request at once

Returns:

whether you want to have JsonRequestHandler.doHandleRequest(MBeanServerConnection, JmxRequest) (false) or JsonRequestHandler.doHandleRequest(MBeanServerExecutor, JmxRequest) (true) called.

doHandleRequest

public Object doHandleRequest(MBeanServerExecutor serverManager,
                              JmxVersionRequest request)
                       throws InstanceNotFoundException,
                              AttributeNotFoundException,
                              ReflectionException,
                              MBeanException,
                              IOException

Default implementation fo handling a request for multiple servers at once. A subclass, which returns, true on JsonRequestHandler.handleAllServersAtOnce(JmxRequest), needs to override this method.

Overrides:

doHandleRequest in class JsonRequestHandler<JmxVersionRequest>

Parameters:

serverManager -

request -

Returns:

the result of the the request.

Throws:

InstanceNotFoundException

AttributeNotFoundException

ReflectionException

MBeanException

IOException

doHandleRequest

public Object doHandleRequest(MBeanServerConnection server,
                              JmxVersionRequest request)

Abstract method to be subclassed by a concrete handler for performing the request.

Specified by:

doHandleRequest in class JsonRequestHandler<JmxVersionRequest>

Parameters:

server - server to try

request - request to process

Returns:

the object result from the request