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 can be implemented by an MBean in order to carry out operations before
30: * and after being registered or de-registered from the MBean server.
31: */
32: public abstract interface MBeanRegistration {
33: /**
34: * Allows the MBean to perform any operations it needs before being
35: * registered in the MBean server. If the name of the MBean is not
36: * specified, the MBean can provide a name for its registration. If any
37: * exception is raised, the MBean will not be registered in the MBean server.
38: *
39: * @param server The MBean server in which the MBean will be registered.
40: *
41: * @param name The object name of the MBean.
42: *
43: * @return The name of the MBean registered.
44: *
45: * @exception Exception This exception should be caught by the MBean server
46: * and re-thrown as an <CODE>MBeanRegistrationException</CODE>.
47: */
48: public ObjectName preRegister(MBeanServer server, ObjectName name)
49: throws Exception;
50:
51: /**
52: * Allows the MBean to perform any operations needed after having been
53: * registered in the MBean server or after the registration has failed.
54: *
55: * @param registrationDone Indicates whether or not the MBean has been
56: * successfully registered in the MBean server. The value
57: * false means that the registration phase has failed.
58: */
59: public void postRegister(Boolean registrationDone);
60:
61: /**
62: * Allows the MBean to perform any operations it needs before being
63: * de-registered by the MBean server.
64: *
65: * @exception Exception This exception should be caught by the MBean server
66: * and re-thrown as an <CODE>MBeanRegistrationException</CODE>.
67: */
68: public void preDeregister() throws Exception;
69:
70: /**
71: * Allows the MBean to perform any operations needed after having been
72: * de-registered in the MBeanServer.
73: */
74: public void postDeregister();
75: }
|