com.ibm.websphere.objectgrid.osgi
Class ServiceUpdateException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          com.ibm.websphere.objectgrid.ObjectGridException
              com.ibm.websphere.objectgrid.osgi.ServiceUpdateException

All Implemented Interfaces:

IObjectGridException, Serializable

public class ServiceUpdateException
extends ObjectGridException

A ServiceUpdateException is thrown if an OSGi service fails to update to a specific service ranking.

The method getServiceName() and getServiceRanking() can be used to get the service name and the service ranking that it fails to update to.

Since:

7.1.1

See Also:

Serialized Form

Constructor Summary

ServiceUpdateException(String serviceName, Integer serviceRanking)
Constructs a new ServiceUpdateException with null as its detail message.

ServiceUpdateException(String serviceName, Integer serviceRanking, String message)
Constructs a new ServiceUpdateException with the specified detail message.

ServiceUpdateException(String serviceName, Integer serviceRanking, String message, Throwable cause)
Constructs a new ServiceUpdateException with the specified detail message and cause.

ServiceUpdateException(String serviceName, Integer serviceRanking, Throwable cause)
Constructs a new ServiceUpdateException with a specified cause.

Method Summary

String	getServiceName()
Integer	getServiceRanking()

Methods inherited from class com.ibm.websphere.objectgrid.ObjectGridException

getCause, initCause

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

ServiceUpdateException

public ServiceUpdateException(String serviceName,
                              Integer serviceRanking)

Constructs a new ServiceUpdateException with null as its detail message. The cause is not initialized, and may subsequently be initialized by a call to the initCause method.

Parameters:

serviceName - the name of the OSGi service that fails to update

serviceRanking - the ranking of the OSGi service that fails to update

See Also:

ObjectGridException.initCause(Throwable)

ServiceUpdateException

public ServiceUpdateException(String serviceName,
                              Integer serviceRanking,
                              String message)

Constructs a new ServiceUpdateException with the specified detail message. The cause is not initialized, and may subsequently be initialized by a call to the initCause method.

Parameters:

serviceName - the name of the OSGi service that fails to update

serviceRanking - the ranking of the OSGi service that fails to update

message - the detail message. The detail message is saved for later retrieval by the getMessage method.

See Also:

ObjectGridException.initCause(Throwable), Throwable.getMessage()

ServiceUpdateException

public ServiceUpdateException(String serviceName,
                              Integer serviceRanking,
                              String message,
                              Throwable cause)

Constructs a new ServiceUpdateException with the specified detail message and cause.

Note that the detail message associated with cause is not automatically incorporated in this ServiceUpdateException's detail message.

Parameters:

serviceName - the name of the OSGi service that fails to update

serviceRanking - the ranking of the OSGi service that fails to update

message - the detail message (which is saved for later retrieval by the getMessage method).

cause - the cause (which is saved for later retrieval by the getCause method). (Anull value is permitted, and indicates that the cause is nonexistent or unknown).

See Also:

ObjectGridException.getCause(), Throwable.getMessage()

ServiceUpdateException

public ServiceUpdateException(String serviceName,
                              Integer serviceRanking,
                              Throwable cause)

Constructs a new ServiceUpdateException with a specified cause. The cause and a detail message of (cause==null ? null : cause.toString()) is used (which typically contains the class and detail message of cause). This constructor is useful for ServiceUpdateExceptions that are little more than wrappers for other throwables.

Parameters:

serviceName - the name of the OSGi service that fails to update

serviceRanking - the ranking of the OSGi service that fails to update

cause - is the exception that caused this exception to be thrown, which is saved for later retrieval by the getCause() method. A null value is permitted and indicates that the cause is nonexistent or is unknown.

See Also:

ObjectGridException.getCause()

Method Detail

getServiceName

public String getServiceName()

Returns:

the name of the service that fails to update

getServiceRanking

public Integer getServiceRanking()

Returns:

the ranking of the service that fails to update