oracle.rc.asadapter.mbean.proxy

Class MBeanProxyFactory

java.lang.Object

oracle.rc.asadapter.mbean.proxy.MBeanProxyFactory

public class MBeanProxyFactory
extends java.lang.Object

A factory for creating MBean proxies that convert javabean interfaces into MBean calls.

The ProxyInfo class provides mapping information between ObjectNames and Interfaces. The underlying connection is obtained from a ConnectionProvider.

Constructor Summary

Constructors

Constructor and Description
MBeanProxyFactory()

Method Summary

Modifier and Type	Method and Description
void	clearCache()
<T> T	findOrCreate(java.lang.Class<T> intf) Returns a proxy object for the specified interface.
java.lang.Object	findOrCreate(javax.management.ObjectName name)
<T> T	findOrCreate(javax.management.ObjectName name, java.lang.Class<T> intf)
ObjectCache	getCache()
javax.management.MBeanServerConnection	getConnection()
static <T> javax.management.ObjectName	getObjectName(T proxy) Find the ObjectName associated with a proxy object.
Session	getSession()
java.lang.Class<? extends java.lang.RuntimeException>	getUndeclaredExceptionClass()
static MBeanProxyFactory	newInstance() Create a new factory.
void	release()
void	setCache(ObjectCache cache)
void	setConnectionProvider(ConnectionProvider<javax.management.MBeanServerConnection> connProvider)
void	setProxyInfo(ProxyInfo proxyInfo)
void	setSession(Session session)
void	setUndeclaredExceptionClass(java.lang.Class<? extends java.lang.RuntimeException> undeclaredExceptionClass) Sets the RuntimeException class to be used as a wrapper when invoking the remote mbean throws an error that is not declared as part of the proxy's method.

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

newInstance

public static MBeanProxyFactory newInstance()

Create a new factory.

The factory should be injected with ProxyInfo and ConnectionProvider before being used.

Returns:

setProxyInfo

public void setProxyInfo(ProxyInfo proxyInfo)

setConnectionProvider

public void setConnectionProvider(ConnectionProvider<javax.management.MBeanServerConnection> connProvider)

getConnection

public javax.management.MBeanServerConnection getConnection()

setCache

public void setCache(ObjectCache cache)

getCache

public ObjectCache getCache()

clearCache

public void clearCache()

setSession

public void setSession(Session session)

getSession

public Session getSession()

setUndeclaredExceptionClass

public void setUndeclaredExceptionClass(java.lang.Class<? extends java.lang.RuntimeException> undeclaredExceptionClass)

Sets the RuntimeException class to be used as a wrapper when invoking the remote mbean throws an error that is not declared as part of the proxy's method.

Parameters:

undeclaredExceptionClass - the wrapper class to use.

Throws:

getUndeclaredExceptionClass

public java.lang.Class<? extends java.lang.RuntimeException> getUndeclaredExceptionClass()

release

public void release()

findOrCreate

public <T> T findOrCreate(java.lang.Class<T> intf)

Returns a proxy object for the specified interface.

Parameters:

intf -

Returns:

Throws:

UnsupportOperationException - if a mapping to an MBean could not be located for that interface.

findOrCreate

public java.lang.Object findOrCreate(javax.management.ObjectName name)

findOrCreate

public <T> T findOrCreate(javax.management.ObjectName name,
                          java.lang.Class<T> intf)

getObjectName

public static <T> javax.management.ObjectName getObjectName(T proxy)
                                                     throws java.lang.IllegalArgumentException

Find the ObjectName associated with a proxy object.

Type Parameters:

T -

Parameters:

proxy -

Returns:

Throws:

java.lang.IllegalArgumentException - if object is not a proxy for an MBean.