Exception
has supported
exception chaining since J2SE 1.4.public class ChainedException
extends java.lang.Exception
ChainedException
exception class is a base Exception type
supporting exceptions which wrap others. An example of this is when
you throw an exception because of a failure in another subsystem.
Typically you should be walking backwards from the top most exception down to the root cause of the failure which initially threw the exception. It could be argued that it should be called the previous exception instead of the next exception, however next was choosen to mimic the behavior of the SQLException class which is familiar to some Java developers.
Example:
try { DriverManager.getConnection(url, props); } catch (SQLException sqlEx) { // This SQLException is the root cause of the failure, and will be at // the bottom of the exception chain. throw new ChainedException (Res.getString(Res.CANNOT_GET_LIST_OF_TABLES, sqlEx); } // Later on in your code where you finally catch this ChainedException catch (ChainException cEx) { Exception ex = cEx; while (ex != null) { ex.printStackTrace(); if (ex instanceof ChainedException) { ex = ex.getNextException(); } else { ex = null; } }
SQLException
,
Exception
,
Serialized FormConstructor and Description |
---|
ChainedException(java.lang.Exception nextException)
Deprecated.
Constructor.
|
ChainedException(java.lang.String msg)
Deprecated.
Constructor.
|
ChainedException(java.lang.String msg,
java.lang.Exception nextException)
Deprecated.
Constructor.
|
Modifier and Type | Method and Description |
---|---|
java.lang.Exception |
getNextException()
Deprecated.
Returns the next Exception in the chain
|
void |
setNextException(java.lang.Exception nextException)
Deprecated.
Sets the next Exception in the chain
|
public ChainedException(java.lang.String msg, java.lang.Exception nextException)
s
- The message of the ExceptionnextException
- the next exception in the chainpublic ChainedException(java.lang.Exception nextException)
nextException
- the next exception in the chainpublic ChainedException(java.lang.String msg)
s
- The message of the Exception