JLib.Exceptions 0.4.3

JLib.Exceptions

Provides a standardized way to create, aggregate and throw exceptions.

ExceptionBuilder Examples

Issues with the current implementation

• The ExceptionBuilder does not have any way to remove children if they have no content - leading to unneccessary memory allocations
  • Solution: The ExceptionBuilder could derive from IDisposable. When disposed, it will freeze and, if empty, remove itself from the parent
• The JLibException and JLibAggregateException sound similar but represent different UseCases:
  • Exception:
    • JLibException: An exception thrown by the JLib itself
    • JLibAggregateException: extended aggregate exception which can be used by everyone, optimized for better readabillity
  • Solutions:
    • Delete the JLibAggregateException and move the utility to an Extension Method
      • Drawback: the ToString has to be overridden manually to get the improved message
    • Rename JlibAggregateException to ExtendedAggregateException
      • Drawback: The name is long and not very descriptive
    • Discard the JLibException as base-class for all exceptions thrown by the JLib
      • Drawback: Exceptions from the JLib can no longer be easily distinguished from other exceptions
        • is this even a reasonable usecase?
• the JLibAggregateException.Message does not behave like the default (containing only the message) but instead contains the whole tree
  • Solutions:
    • move the tree functionality to the ToString method