org.springframework.jmx.support

Class MBeanServerConnectionFactoryBean

java.lang.Object

org.springframework.jmx.support.MBeanServerConnectionFactoryBean

All Implemented Interfaces:

org.springframework.beans.factory.Aware, org.springframework.beans.factory.BeanClassLoaderAware, org.springframework.beans.factory.DisposableBean, org.springframework.beans.factory.FactoryBean<javax.management.MBeanServerConnection>, org.springframework.beans.factory.InitializingBean

public class MBeanServerConnectionFactoryBean
extends java.lang.Object
implements org.springframework.beans.factory.FactoryBean<javax.management.MBeanServerConnection>, org.springframework.beans.factory.BeanClassLoaderAware, org.springframework.beans.factory.InitializingBean, org.springframework.beans.factory.DisposableBean

FactoryBean that creates a JMX 1.2 MBeanServerConnection to a remote MBeanServer exposed via a JMXServerConnector. Exposes the MBeanServer for bean references.

Since:

1.2

Author:

Rob Harrop, Juergen Hoeller

See Also:

MBeanServerFactoryBean, ConnectorServerFactoryBean, MBeanClientInterceptor.setServer(javax.management.MBeanServerConnection), NotificationListenerRegistrar.setServer(javax.management.MBeanServerConnection)

Constructor Summary

Constructors

Constructor and Description
MBeanServerConnectionFactoryBean()

Method Summary

Methods

Modifier and Type	Method and Description
void	afterPropertiesSet() Creates a JMXConnector for the given settings and exposes the associated MBeanServerConnection.
void	destroy() Closes the underlying JMXConnector.
javax.management.MBeanServerConnection	getObject()
java.lang.Class<? extends javax.management.MBeanServerConnection>	getObjectType()
boolean	isSingleton()
void	setBeanClassLoader(java.lang.ClassLoader classLoader)
void	setConnectOnStartup(boolean connectOnStartup) Set whether to connect to the server on startup.
void	setEnvironment(java.util.Properties environment) Set the environment properties used to construct the JMXConnector as java.util.Properties (String key/value pairs).
void	setEnvironmentMap(java.util.Map<java.lang.String,?> environment) Set the environment properties used to construct the JMXConnector as a Map of String keys and arbitrary Object values.
void	setServiceUrl(java.lang.String url) Set the service URL of the remote MBeanServer.

Methods inherited from class java.lang.Object

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

Constructor Detail

MBeanServerConnectionFactoryBean

public MBeanServerConnectionFactoryBean()

Method Detail

setServiceUrl

public void setServiceUrl(java.lang.String url)
                   throws java.net.MalformedURLException

Set the service URL of the remote MBeanServer.

Throws:

java.net.MalformedURLException

setEnvironment

public void setEnvironment(java.util.Properties environment)

Set the environment properties used to construct the JMXConnector as java.util.Properties (String key/value pairs).

setEnvironmentMap

public void setEnvironmentMap(java.util.Map<java.lang.String,?> environment)

Set the environment properties used to construct the JMXConnector as a Map of String keys and arbitrary Object values.

setConnectOnStartup

public void setConnectOnStartup(boolean connectOnStartup)

Set whether to connect to the server on startup. Default is "true".

Can be turned off to allow for late start of the JMX server. In this case, the JMX connector will be fetched on first access.

setBeanClassLoader

public void setBeanClassLoader(java.lang.ClassLoader classLoader)

Specified by:

setBeanClassLoader in interface org.springframework.beans.factory.BeanClassLoaderAware

afterPropertiesSet

public void afterPropertiesSet()
                        throws java.io.IOException

Creates a JMXConnector for the given settings and exposes the associated MBeanServerConnection.

Specified by:

afterPropertiesSet in interface org.springframework.beans.factory.InitializingBean

Throws:

java.io.IOException

getObject

public javax.management.MBeanServerConnection getObject()

Specified by:

getObject in interface org.springframework.beans.factory.FactoryBean<javax.management.MBeanServerConnection>

getObjectType

public java.lang.Class<? extends javax.management.MBeanServerConnection> getObjectType()

Specified by:

getObjectType in interface org.springframework.beans.factory.FactoryBean<javax.management.MBeanServerConnection>

isSingleton

public boolean isSingleton()

Specified by:

isSingleton in interface org.springframework.beans.factory.FactoryBean<javax.management.MBeanServerConnection>

destroy

public void destroy()
             throws java.io.IOException

Closes the underlying JMXConnector.

Specified by:

destroy in interface org.springframework.beans.factory.DisposableBean

Throws:

java.io.IOException