oracle.ifs.fdk
Class FdkExceptionEntry

java.lang.Object
oracle.ifs.fdk.FdkExceptionEntry

All Implemented Interfaces:

java.io.Serializable

public class FdkExceptionEntry

extends java.lang.Object

implements java.io.Serializable

An entry when the exception is an aggregate exception.

Constructor Summary

FdkExceptionEntry()
Constructor required to be a Java Bean.

FdkExceptionEntry(oracle.ifs.ecm.util.AggregateExceptionEntry aee)
Constructor.

Method Summary

java.lang.Throwable	cause() Returns the cause exception of this entry or null if the entry was not caused by another exception.
static FdkExceptionEntry[]	convert(oracle.ifs.common.IfsException ifse) Converts an IfsException into an FdkExceptionEntry[].
java.lang.String	getDetailedErrorCode() Returns the detailed error code that may provide more information about the error.
java.lang.String	getErrorCode() Returns the main error code.
long	getId() Returns the ID of the item for which the error occured.
NamedValue[]	getInfo() Returns additional information about the error or null if no additional information is available.
java.lang.String	getServerStackTraceId() Returns the server stack trace ID for this entry.
java.util.Map	infoMap() Returns additional information about the error or null if no additional information is available.
void	setDetailedErrorCode(java.lang.String errorCode) Always throws a RuntimeException.
void	setErrorCode(java.lang.String errorCode) Always throws a RuntimeException.
void	setId(long id) Always throws a RuntimeException.
void	setInfo(NamedValue[] info) Always throws a RuntimeException.
void	setServerStackTraceId(java.lang.String id) Always throws a RuntimeException.
java.lang.String	toString() Returns a string representation of this entry without the stack trace of the cause exception.
java.lang.String	toStringWithStackTrace() Returns a string representation of this entry with the stack trace of the cause exception, if any.

Methods inherited from class java.lang.Object

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

Constructor Detail

FdkExceptionEntry

public FdkExceptionEntry()

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

Throws:

java.lang.RuntimeException - Always.

FdkExceptionEntry

public FdkExceptionEntry(oracle.ifs.ecm.util.AggregateExceptionEntry aee)

Constructor.

Parameters:

aee - The AggregateExceptionEntry this entry corresponds to.

Method Detail

cause

public java.lang.Throwable cause()

Returns the cause exception of this entry or null if the entry was not caused by another exception.

convert

public static FdkExceptionEntry[] convert(oracle.ifs.common.IfsException ifse)

Converts an IfsException into an FdkExceptionEntry[]. If the IfsException is an aggregate exception, the entries will be mapped and the returned array will most likely have its length > 1. If the IfsException is not an aggregate exception, the returned array will have length exactly 1.

Parameters:

ifse - The IfsException to convert.

getDetailedErrorCode

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

getErrorCode

public java.lang.String getErrorCode()

Returns the main error code.

getId

public long getId()

Returns the ID of the item for which the error occured.

getInfo

public NamedValue[] getInfo()

Returns additional information about the error or null if no additional information is available.

getServerStackTraceId

public java.lang.String getServerStackTraceId()

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

infoMap

public java.util.Map infoMap()

Returns additional information about the error or null if no additional information is available. The result is the same as calling getInfo() except the return type is a Map for convenience.

setDetailedErrorCode

public void setDetailedErrorCode(java.lang.String errorCode)

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

Throws:

java.lang.RuntimeException - Always.

setErrorCode

public void setErrorCode(java.lang.String errorCode)

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

Throws:

java.lang.RuntimeException - Always.

setId

public void setId(long id)

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

Throws:

java.lang.RuntimeException - Always.

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:

java.lang.RuntimeException - Always.

setServerStackTraceId

public void setServerStackTraceId(java.lang.String id)

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

Throws:

java.lang.RuntimeException - Always.

toString

public java.lang.String toString()

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

toStringWithStackTrace

public java.lang.String toStringWithStackTrace()

Returns a string representation of this entry with the stack trace of the cause exception, if any. Logging the result of this method should be guarded by the log level as the string computation is significant.