|
||||||||||
PREV CLASS (src) NEXT CLASS (src) | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
The Management interface provides the APIs to navigate and manipulate managed objects. The J2EE Management EJB component (MEJB) must implement this as its remote interface.
Method Summary | |
java.lang.Object |
getAttribute(ObjectName (src) name,
java.lang.String attribute)
Gets the value of a specific attribute of a named managed object. |
AttributeList (src) |
getAttributes(ObjectName (src) name,
java.lang.String[] attributes)
Enables the values of several attributes of a named managed object. |
java.lang.String |
getDefaultDomain()
Returns the default domain name of this MEJB. |
ListenerRegistration (src) |
getListenerRegistry()
Returns the listener registry implementation for this MEJB. |
java.lang.Integer |
getMBeanCount()
Returns the number of managed objects registered in the MEJB. |
MBeanInfo (src) |
getMBeanInfo(ObjectName (src) name)
This method discovers the attributes and operations that a managed object exposes for management. |
java.lang.Object |
invoke(ObjectName (src) name,
java.lang.String operationName,
java.lang.Object[] params,
java.lang.String[] signature)
Invokes an operation on a managed object |
boolean |
isRegistered(ObjectName (src) name)
Checks whether a managed object, identified by its object name, is already registered with the MEJB. |
java.util.Set |
queryNames(ObjectName (src) name,
QueryExp (src) query)
Gets the names of managed objects controlled by the MEJB. |
void |
setAttribute(ObjectName (src) name,
Attribute (src) attribute)
Sets the value of a specific attribute of a named managed object. |
AttributeList (src) |
setAttributes(ObjectName (src) name,
AttributeList (src) attributes)
Sets the values of several attributes of a named managed object. |
Methods inherited from interface javax.ejb.EJBObject (src) |
getEJBHome, getHandle, getPrimaryKey, isIdentical, remove |
Method Detail |
public java.util.Set queryNames(ObjectName (src) name, QueryExp (src) query) throws java.rmi.RemoteException
name
- The object name pattern identifying the managed objects to be retrieved. If null or no domain and key properties are specified, all the managed objects registered will be retrieved.
java.rmi.RemoteException
- A communication exception occurred during the execution of a remote method callpublic boolean isRegistered(ObjectName (src) name) throws java.rmi.RemoteException
name
- The object name of the managed object to be checked.
java.rmi.RemoteException
- A communication exception occurred during the execution of a remote method callpublic java.lang.Integer getMBeanCount() throws java.rmi.RemoteException
java.rmi.RemoteException
- A communication exception occurred during the execution of a remote method callpublic MBeanInfo (src) getMBeanInfo(ObjectName (src) name) throws IntrospectionException (src) , InstanceNotFoundException (src) , ReflectionException (src) , java.rmi.RemoteException
name
- The name of the managed object to analyze
IntrospectionException (src)
- An exception occurs during introspection.
InstanceNotFoundException (src)
- The managed object specified is not found.
ReflectionException (src)
- An exception occurred when trying to perform reflection on a managed object
java.rmi.RemoteException
- A communication exception occurred during the execution of a remote method callpublic java.lang.Object getAttribute(ObjectName (src) name, java.lang.String attribute) throws MBeanException (src) , AttributeNotFoundException (src) , InstanceNotFoundException (src) , ReflectionException (src) , java.rmi.RemoteException
name
- The object name of the managed object from which the attribute is to be retrieved.attribute
- A String specifying the name of the attribute to be retrieved.
AttributeNotFoundException (src)
- - The attribute specified is not accessible in the managed object.
MBeanException (src)
- - Wraps an exception thrown by the managed object's getter.
InstanceNotFoundException (src)
- - The managed object specified is not registered in the MEJB.
ReflectionException (src)
- - An exception occurred when trying to invoke the getAttribute method of a Dynamic MBean
java.rmi.RemoteException
- - A communication exception occurred during the execution of a remote method call getAttributespublic AttributeList (src) getAttributes(ObjectName (src) name, java.lang.String[] attributes) throws InstanceNotFoundException (src) , ReflectionException (src) , java.rmi.RemoteException
name
- The object name of the managed object from which the attributes are retrieved.attributes
- A list of the attributes to be retrieved.
InstanceNotFoundException (src)
- - The managed object specified is not registered in the MEJB.
ReflectionException (src)
- - An exception occurred when trying to invoke the getAttributes method of a Dynamic MBean.
java.rmi.RemoteException
- - A communication exception occurred during the execution of a remote method callpublic void setAttribute(ObjectName (src) name, Attribute (src) attribute) throws InstanceNotFoundException (src) , AttributeNotFoundException (src) , InvalidAttributeValueException (src) , MBeanException (src) , ReflectionException (src) , java.rmi.RemoteException
name
- The name of the managed object 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 (src)
AttributeNotFoundException (src)
InstanceNotFoundException (src)
- - The managed object specified is not registered in the MEJB.
AttributeNotFoundException (src)
- - The attribute specified is not accessible in the managed object.
InvalidAttributeValueException (src)
- - The value specified for the attribute is not valid.
MBeanException (src)
- - Wraps an exception thrown by the managed object's setter.
ReflectionException (src)
- - An exception occurred when trying to invoke the setAttribute method of a Dynamic MBean.
java.rmi.RemoteException
- - A communication exception occurred during the execution of a remote method call setAttributespublic AttributeList (src) setAttributes(ObjectName (src) name, AttributeList (src) attributes) throws InstanceNotFoundException (src) , ReflectionException (src) , java.rmi.RemoteException
name
- The object name of the managed object 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 (src)
- - The managed object specified is not registered in the MEJB.
ReflectionException (src)
- - An exception occurred when trying to invoke the setAttributes method of a Dynamic MBean.
java.rmi.RemoteException
- - A communication exception occurred during the execution of a remote method call invokepublic java.lang.Object invoke(ObjectName (src) name, java.lang.String operationName, java.lang.Object[] params, java.lang.String[] signature) throws InstanceNotFoundException (src) , MBeanException (src) , ReflectionException (src) , java.rmi.RemoteException
name
- The object name of the managed object on which the method is to be invoked.operationName
- The name of the operation to be invoked.params
- An array containing the parameters to be set when the operation is invokedsignature
- An array containing the signature of the operation. The class objects will be loaded using the same class loader as the one used for loading the managed object on which the operation was invoked.
InstanceNotFoundException (src)
- - The managed object specified is not registered in the MEJB.
MBeanException (src)
- - Wraps an exception thrown by the managed object's invoked method.
ReflectionException (src)
- - Wraps a java.lang.Exception thrown while trying to invoke the method.
java.rmi.RemoteException
- - A communication exception occurred during the execution of a remote method call getDefaultDomainpublic java.lang.String getDefaultDomain() throws java.rmi.RemoteException
java.rmi.RemoteException
- RemoteException - A communication exception occurred during the execution of a remote method call getListenerRegistrypublic ListenerRegistration (src) getListenerRegistry() throws java.rmi.RemoteException
java.rmi.RemoteException
- - A communication exception occurred during the execution of a remote method call
|
||||||||||
PREV CLASS (src) NEXT CLASS (src) | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |