ExceptionBuilder (TrueZIP Kernel 7.7.2 API)

Type Parameters:
C - the type of the cause exceptions.
X - the type of the assembled exceptions.

All Superinterfaces:

ExceptionHandler<C,X>

All Known Implementing Classes:

AbstractExceptionBuilder, FsSyncExceptionBuilder, SequentialIOExceptionBuilder
```
@NotThreadSafe
public interface ExceptionBuilder<C extends Exception,X extends Exception>
extends ExceptionHandler<C,X>
```
An exception builder is an exception handler which assembles an exception of the parameter type T from one or more exceptions of the parameter type C. This may be used in scenarios where a cooperative algorithm needs to continue its task even if one or more exceptional conditions occur. This interface would then allow to collect all cause exceptions during the processing by calling warn(Exception) and later check out the assembled exception by calling fail(Exception) or check().
TODO: Consider allowing Throwable as type parameters.

Author:

Christian Schlichtherle

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`check()` Either returns or checks out and throws the result of the assembly in order to enable the assembly of another exception.
`X`	`fail(C cause)` Adds the `cause` exception to the assembly and checks out and returns the result in order to enable the assembly of another exception.
`void`	`warn(C cause)` Adds the `cause` exception to the assembly and either returns or checks out and throws the result in order to enable the assembly of another exception.

- Method Detail
  - check
```
void check()
           throws X extends Exception
```
    Either returns or checks out and throws the result of the assembly in order to enable the assembly of another exception.
    
    Throws:
    
    X - the assembled exception if the implementation wants the caller to abort its task.
    
    X extends Exception
  - fail
```
X fail(C cause)
```
    Adds the cause exception to the assembly and checks out and returns the result in order to enable the assembly of another exception.
    Called to handle an exceptional condition which does not allow the caller to proceed its task. The implementation must return an appropriate exception to be thrown by the cooperative algorithm. Finally, if the implementation maintains a state, it must be updated so that this instance can be reused to handle more exceptions!
    
    Specified by:
    
    fail in interface ExceptionHandler<C extends Exception,X extends Exception>
    
    Parameters:
    cause - the exception to handle.
    
    Returns:
    The assembled exception to throw.
  - warn
```
void warn(C cause)
          throws X extends Exception
```
    Adds the cause exception to the assembly and either returns or checks out and throws the result in order to enable the assembly of another exception.
    Called to handle an exceptional condition which does allow the caller to proceed its task. The implementation may throw an exception of the parameter type T or return from the call. If the implementation maintains a state, it must be updated so that this instance can be reused to handle more exceptions.
    
    Specified by:
    
    warn in interface ExceptionHandler<C extends Exception,X extends Exception>
    
    Parameters:
    cause - the exception to handle.
    
    Throws:
    
    X - the assembled exception if the implementation wants the caller to abort its task.
    
    X extends Exception

Interface ExceptionBuilder<C extends Exception,X extends Exception>

Method Summary

Method Detail

check

fail

warn