ej.kf

Class Feature

java.lang.Object

ej.kf.Module

ej.kf.Feature

public class Feature
extends Module

A Feature represents an optional part of an application that adds new features and services.

A Feature only depends on Kernel code. A Feature is considered as unreliable code from Kernel point of view.

Instances of this class are owned by the Kernel.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Feature.State A Feature state.

Field Summary

Fields

Modifier and Type	Field and Description
static int	MAX_CRITICALITY The maximum criticality that a feature can have.
static int	MIN_CRITICALITY The minimum criticality that a feature can have.
static int	NORM_CRITICALITY The default criticality that is assigned to a feature.

Method Summary

Modifier and Type	Method and Description
Thread[]	getAllAliveThreads() Gets a snapshot of all alive threads owned by this Feature (some threads included in the returned array may have been terminated when this method returns, some new threads may have been created when this method returns).
int	getCriticality() Returns the criticality of this feature.
Feature.State	getState() Returns the current Feature state.
void	setCriticality(int criticality) Sets the criticality of this feature.
void	start() Causes this Feature to start.
void	stop() Causes this Feature to stop.

Methods inherited from class ej.kf.Module

getExecutionCounter, getExecutionQuota, getName, getProvider, getUID, getVersion, setExecutionQuota

Methods inherited from class java.lang.Object

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

Field Detail

MIN_CRITICALITY

public static final int MIN_CRITICALITY

The minimum criticality that a feature can have.

See Also:

getCriticality(), Constant Field Values

NORM_CRITICALITY

public static final int NORM_CRITICALITY

The default criticality that is assigned to a feature.

See Also:

getCriticality(), Constant Field Values

MAX_CRITICALITY

public static final int MAX_CRITICALITY

The maximum criticality that a feature can have.

See Also:

getCriticality(), Constant Field Values

Method Detail

getAllAliveThreads

public Thread[] getAllAliveThreads()

Gets a snapshot of all alive threads owned by this Feature (some threads included in the returned array may have been terminated when this method returns, some new threads may have been created when this method returns).

Returns:

the threads owned by this Feature

Throws:

IllegalStateException - if the Feature is not in the Feature.State.STARTED state

getState

public Feature.State getState()

Returns the current Feature state.

Returns:

this Feature's state.

See Also:

Feature.State

start

public void start()

Causes this Feature to start. A new thread owned by the Feature is created and started. The Feature is switched in the Feature.State.STARTED state and this method returns. Next steps are executed asynchronously within the new thread context:

• Feature clinits are executed
• Entry point is instantiated
• FeatureEntryPoint.start() is called

Throws:

IllegalStateException - if the Feature state is not in Feature.State.INSTALLED state

stop

public void stop()

Causes this Feature to stop. The following steps are executed:

• A new thread owned by the Feature is created and FeatureEntryPoint.stop() is executed.
• Wait until this thread is normally terminated or timeout occurred.
• ej.lang.Resource.reclaim() is called for each resource that remains open by the Feature.
• A DeadFeatureException is thrown in threads that are running Feature code or in threads that want to call Feature code.
• Wait until all threads owned by this Feature are terminated.
• Feature state is set to Feature.State.STOPPED.
• Objects owned by the Feature are reclaimed. If there are no remaining alive objects, the Feature state is set to Feature.State.INSTALLED.

When the new Feature state is Feature.State.INSTALLED, the Feature runtime has been fully reclaimed (threads and objects). Otherwise, the new Feature state is Feature.State.STOPPED and there are some remaining Feature objects references from Kernel.

This method can be called multiple times by the Kernel to reclaim objects again and thus to try to switch the Feature in the Feature.State.INSTALLED state.

When Feature state is set to Feature.State.STOPPED, Kernel application shall remove all its references to objects owned by this Feature, through the calls of FeatureStateListener#stateChanged(Feature, State).

Throws:

IllegalStateException - if the Feature is in the Feature.State.INSTALLED or Feature.State.UNINSTALLED state

getCriticality

public int getCriticality()

Returns the criticality of this feature.

The criticality is used by the system to determine which feature to kill when there is memory pressure. The features with the lowest criticality will be killed first. The features with a criticality set to MAX_CRITICALITY are not killed automatically by the system when there is memory pressure.

The default criticality of a feature is NORM_CRITICALITY.

If this feature is in Feature.State.UNINSTALLED state, this method returns NORM_CRITICALITY.

Returns:

the criticality.

Throws:

IllegalStateException - if this feature is in Feature.State.UNINSTALLED state.

setCriticality

public void setCriticality(int criticality)

Sets the criticality of this feature.

Parameters:

criticality - the new criticality of this feature.

Throws:

IllegalArgumentException - If the criticality is not in the range MIN_CRITICALITY to MAX_CRITICALITY.

See Also:

getCriticality()