org.apache.aries.application.management.spi.runtime
Interface AriesApplicationContextManager

public interface AriesApplicationContextManager

An ApplicationContextManager is responsible for managing Aries applications in the server's OSGi runtime. We expect that many projects consuming this code will provide their own implementation of this service.

Method Summary

AriesApplicationContext	getApplicationContext(AriesApplication app) Obtain an ApplicationContext for an AriesApplication.
Set<AriesApplicationContext>	getApplicationContexts()
void	remove(AriesApplicationContext app) Remove the provided AriesApplicationContext from the running system.
AriesApplicationContext	update(AriesApplication app, DeploymentMetadata oldMetadata) Update the AriesApplication and return an updated application context.

Method Detail

getApplicationContext

AriesApplicationContext getApplicationContext(AriesApplication app)
                                              throws BundleException,
                                                     ManagementException

Obtain an ApplicationContext for an AriesApplication. Applications are stopped and started via an ApplicationContext.

Parameters:

app - The applicaton for which to obtain an ApplicationContext.

Returns:

AriesApplicationContext

Throws:

BundleException

ManagementException

getApplicationContexts

Set<AriesApplicationContext> getApplicationContexts()

Returns:

The set of all AriesApplicationContexts.

update

AriesApplicationContext update(AriesApplication app,
                               DeploymentMetadata oldMetadata)
                               throws UpdateException

Update the AriesApplication and return an updated application context.

Throws:

UpdateException - if the update failed

IllegalArgumentException - if the app is not currently installed

remove

void remove(AriesApplicationContext app)
            throws BundleException

Remove the provided AriesApplicationContext from the running system.

Parameters:

app - the application to remove.

Throws:

BundleException