org.glassfish.extras.osgicontainer

Class OSGiDeployer

java.lang.Object

org.glassfish.extras.osgicontainer.OSGiDeployer

All Implemented Interfaces:

Deployer<OSGiContainer,OSGiDeployedBundle>

@Service
public class OSGiDeployer
extends Object
implements Deployer<OSGiContainer,OSGiDeployedBundle>

OSGi deployer, takes care of loading and cleaning modules from the OSGi runtime.

Author:

Jerome Dochez, Sanjeeb Sahoo

Constructor Summary

Constructors

Constructor and Description
OSGiDeployer()

Method Summary

Modifier and Type	Method and Description
void	clean(DeploymentContext context) Clean any files and artifacts that were created during the execution of the prepare method.
MetaData	getMetaData() Returns the meta data associated with this Deployer
OSGiDeployedBundle	load(OSGiContainer container, DeploymentContext context) Loads a previously prepared application in its execution environment and return a ContractProvider instance that will identify this environment in future communications with the application's container runtime.
<V> V	loadMetaData(Class<V> type, DeploymentContext context) Loads the meta date associated with the application.
boolean	prepare(DeploymentContext context) Prepares the application bits for running in the application server.
void	unload(OSGiDeployedBundle appContainer, DeploymentContext context) Unload or stop a previously running application identified with the ContractProvider instance.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

OSGiDeployer

public OSGiDeployer()

Method Detail

load

public OSGiDeployedBundle load(OSGiContainer container,
                               DeploymentContext context)

Description copied from interface: Deployer

Loads a previously prepared application in its execution environment and return a ContractProvider instance that will identify this environment in future communications with the application's container runtime.

Specified by:

load in interface Deployer<OSGiContainer,OSGiDeployedBundle>

Parameters:

container - in which the application will reside

context - of the deployment

Returns:

an ApplicationContainer instance identifying the running application

unload

public void unload(OSGiDeployedBundle appContainer,
                   DeploymentContext context)

Description copied from interface: Deployer

Unload or stop a previously running application identified with the ContractProvider instance. The container will be stop upon return from this method.

Specified by:

unload in interface Deployer<OSGiContainer,OSGiDeployedBundle>

Parameters:

appContainer - instance to be stopped

context - of the undeployment

clean

public void clean(DeploymentContext context)

Description copied from interface: Deployer

Clean any files and artifacts that were created during the execution of the prepare method.

Specified by:

clean in interface Deployer<OSGiContainer,OSGiDeployedBundle>

Parameters:

context - deployment context

getMetaData

public MetaData getMetaData()

Description copied from interface: Deployer

Returns the meta data associated with this Deployer

Specified by:

getMetaData in interface Deployer<OSGiContainer,OSGiDeployedBundle>

Returns:

the meta data for this Deployer

loadMetaData

public <V> V loadMetaData(Class<V> type,
                          DeploymentContext context)

Description copied from interface: Deployer

Loads the meta date associated with the application.

Specified by:

loadMetaData in interface Deployer<OSGiContainer,OSGiDeployedBundle>

Parameters:

type - type of meta-data that this deployer has declared providing.

Returns:

the meta-data of type V

prepare

public boolean prepare(DeploymentContext context)

Description copied from interface: Deployer

Prepares the application bits for running in the application server. For certain cases, this is generating non portable artifacts and other application specific tasks. Failure to prepare should throw an exception which will cause the overall deployment to fail.

Specified by:

prepare in interface Deployer<OSGiContainer,OSGiDeployedBundle>

Parameters:

context - of the deployment

Returns:

true if the prepare phase executed successfully