OSGi™ Service Platform
Release 4 Version 4.1

org.osgi.framework
Class BundleException

java.lang.Object
  extended byjava.lang.Throwable
      extended byjava.lang.Exception
          extended byorg.osgi.framework.BundleException
All Implemented Interfaces:
java.io.Serializable

public class BundleException
extends java.lang.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.

See Also:
Serialized Form

Constructor Summary
BundleException(java.lang.String msg)
          Creates a BundleException object with the specified message.
BundleException(java.lang.String msg, java.lang.Throwable cause)
          Creates a BundleException that wraps another exception.
 
Method Summary
 java.lang.Throwable getCause()
          Returns the cause of this exception or null if no cause was specified when this exception was created.
 java.lang.Throwable getNestedException()
          Returns any nested exceptions included in this exception.
 java.lang.Throwable initCause(java.lang.Throwable cause)
          The cause of this exception can only be set when constructed.
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

BundleException

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

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

BundleException

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

Parameters:
msg - The message.
Method Detail

getNestedException

public java.lang.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.

getCause

public java.lang.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

initCause

public java.lang.Throwable initCause(java.lang.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

OSGi™ Service Platform
Release 4 Version 4.1

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