# Exception chaining

> Mediated Wiki article. Canonical URL: https://mediated.wiki/source/Exception_chaining
> Markdown URL: https://mediated.wiki/source/Exception_chaining.md
> Source: https://en.wikipedia.org/wiki/Exception_chaining
> Source revision: 1023270495
> License: Creative Commons Attribution-ShareAlike 4.0 International (https://creativecommons.org/licenses/by-sa/4.0/)

'''Exception chaining''', or '''exception wrapping''', is an [object-oriented programming](/source/object-oriented_programming) technique of [handling exceptions](/source/exception_handling) by re-throwing a caught exception after wrapping it inside a new exception. The original exception is saved as a property (such as ''cause'') of the new exception. The idea is that a method should throw exceptions defined at the same abstraction level as the method itself, but without discarding information from the lower levels. 

For example, a method to play a movie file might handle exceptions in reading the file by re-throwing them inside an exception of movie playing. The user interface doesn't need to know whether the error occurred during reading chunk of bytes or calling eof(). It needs only the exception message extracted from ''cause''. The user interface layer will have its own set of exceptions. The one interested in ''cause'' can see its [stack trace](/source/stack_trace) during debugging or in proper log.

Throwing the right kind of exceptions is particularly enforced by [checked exceptions](/source/exception_handling) in the [Java programming language](/source/Java_(programming_language)), and starting with language version 1.4 almost all exceptions support chaining.

In runtime engine environments such as Java or .NET there exist tools that attach to the runtime engine and every time that an exception of interest occurs they record debugging information that existed in memory at the time the exception was thrown (stack and heap values). These tools are called Exception Interception and they provide "root-cause" information for exceptions in Java programs that run in production, testing, or development environments. 

== References ==

* {{cite web |last1=Goetz |first1=Brian |date=2001-09-14 |df=mdy |url=https://www.infoworld.com/article/2075601/exceptional-practices--part-2.html |title=Exceptional practices, Part 2 |work=[JavaWorld](/source/JavaWorld) |accessdate=2020-07-19}}
* [https://docs.oracle.com/javase/tutorial/essential/exceptions/chained.html ''Chained exceptions''] - Sun's Java tutorial

Category:Software design patterns

---
Adapted from the Wikipedia article [Exception chaining](https://en.wikipedia.org/wiki/Exception_chaining) by Wikipedia contributors ([contributor history](https://en.wikipedia.org/wiki/Exception_chaining?action=history)). Available under [Creative Commons Attribution-ShareAlike 4.0 International](https://creativecommons.org/licenses/by-sa/4.0/). Changes may have been made.