org.jolokia.backend

Class MBeanServerExecutorLocal

java.lang.Object

org.jolokia.backend.executor.AbstractMBeanServerExecutor

org.jolokia.backend.MBeanServerExecutorLocal

All Implemented Interfaces:

EventListener, NotificationListener, MBeanServerExecutor

public class MBeanServerExecutorLocal
extends AbstractMBeanServerExecutor
implements NotificationListener

Singleton responsible for doing the merging of all MBeanServer detected. It provides a single entry point for all supported JMX operations and has the facility to detect MBeanServers by delegating the lookup to various ServerDetectors, to MBeanServerFactory.findMBeanServer(String) and finally to the PlatformMBeanServer It also has a special treatment for the so called "JolokiaMBeanServer" which is always hidden from JSR-160 and provides some extra functionality like JSONMBeans.

Since:

17.01.13

Author:

roland

Nested Class Summary

Nested classes/interfaces inherited from interface org.jolokia.backend.executor.MBeanServerExecutor

MBeanServerExecutor.MBeanAction<R>, MBeanServerExecutor.MBeanEachCallback

Constructor Summary

Constructors

Constructor and Description
MBeanServerExecutorLocal() Constructor with no detectors
MBeanServerExecutorLocal(List<ServerDetector> pDetectors) Constructor with a given list of destectors

Method Summary

Methods

Modifier and Type	Method and Description
void	destroy() Lifecycle method called at the end of life for this object.
protected MBeanServerConnection	getJolokiaMBeanServer() Override this method if you want to provide a Jolokia private MBeanServer.
protected Set<MBeanServerConnection>	getMBeanServers() Get all MBeanServers
String	getServersInfo() Get a string representation of all servers
<R extends JmxRequest> Object	handleRequest(JsonRequestHandler<R> pRequestHandler, R pJmxReq) Handle a single request

Methods inherited from class org.jolokia.backend.executor.AbstractMBeanServerExecutor

call, each, handleNotification, hasMBeansListChangedSince, queryNames, registerForMBeanNotifications

Methods inherited from class java.lang.Object

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

Methods inherited from interface javax.management.NotificationListener

handleNotification

Constructor Detail

MBeanServerExecutorLocal

public MBeanServerExecutorLocal(List<ServerDetector> pDetectors)

Constructor with a given list of destectors

Parameters:

pDetectors - list of detectors for the MBeanServers. Must not be null.

MBeanServerExecutorLocal

public MBeanServerExecutorLocal()

Constructor with no detectors

Method Detail

handleRequest

public <R extends JmxRequest> Object handleRequest(JsonRequestHandler<R> pRequestHandler,
                                          R pJmxReq)
                     throws MBeanException,
                            ReflectionException,
                            AttributeNotFoundException,
                            InstanceNotFoundException,
                            NotChangedException

Handle a single request

Parameters:

pRequestHandler - the handler which can deal with this request

pJmxReq - the request to execute

Returns:

the return value

Throws:

MBeanException

ReflectionException

AttributeNotFoundException

InstanceNotFoundException

NotChangedException

destroy

public void destroy()

Lifecycle method called at the end of life for this object.

Specified by:

destroy in interface MBeanServerExecutor

Overrides:

destroy in class AbstractMBeanServerExecutor

getServersInfo

public String getServersInfo()

Get a string representation of all servers

Returns:

string representation of the servers along with some statistics.

getMBeanServers

protected Set<MBeanServerConnection> getMBeanServers()

Get all MBeanServers

Specified by:

getMBeanServers in class AbstractMBeanServerExecutor

Returns:

all MBeanServers in the merge order

getJolokiaMBeanServer

protected MBeanServerConnection getJolokiaMBeanServer()

Override this method if you want to provide a Jolokia private MBeanServer. Note, that this method should only return a non-null value, if the Jolokia private MBean Server has some MBeans registered

Overrides:

getJolokiaMBeanServer in class AbstractMBeanServerExecutor

Returns:

the Jolokia MBeanServer