01: /* JFox, the OpenSource J2EE Application Server
02: *
03: * Copyright (C) 2002 huihoo.org
04: * Distributable under GNU LGPL license
05: * See the GNU Lesser General Public License for more details.
06: */
07:
08: package javax.management;
09:
10: /**
11: * This interface is used to gain access to descriptors of the Descriptor class
12: * which are associated with a JMX component, i.e. MBean, MBeanInfo,
13: * MBeanAttributeInfo, MBeanNotificationInfo,
14: * MBeanOperationInfo, MBeanParameterInfo.
15: * <P>
16: * ModelMBeans make extensive use of this interface in ModelMBeanInfo classes.
17: *
18: * @author <a href="mailto:young_yy@hotmail.org">Young Yang</a>
19: */
20:
21: public interface DescriptorAccess {
22: /**
23: * Returns a copy of Descriptor.
24: *
25: * @return Descriptor associated with the component implementing this interface.
26: * Null should never be returned. At a minimum a default descriptor with the
27: * descriptor name and descriptorType should be returned.
28: *
29: */
30: public Descriptor getDescriptor();
31:
32: /**
33: * Sets Descriptor (full replace).
34: *
35: * @param inDescriptor - replaces the Descriptor associated with the
36: * component implementing this interface. If the inDescriptor is invalid for the
37: * type of Info object it is being set for, an exception is thrown. If the
38: * inDescriptor is null, then the Descriptor will revert to its default value
39: * which should contain, at a minimum, the descriptor name and descriptorType.
40: *
41: */
42: public void setDescriptor(Descriptor inDescriptor);
43:
44: }
|