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: * Can be implemented by an MBean in order to
12: * carry out operations before and after being registered or de-registered from
13: * the MBean server.
14: *
15: * @author <a href="mailto:young_yy@hotmail.org">Young Yang</a>
16: */
17:
18: public interface MBeanRegistration {
19:
20: /**
21: * Allows the MBean to perform any operations it needs before being registered
22: * in the MBean server. If the name of the MBean is not specified, the
23: * MBean can provide a name for its registration. If any exception is
24: * raised, the MBean will not be registered in the MBean server.
25: *
26: * @param server The MBean server in which the MBean will be registered.
27: * @param name The object name of the MBean.
28: *
29: * @return The name of the MBean registered.
30: *
31: * @exception java.lang.Exception This exception should be caught by the MBean server and re-thrown
32: * as an <CODE>MBeanRegistrationException</CODE>.
33: */
34: public ObjectName preRegister(MBeanServer server, ObjectName name)
35: throws java.lang.Exception;
36:
37: /**
38: * Allows the MBean to perform any operations needed after having been
39: * registered in the MBean server or after the registration has failed.
40: *
41: * @param registrationDone Indicates whether or not the MBean has been successfully registered in
42: * the MBean server. The value false means that the registration phase has failed.
43: */
44: public void postRegister(Boolean registrationDone);
45:
46: /**
47: * Allows the MBean to perform any operations it needs before being de-registered
48: * by the MBean server.
49: *
50: * @exception java.lang.Exception This exception should be caught by the MBean server and re-thrown
51: * as an <CODE>MBeanRegistrationException</CODE>.
52: */
53: public void preDeregister() throws Exception;
54:
55: /**
56: * Allows the MBean to perform any operations needed after having been
57: * de-registered in the MBean server.
58: */
59: public void postDeregister();
60:
61: }
|