org.osgi.framework

Class BundleException

public class BundleException extends Exception

A Framework exception used to indicate that a bundle lifecycle problem occurred.

BundleException object is created by the Framework to denote an exception condition in the lifecycle of a bundle. BundleExceptions should not be created by bundle developers.

This exception is updated to conform to the general purpose exception chaining mechanism.

Version: $Revision: 1.15 $

Constructor Summary
BundleException(String msg, Throwable cause)
Creates a BundleException that wraps another exception.
BundleException(String msg)
Creates a BundleException object with the specified message.
Method Summary
ThrowablegetCause()
Returns the cause of this exception or null if no cause was specified when this exception was created.
ThrowablegetNestedException()
Returns any nested exceptions included in this exception.
ThrowableinitCause(Throwable cause)
The cause of this exception can only be set when constructed.

Constructor Detail

BundleException

public BundleException(String msg, Throwable cause)
Creates a BundleException that wraps another exception.

Parameters: msg The associated message. cause The cause of this exception.

BundleException

public BundleException(String msg)
Creates a BundleException object with the specified message.

Parameters: msg The message.

Method Detail

getCause

public Throwable getCause()
Returns the cause of this exception or null if no cause was specified when this exception was created.

Returns: The cause of this exception or null if no cause was specified.

Since: 1.3

getNestedException

public Throwable getNestedException()
Returns any nested exceptions included in this exception.

This method predates the general purpose exception chaining mechanism. The getCause method is now the preferred means of obtaining this information.

Returns: The nested exception; null if there is no nested exception.

initCause

public Throwable initCause(Throwable cause)
The cause of this exception can only be set when constructed.

Parameters: cause Cause of the exception.

Returns: This object.

Throws: java.lang.IllegalStateException This method will always throw an IllegalStateException since the cause of this exception can only be set when constructed.

Since: 1.3