01: /**
02: * The XMOJO Project 5
03: * Copyright © 2003 XMOJO.org. All rights reserved.
04:
05: * NO WARRANTY
06:
07: * BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR
08: * THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
09: * OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
10: * PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
11: * OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
12: * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
13: * TO THE QUALITY AND PERFORMANCE OF THE LIBRARY IS WITH YOU. SHOULD THE
14: * LIBRARY PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
15: * REPAIR OR CORRECTION.
16:
17: * IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL
18: * ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE
19: * THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
20: * GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
21: * USE OR INABILITY TO USE THE LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF
22: * DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
23: * PARTIES OR A FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE),
24: * EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
25: * SUCH DAMAGES.
26: **/package javax.management;
27:
28: /**
29: * This interface is used to gain access to descriptors of the Descriptor class
30: * which are associated with a JMX component,
31: * i.e. MBean, MBeanInfo, MBeanAttributeInfo, MBeanNotificationInfo,
32: * MBeanOperationInfo, MBeanParameterInfo.
33: * <p>
34: * ModelMBeans make extensive use of this interface in ModelMBeanInfo classes.
35: **/
36: public interface DescriptorAccess {
37: /**
38: * Returns a copy of Descriptor.
39: *
40: * @return Descriptor associated with the component implementing this
41: * interface. Null should never be returned. At a minimum a
42: * default descriptor with the descriptor name and
43: * descriptorType should be returned.
44: */
45: public Descriptor getDescriptor();
46:
47: /**
48: * Sets Descriptor (full replace).
49: *
50: * @param inDescriptor replaces the Descriptor associated with the
51: * component implementing this interface. If the inDescriptor
52: * is invalid for the type of Info object it is being set for,
53: * an exception is thrown. If the inDescriptor is null, then
54: * the Descriptor will revert to its default value which should
55: * contain, at a minimum, the descriptor name and descriptorType.
56: */
57: public void setDescriptor(Descriptor inDescriptor);
58: }
|