| javax.management.MBeanServerConnection
| MBeanServerConnection | | public interface MBeanServerConnection (Code) | | An interface used to talk to an MBeanServer that is either remote or
local. The local interface MBeanServer extends this one.
See Also: javax.management.MBeanServer
author:
Adrian Brock.
version:
$Revision: 57200 $ |
| Method Summary | |
| public void | addNotificationListener(ObjectName name, NotificationListener listener, NotificationFilter filter, Object handback)
Add a notification listener to an MBean. | | public void | addNotificationListener(ObjectName name, ObjectName listener, NotificationFilter filter, Object handback)
Add a notification listener to an MBean. | | public ObjectInstance | createMBean(String className, ObjectName name)
Create an MBean registered using the given object name.
Uses the default contructor. | | public ObjectInstance | createMBean(String className, ObjectName name, ObjectName loaderName)
Create an MBean registered using the given object name.
The MBean is loaded using the passed classloader. | | public ObjectInstance | createMBean(String className, ObjectName name, Object[] params, String[] signature)
Create an MBean registered using the given object name.
Uses the specified constructor. | | public ObjectInstance | createMBean(String className, ObjectName name, ObjectName loaderName, Object[] params, String[] signature)
Create an MBean registered using the given object name.
The MBean is loaded using the passed classloader. | | public Object | getAttribute(ObjectName name, String attribute)
Retrieve a value from an MBean. | | public AttributeList | getAttributes(ObjectName name, String[] attributes)
Retrieve a list of values from an MBean. | | public String | getDefaultDomain()
Retrieve the default domain of the mbeanserver. | | public String[] | getDomains()
Retrieve the domains of the mbeanserver. | | public Integer | getMBeanCount()
Retrieve the number of mbeans registered in the server. | | public MBeanInfo | getMBeanInfo(ObjectName name)
| | public ObjectInstance | getObjectInstance(ObjectName name)
Retrieve an MBean's registration information. | | public Object | invoke(ObjectName name, String operationName, Object[] params, String[] signature)
Invokes an operation on an mbean. | | public boolean | isInstanceOf(ObjectName name, String className)
| | public boolean | isRegistered(ObjectName name)
Test whether an mbean is registered. | | public Set | queryMBeans(ObjectName name, QueryExp query)
| | public Set | queryNames(ObjectName name, QueryExp query)
| | public void | removeNotificationListener(ObjectName name, ObjectName listener)
Removes a listener from an mbean.
All registrations of the listener are removed. | | public void | removeNotificationListener(ObjectName name, ObjectName listener, NotificationFilter filter, Object handback)
Removes a listener from an mbean.
Only the listener that was registered with the same filter and handback is removed. | | public void | removeNotificationListener(ObjectName name, NotificationListener listener)
Removes a listener from an mbean.
All registrations of the listener are removed. | | public void | removeNotificationListener(ObjectName name, NotificationListener listener, NotificationFilter filter, Object handback)
Removes a listener from an mbean.
Only the listener that was registered with the same filter and handback is removed. | | public void | setAttribute(ObjectName name, Attribute attribute)
Set a value for an MBean. | | public AttributeList | setAttributes(ObjectName name, AttributeList attributes)
Set a list of values for an MBean. | | public void | unregisterMBean(ObjectName name)
Unregisters an mbean. |
| addNotificationListener | | public void addNotificationListener(ObjectName name, ObjectName listener, NotificationFilter filter, Object handback) throws InstanceNotFoundException, IOException(Code) | | Add a notification listener to an MBean.
Parameters:
name - the name of the MBean broadcasting notifications
Parameters:
listener - the object name listener to add
Parameters:
filter - a filter to preprocess notifications
Parameters:
handback - a object to add to any notifications
exception:
InstanceNotFoundException - if the broadcaster or listener is not registered
exception:
RuntimeOperationsException - wrapping an IllegalArgumentException for anull listener or the listener does not implement the Notification Listener interface
exception:
IOException - for a communication problem during this operation |
| createMBean | | public ObjectInstance createMBean(String className, ObjectName name, ObjectName loaderName) throws ReflectionException, InstanceAlreadyExistsException, MBeanRegistrationException, MBeanException, NotCompliantMBeanException, InstanceNotFoundException, IOException(Code) | | Create an MBean registered using the given object name.
The MBean is loaded using the passed classloader. Uses the default contructor.
Parameters:
className - the class name of the mbean
Parameters:
loaderName - an MBean that implements a classloader
Parameters:
name - the object name for registration, can be null an ObjectInstance describing the registration
exception:
ReflectionException - for class not found or an exceptioninvoking the contructor
exception:
InstanceAlreadyExistsException - for an MBean already registeredwith the passed or generated ObjectName
exception:
MBeanRegistrationException - for any exception thrown by theMBean's preRegister
exception:
MBeanException - for any exception thrown by the MBean's constructor
exception:
InstanceNotFoundException - if the loaderName is not a classloader registeredin the MBeanServer
exception:
NotCompliantMBeanException - if the class name does not correspond toa valid MBean
exception:
RuntimeOperationsException - wrapping an IllegalArgumentException for anull class name, the ObjectName could not be determined or it is a pattern
exception:
IOException - for a communication problem during this operation |
| createMBean | | public ObjectInstance createMBean(String className, ObjectName name, Object[] params, String[] signature) throws ReflectionException, InstanceAlreadyExistsException, MBeanRegistrationException, MBeanException, NotCompliantMBeanException, IOException(Code) | | Create an MBean registered using the given object name.
Uses the specified constructor.
Parameters:
className - the class name of the mbean
Parameters:
name - the object name for registration, can be null
Parameters:
params - the parameters for the constructor
Parameters:
signature - the signature of the constructor an ObjectInstance describing the registration
exception:
ReflectionException - for class not found or an exceptioninvoking the contructor
exception:
InstanceAlreadyExistsException - for an MBean already registeredwith the passed or generated ObjectName
exception:
MBeanRegistrationException - for any exception thrown by theMBean's preRegister
exception:
MBeanException - for any exception thrown by the MBean's constructor
exception:
NotCompliantMBeanException - if the class name does not correspond toa valid MBean
exception:
RuntimeOperationsException - wrapping an IllegalArgumentException for anull class name, the ObjectName could not be determined or it is a pattern
exception:
IOException - for a communication problem during this operation |
| createMBean | | public ObjectInstance createMBean(String className, ObjectName name, ObjectName loaderName, Object[] params, String[] signature) throws ReflectionException, InstanceAlreadyExistsException, MBeanRegistrationException, MBeanException, NotCompliantMBeanException, InstanceNotFoundException, IOException(Code) | | Create an MBean registered using the given object name.
The MBean is loaded using the passed classloader. Uses the specified constructor.
Parameters:
className - the class name of the mbean
Parameters:
loaderName - an MBean that implements a classloader
Parameters:
name - the object name for registration, can be null
Parameters:
params - the parameters for the constructor
Parameters:
signature - the signature of the constructor an ObjectInstance describing the registration
exception:
ReflectionException - for class not found or an exceptioninvoking the contructor
exception:
InstanceAlreadyExistsException - for an MBean already registeredwith the passed or generated ObjectName
exception:
MBeanRegistrationException - for any exception thrown by theMBean's preRegister
exception:
MBeanException - for any exception thrown by the MBean's constructor
exception:
InstanceNotFoundException - if the loaderName is not a classloader registeredin the MBeanServer
exception:
NotCompliantMBeanException - if the class name does not correspond toa valid MBean
exception:
RuntimeOperationsException - wrapping an IllegalArgumentException for anull class name, the ObjectName could not be determined or it is a pattern
exception:
IOException - for a communication problem during this operation |
| getDefaultDomain | | public String getDefaultDomain() throws IOException(Code) | | Retrieve the default domain of the mbeanserver.
the default domain
exception:
IOException - for a communication problem during this operation |
| getDomains | | public String[] getDomains() throws IOException(Code) | | Retrieve the domains of the mbeanserver.
the domains
exception:
IOException - for a communication problem during this operation |
| getMBeanCount | | public Integer getMBeanCount() throws IOException(Code) | | Retrieve the number of mbeans registered in the server.
true the number of registered mbeans
exception:
IOException - for a communication problem during this operation |
| isRegistered | | public boolean isRegistered(ObjectName name) throws IOException(Code) | | Test whether an mbean is registered.
Parameters:
name - the object name of the mbean true when the mbean is registered, false otherwise
exception:
RuntimeOperationsException - wrapping an IllegalArgumentException for anull name
exception:
IOException - for a communication problem during this operation |
| queryMBeans | | public Set queryMBeans(ObjectName name, QueryExp query) throws IOException(Code) | | Retrieve a set of Object instances
Parameters:
name - an ObjectName pattern, can be null for all mbeans
Parameters:
query - a query expression to further filter the mbeans, can be nullfor no query
exception:
IOException - for a communication problem during this operation |
| queryNames | | public Set queryNames(ObjectName name, QueryExp query) throws IOException(Code) | | Retrieve a set of Object names
Parameters:
name - an ObjectName pattern, can be null for all mbeans
Parameters:
query - a query expression to further filter the mbeans, can be nullfor no query
exception:
IOException - for a communication problem during this operation |
|
|