[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

[<let...@us...>]

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>