diff options
author | Andrew Haley <aph@redhat.com> | 2016-09-30 16:24:48 +0000 |
---|---|---|
committer | Andrew Haley <aph@gcc.gnu.org> | 2016-09-30 16:24:48 +0000 |
commit | 07b78716af6a9d7c9fd1e94d9baf94a52c873947 (patch) | |
tree | 3f22b3241c513ad168c8353805614ae1249410f4 /libjava/classpath/javax/management/MBeanServerConnection.java | |
parent | eae993948bae8b788c53772bcb9217c063716f93 (diff) | |
download | gcc-07b78716af6a9d7c9fd1e94d9baf94a52c873947.zip gcc-07b78716af6a9d7c9fd1e94d9baf94a52c873947.tar.gz gcc-07b78716af6a9d7c9fd1e94d9baf94a52c873947.tar.bz2 |
Makefile.def: Remove libjava.
2016-09-30 Andrew Haley <aph@redhat.com>
* Makefile.def: Remove libjava.
* Makefile.tpl: Likewise.
* Makefile.in: Regenerate.
* configure.ac: Likewise.
* configure: Likewise.
* gcc/java: Remove.
* libjava: Likewise.
From-SVN: r240662
Diffstat (limited to 'libjava/classpath/javax/management/MBeanServerConnection.java')
-rw-r--r-- | libjava/classpath/javax/management/MBeanServerConnection.java | 768 |
1 files changed, 0 insertions, 768 deletions
diff --git a/libjava/classpath/javax/management/MBeanServerConnection.java b/libjava/classpath/javax/management/MBeanServerConnection.java deleted file mode 100644 index 9e44b8f..0000000 --- a/libjava/classpath/javax/management/MBeanServerConnection.java +++ /dev/null @@ -1,768 +0,0 @@ -/* MBeanServerConnection.java -- Represents a connection to a management server. - Copyright (C) 2006 Free Software Foundation, Inc. - -This file is part of GNU Classpath. - -GNU Classpath is free software; you can redistribute it and/or modify -it under the terms of the GNU General Public License as published by -the Free Software Foundation; either version 2, or (at your option) -any later version. - -GNU Classpath is distributed in the hope that it will be useful, but -WITHOUT ANY WARRANTY; without even the implied warranty of -MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -General Public License for more details. - -You should have received a copy of the GNU General Public License -along with GNU Classpath; see the file COPYING. If not, write to the -Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA -02110-1301 USA. - -Linking this library statically or dynamically with other modules is -making a combined work based on this library. Thus, the terms and -conditions of the GNU General Public License cover the whole -combination. - -As a special exception, the copyright holders of this library give you -permission to link this library with independent modules to produce an -executable, regardless of the license terms of these independent -modules, and to copy and distribute the resulting executable under -terms of your choice, provided that you also meet, for each linked -independent module, the terms and conditions of the license of that -module. An independent module is a module which is not derived from -or based on this library. If you modify this library, you may extend -this exception to your version of the library, but you are not -obligated to do so. If you do not wish to do so, delete this -exception statement from your version. */ - -package javax.management; - -import java.io.IOException; - -import java.util.Set; - -/** - * This interface represents a communication mechanism which may - * be used to access an MBean server, whether this be local or - * remote. The {@link MBeanServer} interface extends this with - * additional methods that apply only to local servers. - * - * @author Andrew John Hughes (gnu_andrew@member.fsf.org) - * @since 1.5 - */ -public interface MBeanServerConnection -{ - - /** - * Registers the supplied listener with the specified management - * bean. Notifications emitted by the management bean are forwarded - * to the listener via the server, which will convert any MBean - * references in the source to portable {@link ObjectName} - * instances. The notification is otherwise unchanged. - * - * @param name the name of the management bean with which the listener - * should be registered. - * @param listener the listener which will handle notifications from - * the bean. - * @param filter the filter to apply to incoming notifications, or - * <code>null</code> if no filtering should be applied. - * @param passback an object to be passed to the listener when a - * notification is emitted. - * @throws InstanceNotFoundException if the name of the management bean - * could not be resolved. - * @throws IOException if an I/O error occurred in communicating with - * the bean server. - * @see #removeNotificationListener(ObjectName, NotificationListener) - * @see #removeNotificationListener(ObjectName, NotificationListener, - * NotificationFilter, Object) - * @see NotificationBroadcaster#addNotificationListener(NotificationListener, - * NotificationFilter, - * Object) - */ - void addNotificationListener(ObjectName name, NotificationListener listener, - NotificationFilter filter, Object passback) - throws InstanceNotFoundException, IOException; - - /** - * <p> - * Registers the supplied listener with the specified management - * bean. Notifications emitted by the management bean are forwarded - * to the listener via the server, which will convert any MBean - * references in the source to portable {@link ObjectName} - * instances. The notification is otherwise unchanged. - * </p> - * <p> - * The listener that receives notifications will be the one that is - * registered with the given name at the time this method is called. - * Even if it later unregisters and ceases to use that name, it will - * still receive notifications. - * </p> - * - * @param name the name of the management bean with which the listener - * should be registered. - * @param listener the name of the listener which will handle - * notifications from the bean. - * @param filter the filter to apply to incoming notifications, or - * <code>null</code> if no filtering should be applied. - * @param passback an object to be passed to the listener when a - * notification is emitted. - * @throws InstanceNotFoundException if the name of the management bean - * could not be resolved. - * @throws RuntimeOperationsException if the bean associated with the given - * object name is not a - * {@link NotificationListener}. This - * exception wraps an - * {@link IllegalArgumentException}. - * @throws IOException if an I/O error occurred in communicating with - * the bean server. - * @see #removeNotificationListener(ObjectName, NotificationListener) - * @see #removeNotificationListener(ObjectName, NotificationListener, - * NotificationFilter, Object) - * @see NotificationBroadcaster#addNotificationListener(NotificationListener, - * NotificationFilter, - * Object) - */ - void addNotificationListener(ObjectName name, ObjectName listener, - NotificationFilter filter, Object passback) - throws InstanceNotFoundException, RuntimeOperationsException, IOException; - - /** - * <p> - * Instantiates a new instance of the specified management bean - * using the default constructor and registers it with the server - * under the supplied name. The class is loaded using the - * {@link javax.management.loading.ClassLoaderRepository default - * loader repository} of the server. - * </p> - * <p> - * If the name supplied is <code>null</code>, then the bean is - * expected to implement the {@link MBeanRegistration} interface. - * The {@link MBeanRegistration#preRegister preRegister} method - * of this interface will be used to obtain the name in this case. - * </p> - * <p> - * This method is equivalent to calling {@link - * #createMBean(String, ObjectName, Object[], String[]) - * <code>createMBean(className, name, (Object[]) null, - * (String[]) null)</code>} with <code>null</code> parameters - * and signature. - * </p> - * - * @param className the class of the management bean, of which - * an instance should be created. - * @param name the name to register the new bean with. - * @return an {@link ObjectInstance} containing the {@link ObjectName} - * and Java class name of the created instance. - * @throws ReflectionException if an exception occurs in creating - * an instance of the bean. - * @throws InstanceAlreadyExistsException if a matching instance - * already exists. - * @throws MBeanRegistrationException if an exception occurs in - * calling the preRegister - * method. - * @throws MBeanException if the bean's constructor throws an exception. - * @throws NotCompliantMBeanException if the created bean is not - * compliant with the JMX specification. - * @throws RuntimeOperationsException if an {@link IllegalArgumentException} - * is thrown by the server due to a - * <code>null</code> class name or object - * name or if the object name is a pattern. - * @throws IOException if an I/O error occurred in communicating with - * the bean server. - * @see #createMBean(String, ObjectName, Object[], String[]) - */ - ObjectInstance createMBean(String className, ObjectName name) - throws ReflectionException, InstanceAlreadyExistsException, - MBeanRegistrationException, MBeanException, - NotCompliantMBeanException, IOException; - - /** - * <p> - * Instantiates a new instance of the specified management bean - * using the given constructor and registers it with the server - * under the supplied name. The class is loaded using the - * {@link javax.management.loading.ClassLoaderRepository default - * loader repository} of the server. - * </p> - * <p> - * If the name supplied is <code>null</code>, then the bean is - * expected to implement the {@link MBeanRegistration} interface. - * The {@link MBeanRegistration#preRegister preRegister} method - * of this interface will be used to obtain the name in this case. - * </p> - * - * @param className the class of the management bean, of which - * an instance should be created. - * @param name the name to register the new bean with. - * @param params the parameters for the bean's constructor. - * @param sig the signature of the constructor to use. - * @return an {@link ObjectInstance} containing the {@link ObjectName} - * and Java class name of the created instance. - * @throws ReflectionException if an exception occurs in creating - * an instance of the bean. - * @throws InstanceAlreadyExistsException if a matching instance - * already exists. - * @throws MBeanRegistrationException if an exception occurs in - * calling the preRegister - * method. - * @throws MBeanException if the bean's constructor throws an exception. - * @throws NotCompliantMBeanException if the created bean is not - * compliant with the JMX specification. - * @throws RuntimeOperationsException if an {@link IllegalArgumentException} - * is thrown by the server due to a - * <code>null</code> class name or object - * name or if the object name is a pattern. - * @throws IOException if an I/O error occurred in communicating with - * the bean server. - */ - ObjectInstance createMBean(String className, ObjectName name, - Object[] params, String[] sig) - throws ReflectionException, InstanceAlreadyExistsException, - MBeanRegistrationException, MBeanException, - NotCompliantMBeanException, IOException; - - /** - * <p> - * Instantiates a new instance of the specified management bean - * using the default constructor and registers it with the server - * under the supplied name. The class is loaded using the - * given class loader. If this argument is <code>null</code>, - * then the same class loader as was used to load the server - * is used. - * </p> - * <p> - * If the name supplied is <code>null</code>, then the bean is - * expected to implement the {@link MBeanRegistration} interface. - * The {@link MBeanRegistration#preRegister preRegister} method - * of this interface will be used to obtain the name in this case. - * </p> - * <p> - * This method is equivalent to calling {@link - * #createMBean(String, ObjectName, ObjectName, Object[], String) - * <code>createMBean(className, name, loaderName, (Object[]) null, - * (String) null)</code>} with <code>null</code> parameters - * and signature. - * </p> - * - * @param className the class of the management bean, of which - * an instance should be created. - * @param name the name to register the new bean with. - * @param loaderName the name of the class loader. - * @return an {@link ObjectInstance} containing the {@link ObjectName} - * and Java class name of the created instance. - * @throws ReflectionException if an exception occurs in creating - * an instance of the bean. - * @throws InstanceAlreadyExistsException if a matching instance - * already exists. - * @throws MBeanRegistrationException if an exception occurs in - * calling the preRegister - * method. - * @throws MBeanException if the bean's constructor throws an exception. - * @throws NotCompliantMBeanException if the created bean is not - * compliant with the JMX specification. - * @throws InstanceNotFoundException if the specified class loader is not - * registered with the server. - * @throws RuntimeOperationsException if an {@link IllegalArgumentException} - * is thrown by the server due to a - * <code>null</code> class name or object - * name or if the object name is a pattern. - * @throws IOException if an I/O error occurred in communicating with - * the bean server. - * @see #createMBean(String, ObjectName, ObjectName, Object[], String[]) - */ - ObjectInstance createMBean(String className, ObjectName name, - ObjectName loaderName) - throws ReflectionException, InstanceAlreadyExistsException, - MBeanRegistrationException, MBeanException, - NotCompliantMBeanException, InstanceNotFoundException, - IOException; - - /** - * <p> - * Instantiates a new instance of the specified management bean - * using the given constructor and registers it with the server - * under the supplied name. The class is loaded using the - * given class loader. If this argument is <code>null</code>, - * then the same class loader as was used to load the server - * is used. - * </p> - * <p> - * If the name supplied is <code>null</code>, then the bean is - * expected to implement the {@link MBeanRegistration} interface. - * The {@link MBeanRegistration#preRegister preRegister} method - * of this interface will be used to obtain the name in this case. - * </p> - * - * @param className the class of the management bean, of which - * an instance should be created. - * @param name the name to register the new bean with. - * @param loaderName the name of the class loader. - * @param params the parameters for the bean's constructor. - * @param sig the signature of the constructor to use. - * @return an {@link ObjectInstance} containing the {@link ObjectName} - * and Java class name of the created instance. - * @throws ReflectionException if an exception occurs in creating - * an instance of the bean. - * @throws InstanceAlreadyExistsException if a matching instance - * already exists. - * @throws MBeanRegistrationException if an exception occurs in - * calling the preRegister - * method. - * @throws MBeanException if the bean's constructor throws an exception. - * @throws NotCompliantMBeanException if the created bean is not - * compliant with the JMX specification. - * @throws InstanceNotFoundException if the specified class loader is not - * registered with the server. - * @throws RuntimeOperationsException if an {@link IllegalArgumentException} - * is thrown by the server due to a - * <code>null</code> class name or object - * name or if the object name is a pattern. - * @throws IOException if an I/O error occurred in communicating with - * the bean server. - */ - ObjectInstance createMBean(String className, ObjectName name, - ObjectName loaderName, Object[] params, - String[] sig) - throws ReflectionException, InstanceAlreadyExistsException, - MBeanRegistrationException, MBeanException, - NotCompliantMBeanException, InstanceNotFoundException, - IOException; - - /** - * Returns the value of the supplied attribute from the specified - * management bean. - * - * @param bean the bean to retrieve the value from. - * @param name the name of the attribute to retrieve. - * @return the value of the attribute. - * @throws AttributeNotFoundException if the attribute could not be - * accessed from the bean. - * @throws MBeanException if the management bean's accessor throws - * an exception. - * @throws InstanceNotFoundException if the bean can not be found. - * @throws ReflectionException if an exception was thrown in trying - * to invoke the bean's accessor. - * @throws RuntimeOperationsException if an {@link IllegalArgumentException} - * is thrown by the server due to a - * <code>null</code> bean or attribute - * name. - * @throws IOException if an I/O error occurred in communicating with - * the bean server. - * @see DynamicMBean#getAttribute(String) - */ - Object getAttribute(ObjectName bean, String name) - throws MBeanException, AttributeNotFoundException, - InstanceNotFoundException, ReflectionException, - IOException; - - /** - * Returns the values of the named attributes from the specified - * management bean. - * - * @param bean the bean to retrieve the value from. - * @param names the names of the attributes to retrieve. - * @return the values of the attributes. - * @throws InstanceNotFoundException if the bean can not be found. - * @throws ReflectionException if an exception was thrown in trying - * to invoke the bean's accessor. - * @throws RuntimeOperationsException if an {@link IllegalArgumentException} - * is thrown by the server due to a - * <code>null</code> bean or attribute - * name. - * @throws IOException if an I/O error occurred in communicating with - * the bean server. - * @see DynamicMBean#getAttributes(String[]) - */ - AttributeList getAttributes(ObjectName bean, String[] names) - throws InstanceNotFoundException, ReflectionException, - IOException; - - /** - * Returns the default domain this server applies to beans that have - * no specified domain. - * - * @return the default domain. - * @throws IOException if an I/O error occurred in communicating with - * the bean server. - */ - String getDefaultDomain() - throws IOException; - - /** - * Returns an array containing all the domains used by beans registered - * with this server. The ordering of the array is undefined. - * - * @return the list of domains. - * @throws IOException if an I/O error occurred in communicating with - * the bean server. - * @see ObjectName#getDomain() - */ - String[] getDomains() - throws IOException; - - /** - * Returns the number of management beans registered with this server. - * - * @return the number of registered beans. - * @throws IOException if an I/O error occurred in communicating with - * the bean server. - */ - Integer getMBeanCount() - throws IOException; - - /** - * Returns information on the given management bean. - * - * @param name the name of the management bean. - * @return an instance of {@link MBeanInfo} for the bean. - * @throws IntrospectionException if an exception occurs in examining - * the bean. - * @throws InstanceNotFoundException if the bean can not be found. - * @throws ReflectionException if an exception occurs when trying - * to invoke {@link DynamicMBean#getMBeanInfo()} - * on the bean. - * @throws IOException if an I/O error occurred in communicating with - * the bean server. - * @see DynamicMBean#getMBeanInfo() - */ - MBeanInfo getMBeanInfo(ObjectName name) - throws InstanceNotFoundException, IntrospectionException, - ReflectionException, IOException; - - /** - * Returns the {@link ObjectInstance} created for the specified - * management bean on registration. - * - * @param name the name of the bean. - * @return the corresponding {@link ObjectInstance} instance. - * @throws InstanceNotFoundException if the bean can not be found. - * @throws IOException if an I/O error occurred in communicating with - * the bean server. - * @see #createMBean(String, ObjectName) - */ - ObjectInstance getObjectInstance(ObjectName name) - throws InstanceNotFoundException, IOException; - - /** - * Invokes the supplied operation on the specified management - * bean. The class objects specified in the signature are loaded - * using the same class loader as was used for the management bean. - * - * @param bean the management bean whose operation should be invoked. - * @param name the name of the operation to invoke. - * @param params the parameters of the operation. - * @param sig the signature of the operation. - * @return the return value of the method. - * @throws InstanceNotFoundException if the bean can not be found. - * @throws MBeanException if the method invoked throws an exception. - * @throws ReflectionException if an exception is thrown in invoking the - * method. - * @throws IOException if an I/O error occurred in communicating with - * the bean server. - * @see DynamicMBean#invoke(String, Object[], String[]) - */ - Object invoke(ObjectName bean, String name, Object[] params, String[] sig) - throws InstanceNotFoundException, MBeanException, - ReflectionException, IOException; - - /** - * <p> - * Returns true if the specified management bean is an instance - * of the supplied class. - * </p> - * <p> - * A bean, B, is an instance of a class, C, if either of the following - * conditions holds: - * </p> - * <ul> - * <li>The class name in B's {@link MBeanInfo} is equal to the supplied - * name.</li> - * <li>Both the class of B and C were loaded by the same class loader, - * and B is assignable to C.</li> - * </ul> - * - * @param name the name of the management bean. - * @param className the name of the class to test if <code>name</code> is - * an instance of. - * @return true if either B is directly an instance of the named class, - * or B is assignable to the class, given that both it and B's - * current class were loaded using the same class loader. - * @throws InstanceNotFoundException if the bean can not be found. - * @throws IOException if an I/O error occurred in communicating with - * the bean server. - */ - boolean isInstanceOf(ObjectName name, String className) - throws InstanceNotFoundException, IOException; - - /** - * Returns true if the specified management bean is registered with - * the server. - * - * @param name the name of the management bean. - * @return true if the bean is registered. - * @throws RuntimeOperationsException if an {@link IllegalArgumentException} - * is thrown by the server due to a - * <code>null</code> bean name. - * @throws IOException if an I/O error occurred in communicating with - * the bean server. - */ - boolean isRegistered(ObjectName name) - throws IOException; - - /** - * <p> - * Returns a set of {@link ObjectInstance}s matching the specified - * criteria. The full set of beans registered with the server - * are passed through two filters: - * </p> - * <ol> - * <li>Pattern matching is performed using the supplied - * {@link ObjectName}.</li> - * <li>The supplied query expression is applied.</li> - * </ol> - * <p> - * If both the object name and the query expression are <code>null</code>, - * or the object name has no domain and no key properties, - * no filtering will be performed and all beans are returned. - * </p> - * - * @param name an {@link ObjectName} to use as a filter. - * @param query a query expression to apply to each of the beans that match - * the given object name. - * @return a set of {@link ObjectInstance}s matching the filtered beans. - * @throws IOException if an I/O error occurred in communicating with - * the bean server. - */ - Set<ObjectInstance> queryMBeans(ObjectName name, QueryExp query) - throws IOException; - - /** - * <p> - * Returns a set of {@link ObjectName}s matching the specified - * criteria. The full set of beans registered with the server - * are passed through two filters: - * </p> - * <ol> - * <li>Pattern matching is performed using the supplied - * {@link ObjectName}.</li> - * <li>The supplied query expression is applied.</li> - * </ol> - * <p> - * If both the object name and the query expression are <code>null</code>, - * or the object name has no domain and no key properties, - * no filtering will be performed and all beans are returned. - * </p> - * - * @param name an {@link ObjectName} to use as a filter. - * @param query a query expression to apply to each of the beans that match - * the given object name. - * @return a set of {@link ObjectName}s matching the filtered beans. - * @throws IOException if an I/O error occurred in communicating with - * the bean server. - */ - Set<ObjectName> queryNames(ObjectName name, QueryExp query) - throws IOException; - - /** - * Removes the specified listener from the list of recipients - * of notifications from the supplied bean. This includes all - * combinations of filters and passback objects registered for - * this listener. For more specific removal of listeners, see - * {@link #removeNotificationListener(ObjectName, - * NotificationListener,NotificationFilter,Object)} - * - * @param name the name of the management bean from which the - * listener should be removed. - * @param listener the listener to remove. - * @throws InstanceNotFoundException if the bean can not be found. - * @throws ListenerNotFoundException if the specified listener - * is not registered with the bean. - * @throws IOException if an I/O error occurred in communicating with - * the bean server. - * @see #addNotificationListener(NotificationListener, NotificationFilter, - * java.lang.Object) - * @see NotificationBroadcaster#removeNotificationListener(NotificationListener) - */ - void removeNotificationListener(ObjectName name, - NotificationListener listener) - throws InstanceNotFoundException, ListenerNotFoundException, - IOException; - - /** - * Removes the specified listener from the list of recipients - * of notifications from the supplied bean. Only the first instance with - * the supplied filter and passback object is removed. - * <code>null</code> is used as a valid value for these parameters, - * rather than as a way to remove all registration instances for - * the specified listener; for this behaviour instead, see - * {@link #removeNotificationListener(ObjectName, NotificationListener)}. - * - * @param name the name of the management bean from which the - * listener should be removed. - * @param listener the listener to remove. - * @param filter the filter of the listener to remove. - * @param passback the passback object of the listener to remove. - * @throws InstanceNotFoundException if the bean can not be found. - * @throws ListenerNotFoundException if the specified listener - * is not registered with the bean. - * @throws IOException if an I/O error occurred in communicating with - * the bean server. - * @see #addNotificationListener(ObjectName, NotificationListener, - * NotificationFilter, Object) - * @see NotificationEmitter#removeNotificationListener(NotificationListener, - * NotificationFilter, - * Object) - */ - void removeNotificationListener(ObjectName name, - NotificationListener listener, - NotificationFilter filter, - Object passback) - throws InstanceNotFoundException, ListenerNotFoundException, - IOException; - - /** - * Removes the specified listener from the list of recipients - * of notifications from the supplied bean. This includes all - * combinations of filters and passback objects registered for - * this listener. For more specific removal of listeners, see - * {@link #removeNotificationListener(ObjectName, - * ObjectName,NotificationFilter,Object)} - * - * @param name the name of the management bean from which the - * listener should be removed. - * @param listener the name of the listener to remove. - * @throws InstanceNotFoundException if a name doesn't match a registered - * bean. - * @throws ListenerNotFoundException if the specified listener - * is not registered with the bean. - * @throws IOException if an I/O error occurred in communicating with - * the bean server. - * @see #addNotificationListener(NotificationListener, NotificationFilter, - * java.lang.Object) - * @see NotificationBroadcaster#removeNotificationListener(NotificationListener) - */ - void removeNotificationListener(ObjectName name, ObjectName listener) - throws InstanceNotFoundException, ListenerNotFoundException, - IOException; - - /** - * Removes the specified listener from the list of recipients - * of notifications from the supplied bean. Only the first instance with - * the supplied filter and passback object is removed. - * <code>null</code> is used as a valid value for these parameters, - * rather than as a way to remove all registration instances for - * the specified listener; for this behaviour instead, see - * {@link #removeNotificationListener(ObjectName, ObjectName)}. - * - * @param name the name of the management bean from which the - * listener should be removed. - * @param listener the name of the listener to remove. - * @param filter the filter of the listener to remove. - * @param passback the passback object of the listener to remove. - * @throws InstanceNotFoundException if a name doesn't match a registered - * bean. - * @throws ListenerNotFoundException if the specified listener - * is not registered with the bean. - * @throws IOException if an I/O error occurred in communicating with - * the bean server. - * @see #addNotificationListener(ObjectName, NotificationListener, - * NotificationFilter, Object) - * @see NotificationEmitter#removeNotificationListener(NotificationListener, - * NotificationFilter, - * Object) - */ - void removeNotificationListener(ObjectName name, - ObjectName listener, - NotificationFilter filter, - Object passback) - throws InstanceNotFoundException, ListenerNotFoundException, - IOException; - - /** - * Sets the value of the specified attribute of the supplied - * management bean. - * - * @param name the name of the management bean. - * @param attribute the attribute to set. - * @throws InstanceNotFoundException if the bean can not be found. - * @throws AttributeNotFoundException if the attribute does not - * correspond to an attribute - * of the bean. - * @throws InvalidAttributeValueException if the value is invalid - * for this particular - * attribute of the bean. - * @throws MBeanException if setting the attribute causes - * the bean to throw an exception (which - * becomes the cause of this exception). - * @throws ReflectionException if an exception occurred in trying - * to use the reflection interface - * to lookup the attribute. The - * thrown exception is the cause of - * this exception. - * @throws RuntimeOperationsException if an {@link IllegalArgumentException} - * is thrown by the server due to a - * <code>null</code> bean or attribute - * name. - * @throws IOException if an I/O error occurred in communicating with - * the bean server. - * @see #getAttribute(ObjectName, String) - * @see DynamicMBean#setAttribute(Attribute) - */ - void setAttribute(ObjectName name, Attribute attribute) - throws InstanceNotFoundException, AttributeNotFoundException, - InvalidAttributeValueException, MBeanException, - ReflectionException, IOException; - - /** - * Sets the value of each of the specified attributes - * of the supplied management bean to that specified by - * the {@link Attribute} object. The returned list contains - * the attributes that were set and their new values. - * - * @param name the name of the management bean. - * @param attributes the attributes to set. - * @return a list of the changed attributes. - * @throws InstanceNotFoundException if the bean can not be found. - * @throws ReflectionException if an exception occurred in trying - * to use the reflection interface - * to lookup the attribute. The - * thrown exception is the cause of - * this exception. - * @throws RuntimeOperationsException if an {@link IllegalArgumentException} - * is thrown by the server due to a - * <code>null</code> bean or attribute - * list. - * @throws IOException if an I/O error occurred in communicating with - * the bean server. - * @see #getAttributes(ObjectName, String[]) - * @see DynamicMBean#setAttributes(AttributeList) - */ - AttributeList setAttributes(ObjectName name, AttributeList attributes) - throws InstanceNotFoundException, ReflectionException, - IOException; - - /** - * Unregisters the specified management bean. Following this operation, - * the bean instance is no longer accessible from the server via this - * name. Prior to unregistering the bean, the - * {@link MBeanRegistration#preDeregister()} method will be called if - * the bean implements the {@link MBeanRegistration} interface. - * - * @param name the name of the management bean. - * @throws InstanceNotFoundException if the bean can not be found. - * @throws MBeanRegistrationException if an exception occurs in - * calling the preDeregister - * method. - * @throws RuntimeOperationsException if an {@link IllegalArgumentException} - * is thrown by the server due to a - * <code>null</code> bean name or a - * request being made to unregister the - * {@link MBeanServerDelegate} bean. - * @throws IOException if an I/O error occurred in communicating with - * the bean server. - */ - void unregisterMBean(ObjectName name) - throws InstanceNotFoundException, MBeanRegistrationException, - IOException; - -} |