ej.wadapps.multisandbox.application

Class ApplicationManagerKF

java.lang.Object

ej.wadapps.multisandbox.application.ApplicationManagerKF

All Implemented Interfaces:

FeatureStateListener, ApplicationManager

public class ApplicationManagerKF
extends Object
implements ApplicationManager, FeatureStateListener

Used in a KF environment with perfect matching with KF.

1. Start: the feature is started by KF.
2. Stop: the feature is stopped by KF.

Constructor Summary

Constructors

Constructor and Description
ApplicationManagerKF() Creates an application manager KF with all the installed features.
ApplicationManagerKF(Feature[] features) Creates an application manager KF with the given features.

Method Summary

Modifier and Type	Method and Description
Application	addApplication(Feature feature) Adds an application associated with a feature.
void	addApplicationLifecycleListener(ApplicationLifecycleListener appLifecycleListener) Adds an application lifecycle listener.
boolean	contains(Feature feature) Gets whether a feature is manager by the application manager or not.
protected FeatureApplication	createApplication(Feature feature) Creates an application from the given feature.
Application	getApplication(Feature feature) Gets the application associated with a feature.
Application	getApplication(Module module) Gets the application for a module.
Application[]	getApplications() Gets all available applications.
Feature	getFeature(Application application) Gets the feature associated with the application.
Feature[]	getFeatures() Gets all available features known by this manager.
Application	removeApplication(Feature feature) Removes the application associated with a feature.
void	removeApplicationLifecycleListener(ApplicationLifecycleListener appLifecycleListener) Removes an application lifecycle listener.
void	stateChanged(Feature feature, Feature.State previousState) Called when the state of a Feature has changed.

Methods inherited from class java.lang.Object

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

Constructor Detail

ApplicationManagerKF

public ApplicationManagerKF()

Creates an application manager KF with all the installed features.

See Also:

Kernel.getAllLoadedFeatures(), ApplicationManagerKF(Feature[])

ApplicationManagerKF

public ApplicationManagerKF(Feature[] features)

Creates an application manager KF with the given features.

For each feature, an application will be created and available in getApplications().

Parameters:

features - the feature to manage.

Method Detail

addApplication

public Application addApplication(Feature feature)

Adds an application associated with a feature.

If the feature is already managed by the application manager, nothing changes.

Parameters:

feature - the feature.

Returns:

the newly created application.

addApplicationLifecycleListener

public void addApplicationLifecycleListener(ApplicationLifecycleListener appLifecycleListener)

Description copied from interface: ApplicationManager

Adds an application lifecycle listener.

It will be notified for each application event: start, stop.

Specified by:

addApplicationLifecycleListener in interface ApplicationManager

Parameters:

appLifecycleListener - the listener to add.

contains

public boolean contains(Feature feature)

Gets whether a feature is manager by the application manager or not.

Parameters:

feature - the feature.

Returns:

true if the feature is managed by this application manager, false otherwise.

createApplication

protected FeatureApplication createApplication(Feature feature)

Creates an application from the given feature.

Parameters:

feature - the feature to manage

Returns:

the application

getApplication

@Nullable
public Application getApplication(Feature feature)

Gets the application associated with a feature.

Parameters:

feature - the feature.

Returns:

the application, or null if no application matches the given feature.

getApplication

@Nullable
public Application getApplication(Module module)

Gets the application for a module.

If the given module is the kernel, the method returns null.

Parameters:

module - the module.

Returns:

the application matching the module or null.

See Also:

getApplication(Feature)

getApplications

public Application[] getApplications()

Description copied from interface: ApplicationManager

Gets all available applications.

If there is no application, this method returns an empty array.

Specified by:

getApplications in interface ApplicationManager

Returns:

all available applications.

getFeature

@Nullable
public Feature getFeature(Application application)

Gets the feature associated with the application.

Parameters:

application - the application.

Returns:

the feature, or null if no feature is associated to the given application.

getFeatures

public Feature[] getFeatures()

Gets all available features known by this manager.

If there is none, this method returns an empty array.

Returns:

all available feature.

removeApplication

@Nullable
public Application removeApplication(Feature feature)

Removes the application associated with a feature.

If the feature is not managed by the application manager, nothing changes and null is returned.

Parameters:

feature - the feature.

Returns:

the application associated to the given feature or null if not found.

removeApplicationLifecycleListener

public void removeApplicationLifecycleListener(ApplicationLifecycleListener appLifecycleListener)

Description copied from interface: ApplicationManager

Removes an application lifecycle listener.

If the given listener is not registered, nothing is done.

Specified by:

removeApplicationLifecycleListener in interface ApplicationManager

Parameters:

appLifecycleListener - the listener to remove.

stateChanged

public void stateChanged(@Nullable
                         Feature feature,
                         @Nullable
                         Feature.State previousState)

Description copied from interface: FeatureStateListener

Called when the state of a Feature has changed.

Specified by:

stateChanged in interface FeatureStateListener

Parameters:

feature - the Feature which state has changed

previousState - the previous state, null if Feature state is Feature.State.INSTALLED