|
XMOJO 5 API Docs | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--com.adventnet.adaptors.clients.AbstractClient | +--com.adventnet.adaptors.clients.rmi.RMIClient
Field Summary | |
java.lang.String |
mbeanServerID
|
Fields inherited from class com.adventnet.adaptors.clients.AbstractClient |
adaptorInfo, heartBeatRate, host, isSubAgentAlive, listeners, port |
Constructor Summary | |
RMIClient()
|
Method Summary | |
void |
addNotificationListener(ObjectName name,
NotificationListener listener,
NotificationFilter filter,
java.lang.Object handback)
Enables a couple (listener,handback) for a registered MBean to be added using this client through the relevant adaptor. |
void |
addNotificationListener(ObjectName name,
ObjectName listener,
NotificationFilter filter,
java.lang.Object handback)
Enables a couple (listener,handback) for a registered MBean to be added using this client through the relevant adaptor. |
void |
authenticate(com.adventnet.agent.security.UserContext userContext)
Authenticates the user corresponig to the UserContext passed |
void |
connect(java.lang.String host,
int port,
java.lang.Object adaptorInfo)
Initializes the communication with the remote managed object server. |
ObjectInstance |
createMBean(java.lang.String className,
ObjectName name)
Instantiates and registers a MBean with the MBeanServer using this client through the relevant adaptor. |
ObjectInstance |
createMBean(java.lang.String className,
ObjectName name,
java.lang.Object[] params,
java.lang.String[] signature)
Instantiates and registers a MBean with the MBeanServer using this client through the relevant adaptor.The MBean server will use the DefaultLoaderRepository to load the class of the MBean. |
ObjectInstance |
createMBean(java.lang.String className,
ObjectName name,
ObjectName loaderName)
Instantiates and registers a MBean with the MBeanServer using this client through the relevant adaptor. |
ObjectInstance |
createMBean(java.lang.String className,
ObjectName name,
ObjectName loaderName,
java.lang.Object[] params,
java.lang.String[] signature)
Instantiates and registers a MBean with the MBeanServer using this client through the relevant adaptor.The class loader to be used is identified by its object name. |
java.io.ObjectInputStream |
deserialize(ObjectName objectName,
byte[] data)
Deserializes the data passed |
java.io.ObjectInputStream |
deserialize(java.lang.String className,
byte[] data)
De-serializes a byte array in the context of a given MBean class loader. |
java.io.ObjectInputStream |
deserialize(java.lang.String className,
ObjectName objectName,
byte[] data)
De-serializes a byte array in the context of a given MBean class loader. |
void |
disconnect()
Diconnects the communication with the adaptor. |
java.lang.Object |
getAttribute(ObjectName name,
java.lang.String attribute)
Gets the value of a specific attribute of a named MBean using this client through the relevant adaptor. |
AttributeList |
getAttributes(ObjectName name,
java.lang.String[] attributes)
Enables the values of several attributes of a named MBean using this client through the relevant adaptor. |
java.lang.String |
getDefaultDomain()
Returns the default domain used for naming the MBean. |
java.lang.Integer |
getMBeanCount()
Returns the number of MBeans controlled by the MBeanServer using this client through the relevant adaptor. |
MBeanInfo |
getMBeanInfo(ObjectName name)
This method discovers the attributes and operations that an MBean exposes for management using this client through the relevant adaptor.When flatten is false, inherited attributes are not returned. |
java.lang.String |
getMBeanServerID()
Returns the MBeanServerID |
ObjectInstance |
getObjectInstance(ObjectName name)
Gets the ObjectInstance for a given MBean registered with the MBean server using this client through the relevant adaptor. |
java.lang.Object |
instantiate(java.lang.String className)
Instantiates an object using the list of all class loaders registered in the MBean server (Default Loader Repository using this client through the relevant adaptor. |
java.lang.Object |
instantiate(java.lang.String className,
java.lang.Object[] params,
java.lang.String[] signature)
Instantiates an object using the list of all class loaders registered in the MBean server (Default Loader Repository) using this client through the relevant adaptor.The object's class should have a public constructor. |
java.lang.Object |
instantiate(java.lang.String className,
ObjectName loaderName)
Instantiates an object using the class Loader specified by its ObjectName using this client through the relevant adaptor. |
java.lang.Object |
instantiate(java.lang.String className,
ObjectName loaderName,
java.lang.Object[] params,
java.lang.String[] signature)
Instantiates an object using this client through the relevant adaptor. |
java.lang.Object |
invoke(ObjectName name,
java.lang.String actionName,
java.lang.Object[] params,
java.lang.String[] signature)
Invokes an action on an MBean using this client through the relevant adaptor. |
boolean |
isAuthenticationEnabled()
Determines whether authentication is enabled or not |
java.lang.Boolean |
isConnectedWithAdaptor()
Indicates whether the RMI client is connected with the RMI adaptor. |
boolean |
isInstanceOf(ObjectName name,
java.lang.String className)
Returns true if the MBean specified is an instance of the specified class, false otherwise. |
boolean |
isRegistered(ObjectName name)
Checks whether an MBean, identified by its object name, is already registered with the MBeanServer using this client through the relevant adaptor. |
java.util.Set |
queryMBeans(ObjectName name,
QueryExp query)
Gets MBeans controlled by the MBeanServer using this client through the relevant adaptor. |
java.util.Set |
queryNames(ObjectName name,
QueryExp query)
Gets the names of MBeans controlled by the MBeanServer using this client through the relevant adaptor. |
ObjectInstance |
registerAsModelMBean(java.lang.Object mbean,
java.lang.String xmlFile,
ObjectName name)
Remote method call which registers the MBean. |
ObjectInstance |
registerMBean(java.lang.Object object,
ObjectName objectName)
Registers a pre-existing object as an MBean with the MBean server. |
ObjectInstance |
registerMBean(java.lang.String className,
ObjectName name)
Registers a pre-existing object as an MBean with the MBeanServer using this client through the relevant adaptor. |
void |
removeNotificationListener(ObjectName name,
NotificationListener listener)
Enables a listener for an MBean to be removed using this client through the relevant adaptor. |
void |
removeNotificationListener(ObjectName name,
ObjectName listener)
Enables a listener for an MBean to be removed using this client through the relevant adaptor. |
void |
sendHeartBeatEvent()
This synchronized method sends the HeartBeartEvent to all the registered listeners |
void |
setAttribute(ObjectName name,
Attribute attribute)
Sets the value of a specific attribute of a named MBean using this client through the relevant adaptor. |
AttributeList |
setAttributes(ObjectName name,
AttributeList attributes)
Sets the values of several attributes of a named MBean using this client through the relevant adaptor. |
void |
unregisterMBean(ObjectName name)
De-registers an MBean from the MBeanServer using this client through the relevant adaptor. |
Methods inherited from class com.adventnet.adaptors.clients.AbstractClient |
addHeartBeatListener, enableHeartBeat, getHeartBeatRate, isHeartBeatEnabled, removeHeartBeatListener, setHeartBeatRate, startHeartBeat, stopHeartBeat |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
public java.lang.String mbeanServerID
Constructor Detail |
public RMIClient()
Method Detail |
public java.io.ObjectInputStream deserialize(ObjectName objectName, byte[] data) throws InstanceNotFoundException, OperationsException
deserialize
in class com.adventnet.adaptors.clients.AbstractClient
objectName
- The objectName of the MBeandata
- The data as byte arrayInstanceNotFoundException
- If the specified MBean is not registered with the MBeanServerOperationsException
- public java.io.ObjectInputStream deserialize(java.lang.String className, byte[] data) throws OperationsException, ReflectionException
MBeanServer
deserialize
in class com.adventnet.adaptors.clients.AbstractClient
className
- The class namedata
- The data as byte arrayReflectionException
- OperationsException
- public java.io.ObjectInputStream deserialize(java.lang.String className, ObjectName objectName, byte[] data) throws InstanceNotFoundException, OperationsException, ReflectionException
MBeanServer
deserialize
in class com.adventnet.adaptors.clients.AbstractClient
className
- The class nameobjectName
- The object name of the mbeandata
- The data as byte arrayInstanceNotFoundException
- If the specifed MBean is not registered with the MBeanServerOperationsException
- ReflectionException
- public void connect(java.lang.String host, int port, java.lang.Object adaptorInfo) throws java.net.ConnectException
connect
in class com.adventnet.adaptors.clients.AbstractClient
host
- The host name of the adaptor.port
- The port number of the adaptor.adaptorInfo
- The information object specific to the adaptor. Here the
Factory object look up name String can be specfied. If null, then
lookup is made for "AdventnetRMIAdaptor"
- public void authenticate(com.adventnet.agent.security.UserContext userContext) throws com.adventnet.agent.security.AuthenticationException
userContext
- The UserContext corresponding to the userpublic boolean isAuthenticationEnabled()
public void disconnect()
disconnect
in class com.adventnet.adaptors.clients.AbstractClient
public java.lang.Boolean isConnectedWithAdaptor()
isConnectedWithAdaptor
in class com.adventnet.adaptors.clients.AbstractClient
public void sendHeartBeatEvent()
sendHeartBeatEvent
in class com.adventnet.adaptors.clients.AbstractClient
public java.lang.String getMBeanServerID()
public void addNotificationListener(ObjectName name, NotificationListener listener, NotificationFilter filter, java.lang.Object handback) throws InstanceNotFoundException
addNotificationListener
in class com.adventnet.adaptors.clients.AbstractClient
name
- The name of the MBean on which the listener should be added.listener
- The listener object which will handles notifications
emitted by the registered MBean.filter
- The filter object. If not specified, no filtering will be
performed before handling notifications.handback
- The context to be sent to the listener when a notification
is emitted.InstanceNotFoundException
- The MBean name
doesn't correspond to a registered MBean.public void addNotificationListener(ObjectName name, ObjectName listener, NotificationFilter filter, java.lang.Object handback) throws InstanceNotFoundException
addNotificationListener
in class com.adventnet.adaptors.clients.AbstractClient
name
- The name of the MBean on which the listener should be added.listener
- The listener name which will handles notifications
emitted by the registered MBean.filter
- The filter object. If not specified, no filtering will be
performed before handling notifications.handback
- The context to be sent to the listener when a notification
is emitted.InstanceNotFoundException
- The MBean name
doesn't correspond to a registered MBean.public ObjectInstance createMBean(java.lang.String className, ObjectName name) throws ReflectionException, InstanceAlreadyExistsException, MBeanRegistrationException, MBeanException, NotCompliantMBeanException
createMBean
in class com.adventnet.adaptors.clients.AbstractClient
className
- The class name of the MBean to be instantiated.name
- The object name of the MBean. May be null.ReflectionException
- Wraps Wraps a
ClassNotFoundException or a java.lang.Exception that occured trying to
invoke the MBean's constructor.InstanceAlreadyExistsException
- The MBean is
already under the control of the MBeanServer.MBeanRegistrationException
- The preRegister
(MBeanRegistration interface) method of the MBean has thrown an exception.
The MBean will not be registered.MBeanException
- The constructor of the MBean has
thrown an exceptionNotCompliantMBeanException
- This class is not an
JMX compliant MBeanRuntimeOperationsException
- Wraps a
java.lang.IllegalArgumentException: The className passed in parameter is
null, the ObjectName passed in parameter contains a pattern or no ObjectName
is specified for the MBean.public ObjectInstance createMBean(java.lang.String className, ObjectName name, java.lang.Object[] params, java.lang.String[] signature) throws ReflectionException, InstanceAlreadyExistsException, MBeanRegistrationException, MBeanException, NotCompliantMBeanException
createMBean
in class com.adventnet.adaptors.clients.AbstractClient
className
- The class name of the MBean to be instantiated.name
- The object name of the MBean. May be null.params
- An array containing the parameters of the constructor to be
invoked.signature
- An array containing the signature of the constructor to be
invoked.ReflectionException
- Wraps Wraps a
ClassNotFoundException or a java.lang.Exception that occured trying to
invoke the MBean's constructor.InstanceAlreadyExistsException
- The MBean is
already under the control of the MBeanServer.MBeanRegistrationException
- The preRegister
(MBeanRegistration interface) method of the MBean has thrown an exception.
The MBean will not be registered.MBeanException
- The constructor of the MBean has
thrown an exceptionNotCompliantMBeanException
- This class is not an
JMX compliant MBeanRuntimeOperationsException
- Wraps a
java.lang.IllegalArgumentException: The className passed in parameter is
null, the ObjectName passed in parameter contains a pattern or no ObjectName
is specified for the MBean.public ObjectInstance createMBean(java.lang.String className, ObjectName name, ObjectName loaderName) throws ReflectionException, InstanceAlreadyExistsException, MBeanRegistrationException, MBeanException, NotCompliantMBeanException, InstanceNotFoundException
createMBean
in class com.adventnet.adaptors.clients.AbstractClient
className
- The class name of the MBean to be instantiated.name
- The object name of the MBean. May be null.loaderName
- The object name of the class loader to be used.InstanceAlreadyExistsException
- The MBean is
already under the control of the MBeanServer.MBeanRegistrationException
- The preRegister
(MBeanRegistration interface) method of the MBean has thrown an exception.
The MBean will not be registered.MBeanException
- The constructor of the MBean has
thrown an exceptionNotCompliantMBeanException
- This class is not an
JMX compliant MBeanInstanceNotFoundException
- The specified class
loader is not registered in the MBeanServer.RuntimeOperationsException
- Wraps a
java.lang.IllegalArgumentException: The className passed in parameter is
null, the ObjectName passed in parameter contains a pattern or no ObjectName
is specified for the MBean.public ObjectInstance createMBean(java.lang.String className, ObjectName name, ObjectName loaderName, java.lang.Object[] params, java.lang.String[] signature) throws ReflectionException, InstanceAlreadyExistsException, MBeanRegistrationException, MBeanException, NotCompliantMBeanException, InstanceNotFoundException
createMBean
in class com.adventnet.adaptors.clients.AbstractClient
className
- The class name of the MBean to be instantiated.name
- The object name of the MBean. May be null.params
- An array containing the parameters of the constructor to be
invoked.signature
- An array containing the signature of the constructor to be
invoked.loaderName
- The object name of the class loader to be used.ReflectionException
- Wraps Wraps a
ClassNotFoundException or a java.lang.Exception that occured trying to
invoke the MBean's constructor.InstanceAlreadyExistsException
- The MBean is
already under the control of the MBeanServer.MBeanRegistrationException
- The preRegister
(MBeanRegistration interface) method of the MBean has thrown an exception.
The MBean will not be registered.MBeanException
- The constructor of the MBean has
thrown an exceptionNotCompliantMBeanException
- This class is not an
JMX compliant MBeanInstanceNotFoundException
- The specified class
loader is not registered in the MBeanServer.RuntimeOperationsException
- Wraps a
java.lang.IllegalArgumentException: The className passed in parameter is
null, the ObjectName passed in parameter contains a pattern or no ObjectName
is specified for the MBean.public java.lang.Object getAttribute(ObjectName name, java.lang.String attribute) throws MBeanException, AttributeNotFoundException, InstanceNotFoundException, ReflectionException
getAttribute
in class com.adventnet.adaptors.clients.AbstractClient
name
- The object name of the MBean from which the
attribute is to be retrieved.attribute
- A String specifying the name of the
attribute to be retrieved.ReflectionException
- wraps a
ClassNotFoundException or a java.lang.Exception that occured trying to
invoke the MBean's constructor.AttributeNotFoundException
- The
specified attribute is not accessible in the MBean.MBeanException
- Wraps an exception
thrown by the MBean's getter.InstanceNotFoundException
- The
specified MBean is not registered in the MBeanServer.ReflectionException
- Wraps an
java.lang.Exception thrown while trying to invoke the setter.RuntimeOperationsException
- Wraps a
java.lang.IllegalArgumentException: The object name in parameter
is null or the attribute in parameter is null.public AttributeList getAttributes(ObjectName name, java.lang.String[] attributes) throws InstanceNotFoundException, ReflectionException
getAttributes
in class com.adventnet.adaptors.clients.AbstractClient
name
- The object name of the MBean from which the
attributes are to be retrieved.attributes
- A list of the attributes to be retrieved.InstanceNotFoundException
- The
specified MBean is not registered in the MBeanServer.ReflectionException
- An exception
occurred when trying to invoke the getAttributes method of a Dynamic MBean.RuntimeOperationsException
- Wraps a
java.lang.IllegalArgumentException: The object name in parameter
is null or the attribute in parameter is null.public java.lang.String getDefaultDomain()
getDefaultDomain
in class com.adventnet.adaptors.clients.AbstractClient
public java.lang.Integer getMBeanCount()
getMBeanCount
in class com.adventnet.adaptors.clients.AbstractClient
public MBeanInfo getMBeanInfo(ObjectName name) throws InstanceNotFoundException, IntrospectionException, ReflectionException
getMBeanInfo
in class com.adventnet.adaptors.clients.AbstractClient
name
- The name of the MBean to analyzejava.beans.IntrospectionException
- An exception
occurs during introspection.InstanceNotFoundException
- The specified
MBean is not found.ReflectionException
- An exception occurred
when trying to invoke the getMBeanInfo of a Dynamic MBean.public ObjectInstance getObjectInstance(ObjectName name) throws InstanceNotFoundException
getObjectInstance
in class com.adventnet.adaptors.clients.AbstractClient
name
- The object name of the MBean.InstanceNotFoundException
- The MBean specified
is not registered in the MBean server.public java.lang.Object instantiate(java.lang.String className) throws ReflectionException, MBeanException
instantiate
in class com.adventnet.adaptors.clients.AbstractClient
className
- The class name of the object to be instantiated.ReflectionException
- Wraps a
ClassNotFoundException or the java.lang.Exception that occured trying
to invoke the object's constructor.MBeanException
- The constructor of the object
has thrown an exceptionRuntimeOperationsException
- Wraps a
java.lang.IllegalArgumentException: The className passed in parameter is null.public java.lang.Object instantiate(java.lang.String className, java.lang.Object[] params, java.lang.String[] signature) throws ReflectionException, MBeanException
instantiate
in class com.adventnet.adaptors.clients.AbstractClient
className
- The class name of the object to be instantiated.params
- An array containing the parameters of the constructor to be invoked.signature
- An array containing the signature of the constructor to be invoked.ReflectionException
- Wraps a
ClassNotFoundException or the java.lang.Exception that occured trying
to invoke the object's constructor.MBeanException
- The constructor of the object
has thrown an exceptionRuntimeOperationsException
- Wraps a
java.lang.IllegalArgumentException: The className passed in parameter is null.public java.lang.Object instantiate(java.lang.String className, ObjectName loaderName) throws ReflectionException, MBeanException, InstanceNotFoundException
instantiate
in class com.adventnet.adaptors.clients.AbstractClient
className
- The class name of the object to be instantiated.loaderName
- The object name of the class loader to be used.ReflectionException
- Wraps a
ClassNotFoundException or the java.lang.Exception that occured trying
to invoke the object's constructor.MBeanException
- The constructor of the object
has thrown an exceptionInstanceNotFoundException
- The specified class
loader is not registered in the MBeanServer.RuntimeOperationsException
- Wraps a
java.lang.IllegalArgumentException: The className passed in parameter is null.public java.lang.Object instantiate(java.lang.String className, ObjectName loaderName, java.lang.Object[] params, java.lang.String[] signature) throws ReflectionException, MBeanException, InstanceNotFoundException
instantiate
in class com.adventnet.adaptors.clients.AbstractClient
className
- The class name of the object to be instantiated.loaderName
- The object name of the class loader to be used.params
- An array containing the parameters of the constructor to be invoked.signature
- An array containing the signature of the constructor to be invoked.ReflectionException
- Wraps a
ClassNotFoundException or the java.lang.Exception that occured trying
to invoke the object's constructor.MBeanException
- The constructor of the object
has thrown an exceptionInstanceNotFoundException
- The specified class
loader is not registered in the MBeanServer.RuntimeOperationsException
- Wraps a
java.lang.IllegalArgumentException: The className passed in parameter is null.public java.lang.Object invoke(ObjectName name, java.lang.String actionName, java.lang.Object[] params, java.lang.String[] signature) throws InstanceNotFoundException, MBeanException, ReflectionException
invoke
in class com.adventnet.adaptors.clients.AbstractClient
name
- The object name of the MBean on which
the method is to be invoked.actionName
- The name of the action to be invoked.params
- An array containing the parameters to be
set when the action is invokedsignature
- An array containing the signature of
the action. The class objects will be loaded using the
same class loader as the one used for loading the MBean
on which the action was invoked.InstanceNotFoundException
- The
specified MBean is not registered in the MBeanServer.MBeanException
- Wraps an exception
thrown by the MBean's invoked method.ReflectionException
- Wraps an
java.lang.Exception thrown while trying to invoke the method.public boolean isRegistered(ObjectName name)
isRegistered
in class com.adventnet.adaptors.clients.AbstractClient
name
- The object name of the MBean to be checked.RuntimeOperationsException
- Wraps a
java.lang.IllegalArgumentException: The ObjectName parameter is null.public boolean isInstanceOf(ObjectName name, java.lang.String className) throws InstanceNotFoundException
isInstanceOf
in class com.adventnet.adaptors.clients.AbstractClient
name
- The object name of the MBean to be checked.className
- The name of the class.InstanceNotFoundException
- The MBean specified is not registered in the MBean server.public java.util.Set queryMBeans(ObjectName name, QueryExp query)
queryMBeans
in class com.adventnet.adaptors.clients.AbstractClient
name
- The object name pattern identifying the MBeans to be
retrieved. If null orempty all the MBeans registered will be retrieved.query
- The query expression to be applied for selecting MBeans.public java.util.Set queryNames(ObjectName name, QueryExp query)
queryNames
in class com.adventnet.adaptors.clients.AbstractClient
name
- The object name pattern identifying the MBean names
to be retrieved. If null or empty, the name of all registered
MBeans will be retrieved.query
- The query expression to be applied for selecting MBeans.public ObjectInstance registerMBean(java.lang.String className, ObjectName name) throws InstanceAlreadyExistsException, MBeanRegistrationException, NotCompliantMBeanException
String
- The classname of the Java Bean to be registered as an MBean.name
- The object name of the MBean. May be null.InstanceAlreadyExistsException
- The MBean
is already under the control of the MBeanServer.MBeanRegistrationException
- The preRegister
(MBeanRegistration interface) method of the MBean has thrown an exception.
The MBean will not be registered.NotCompliantMBeanException
- This object is
not an JMX compliant MBeanRuntimeOperationsException
- Wraps a
java.lang.IllegalArgumentException: The object passed in parameter is null
or no object name is specified.public ObjectInstance registerMBean(java.lang.Object object, ObjectName objectName) throws InstanceAlreadyExistsException, MBeanRegistrationException, NotCompliantMBeanException
MBeanServer
MBeanRegistration
interface.
The call returns an ObjectInstance
object
representing the registered MBean.registerMBean
in class com.adventnet.adaptors.clients.AbstractClient
javax.management.MBeanServer
object
- The MBean to be registered as an MBean.name
- The object name of the MBean. May be null.ObjectInstance
for the registered MBean.InstanceAlreadyExistsException
- The MBean is already
under the control of the MBean server.MBeanRegistrationException
- The preRegister
(MBeanRegistration
interface) method of the
MBean has thrown an exception. The MBean will not be registered.NotCompliantMBeanException
- This object is not a JMX compliant MBean.RuntimeOperationsException
- Wraps a
java.lang.IllegalArgumentException
:
The object passed in parameter is null
or no object name is specified.public ObjectInstance registerAsModelMBean(java.lang.Object mbean, java.lang.String xmlFile, ObjectName name) throws InstanceAlreadyExistsException, MBeanRegistrationException, NotCompliantMBeanException
mbean
- The mbean object which is to be instantiated locally as modelmbean in the mbean
server and registered.xmlFile
- The path of the xml file name locally in the mbean server.name
- The object name of the MBean. May be null.InstanceAlreadyExistsException
- The MBean
is already under the control of the MBeanServer.MBeanRegistrationException
- The preRegister
(MBeanRegistration interface) method of the MBean has thrown an exception.
The MBean will not be registered.NotCompliantMBeanException
- This object is
not an JMX compliant MBeanRuntimeOperationsException
- Wraps a
java.lang.IllegalArgumentException: The object passed in parameter is null
or no object name is specified.public void removeNotificationListener(ObjectName name, NotificationListener listener) throws InstanceNotFoundException, ListenerNotFoundException
removeNotificationListener
in class com.adventnet.adaptors.clients.AbstractClient
name
- The name of the MBean on which the listener should be removedlistener
- The listener object which will handles notifications
emitted by the registered MBean.This method will remove all information
related to this listener.InstanceNotFoundException
- The MBean name
doesn't correspond to a registered MBean.ListenerNotFoundException
- The couple
(listener,handback) is not registered in the MBean. The exception message
contains either "listener", "handback" or the object name depending on
which object cannot be found.public void removeNotificationListener(ObjectName name, ObjectName listener) throws InstanceNotFoundException, ListenerNotFoundException
removeNotificationListener
in class com.adventnet.adaptors.clients.AbstractClient
name
- The name of the MBean on which the listener should be removedlistener
- The listener name which will handles notifications
emitted by the registered MBean. This method will remove all information
related to this listener.InstanceNotFoundException
- The MBean name or
the listener name doesn't correspond to a registered MBeanListenerNotFoundException
- The couple
(listener,handback) is not registered in the MBean. The exception message
contains either "listener", "handback" or the object name depending on
which object cannot be found.public void setAttribute(ObjectName name, Attribute attribute) throws InstanceNotFoundException, AttributeNotFoundException, InvalidAttributeValueException, MBeanException, ReflectionException
setAttribute
in class com.adventnet.adaptors.clients.AbstractClient
name
- The name of the MBean within which the
attribute is to be set.attribute
- The identification of the attribute to
be set and the value it is to be set to.InstanceNotFoundException
- The
specified MBean is not registered in the MBeanServer.AttributeNotFoundException
- The
specified attribute is not accessible in the MBean.InvalidAttributeValueException
- The
specified value for the attribute is not valid.MBeanException
- Wraps an exception
thrown by the MBean's setter.ReflectionException
- Wraps an
java.lang.Exception thrown while trying to invoke the setter.RuntimeOperationsException
- Wraps a
java.lang.IllegalArgumentException: The object name in parameter is null
or the attribute in parameter is null.public AttributeList setAttributes(ObjectName name, AttributeList attributes) throws InstanceNotFoundException, ReflectionException
setAttributes
in class com.adventnet.adaptors.clients.AbstractClient
name
- The object name of the MBean within which the
attributes are to be set.attributes
- A list of attributes: The identification
of the attributes to be set and the values they are to be set to.InstanceNotFoundException
- The specified
MBean is not registered in the MBeanServer.ReflectionException
- An exception occurred
when trying to invoke the getAttributes method of a Dynamic MBean.RuntimeOperationsException
- Wraps a
java.lang.IllegalArgumentException: The object name in parameter is null
or attributes in parameter is null.public void unregisterMBean(ObjectName name) throws InstanceNotFoundException, MBeanRegistrationException
unregisterMBean
in class com.adventnet.adaptors.clients.AbstractClient
name
- The object name of the MBean to be de-registered.InstanceNotFoundException
- The
specified MBean is not registered in the MBeanServer.MBeanRegistrationException
- The
preDeregister (MBeanRegistration interface) method of the
MBean has thrown an exception.RuntimeOperationsException
- Wraps a
java.lang.IllegalArgumentException: The object name in parameter is
null or the MBean you are when trying to de-register is the
MBeanServerDelegate MBean.
|
XMOJO 5 API Docs | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |