|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface DeploymentDock
The remote interface to the Deployment Dock.
Method Summary | |
---|---|
java.util.List<Capability> |
getCapabilities()
Returns a list of capabilities of the dock. |
Capability |
getCapability(java.lang.String name)
Returns a capability with the given name. |
java.lang.String |
getName()
Returns the name of the deployment dock. |
java.util.List<ComponentHandle> |
getRunningApplications()
Gets the names of all applications running in this Deployment Dock. |
java.util.List<ComponentHandle> |
getRunningComponents()
Gets the names of all components running in this Deployment Dock. |
ComponentHandle |
instantiateComponent(org.objectweb.dsrg.sofa.deployment.DeploymentDescripton context,
java.lang.String componentInstanceName,
ComponentHandle parent,
java.util.List<org.objectweb.dsrg.sofa.deployment.ConnectorUnitTemplate> cuList)
Instantiates a component with a given name in the given Deployment Plan |
java.lang.Object |
instantiateDynamicComponent(java.lang.String factoryInstanceName,
int dynamicInstanceIndex,
java.lang.String interfaceName,
java.lang.String dynamicID,
java.lang.String appID)
Instantiates a dynamic component from a factory with a given name. |
ComponentHandle |
launchApplication(java.lang.String dpName,
java.lang.String dpVersion)
Launches an application specified by name and version of a Deployment Plan |
ComponentHandle |
launchApplication(java.lang.String dpName,
java.lang.String dpVersion,
java.lang.String dpTag)
Launches an application specified by name and version/tag of a Deployment Plan. |
ComponentHandle |
lookup(java.lang.String componentName)
Gets a reference to a component with a given identifier |
ComponentHandle |
lookup(java.lang.String applicationName,
java.lang.String hierarchicalName)
Gets a reference to a component identified by name of the containing application and hierarchical name of the component. |
void |
notifyDeploymentFailed(java.lang.String appID)
Notifies DeploymentDock that application deplyment failed. |
void |
notifyDeploymentSuccessfull(java.lang.String appID)
Notifies DeploymentDock that the application was succefully deployed. |
void |
removeApplicationComponents(java.lang.String componentID)
|
void |
shutdownApplication(java.lang.String appID)
Shuts down the application identified by the component instance ID. |
void |
startComponent(java.lang.String componentId)
Starts a component on this dock. |
void |
stopComponent(java.lang.String componentId)
Stops component on this dock. |
ComponentHandle |
updateComponent(java.lang.String componentID,
java.lang.String archName,
java.lang.String archVersion)
Updates the component with another implementation. |
Method Detail |
---|
ComponentHandle launchApplication(java.lang.String dpName, java.lang.String dpVersion) throws java.rmi.RemoteException, DeploymentErrorException
dpName
- Name of the Deployment Plan to start withdpVersion
- The version of the Deployment Plan
RemoteException,
- DeploymentErrorException
java.rmi.RemoteException
DeploymentErrorException
ComponentHandle launchApplication(java.lang.String dpName, java.lang.String dpVersion, java.lang.String dpTag) throws java.rmi.RemoteException, DeploymentErrorException
dpName
- Name of the Deployment Plan to start withdpVersion
- The version of the Deployment PlandpTag
- The tag of the Deployment Plan
RemoteException,
- DeploymentErrorException
java.rmi.RemoteException
DeploymentErrorException
void shutdownApplication(java.lang.String appID) throws java.rmi.RemoteException, DeploymentErrorException
appID
- Component instance ID.
java.rmi.RemoteException
- remote exception
DeploymentErrorException
ComponentHandle instantiateComponent(org.objectweb.dsrg.sofa.deployment.DeploymentDescripton context, java.lang.String componentInstanceName, ComponentHandle parent, java.util.List<org.objectweb.dsrg.sofa.deployment.ConnectorUnitTemplate> cuList) throws java.rmi.RemoteException, DeploymentErrorException
context
- Context of the application being deployed. Can be seen as transaction identifier.componentInstanceName
- The hierarchical name of the instance of component to be instantiated as is in the deployment dock.parent
- Reference to parent component (may be null if the component is top-level).cuList
- List of ConnectorUnitTemplate
that should be initialized on this component.
RemoteException,
- IncorrectDeploymentRequestException
java.rmi.RemoteException
DeploymentErrorException
java.lang.Object instantiateDynamicComponent(java.lang.String factoryInstanceName, int dynamicInstanceIndex, java.lang.String interfaceName, java.lang.String dynamicID, java.lang.String appID) throws java.rmi.RemoteException, DeploymentErrorException
factoryInstanceName
- The hierarchical name of the factory of the given componentdynamicInstanceIndex
- Index of the dynamic instance in above mentioned factory's listinterfaceName
- The name of the interface that should be returneddynamicID
- ID of the newly created componentappID
- application ID
java.rmi.RemoteException
- DeploymentErrorException
DeploymentErrorException
ComponentHandle updateComponent(java.lang.String componentID, java.lang.String archName, java.lang.String archVersion) throws java.rmi.RemoteException, DeploymentErrorException
componentID
- ID of the component to be updated.archName
- Architecture of a primitive component to replace running component.archVersion
- Version of the architecture that replaces the component.
ComponentHandle
to the new component instance.
java.rmi.RemoteException
DeploymentErrorException
void startComponent(java.lang.String componentId) throws java.rmi.RemoteException, DeploymentErrorException
componentId
- ID of the component to be started.
RemoteException,
- DeploymentErrorException
java.rmi.RemoteException
DeploymentErrorException
void stopComponent(java.lang.String componentId) throws java.rmi.RemoteException, DeploymentErrorException
componentId
- ID of the component to be stopped.
RemoteException,
- DeploymentErrorException
java.rmi.RemoteException
DeploymentErrorException
void notifyDeploymentSuccessfull(java.lang.String appID) throws java.rmi.RemoteException, DeploymentErrorException
DeploymentDock
that the application was succefully deployed.
appID
- The ID of the application that was deployed.
java.rmi.RemoteException
DeploymentErrorException
void notifyDeploymentFailed(java.lang.String appID) throws java.rmi.RemoteException, DeploymentErrorException
DeploymentDock
that application deplyment failed. The dock
should clean up temporary data.
appID
- The ID of the application that failed.
RemoteException,
- DeploymentErrorException
java.rmi.RemoteException
DeploymentErrorException
void removeApplicationComponents(java.lang.String componentID) throws java.rmi.RemoteException, DeploymentErrorException
componentID
-
java.rmi.RemoteException
DeploymentErrorException
java.util.List<ComponentHandle> getRunningApplications() throws java.rmi.RemoteException, DeploymentErrorException
RemoteException,
- DeploymentErrorException
java.rmi.RemoteException
DeploymentErrorException
java.lang.String getName() throws java.rmi.RemoteException
java.rmi.RemoteException
java.util.List<ComponentHandle> getRunningComponents() throws java.rmi.RemoteException, DeploymentErrorException
RemoteException,
- DeploymentErrorException
java.rmi.RemoteException
DeploymentErrorException
ComponentHandle lookup(java.lang.String componentName) throws java.rmi.RemoteException, DeploymentErrorException
componentName
- Name of the component to get reference to.
RemoteException,
- DeploymentErrorException
java.rmi.RemoteException
DeploymentErrorException
ComponentHandle lookup(java.lang.String applicationName, java.lang.String hierarchicalName) throws java.rmi.RemoteException, DeploymentErrorException
applicationName
- Application ID.hierarchicalName
- Hierarchical name of the component.
java.rmi.RemoteException
DeploymentErrorException
Capability getCapability(java.lang.String name) throws java.rmi.RemoteException, java.lang.IllegalArgumentException
name
- name of the capability
java.rmi.RemoteException
java.lang.IllegalArgumentException
- non existing name of a capabilityjava.util.List<Capability> getCapabilities() throws java.rmi.RemoteException
java.rmi.RemoteException
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |