spring-context

org.springframework.jmx.support
Class MBeanServerConnectionFactoryBean

java.lang.Object
  extended by 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
MBeanServerConnectionFactoryBean()
           
 
Method Summary
 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

spring-context