[Ejtools-cvs] libraries/j2ee.management/src/main/javax/management/j2ee ListenerRegistration.java,NON
Brought to you by:
letiemble
Menu
▾
▴
[Ejtools-cvs] libraries/j2ee.management/src/main/javax/management/j2ee ListenerRegistration.java,NONE,1.1 Management.java,NONE,1.1 ManagementHome.java,NONE,1.1 package.html,NONE,1.1
Update of /cvsroot/ejtools/libraries/j2ee.management/src/main/javax/management/j2ee In directory sc8-pr-cvs1:/tmp/cvs-serv9476/src/main/javax/management/j2ee Added Files: ListenerRegistration.java Management.java ManagementHome.java package.html Log Message: Add up-to-date JSR77 implementation. Can skip the Sun one. --- NEW FILE: ListenerRegistration.java --- /* * EJTools, the Enterprise Java Tools * * Distributable under LGPL license. * See terms of license at www.gnu.org. */ package javax.management.j2ee; import java.io.Serializable; import java.rmi.RemoteException; import javax.management.InstanceNotFoundException; import javax.management.ListenerNotFoundException; import javax.management.NotificationFilter; import javax.management.NotificationListener; import javax.management.ObjectName; /** * Provides the methods to add and remove event listeners to the MEJB component. * * @author Laurent Etiemble * @version $Revision: 1.1 $ */ public interface ListenerRegistration extends Serializable { /** * Add a listener to a registered managed object. * * @param name The name of the managed object on which * the listener should be added. * @param listener The listener object which will handle * the events emitted by the registered managed object. * @param filter The filter object. If filter is null, * no filtering will be performed before handling events. * @param handback An opaque object to be sent back to the * listener when a notification is emitted which helps the listener to associate * information regarding the MBean emitter. This object cannot be used by * the Notification broadcaster object. It should be resent unchanged with * the notification to the listener. * @exception InstanceNotFoundException The managed object name provided does * not match any of the registered managed objects. * @exception RemoteException a communication exception occurred during * the execution of a remote method call. */ public void addNotificationListener(ObjectName name, NotificationListener listener, NotificationFilter filter, Object handback) throws InstanceNotFoundException, RemoteException; /** * Enables to remove a listener from a registered managed object. * * @param name The name of the managed object on which * the listener should be removed. * @param listener The listener object which will handle * the events emitted by the registered managed object. This method will * remove all the information related to this listener. * @exception InstanceNotFoundException The managed object name provided does * not match any of the registered managed objects. * @exception ListenerNotFoundException The listener is not registered in the * managed object. * @exception RemoteException A communication exception occurred during * the execution of a remote method call. */ public void removeNotificationListener(ObjectName name, NotificationListener listener) throws InstanceNotFoundException, ListenerNotFoundException, RemoteException; } --- NEW FILE: Management.java --- /* * EJTools, the Enterprise Java Tools * * Distributable under LGPL license. * See terms of license at www.gnu.org. */ package javax.management.j2ee; import java.rmi.RemoteException; import java.util.Set; import javax.ejb.EJBObject; import javax.management.Attribute; import javax.management.AttributeList; import javax.management.AttributeNotFoundException; import javax.management.InstanceNotFoundException; import javax.management.IntrospectionException; import javax.management.InvalidAttributeValueException; import javax.management.MBeanException; import javax.management.MBeanInfo; import javax.management.ObjectName; import javax.management.QueryExp; import javax.management.ReflectionException; /** * The Management interface provides the APIs to navigate and manipulate managed * objects. <p> * * The Management EJB component must implement this interface as its remote interface. * </p> * * @author Laurent Etiemble * @version $Revision: 1.1 $ */ public interface Management extends EJBObject { /** * Description of the Method * * @param objectname Description of the Parameter * @param queryexp Description of the Parameter * @return Description of the Return Value * @exception RemoteException Description of the Exception */ public Set queryNames(ObjectName objectname, QueryExp queryexp) throws RemoteException; /** * Gets the registered attribute of the Management object * * @param objectname Description of the Parameter * @return The registered value * @exception RemoteException Description of the Exception */ public boolean isRegistered(ObjectName objectname) throws RemoteException; /** * Gets the mBeanCount attribute of the Management object * * @return The mBeanCount value * @exception RemoteException Description of the Exception */ public Integer getMBeanCount() throws RemoteException; /** * Gets the mBeanInfo attribute of the Management object * * @param objectname Description of the Parameter * @return The mBeanInfo value * @exception IntrospectionException Description of the Exception * @exception InstanceNotFoundException Description of the Exception * @exception ReflectionException Description of the Exception * @exception RemoteException Description of the Exception */ public MBeanInfo getMBeanInfo(ObjectName objectname) throws IntrospectionException, InstanceNotFoundException, ReflectionException, RemoteException; /** * Gets the value of a specific attribute of a named managed object. The managed * object is identified by its object name. * * @param objectname Description of the Parameter * @param s Description of the Parameter * @return The attribute value * @exception MBeanException Description of the Exception * @exception AttributeNotFoundException Description of the Exception * @exception InstanceNotFoundException Description of the Exception * @exception ReflectionException Description of the Exception * @exception RemoteException Description of the Exception */ public Object getAttribute(ObjectName objectname, String s) throws MBeanException, AttributeNotFoundException, InstanceNotFoundException, ReflectionException, RemoteException; /** * Gets the attributes attribute of the Management object * * @param objectname Description of the Parameter * @param as Description of the Parameter * @return The attributes value * @exception InstanceNotFoundException Description of the Exception * @exception ReflectionException Description of the Exception * @exception RemoteException Description of the Exception */ public AttributeList getAttributes(ObjectName objectname, String as[]) throws InstanceNotFoundException, ReflectionException, RemoteException; /** * Sets the attribute attribute of the Management object * * @param objectname The new attribute value * @param attribute The new attribute value * @exception InstanceNotFoundException Description of the Exception * @exception AttributeNotFoundException Description of the Exception * @exception InvalidAttributeValueException Description of the Exception * @exception MBeanException Description of the Exception * @exception ReflectionException Description of the Exception * @exception RemoteException Description of the Exception */ public void setAttribute(ObjectName objectname, Attribute attribute) throws InstanceNotFoundException, AttributeNotFoundException, InvalidAttributeValueException, MBeanException, ReflectionException, RemoteException; /** * Sets the attributes attribute of the Management object * * @param objectname The new attributes value * @param attributelist The new attributes value * @return Description of the Return Value * @exception InstanceNotFoundException Description of the Exception * @exception ReflectionException Description of the Exception * @exception RemoteException Description of the Exception */ public AttributeList setAttributes(ObjectName objectname, AttributeList attributelist) throws InstanceNotFoundException, ReflectionException, RemoteException; /** * Description of the Method * * @param objectname Description of the Parameter * @param s Description of the Parameter * @param aobj Description of the Parameter * @param as Description of the Parameter * @return Description of the Return Value * @exception InstanceNotFoundException Description of the Exception * @exception MBeanException Description of the Exception * @exception ReflectionException Description of the Exception * @exception RemoteException Description of the Exception */ public Object invoke(ObjectName objectname, String s, Object aobj[], String as[]) throws InstanceNotFoundException, MBeanException, ReflectionException, RemoteException; /** * Gets the defaultDomain attribute of the Management object * * @return The defaultDomain value * @exception RemoteException Description of the Exception */ public String getDefaultDomain() throws RemoteException; /** * Gets the listenerRegistry attribute of the Management object * * @return The listenerRegistry value * @exception RemoteException Description of the Exception */ public ListenerRegistration getListenerRegistry() throws RemoteException; } --- NEW FILE: ManagementHome.java --- /* * EJTools, the Enterprise Java Tools * * Distributable under LGPL license. * See terms of license at www.gnu.org. */ package javax.management.j2ee; import java.rmi.RemoteException; import javax.ejb.CreateException; import javax.ejb.EJBHome; /** * The required home interface for the Management EJB component. <p> * * The interface may be extended by a proprietary interface to include additional * create methods that take initialization arguments.</p> <p> * * A J2EE client must be able to create a compliant session object using the specified * create method which takes no arguments.</p> * * @author Laurent Etiemble * @version $Revision: 1.1 $ */ public interface ManagementHome extends EJBHome { /** * Creates an MEJB session object which provides access to the J2EE Management * Model. * * @return An session object which implements <code>javax.management.j2ee.Management</code> * . * @exception CreateException indicates a failure to create an EJB Object. * @exception RemoteException a communication exception occurred during the execution * of a remote method call. */ public Management create() throws CreateException, RemoteException; } --- NEW FILE: package.html --- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> <!-- EJTools, the Enterprise Java Tools Distributable under LGPL license. See terms of license at www.gnu.org. $Revision: 1.1 $ --> <html> <head/> <body> Provides MEJB releated classes and interfaces. <p> The J2EE Management EJB component (MEJB) provides interoperable access to the J2EE Management Model from any J2EE component on all platforms that implement the J2EE Management specification. The MEJB component incorporates the Java Management Extensions (JMX) API, a standard framework for Java object instrumentation.</p> <p>The MEJB component exposes the managed objects on any J2EE platform as JMX manageable resources as defined by the Java Management Extensions Instrumentation and Agent Specification (JSR003). The MEJB component provides local and remote access of the platform's manageable resources through the EJB interoperability protocol.</p> <h2>Package Specification</h2> <ul> <li><a href="http://jcp.org/jsr/detail/77.jsp">JSR 77, J2EE Management</a></li> </ul> <h2>Related Documentation</h2> For overviews, tutorials, examples, guides, and tool documentation, please see: <ul> <li><a href="http://java.sun.com/j2ee/tools">J2EE Tools</a></li> </ul> </body> </html> |
