lumis.portal.deployment
Interface IDeploymentManager

Package class diagram package IDeploymentManager
All Known Implementing Classes:
DeploymentManager

public interface IDeploymentManager

Handles the deployment of portal resources.

All methods in this manager execute in their own transaction.

Since:
4.0.7

Method Summary
 ModuleType detectModuleType(InputStream moduleArchive)
          Detects the module type of an archive, based on its contents.
 IModule distribute(String moduleId, InputStream moduleArchive)
          Distributes a module archive to the portal servers.
 Class<?> getClass(String className)
          Returns the Class object associated with the class or interface with the given string name, within the deployed JAR library modules or the shared level class loader.
 IModule getModule(String moduleId)
          Returns the module with the specified identifier.
 Collection<IModule> getModules(ModuleType moduleType)
          Returns the currently installed modules of the specified type.
 IPortalDeployer getPortalDeployer(DeployConfig deployConfig)
          Deprecated. Since 5.0.0 the use of IPortalDeployer has been deprecated.
 void init()
          Initializes the deployment manager.
 void registerDeployer(IPortalDeployer deployer)
          Deprecated. Since 5.0.0 the use of IPortalDeployer has been deprecated.
 void start(IModule module)
          Starts the execution of a module.
 void stop(IModule module)
          Stops the execution of a module.
 void undeploy(IModule module)
          Undeploys a module from the portal servers.
 boolean unregisterDeployer(IPortalDeployer deployer)
          Deprecated. Since 5.0.0 the use of IPortalDeployer has been deprecated.
 

Method Detail

registerDeployer

@Deprecated
void registerDeployer(IPortalDeployer deployer)
Deprecated. Since 5.0.0 the use of IPortalDeployer has been deprecated.

Register a deployer that may be used when performing a deployment.

Parameters:
deployer - the deployer.
Since:
4.0.7

unregisterDeployer

@Deprecated
boolean unregisterDeployer(IPortalDeployer deployer)
Deprecated. Since 5.0.0 the use of IPortalDeployer has been deprecated.

Unregisters a deployer that may be used when performing a deployment.

Parameters:
deployer - the deployer.
Returns:
Since:
4.0.7

getPortalDeployer

@Deprecated
IPortalDeployer getPortalDeployer(DeployConfig deployConfig)
                                  throws PortalException
Deprecated. Since 5.0.0 the use of IPortalDeployer has been deprecated.

Returns the deployer to be used to deploy to the portal.

Parameters:
deployConfig - the deployment specification.
Returns:
the deployer.
Throws:
PortalException - if there is no deployer that can handle the specified deployment.
Since:
4.0.7

init

void init()
Initializes the deployment manager. This method initializes the deployed modules and starts the monitoring of deployments.

Since:
5.0.0

getClass

Class<?> getClass(String className)
                  throws ClassNotFoundException
Returns the Class object associated with the class or interface with the given string name, within the deployed JAR library modules or the shared level class loader.

Parameters:
className - the fully qualified name of the desired class.
Returns:
the Class object for the class with the specified name.
Throws:
ClassNotFoundException - if the class cannot be located.
Since:
5.0.0
See Also:
Class#forName(String)}

detectModuleType

ModuleType detectModuleType(InputStream moduleArchive)
                            throws IOException,
                                   IllegalModuleArchiveException,
                                   PortalException
Detects the module type of an archive, based on its contents.

Parameters:
moduleArchive - the archive content input stream.
Returns:
the module type.
Throws:
IOException - if an I/O error occurs.
IllegalModuleArchiveException - if the archive module type could not be recognized.
PortalException
Since:
5.0.0

distribute

IModule distribute(String moduleId,
                   InputStream moduleArchive)
                   throws IOException,
                          IllegalModuleArchiveException,
                          PortalException
Distributes a module archive to the portal servers. This operation validates the archive, generates all container specific classes and interfaces, and moves the resulting archive to all portal server nodes.

Parameters:
moduleId - the identifier for the module being deployed.
moduleArchive - the module archive input stream.
Returns:
the deployed module object.
Throws:
IOException - if an I/O error occurs.
IllegalModuleArchiveException - if the archive module type could not be recognized.
PortalException
Since:
5.0.0

start

void start(IModule module)
           throws PortalException
Starts the execution of a module. If the module is already running it is not affected.

Parameters:
module - the module.
Throws:
PortalException
Since:
5.0.0

stop

void stop(IModule module)
          throws PortalException
Stops the execution of a module. If the module is not running it is not affected.

Parameters:
module - the module.
Throws:
PortalException
Since:
5.0.0

undeploy

void undeploy(IModule module)
              throws PortalException
Undeploys a module from the portal servers.

Parameters:
module - the module to be undeployed.
Throws:
PortalException
Since:
5.0.0

getModules

Collection<IModule> getModules(ModuleType moduleType)
                               throws PortalException
Returns the currently installed modules of the specified type.

Parameters:
moduleType - the module type.
Returns:
the modules.
Throws:
PortalException
Since:
5.0.0

getModule

IModule getModule(String moduleId)
                  throws PortalException
Returns the module with the specified identifier.

Parameters:
moduleId - the module identifier.
Returns:
the module.
Throws:
PortalObjectNotFoundException - if no module with the given identifier was found.
PortalException
Since:
5.0.0


Lumisportal  5.5.0.091130 - Copyright © 2001-2007, Lumis. All Rights Reserved.