This project provides libraries to make exception handling in applications easier.
You may have encountered the following requirements in your exception handling. This project provides a ready-to-use implementation for them.
| Your Requirement | Implemented by ... |
|---|---|
| We require to track an exception in log files on different systems. A unique identifier should be provided by the logged exception to trace the event through several log files. | Unique Exception Identifier |
| We require a certain structure in our exception codes and want to have a report generated for them by our build system so that developers find documentation for the error codes more easily. | Exception Code maven-exceptioncodes-plugin Screenshot of example report |
| We require that every exception contains the time it has been created (ok, that is pretty easy). | Time |
| We require our exceptions to be I18N capable to be localized for different locales. | Internationalization |
Summarizing, this project addresses the following services commonly required for application, be them standalone or distributed multi-tier enterprise applications:
And visually:
| Topic | Screenshot |
|---|---|
| Stack Trace |  |
| Exception Codes Report |  |
| Workspace |  |
The services (core and i18n) are implemented by different sub projects so that only those services that are relevant are deployed. So, for instance, if you do not need internationalization you simply do not deploy that module.
The core module is the non-optional project that delivers the following services.
The i18n module is optional and provides internationalization support.
The following projects provide integration of the report generator into Maven and Ant as well as a simple command line client.
The maven report plugin generates a Maven report on the exception codes.
The ant task generates a report on the exception codes via Ant.
The command line client generates a report on the exception codes via the command line.