org.backsource.jmx
Class MBeanProxyFactory

java.lang.Object
  org.backsource.jmx.MBeanProxyFactory

public class MBeanProxyFactory

extends java.lang.Object

A factory for creating and binding MBean proxies.

This factory will create and bind MBean proxies. These have three capabilities:

• It makes an MBean types through an interface. The proxy will use the normal JMX invokation style under the hood, but to the caller it is as if invoking a normal object.
• It will bind the proxy in JNDI where it is possible to lookup both locally and remotely. When used locally the invokation will goto directly against the local mbean server, whith one exception - see below, when looked up from a remote JVM (or through a JNDI with remote semantics) the mbean server will be invoked over RMI.
• When configured with jndiURL, the proxy is actually a proxy to another remote MBean server. In that case the invokation will go to the other remote MBean server. Normally one should probably bind these types of proxied in the java: naming domain, since they are reallt meant to be used only locally!

To be able to guarantee this semantics the rebinds and unbind methods int this class must be used to bind the proxied into JNDI.

Version:

$Revision: 1.2 $

Author:

Peter Antman

Constructor Summary

MBeanProxyFactory()


Method Summary

static java.lang.Object	create(java.lang.Class intf, java.lang.String name) Create an MBean proxy.
static java.lang.Object	create(java.lang.Class intf, java.lang.String name, java.lang.String jndiURL) Create an MBean proxy.
static java.lang.Object	create(java.lang.String intfName, java.lang.String name) Create an MBean proxy.
static java.lang.Object	create(java.lang.String intfName, java.lang.String name, java.lang.String jndiURL) Create an MBean proxy.
static void	rebind(java.lang.String jndiName, java.lang.Object o) Helper to bind object at the given jndiName, any missing parent name will be created.
static void	unbind(java.lang.String jndiName) An object bound through the rebind method whould use this method when unbinding!

Methods inherited from class java.lang.Object

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

Constructor Detail

MBeanProxyFactory

public MBeanProxyFactory()

Method Detail

create

public static java.lang.Object create(java.lang.Class intf,
                                      java.lang.String name)
                               throws javax.management.OperationsException,
                                      javax.naming.NamingException

Create an MBean proxy.

Parameters:

intf - class of interface to cover for.

name - ObjectName of MBean to invoke.

Throws:

javax.management.OperationsException

javax.naming.NamingException

create

public static java.lang.Object create(java.lang.Class intf,
                                      java.lang.String name,
                                      java.lang.String jndiURL)
                               throws javax.management.OperationsException,
                                      javax.naming.NamingException

Create an MBean proxy.

Parameters:

intf - class of interface to cover for.

name - ObjectName of MBean to invoke.

jndiURL - a java.naming.provider.url pointing to another JNDI space, which holds an MBean server to invoke, if null the local server is used.

Throws:

javax.management.OperationsException

javax.naming.NamingException

create

public static java.lang.Object create(java.lang.String intfName,
                                      java.lang.String name,
                                      java.lang.String jndiURL)
                               throws javax.management.OperationsException,
                                      java.lang.ClassNotFoundException,
                                      javax.naming.NamingException

Create an MBean proxy.

Parameters:

name - ObjectName of MBean to invoke.

jndiURL - a java.naming.provider.url pointing to another JNDI space, which holds an MBean server to invoke, if null the local server is used.

Throws:

javax.management.OperationsException

java.lang.ClassNotFoundException

javax.naming.NamingException

create

public static java.lang.Object create(java.lang.String intfName,
                                      java.lang.String name)
                               throws javax.management.OperationsException,
                                      java.lang.ClassNotFoundException,
                                      javax.naming.NamingException

Create an MBean proxy.

Parameters:

name - ObjectName of MBean to invoke.

Throws:

javax.management.OperationsException

java.lang.ClassNotFoundException

javax.naming.NamingException

rebind

public static void rebind(java.lang.String jndiName,
                          java.lang.Object o)
                   throws javax.naming.NamingException

Helper to bind object at the given jndiName, any missing parent name will be created.

by using the method, users will be failsafe if JBoss changes is JNDI semantics. JBoss currently does not serialize object when running in the same vm,see org.jnp.interfaces.NamingContext.rebind and lookup and the usage of MarshalledValuePair. This may ofcource change

Throws:

javax.naming.NamingException

unbind

public static void unbind(java.lang.String jndiName)
                   throws javax.naming.NamingException

An object bound through the rebind method whould use this method when unbinding!

Throws:

javax.naming.NamingException