Package org.jolokia.server.core.service.impl

Class JolokiaServiceManagerImpl

java.lang.Object

org.jolokia.server.core.service.impl.JolokiaServiceManagerImpl

All Implemented Interfaces:

JolokiaServiceManager

public class JolokiaServiceManagerImpl
extends Object
implements JolokiaServiceManager

The service manager for handling all the service organisation stuff.

Since:

28.03.13

Author:

roland

Constructor Summary

Constructors

Constructor	Description
JolokiaServiceManagerImpl(Configuration pConfig, LogHandler pLogHandler, Restrictor pRestrictor, ServerDetectorLookup pDetectorLookup)	Create the implementation of a service manager

Method Summary

Modifier and Type	Method	Description
final void	addService(JolokiaService<?> pService)	Add a single service.
void	addServiceLookup(JolokiaServiceLookup pLookup)	Add a service factory for dynamically looking up services.
void	addServices(JolokiaServiceCreator pServiceCreator)	A JolokiaServiceCreator is responsible for creating one or more service.
AgentDetails	getAgentDetails()	Return the details of this agent
Configuration	getConfiguration()	Get the overall configuration
LogHandler	getLogHandler()	Get the loghandler used for logging
Restrictor	getRestrictor()	Get the restrictor
<T extends JolokiaService<?>> T	getService(Class<T> pType)	Get a single service.
<T extends JolokiaService<?>> SortedSet<T>	getServices(Class<T> pType)	Get all services of a certain type currently registered.
final ObjectName	registerMBean(Object pMBean, String... pOptionalName)	Register a MBean under a certain name to the platform MBeanServer.
JolokiaContext	start()	Start up the service manager.
void	stop()	Stop the service manager and all services by calling their lifecycle methods JolokiaService.destroy() and JolokiaServiceLookup.destroy() on all static and dynamic services.
final void	unregisterMBean(ObjectName pObjectName)	Unregister an MBean which has been registered formerly via the registry

Methods inherited from class java.lang.Object

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

Constructor Details

JolokiaServiceManagerImpl

public JolokiaServiceManagerImpl(Configuration pConfig,
 LogHandler pLogHandler,
 Restrictor pRestrictor,
 ServerDetectorLookup pDetectorLookup)

Create the implementation of a service manager

Parameters:

pConfig - configuration to use

pLogHandler - the logger

pRestrictor - restrictor to apply

pDetectorLookup - additional lookup server detectors when the services start (in addition to the classpath based lookup) These detectors while have a higher precedence than the classpath based lookup. Might be null.

Method Details

getConfiguration

public Configuration getConfiguration()

Get the overall configuration

Returns:

configuration

getLogHandler

public LogHandler getLogHandler()

Get the loghandler used for logging

Returns:

loghandler

getRestrictor

public Restrictor getRestrictor()

Get the restrictor

Returns:

restrictor

addService

public final void addService(JolokiaService<?> pService)

Add a single service. This service is static in so far as it is in use until the end of this service manager

Specified by:

addService in interface JolokiaServiceManager

Parameters:

pService - service to add

addServiceLookup

public void addServiceLookup(JolokiaServiceLookup pLookup)

Add a service factory for dynamically looking up services. This is especially useful when services can come and go dynamically. JolokiaServiceLookup.getServices(Class) will be always called when looking up services within the core.

Specified by:

addServiceLookup in interface JolokiaServiceManager

Parameters:

pLookup - lookup for services to add.

addServices

public void addServices(JolokiaServiceCreator pServiceCreator)

A JolokiaServiceCreator is responsible for creating one or more service. These will be created right during this call and have the same lifecycle as static services added with JolokiaServiceManager.addService(JolokiaService)

Specified by:

addServices in interface JolokiaServiceManager

Parameters:

pServiceCreator - creator for creating the service

start

public JolokiaContext start()

Start up the service manager. All static services are initialized via its lifecycle method JolokiaService.init(JolokiaContext). For dynamic services, the lookup service obtains a handle to the created JolokiaContext via JolokiaServiceLookup.init(JolokiaContext). This method is omnipotent as it can be called multiple in sequence returning always the same JolokiaContext.

Specified by:

start in interface JolokiaServiceManager

Returns:

the created jolokia context which can be used directly

stop

public void stop()

Stop the service manager and all services by calling their lifecycle methods JolokiaService.destroy() and JolokiaServiceLookup.destroy() on all static and dynamic services. The Jolokia context returned on start is not valid anymore.

Specified by:

stop in interface JolokiaServiceManager

getServices

public <T extends JolokiaService<?>> SortedSet<T> getServices(Class<T> pType)

Get all services of a certain type currently registered. Static services are returned directly, for dynamic services a lookup to the service factory is performed.

Parameters:

pType - service type to fetch

Returns:

set of services detected or an empty list

getService

public <T extends JolokiaService<?>> T getService(Class<T> pType)

Get a single service. If more than one service of the given type has been registered, return the one with the highest order. If no one has been registered return null

Parameters:

pType - requested service type

Returns:

the requested service or null if none has been registered

getAgentDetails

public AgentDetails getAgentDetails()

Return the details of this agent

Returns:

the nifty details

registerMBean

public final ObjectName registerMBean(Object pMBean,
 String... pOptionalName)
                               throws MalformedObjectNameException,
NotCompliantMBeanException,
InstanceAlreadyExistsException,
MBeanRegistrationException

Register a MBean under a certain name to the platform MBeanServer. This method delegates to the MBeanRegistry.

Parameters:

pMBean - MBean to register

pOptionalName - optional name under which the bean should be registered. If not provided, it depends on whether the MBean to register implements MBeanRegistration or not.

Returns:

the name under which the MBean is registered.

Throws:

MalformedObjectNameException

NotCompliantMBeanException

InstanceAlreadyExistsException

MBeanRegistrationException

unregisterMBean

public final void unregisterMBean(ObjectName pObjectName)
                           throws MBeanRegistrationException

Unregister an MBean which has been registered formerly via the registry

Parameters:

pObjectName - MBean to unregister

Throws:

MBeanRegistrationException