org.ow2.chameleon.core.activators

Class BundleStabilityChecker

java.lang.Object

org.ow2.chameleon.core.services.AbstractStabilityChecker

org.ow2.chameleon.core.activators.BundleStabilityChecker

All Implemented Interfaces:

StabilityChecker

public class BundleStabilityChecker
extends AbstractStabilityChecker

Stability check verifying the bundle state.

It fails if at least one bundle does not reach its final state before a timeout. This timeout is impacted by the "time.factor" system property.

Field Summary

Fields inherited from class org.ow2.chameleon.core.services.AbstractStabilityChecker

STABILITY_ATTEMPTS, STABILITY_GRACE, TIME_FACTOR

Constructor Summary

Constructors

Constructor and Description
BundleStabilityChecker(org.osgi.framework.BundleContext context) Creates a new instance of BundleStabilityChecker.
BundleStabilityChecker(org.osgi.framework.BundleContext context, int max) Creates a new instance of BundleStabilityChecker.

Method Summary

Modifier and Type	Method and Description
StabilityResult	check() Tries to reach the stability criteria checked by the current checker.
static boolean	getBundleStability(org.osgi.framework.BundleContext bc) checks whether or not bundles have reach their 'final' state.
String	getName() Gets the name of the checker.
int	getPriority() Gets the checker priority.

Methods inherited from class org.ow2.chameleon.core.services.AbstractStabilityChecker

getDefaultGracePeriodInMillis, getDefaultNumberOfAttempts, getTimeFactor, grace, grace

Methods inherited from class java.lang.Object

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

Constructor Detail

BundleStabilityChecker

public BundleStabilityChecker(org.osgi.framework.BundleContext context)

Creates a new instance of BundleStabilityChecker. It uses the default number of attempts.

Parameters:

context - the bundle context

BundleStabilityChecker

public BundleStabilityChecker(org.osgi.framework.BundleContext context,
                              int max)

Creates a new instance of BundleStabilityChecker.

Parameters:

context - the bundle context

max - the maximum number of attemps

Method Detail

getName

public String getName()

Gets the name of the checker. This is used to identify failed checks.

Returns:

the checker name, human-friendly.

getPriority

public int getPriority()

Gets the checker priority. Low priorities are executed first.

Returns:

the priority of the checker

check

public StabilityResult check()

Tries to reach the stability criteria checked by the current checker.

Returns:

the stability result

getBundleStability

public static boolean getBundleStability(org.osgi.framework.BundleContext bc)

checks whether or not bundles have reach their 'final' state. The final state depends on the bundle type. For Fragments it's `RESOLVED`, for regular bundle it's `ACTIVE`.

Parameters:

bc - the bundle context

Returns:

true if every bundles have reached its final state.