Returns a proxy for a
MXBean, using the specified
connection to access the named implementation.
To create a proxy for the bean,
SomethingMXBean, a call to
JMX.newMXBeanProxy(server, name, SomethingMXBean.class)
is made, where
server is a local or remote management
server, and
name is the registered
ObjectName
of the implementation of
SomethingMBean to use.
The proxy redirects calls to the methods of the interface,
SomethingMXBean, to the appropriate methods of the
management server with appropriate conversion between
Java and open types, according to the MXBean rules. If
SomethingMXBean is specified as follows:
public interface SomethingMXBean
{
String getName();
void setName(String name);
List getStatistics();
void setStatistics(List statistics);
List getNamedStatistics(String, Map);
}
The proxy created above will provide these five methods
using an instance of
MBeanServerInvocationHandler.
The two methods,
getName and
setName define
an attribute,
Name, so a call to
getName()
will return the value of
server.getAttribute(name,
"Name"), while
setName(newName) will result in a
call to
server.setAttribute(name, new Attribute("Name",
newName)). As this uses a simple type,
String, no
conversion is necessary.
The two methods,
getStatistics and
setStatistics
similarly define another attribute,
Statistics. Calling
getStatistics() will cause a call to the server to be
made as before,
server.getAttribute(name, "Statistics").
However, the type of the return value from this call will be
an array of
Double objects, as per the
MXBean
rules. The proxy converts this back in to a
List
of
Double objects before returning it.
The same process is applied in reverse for
setStatistics(newStats). The list is converted into
an appropriate array before the call to
MBeanServerConnection.setAttribute(ObjectName,Attribute)
is made. Finally, a call to
getNamedStatistics will require
both a Java to open type conversion on the arguments, and then
an open type to Java conversion of the return value. Thus, a proxy
enables an
MXBean to be used in cases where the appropriate
Java types are available and the user wishes to access the bean
using the types directly defined in its interface, just as with
standard management beans.
Calling this method is equivalent to calling
newMXBeanProxy(MBeanServerConnection, ObjectName, Class,
boolean).