org.osgi.core 6.0.0 · org.osgi.framework.ServiceException

A service exception used to indicate that a service problem occurred.

A ServiceException object is created by the Framework or service implementation to denote an exception condition in the service. A type code is used to identify the exception type for future extendability. Service implementations may also create subclasses of ServiceException. When subclassing, the subclass should set the type to SUBCLASSED to indicate that ServiceException has been subclassed.

This exception conforms to the general purpose exception chaining mechanism.

Field Summary

Modifier and Type	Field and Description
public static final int	ASYNC_ERROR An asynchronous operation was unable to obtain the service.
public static final int	FACTORY_ERROR The service factory produced an invalid service object.
public static final int	FACTORY_EXCEPTION The service factory threw an exception.
public static final int	FACTORY_RECURSION The service factory resulted in a recursive call to itself for the requesting bundle.
public static final int	REMOTE An error occurred invoking a remote service.
pack-priv static final long	serialVersionUID Hides java.lang.RuntimeException.serialVersionUID.
public static final int	SUBCLASSED The exception is a subclass of ServiceException.
private final int	type Type of service exception.
public static final int	UNREGISTERED The service has been unregistered.
public static final int	UNSPECIFIED No exception type is unspecified.

Constructor Summary

Access	Constructor and Description
public	ServiceException(String The associated message. msg, Throwable The cause of this exception. cause) Creates a `ServiceException` with the specified message and exception cause.
public	ServiceException(String The message. msg) Creates a `ServiceException` with the specified message.
public	ServiceException(String The associated message. msg, int The type for this exception. type, Throwable The cause of this exception. cause) Creates a `ServiceException` with the specified message, type and exception cause.
public	ServiceException(String The message. msg, int The type for this exception. type) Creates a `ServiceException` with the specified message and type.

Method Summary

Modifier and Type	Method and Description
public int	Returns: The type of this exception. getType() Returns the type for this exception or `UNSPECIFIED` if the type was unspecified or unknown.

Field Detail

ASYNC_ERROR	back to summary
public static final int ASYNC_ERROR An asynchronous operation was unable to obtain the service. Since 1.8

ASYNC_ERROR

back to summary

public static final int ASYNC_ERROR

An asynchronous operation was unable to obtain the service.

Since: 1.8

FACTORY_ERROR	back to summary
public static final int FACTORY_ERROR The service factory produced an invalid service object.

FACTORY_EXCEPTION	back to summary
public static final int FACTORY_EXCEPTION The service factory threw an exception.

FACTORY_RECURSION	back to summary
public static final int FACTORY_RECURSION The service factory resulted in a recursive call to itself for the requesting bundle. Since 1.6

FACTORY_RECURSION

back to summary

public static final int FACTORY_RECURSION

The service factory resulted in a recursive call to itself for the requesting bundle.

Since: 1.6

REMOTE	back to summary
public static final int REMOTE An error occurred invoking a remote service.

serialVersionUID	back to summary
pack-priv static final long serialVersionUID Hides java.lang.RuntimeException.serialVersionUID.

SUBCLASSED	back to summary
public static final int SUBCLASSED The exception is a subclass of ServiceException. The subclass should be examined for the type of the exception.

type	back to summary
private final int type Type of service exception.

UNREGISTERED	back to summary
public static final int UNREGISTERED The service has been unregistered.

UNSPECIFIED	back to summary
public static final int UNSPECIFIED No exception type is unspecified.

Constructor Detail

ServiceException back to summary

ServiceException	back to summary
public ServiceException(String msg, Throwable cause) Creates a `ServiceException` with the specified message and exception cause. Parameters msg:String The associated message. cause:Throwable The cause of this exception.

public ServiceException(String msg, Throwable cause)

Creates a ServiceException with the specified message and exception cause.

Parameters

msg:String: The associated message.
cause:Throwable: The cause of this exception.

ServiceException back to summary

ServiceException	back to summary
public ServiceException(String msg) Creates a `ServiceException` with the specified message. Parameters msg:String The message.

public ServiceException(String msg)

Creates a ServiceException with the specified message.

Parameters

msg:String: The message.

ServiceException back to summary

ServiceException	back to summary
public ServiceException(String msg, int type, Throwable cause) Creates a `ServiceException` with the specified message, type and exception cause. Parameters msg:String The associated message. type:int The type for this exception. cause:Throwable The cause of this exception.

public ServiceException(String msg, int type, Throwable cause)

Creates a ServiceException with the specified message, type and exception cause.

Parameters

msg:String: The associated message.
type:int: The type for this exception.
cause:Throwable: The cause of this exception.

ServiceException back to summary

ServiceException	back to summary
public ServiceException(String msg, int type) Creates a `ServiceException` with the specified message and type. Parameters msg:String The message. type:int The type for this exception.

public ServiceException(String msg, int type)

Creates a ServiceException with the specified message and type.

Parameters

msg:String: The message.
type:int: The type for this exception.

Method Detail

getType back to summary

getType	back to summary
public int getType() Returns the type for this exception or `UNSPECIFIED` if the type was unspecified or unknown. Returns:int The type of this exception.

public int getType()

Returns the type for this exception or UNSPECIFIED if the type was unspecified or unknown.

Returns:int: The type of this exception.

public Class ServiceException

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail