oracle.ifs.fdk

Class FdkException

java.lang.Object

java.lang.Throwable

java.lang.Exception

oracle.ifs.fdk.FdkException

All Implemented Interfaces:

Serializable

public class FdkException
extends Exception
implements Serializable

The exception thrown by the framework.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
FdkException() Constructor required to be a Java Bean.
FdkException(String detailedErrorCode, String errorCode, FdkExceptionEntry[] exceptionEntries, NamedValue[] info, String serverStackTraceId) Constructor for WebLogic web services.

Method Summary

Modifier and Type	Method and Description
String	getDetailedErrorCode() Returns the detailed error code that may provide more information about the error.
String	getErrorCode() Returns the main error code.
FdkExceptionEntry[]	getExceptionEntries() If this is an aggregate exception, it will return the individual entries, otherwise it returns null.
NamedValue[]	getInfo() Returns the optional info for this error.
static FdkException	getInstance(String detailedErrorCode, NamedValue[] info) Constructs a new instance.
static FdkException	getInstance(String detailedErrorCode, Throwable cause, NamedValue[] info) Maps any Throwable to and FdkException, setting the error code explicitly.
static FdkException	getInstance(Throwable cause) Maps any Throwable to an FdkException.
static FdkException	getInstance(Throwable cause, NamedValue[] info) Maps any Throwable to an FdkException.
static FdkException	getInstance(Throwable cause, NamedValue[] info, boolean log) Gives control over what needs to be logged.
String	getServerStackTraceId() Returns the server stack trace ID for this exception.
Map	infoMap() Returns the options info for this error as a map.
void	printLocalizedStackTrace(PrintStream stream) Prints the stack trace of this FdkException to the specified PrintStream.
void	printStackTrace(PrintWriter pw) Prints the stack trace of this FdkException to the specified PrintWriter.
void	setDetailedErrorCode(String errorCode) Always throws a RuntimeException.
void	setErrorCode(String errorCode) Always throws a RuntimeException.
void	setExceptionEntries(FdkExceptionEntry[] entries) Always throws a RuntimeException.
void	setInfo(NamedValue[] info) Always throws a RuntimeException.
void	setServerStackTraceId(String id) Sets the server stack trace ID.
String	toLogString(boolean includeStackTraces) Returns a string representation of this exception.
String	toLogString(boolean includeMainStackTrace, boolean includeEntryStackTraces) Returns a string representation of this exception.
String	toString() Returns a minimal string representation of this exception (ERROR_CODE:DETAILED_ERROR_CODE).

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, setStackTrace

Methods inherited from class java.lang.Object

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

Constructor Detail

FdkException

public FdkException()

Constructor required to be a Java Bean. Do not use it, it will always throw RuntimeException.

Throws:

RuntimeException - Always.

(Unpublished)

FdkException

public FdkException(String detailedErrorCode,
                    String errorCode,
                    FdkExceptionEntry[] exceptionEntries,
                    NamedValue[] info,
                    String serverStackTraceId)

Constructor for WebLogic web services. Do not use it, it will always throw RuntimeException.

Throws:

RuntimeException - Always.

(Unpublished)

Method Detail

getInstance

public static FdkException getInstance(String detailedErrorCode,
                                       NamedValue[] info)

Constructs a new instance.

Parameters:

detailedErrorCode - The detailed error code.

info - The optional info about the error. It can be null.

(Unpublished)

getInstance

public static FdkException getInstance(Throwable cause)

Maps any Throwable to an FdkException. The additional information about the error will automatically be extracted from the cause exception if possible.

Parameters:

cause - The Throwable that occured.

(Unpublished)

getInstance

public static FdkException getInstance(Throwable cause,
                                       NamedValue[] info)

Maps any Throwable to an FdkException. The additional information about the error will automatically be extracted from the cause exception if possible and merged with the provided info in the constructor.

Parameters:

cause - The Throwable that occured.

info - The additional information that should be merged with the info extracted. This information is considered the master, identical entries in the extracted information will be ignored. Can be null.

(Unpublished)

getInstance

public static FdkException getInstance(String detailedErrorCode,
                                       Throwable cause,
                                       NamedValue[] info)

Maps any Throwable to and FdkException, setting the error code explicitly.

Parameters:

detailedErrorCode - The detailed error code.

cause - The exception that was the cause for this exception.

info - The optional info about the error. It can be null.

(Unpublished)

getInstance

public static FdkException getInstance(Throwable cause,
                                       NamedValue[] info,
                                       boolean log)

Gives control over what needs to be logged. Note that this method may still decide to log based on the severity of the error.

Parameters:

cause - The exception that was the cause for this exception.

info - The additional information that should be merged with the info extracted. This information is considered the master, identical entries in the extracted information will be ignored. Can be null.

log - If true the exception will always be logged, otherwise the exception may be logged if the implementation decides the error is important enough to be logged.

(Unpublished)

getErrorCode

public String getErrorCode()

Returns the main error code.

setErrorCode

public void setErrorCode(String errorCode)

Always throws a RuntimeException. Method needs to be here in order for the object to be a Java Bean.

Throws:

RuntimeException - Always.

(Unpublished)

getDetailedErrorCode

public String getDetailedErrorCode()

Returns the detailed error code that may provide more information about the error. If a detailed error code is not available, the same value as the main error code will be returned.

setDetailedErrorCode

public void setDetailedErrorCode(String errorCode)

Always throws a RuntimeException. Method needs to be here in order for the object to be a Java Bean.

Throws:

RuntimeException - Always.

(Unpublished)

getInfo

public NamedValue[] getInfo()

Returns the optional info for this error.

setInfo

public void setInfo(NamedValue[] info)

Always throws a RuntimeException. Method needs to be here in order for the object to be a Java Bean.

Throws:

RuntimeException - Always.

(Unpublished)

infoMap

public Map infoMap()

Returns the options info for this error as a map.

(Unpublished)

getServerStackTraceId

public String getServerStackTraceId()

Returns the server stack trace ID for this exception. This method is useful when invoking the API remotely. For in-process calls the cause exception (if any) is always available by calling getCause().

setServerStackTraceId

public void setServerStackTraceId(String id)

Sets the server stack trace ID. Method needs to be public in order for the object to be a Java Bean. This method should only be called by the logging methods to identify the stack trace in the log file.

(Unpublished)

getExceptionEntries

public FdkExceptionEntry[] getExceptionEntries()

If this is an aggregate exception, it will return the individual entries, otherwise it returns null.

setExceptionEntries

public void setExceptionEntries(FdkExceptionEntry[] entries)

Always throws a RuntimeException. Method needs to be here in order for the object to be a Java Bean.

Throws:

RuntimeException - Always.

(Unpublished)

toLogString

public String toLogString(boolean includeStackTraces)

Returns a string representation of this exception. Logging the result of this method should be guarded by the log level as the string computation is significant.

Parameters:

includeStackTraces - If true a more verbose string will be generated which also includes all the stack traces for the main exception as well as any entries.

(Unpublished)

toLogString

public String toLogString(boolean includeMainStackTrace,
                          boolean includeEntryStackTraces)

Returns a string representation of this exception. Logging the result of this method should be guarded by the log level as the string computation is significant.

Parameters:

includeMainStackTrace - A boolean, true will include all the stack stack traces for the main FdkException.

includeEntryStackTraces - A boolean, true will include all the stack traces for any entries.

(Unpublished)

toString

public String toString()

Returns a minimal string representation of this exception (ERROR_CODE:DETAILED_ERROR_CODE). For a detailed string representation see toLogString()

Overrides:

toString in class Throwable

printStackTrace

public void printStackTrace(PrintWriter pw)

Prints the stack trace of this FdkException to the specified PrintWriter. This provides extra information for debugging.

Overrides:

printStackTrace in class Throwable

Parameters:

pw - The PrintWriter to write to.

printLocalizedStackTrace

public void printLocalizedStackTrace(PrintStream stream)

Prints the stack trace of this FdkException to the specified PrintStream. This provides extra information for debugging.

Parameters:

stream - The PrintStream to write to.

(Unpublished)