org.apache.commons.modeler
Class JndiJmx
java.lang.Object
|
+--org.apache.commons.modeler.BaseModelMBean
|
+--org.apache.commons.modeler.JndiJmx
- public class JndiJmx
- extends BaseModelMBean
Link between JNDI and JMX. JNDI can be used for persistence ( it is
an API for storing hierarchical data and a perfect fit for that ), as
well as an alternate view of the MBean registry.
If this component is enabled, all MBeans will be registered in JNDI, and
all attributes that are set via JMX can be stored in a DirContext.
This acts as a "recorder" for creation of mbeans and attribute changes
done via JMX.
XXX How can we control ( filter ) which mbeans will be registere ? Or
attributes ?
XXX How can we get the beans and attributes loaded before jndijmx ?
The intended use:
- do whatever you want to start the application
- load JndiJmx as an mbean
- make changes via JMX. All changes are recorded
- you can use JndiJmx to save the changes in a Jndi context.
- you can use JndiJmx to load changes from a JndiContext and replay them.
The main benefit is that only changed attributes are saved, and the Jndi
layer can preserve most of the original structure of the config file. The
alternative is to override the config files with config info extracted
from the live objects - but it's very hard to save only what was actually
changed and preserve structure and comments.
- Author:
- Costin Manolache
Constructor Summary |
JndiJmx()
Protected constructor to require use of the factory create method. |
Method Summary |
java.lang.String |
dumpStatus()
|
void |
handleNotification(Notification notification,
java.lang.Object handback)
|
void |
init()
|
void |
replay()
|
void |
setComponentContext(javax.naming.Context ctx)
If a JNDI context is set, all components
will be registered in the context. |
void |
setConfigContext(javax.naming.Context ctx)
JNDI context where attributes will be stored for persistence |
void |
setDescriptorContext(javax.naming.Context ctx)
JNDI context for component descriptors ( metadata ). |
Methods inherited from class org.apache.commons.modeler.BaseModelMBean |
addAttributeChangeNotificationListener, addNotificationListener, createDefaultModelMBeanInfo, createResource, getAttribute, getAttributes, getClassName, getManagedResource, getMBeanInfo, getModelerType, getNotificationInfo, getObjectName, getRegistry, initModelInfo, invoke, isModelMBeanInfoValid, load, postDeregister, postRegister, preDeregister, preRegister, removeAttributeChangeNotificationListener, removeAttributeChangeNotificationListener, removeNotificationListener, removeNotificationListener, removeNotificationListener, sendAttributeChangeNotification, sendAttributeChangeNotification, sendNotification, setAttribute, setAttributes, setManagedResource, setModeledType, setModelMBeanInfo, setRegistry, store, toString |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
log
private static Log log
componentContext
protected javax.naming.Context componentContext
descriptorContext
protected javax.naming.Context descriptorContext
configContext
protected javax.naming.Context configContext
mserver
MBeanServer mserver
attributes
java.util.Hashtable attributes
instances
java.util.Hashtable instances
JndiJmx
public JndiJmx()
throws MBeanException
- Protected constructor to require use of the factory create method.
setComponentContext
public void setComponentContext(javax.naming.Context ctx)
- If a JNDI context is set, all components
will be registered in the context.
- Parameters:
ctx
-
setDescriptorContext
public void setDescriptorContext(javax.naming.Context ctx)
- JNDI context for component descriptors ( metadata ).
- Parameters:
ctx
-
setConfigContext
public void setConfigContext(javax.naming.Context ctx)
- JNDI context where attributes will be stored for persistence
handleNotification
public void handleNotification(Notification notification,
java.lang.Object handback)
dumpStatus
public java.lang.String dumpStatus()
throws java.lang.Exception
java.lang.Exception
replay
public void replay()
throws java.lang.Exception
java.lang.Exception
init
public void init()
throws java.lang.Exception
java.lang.Exception
Copyright (c) 2001-2003 - Apache Software Foundation