com.sap.netweaver.bc.rf.common.exception

Class ServiceNotAvailableException

java.lang.Object

java.lang.Throwable

java.lang.Exception

com.sap.exception.BaseException

com.sap.netweaver.bc.rf.util.exception.BaseException

com.sap.netweaver.bc.rf.common.exception.RepositoryException

com.sap.netweaver.bc.rf.common.exception.ResourceException

com.sap.netweaver.bc.rf.common.exception.ServiceNotAvailableException

All Implemented Interfaces:

com.sap.exception.IBaseException, Serializable

public class ServiceNotAvailableException
extends ResourceException

Indicates that the repository (the service provided by a method call) is not available at this time but may available later. Examples:
- The repository has a fixed amount of available resources to process a request (e.g. backend connections) and all resources are in use by other threads.
- The repository backend system is overloaded (e.g. a WebDAV Server that reports HTTP Status 503). This exception may be used by a repository implementation as an alternative to blocking the calling thread until enough resources are available to process the request. The caller may use this exception to retry the method call at a later time (see getRetryAfterDate()). Created 14. April 2003

See Also:

Serialized Form

Field Summary

Fields inherited from interface com.sap.exception.IBaseException

audit, defaultLocale

Constructor Summary

Constructors

Modifier	Constructor and Description
	ServiceNotAvailableException(IRid rid, Date retryAfterDate) Constructs a new exception.
	ServiceNotAvailableException(IRid rid, Date retryAfterDate, boolean logExceptionOnCreation) Constructs a new exception.
protected	ServiceNotAvailableException(IRid rid, Date retryAfterDate, ResourceAccessor resourceAccessor, String key) Constructs a new exception.
protected	ServiceNotAvailableException(IRid rid, Date retryAfterDate, ResourceAccessor resourceAccessor, String key, boolean logExceptionOnCreation) Constructs a new exception.
protected	ServiceNotAvailableException(IRid rid, Date retryAfterDate, ResourceAccessor resourceAccessor, String key, Object[] args) Constructs a new exception.
protected	ServiceNotAvailableException(IRid rid, Date retryAfterDate, ResourceAccessor resourceAccessor, String key, Object[] args, boolean logExceptionOnCreation) Constructs a new exception.
protected	ServiceNotAvailableException(IRid rid, Date retryAfterDate, ResourceAccessor resourceAccessor, String key, Object[] args, Throwable rootCause) Constructs a new exception.
protected	ServiceNotAvailableException(IRid rid, Date retryAfterDate, ResourceAccessor resourceAccessor, String key, Object[] args, Throwable rootCause, boolean logExceptionOnCreation) Constructs a new exception.
protected	ServiceNotAvailableException(IRid rid, Date retryAfterDate, ResourceAccessor resourceAccessor, String key, Throwable rootCause) Constructs a new exception.
protected	ServiceNotAvailableException(IRid rid, Date retryAfterDate, ResourceAccessor resourceAccessor, String key, Throwable rootCause, boolean logExceptionOnCreation) Constructs a new exception.
protected	ServiceNotAvailableException(IRid rid, Date retryAfterDate, ResourceMessage message) Constructs a new exception.
protected	ServiceNotAvailableException(IRid rid, Date retryAfterDate, ResourceMessage message, boolean logExceptionOnCreation) Constructs a new exception.
protected	ServiceNotAvailableException(IRid rid, Date retryAfterDate, ResourceMessage message, Throwable rootCause) Constructs a new exception.
protected	ServiceNotAvailableException(IRid rid, Date retryAfterDate, ResourceMessage message, Throwable rootCause, boolean logExceptionOnCreation) Constructs a new exception.
	ServiceNotAvailableException(IRid rid, Date retryAfterDate, String message) Constructs a new exception.
	ServiceNotAvailableException(IRid rid, Date retryAfterDate, String message, boolean logExceptionOnCreation) Constructs a new exception.
	ServiceNotAvailableException(IRid rid, Date retryAfterDate, String message, Object[] args) Constructs a new exception.
	ServiceNotAvailableException(IRid rid, Date retryAfterDate, String message, Object[] args, boolean logExceptionOnCreation) Constructs a new exception.
	ServiceNotAvailableException(IRid rid, Date retryAfterDate, String message, Object[] args, Throwable rootCause) Constructs a new exception.
	ServiceNotAvailableException(IRid rid, Date retryAfterDate, String message, Object[] args, Throwable rootCause, boolean logExceptionOnCreation) Constructs a new exception.
	ServiceNotAvailableException(IRid rid, Date retryAfterDate, String message, Throwable rootCause) Constructs a new exception.
	ServiceNotAvailableException(IRid rid, Date retryAfterDate, String message, Throwable rootCause, boolean logExceptionOnCreation) Constructs a new exception.
	ServiceNotAvailableException(IRid rid, Date retryAfterDate, Throwable rootCause) Constructs a new exception.
	ServiceNotAvailableException(IRid rid, Date retryAfterDate, Throwable rootCause, boolean logExceptionOnCreation) Constructs a new exception.

Method Summary

Modifier and Type	Method and Description
Date	getRetryAfterDate() Returns the time when retries of the operation are recommended.

Methods inherited from class com.sap.netweaver.bc.rf.common.exception.ResourceException

getRID

Methods inherited from class com.sap.exception.BaseException

finallyLocalize, finallyLocalize, finallyLocalize, finallyLocalize, getCause, getLocalizableMessage, getLocalizedMessage, getLocalizedMessage, getLocalizedMessage, getLocalizedMessage, getLogCategory, getLogLocation, getLogSeverity, getMessage, getNestedLocalizedMessage, getNestedLocalizedMessage, getNestedLocalizedMessage, getNestedLocalizedMessage, getNestedStackTraceString, getStackTraceString, getSystemStackTraceString, initCause, log, printStackTrace, printStackTrace, printStackTrace, restoreLogSettings, setLogSettings, trace, trace

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getStackTrace, getSuppressed, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

ServiceNotAvailableException

public ServiceNotAvailableException(IRid rid,
                                    Date retryAfterDate)

Constructs a new exception.

Parameters:

rid - resource id of the resource this exception is associated with (if any)

retryAfterDate - retry interval, can be null (see getRetryAfterDate()).

ServiceNotAvailableException

public ServiceNotAvailableException(IRid rid,
                                    Date retryAfterDate,
                                    boolean logExceptionOnCreation)

Constructs a new exception.

Parameters:

rid - resource id of the resource this exception is associated with (if any)

retryAfterDate - retry interval, can be null (see getRetryAfterDate()).

logExceptionOnCreation - when true log the exception now during its construction

ServiceNotAvailableException

public ServiceNotAvailableException(IRid rid,
                                    Date retryAfterDate,
                                    Throwable rootCause)

Constructs a new exception.

Parameters:

rid - resource id of the resource this exception is associated with (if any)

retryAfterDate - retry interval, can be null (see getRetryAfterDate()).

rootCause - throwable object which caused this exception

ServiceNotAvailableException

public ServiceNotAvailableException(IRid rid,
                                    Date retryAfterDate,
                                    Throwable rootCause,
                                    boolean logExceptionOnCreation)

Constructs a new exception.

Parameters:

rid - resource id of the resource this exception is associated with (if any)

retryAfterDate - retry interval, can be null (see getRetryAfterDate()).

rootCause - throwable object which caused this exception

logExceptionOnCreation - when true log the exception now during its construction

ServiceNotAvailableException

public ServiceNotAvailableException(IRid rid,
                                    Date retryAfterDate,
                                    String message)

Constructs a new exception.

Parameters:

rid - resource id of the resource this exception is associated with (if any)

retryAfterDate - retry interval, can be null (see getRetryAfterDate()).

message - not localized message

ServiceNotAvailableException

public ServiceNotAvailableException(IRid rid,
                                    Date retryAfterDate,
                                    String message,
                                    Object[] args)

Constructs a new exception.

Parameters:

rid - resource id of the resource this exception is associated with (if any)

retryAfterDate - retry interval, can be null (see getRetryAfterDate()).

message - not localized message

args - message arguments inserted by MessageFormat means

ServiceNotAvailableException

public ServiceNotAvailableException(IRid rid,
                                    Date retryAfterDate,
                                    String message,
                                    Throwable rootCause)

Constructs a new exception.

Parameters:

rid - resource id of the resource this exception is associated with (if any)

retryAfterDate - retry interval, can be null (see getRetryAfterDate()).

message - not localized message

rootCause - throwable object which caused this exception

ServiceNotAvailableException

public ServiceNotAvailableException(IRid rid,
                                    Date retryAfterDate,
                                    String message,
                                    Object[] args,
                                    Throwable rootCause)

Constructs a new exception.

Parameters:

rid - resource id of the resource this exception is associated with (if any)

retryAfterDate - retry interval, can be null (see getRetryAfterDate()).

message - not localized message

args - message arguments inserted by MessageFormat means

rootCause - throwable object which caused this exception

ServiceNotAvailableException

public ServiceNotAvailableException(IRid rid,
                                    Date retryAfterDate,
                                    String message,
                                    boolean logExceptionOnCreation)

Constructs a new exception.

Parameters:

rid - resource id of the resource this exception is associated with (if any)

retryAfterDate - retry interval, can be null (see getRetryAfterDate()).

message - not localized message

logExceptionOnCreation - when true log the exception now during its construction

ServiceNotAvailableException

public ServiceNotAvailableException(IRid rid,
                                    Date retryAfterDate,
                                    String message,
                                    Object[] args,
                                    boolean logExceptionOnCreation)

Constructs a new exception.

Parameters:

rid - resource id of the resource this exception is associated with (if any)

retryAfterDate - retry interval, can be null (see getRetryAfterDate()).

message - not localized message

args - message arguments inserted by MessageFormat means

logExceptionOnCreation - when true log the exception now during its construction

ServiceNotAvailableException

public ServiceNotAvailableException(IRid rid,
                                    Date retryAfterDate,
                                    String message,
                                    Throwable rootCause,
                                    boolean logExceptionOnCreation)

Constructs a new exception.

Parameters:

rid - resource id of the resource this exception is associated with (if any)

retryAfterDate - retry interval, can be null (see getRetryAfterDate()).

message - not localized message

rootCause - throwable object which caused this exception

logExceptionOnCreation - when true log the exception now during its construction

ServiceNotAvailableException

public ServiceNotAvailableException(IRid rid,
                                    Date retryAfterDate,
                                    String message,
                                    Object[] args,
                                    Throwable rootCause,
                                    boolean logExceptionOnCreation)

Constructs a new exception.

Parameters:

rid - resource id of the resource this exception is associated with (if any)

retryAfterDate - retry interval, can be null (see getRetryAfterDate()).

message - not localized message

args - message arguments inserted by MessageFormat means

rootCause - throwable object which caused this exception

logExceptionOnCreation - when true log the exception now during its construction

ServiceNotAvailableException

protected ServiceNotAvailableException(IRid rid,
                                       Date retryAfterDate,
                                       ResourceAccessor resourceAccessor,
                                       String key)

Constructs a new exception.

Parameters:

rid - resource id of the resource this exception is associated with (if any)

retryAfterDate - retry interval, can be null (see getRetryAfterDate()).

resourceAccessor - resource accessor

key - resource identifier for localized message

ServiceNotAvailableException

protected ServiceNotAvailableException(IRid rid,
                                       Date retryAfterDate,
                                       ResourceAccessor resourceAccessor,
                                       String key,
                                       Object[] args)

Constructs a new exception.

Parameters:

rid - resource id of the resource this exception is associated with (if any)

retryAfterDate - retry interval, can be null (see getRetryAfterDate()).

resourceAccessor - resource accessor

key - resource identifier for localized message

args - message arguments inserted by MessageFormat means

ServiceNotAvailableException

protected ServiceNotAvailableException(IRid rid,
                                       Date retryAfterDate,
                                       ResourceAccessor resourceAccessor,
                                       String key,
                                       Throwable rootCause)

Constructs a new exception.

Parameters:

rid - resource id of the resource this exception is associated with (if any)

retryAfterDate - retry interval, can be null (see getRetryAfterDate()).

resourceAccessor - resource accessor

key - resource identifier for localized message

rootCause - throwable object which caused this exception

ServiceNotAvailableException

protected ServiceNotAvailableException(IRid rid,
                                       Date retryAfterDate,
                                       ResourceAccessor resourceAccessor,
                                       String key,
                                       Object[] args,
                                       Throwable rootCause)

Constructs a new exception.

Parameters:

rid - resource id of the resource this exception is associated with (if any)

retryAfterDate - retry interval, can be null (see getRetryAfterDate()).

resourceAccessor - resource accessor

key - resource identifier for localized message

args - message arguments inserted by MessageFormat means

rootCause - throwable object which caused this exception

ServiceNotAvailableException

protected ServiceNotAvailableException(IRid rid,
                                       Date retryAfterDate,
                                       ResourceAccessor resourceAccessor,
                                       String key,
                                       boolean logExceptionOnCreation)

Constructs a new exception.

Parameters:

rid - resource id of the resource this exception is associated with (if any)

retryAfterDate - retry interval, can be null (see getRetryAfterDate()).

resourceAccessor - resource accessor

key - resource identifier for localized message

logExceptionOnCreation - when true log the exception now during its construction

ServiceNotAvailableException

protected ServiceNotAvailableException(IRid rid,
                                       Date retryAfterDate,
                                       ResourceAccessor resourceAccessor,
                                       String key,
                                       Object[] args,
                                       boolean logExceptionOnCreation)

Constructs a new exception.

Parameters:

rid - resource id of the resource this exception is associated with (if any)

retryAfterDate - retry interval, can be null (see getRetryAfterDate()).

resourceAccessor - resource accessor

key - resource identifier for localized message

args - message arguments inserted by MessageFormat means

logExceptionOnCreation - when true log the exception now during its construction

ServiceNotAvailableException

protected ServiceNotAvailableException(IRid rid,
                                       Date retryAfterDate,
                                       ResourceAccessor resourceAccessor,
                                       String key,
                                       Throwable rootCause,
                                       boolean logExceptionOnCreation)

Constructs a new exception.

Parameters:

rid - resource id of the resource this exception is associated with (if any)

retryAfterDate - retry interval, can be null (see getRetryAfterDate()).

resourceAccessor - resource accessor

key - resource identifier for localized message

rootCause - throwable object which caused this exception

logExceptionOnCreation - when true log the exception now during its construction

ServiceNotAvailableException

protected ServiceNotAvailableException(IRid rid,
                                       Date retryAfterDate,
                                       ResourceAccessor resourceAccessor,
                                       String key,
                                       Object[] args,
                                       Throwable rootCause,
                                       boolean logExceptionOnCreation)

Constructs a new exception.

Parameters:

rid - resource id of the resource this exception is associated with (if any)

retryAfterDate - retry interval, can be null (see getRetryAfterDate()).

resourceAccessor - resource accessor

key - resource identifier for localized message

args - message arguments inserted by MessageFormat means

rootCause - throwable object which caused this exception

logExceptionOnCreation - when true log the exception now during its construction

ServiceNotAvailableException

protected ServiceNotAvailableException(IRid rid,
                                       Date retryAfterDate,
                                       ResourceMessage message)

Constructs a new exception.

Parameters:

rid - resource id of the resource this exception is associated with (if any)

retryAfterDate - retry interval, can be null (see getRetryAfterDate()).

message - not localized message

ServiceNotAvailableException

protected ServiceNotAvailableException(IRid rid,
                                       Date retryAfterDate,
                                       ResourceMessage message,
                                       Throwable rootCause)

Constructs a new exception.

Parameters:

rid - resource id of the resource this exception is associated with (if any)

retryAfterDate - retry interval, can be null (see getRetryAfterDate()).

message - not localized message

rootCause - throwable object which caused this exception

ServiceNotAvailableException

protected ServiceNotAvailableException(IRid rid,
                                       Date retryAfterDate,
                                       ResourceMessage message,
                                       boolean logExceptionOnCreation)

Constructs a new exception.

Parameters:

rid - resource id of the resource this exception is associated with (if any)

retryAfterDate - retry interval, can be null (see getRetryAfterDate()).

message - not localized message

logExceptionOnCreation - when true log the exception now during its construction

ServiceNotAvailableException

protected ServiceNotAvailableException(IRid rid,
                                       Date retryAfterDate,
                                       ResourceMessage message,
                                       Throwable rootCause,
                                       boolean logExceptionOnCreation)

Constructs a new exception.

Parameters:

rid - resource id of the resource this exception is associated with (if any)

retryAfterDate - retry interval, can be null (see getRetryAfterDate()).

message - not localized message

rootCause - throwable object which caused this exception

logExceptionOnCreation - when true log the exception now during its construction

Method Detail

getRetryAfterDate

public Date getRetryAfterDate()

Returns the time when retries of the operation are recommended. Repeating the operation before this time, will most likely raise this exception again. If the best time for retry is unknown, null is retuned.

Returns:

time of first recommended retry or null if not known