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.relation;
27:
28: /**
29: * A RelationSupport object is used internally by the Relation Service to
30: * represent simple relations (only roles, no properties or methods), with an
31: * unlimited number of roles, of any relation type. As internal representation,
32: * it is not exposed to the user.
33: * RelationSupport class conforms to the design patterns of standard MBean. So
34: * the user can decide to instantiate a RelationSupport object himself as a
35: * MBean (as it follows the MBean design patterns), to register it in the
36: * MBean Server, and then to add it in the Relation Service.
37: * The user can also, when creating his own MBean relation class, have it
38: * extending RelationSupport, to retrieve the implementations of required
39: * interfaces (see below).
40: * It is also possible to have in a user relation MBean class a member being a
41: * RelationSupport object, and to implement the required interfaces by
42: * delegating all to this member.
43: * RelationSupport implements the Relation interface (to be handled by the
44: * Relation Service).
45: */
46:
47: public interface RelationSupportMBean extends Relation {
48: /**
49: * Returns an internal flag specifying if the object is still handled by
50: * the Relation Service.
51: */
52: public Boolean isInRelationService();
53:
54: /**
55: * Sets the flag to specify that it is handled or not by the Relation Service
56: * BEWARE, this method has to be exposed as the Relation Service will access
57: * the relation through its management interface. It is RECOMMENDED NOT to
58: * use this method. Using it does not affect the registration of the
59: * relation object in the Relation Service, but will provide wrong
60: * information about it!!!!
61: *
62: * @param theFlg True if the flag is handled by the Relation service otherwise false
63: *
64: * @throws java.lang.IllegalArgumentException - if null parameter
65: */
66: public void setRelationServiceManagementFlag(Boolean theFlg)
67: throws IllegalArgumentException;
68:
69: }
|