KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > objectweb > petals > jbi > management > service > LifeCycleManagerService


1 package org.objectweb.petals.jbi.management.service;
2
3 import java.util.Map JavaDoc;
4
5 import javax.management.MBeanServer JavaDoc;
6 import javax.management.ObjectName JavaDoc;
7
8 import org.objectweb.petals.jbi.component.lifecycle.ComponentLifeCycle;
9 import org.objectweb.petals.jbi.component.lifecycle.Installer;
10 import org.objectweb.petals.jbi.component.lifecycle.LifeCycleAbstract;
11 import org.objectweb.petals.jbi.component.lifecycle.ServiceAssemblyLifeCycle;
12
13 /**
14  * Manager is the entry point for register and unregister elements in the JMX
15  * environment (elements are JBI binding/engine components and systemServices
16  * components). Related MBeans are created when registering and unregistering
17  * elements.
18  *
19  * <code>Manager</code> owns the JMX management services offered by the JBI
20  * container to administrative clients. Management services are : - AdminService
21  * (referenced in the JMX server as "admin"); - InstallationService (referenced
22  * in the JMX server as "installation"); - DeploymentService (referenced in the
23  * JMX server as "deployment");
24  *
25  * <code>Manager</code> is the central point for accessing the mBeans
26  * associated to the JBI container elements.
27  *
28  * <code>ManagementException</code> exceptions are thrown when problems for
29  * accessing the JMX server occur.
30  *
31  * @author ofabre
32  *
33  */
34 public interface LifeCycleManagerService {
35
36     ObjectName JavaDoc getAdminServiceMBeanName() throws ManagementException;
37
38     /**
39      * Find the {@link LifeCycleAbstract} of a JBI Installable Component by its
40      * unique name.
41      *
42      * @param name
43      * the name of the engine or binding component; must be non-null
44      * and non-empty
45      * @return the {@link LifeCycleAbstract} of the component, or
46      * <code>null</code> if there is no such component with the given
47      * <code>name</code>
48      */
49     ComponentLifeCycle getComponentByName(String JavaDoc name);
50
51     ObjectName JavaDoc getDeploymentServiceMBeanName() throws ManagementException;
52
53     ObjectName JavaDoc getInstallationServiceMBeanName() throws ManagementException;
54
55     ObjectName JavaDoc getInstallerByName(String JavaDoc name);
56
57     MBeanNamesImpl getMBeanNames();
58
59     MBeanServer JavaDoc getMBeanServer();
60
61     ServiceAssemblyLifeCycle getServiceAssemblyByName(String JavaDoc saName);
62
63     Map JavaDoc<ObjectName JavaDoc, ComponentLifeCycle> getBindingCompoLifeCycles();
64
65     Map JavaDoc<ObjectName JavaDoc, ComponentLifeCycle> getEngineCompoLifeCycles();
66
67     Map JavaDoc<ObjectName JavaDoc, Installer> getInstallers();
68
69     Map JavaDoc<String JavaDoc, ServiceAssemblyLifeCycle> getServiceAssemblyLifeCycles();
70
71     Map JavaDoc<ObjectName JavaDoc, LifeCycleAbstract> getSystemServices();
72
73     ObjectName JavaDoc registerBindingComponent(ComponentLifeCycle lifeCycle)
74         throws ManagementException;
75
76     ObjectName JavaDoc registerEngineComponent(ComponentLifeCycle lifeCycle)
77         throws ManagementException;
78
79     ObjectName JavaDoc registerInstaller(Installer installerMBean)
80         throws ManagementException;
81
82     void registerServiceAssembly(String JavaDoc saName,
83         ServiceAssemblyLifeCycle serviceAssemblyLifeCycle);
84
85     void unregisterBindingComponent(ObjectName JavaDoc name) throws ManagementException;
86
87     void unregisterEngineComponent(ObjectName JavaDoc name) throws ManagementException;
88
89     void unregisterInstaller(ObjectName JavaDoc name) throws ManagementException;
90
91     void unregisterServiceAssembly(String JavaDoc saName) throws ManagementException;
92 }
93
Popular Tags