OSGi™ Service Platform
Core Specification

Release 4 Version 4.3

org.osgi.framework
Class BundleEvent

java.lang.Object
  extended by java.util.EventObject
      extended by org.osgi.framework.BundleEvent
All Implemented Interfaces:
java.io.Serializable

public class BundleEvent
extends java.util.EventObject

An event from the Framework describing a bundle lifecycle change.

BundleEvent objects are delivered to SynchronousBundleListeners and BundleListeners when a change occurs in a bundle's lifecycle. A type code is used to identify the event type for future extendability.

OSGi Alliance reserves the right to extend the set of types.

See Also:
BundleListener, SynchronousBundleListener, Serialized Form
Immutable

Field Summary
static int INSTALLED
          The bundle has been installed.
static int LAZY_ACTIVATION
          The bundle will be lazily activated.
static int RESOLVED
          The bundle has been resolved.
static int STARTED
          The bundle has been started.
static int STARTING
          The bundle is about to be activated.
static int STOPPED
          The bundle has been stopped.
static int STOPPING
          The bundle is about to deactivated.
static int UNINSTALLED
          The bundle has been uninstalled.
static int UNRESOLVED
          The bundle has been unresolved.
static int UPDATED
          The bundle has been updated.
 
Fields inherited from class java.util.EventObject
source
 
Constructor Summary
BundleEvent(int type, Bundle bundle)
          Creates a bundle event of the specified type.
BundleEvent(int type, Bundle bundle, Bundle origin)
          Creates a bundle event of the specified type.
 
Method Summary
 Bundle getBundle()
          Returns the bundle which had a lifecycle change.
 Bundle getOrigin()
          Returns the bundle that was the origin of the event.
 int getType()
          Returns the type of lifecyle event.
 
Methods inherited from class java.util.EventObject
getSource
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

INSTALLED

public static final int INSTALLED
The bundle has been installed.

See Also:
BundleContext.installBundle(String), Constant Field Values

STARTED

public static final int STARTED
The bundle has been started.

The bundle's BundleActivator start method has been executed if the bundle has a bundle activator class.

See Also:
Bundle.start(), Constant Field Values

STOPPED

public static final int STOPPED
The bundle has been stopped.

The bundle's BundleActivator stop method has been executed if the bundle has a bundle activator class.

See Also:
Bundle.stop(), Constant Field Values

UPDATED

public static final int UPDATED
The bundle has been updated.

See Also:
Bundle.update(), Constant Field Values

UNINSTALLED

public static final int UNINSTALLED
The bundle has been uninstalled.

See Also:
Bundle.uninstall(), Constant Field Values

RESOLVED

public static final int RESOLVED
The bundle has been resolved.

Since:
1.3
See Also:
Bundle.RESOLVED, Constant Field Values

UNRESOLVED

public static final int UNRESOLVED
The bundle has been unresolved.

Since:
1.3
See Also:
Bundle.INSTALLED, Constant Field Values

STARTING

public static final int STARTING
The bundle is about to be activated.

The bundle's BundleActivator start method is about to be called if the bundle has a bundle activator class. This event is only delivered to SynchronousBundleListeners. It is not delivered to BundleListeners.

Since:
1.3
See Also:
Bundle.start(), Constant Field Values

STOPPING

public static final int STOPPING
The bundle is about to deactivated.

The bundle's BundleActivator stop method is about to be called if the bundle has a bundle activator class. This event is only delivered to SynchronousBundleListeners. It is not delivered to BundleListeners.

Since:
1.3
See Also:
Bundle.stop(), Constant Field Values

LAZY_ACTIVATION

public static final int LAZY_ACTIVATION
The bundle will be lazily activated.

The bundle has a lazy activation policy and is waiting to be activated. It is now in the STARTING state and has a valid BundleContext. This event is only delivered to SynchronousBundleListeners. It is not delivered to BundleListeners.

Since:
1.4
See Also:
Constant Field Values
Constructor Detail

BundleEvent

public BundleEvent(int type,
                   Bundle bundle,
                   Bundle origin)
Creates a bundle event of the specified type.

Parameters:
type - The event type.
bundle - The bundle which had a lifecycle change.
origin - The bundle which is the origin of the event. For the event type INSTALLED, this is the bundle whose context was used to install the bundle. Otherwise it is the bundle itself.
Since:
1.6

BundleEvent

public BundleEvent(int type,
                   Bundle bundle)
Creates a bundle event of the specified type.

Parameters:
type - The event type.
bundle - The bundle which had a lifecycle change. This bundle is used as the origin of the event.
Method Detail

getBundle

public Bundle getBundle()
Returns the bundle which had a lifecycle change. This bundle is the source of the event.

Returns:
The bundle that had a change occur in its lifecycle.

getType

public int getType()
Returns the type of lifecyle event. The type values are:

Returns:
The type of lifecycle event.

getOrigin

public Bundle getOrigin()
Returns the bundle that was the origin of the event.

For the event type INSTALLED, this is the bundle whose context was used to install the bundle. Otherwise it is the bundle itself.

Returns:
The bundle that was the origin of the event.
Since:
1.6

OSGi™ Service Platform
Core Specification

Release 4 Version 4.3

Copyright © OSGi Alliance (2000, 2012). All Rights Reserved. Licensed under the OSGi Specification License, Version 2.0