You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
123 lines
3.8 KiB
123 lines
3.8 KiB
/*
|
|
* Copyright (c) 1999, 2003, Oracle and/or its affiliates. All rights reserved.
|
|
* ORACLE PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*/
|
|
|
|
|
|
package javax.management;
|
|
|
|
|
|
/**
|
|
* Defines the methods that should be implemented by
|
|
* a Dynamic MBean (MBean that exposes a dynamic management interface).
|
|
*
|
|
* @since 1.5
|
|
*/
|
|
public interface DynamicMBean {
|
|
|
|
|
|
/**
|
|
* Obtain the value of a specific attribute of the Dynamic MBean.
|
|
*
|
|
* @param attribute The name of the attribute to be retrieved
|
|
*
|
|
* @return The value of the attribute retrieved.
|
|
*
|
|
* @exception AttributeNotFoundException
|
|
* @exception MBeanException Wraps a <CODE>java.lang.Exception</CODE> thrown by the MBean's getter.
|
|
* @exception ReflectionException Wraps a <CODE>java.lang.Exception</CODE> thrown while trying to invoke the getter.
|
|
*
|
|
* @see #setAttribute
|
|
*/
|
|
public Object getAttribute(String attribute) throws AttributeNotFoundException,
|
|
MBeanException, ReflectionException;
|
|
|
|
/**
|
|
* Set the value of a specific attribute of the Dynamic MBean.
|
|
*
|
|
* @param attribute The identification of the attribute to
|
|
* be set and the value it is to be set to.
|
|
*
|
|
* @exception AttributeNotFoundException
|
|
* @exception InvalidAttributeValueException
|
|
* @exception MBeanException Wraps a <CODE>java.lang.Exception</CODE> thrown by the MBean's setter.
|
|
* @exception ReflectionException Wraps a <CODE>java.lang.Exception</CODE> thrown while trying to invoke the MBean's setter.
|
|
*
|
|
* @see #getAttribute
|
|
*/
|
|
public void setAttribute(Attribute attribute) throws AttributeNotFoundException,
|
|
InvalidAttributeValueException, MBeanException, ReflectionException ;
|
|
|
|
/**
|
|
* Get the values of several attributes of the Dynamic MBean.
|
|
*
|
|
* @param attributes A list of the attributes to be retrieved.
|
|
*
|
|
* @return The list of attributes retrieved.
|
|
*
|
|
* @see #setAttributes
|
|
*/
|
|
public AttributeList getAttributes(String[] attributes);
|
|
|
|
/**
|
|
* Sets the values of several attributes of the Dynamic MBean.
|
|
*
|
|
* @param attributes A list of attributes: The identification of the
|
|
* attributes to be set and the values they are to be set to.
|
|
*
|
|
* @return The list of attributes that were set, with their new values.
|
|
*
|
|
* @see #getAttributes
|
|
*/
|
|
public AttributeList setAttributes(AttributeList attributes);
|
|
|
|
/**
|
|
* Allows an action to be invoked on the Dynamic MBean.
|
|
*
|
|
* @param actionName The name of the action to be invoked.
|
|
* @param params An array containing the parameters to be set when the action is
|
|
* invoked.
|
|
* @param signature An array containing the signature of the action. The class objects will
|
|
* be loaded through the same class loader as the one used for loading the
|
|
* MBean on which the action is invoked.
|
|
*
|
|
* @return The object returned by the action, which represents the result of
|
|
* invoking the action on the MBean specified.
|
|
*
|
|
* @exception MBeanException Wraps a <CODE>java.lang.Exception</CODE> thrown by the MBean's invoked method.
|
|
* @exception ReflectionException Wraps a <CODE>java.lang.Exception</CODE> thrown while trying to invoke the method
|
|
*/
|
|
public Object invoke(String actionName, Object params[], String signature[])
|
|
throws MBeanException, ReflectionException ;
|
|
|
|
/**
|
|
* Provides the exposed attributes and actions of the Dynamic MBean using an MBeanInfo object.
|
|
*
|
|
* @return An instance of <CODE>MBeanInfo</CODE> allowing all attributes and actions
|
|
* exposed by this Dynamic MBean to be retrieved.
|
|
*
|
|
*/
|
|
public MBeanInfo getMBeanInfo();
|
|
|
|
}
|