Constructor Detail

• AbstractExceptionBuilder

  public AbstractExceptionBuilder()

Method Detail

• check

  public final 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.

  Specified by:

  check in interface ExceptionBuilder<C extends Exception,X extends Exception>

  Throws:

  X - the assembled exception if the implementation wants the caller to abort its task.

  X extends Exception

  See Also:

  post(Exception)

• fail

  public final 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 ExceptionBuilder<C extends Exception,X extends Exception>

  Specified by:

  fail in interface ExceptionHandler<C extends Exception,X extends Exception>

  Parameters:

  cause - the exception to handle.

  Returns:

  The assembled exception to throw.

  See Also:

  update(Exception, Exception), post(Exception)

• post

  protected X post(X assembly)

  This method is called to post-process the given result of the assembly after it has been checked out.

  The implementation in the class AbstractExceptionBuilder simply returns the parameter.

  Parameters:

  assembly - The checked out result of the exception assembly.

  Returns:

  The post-processed checked out result of the exception assembly.

• update

  protected abstract X update(C cause,
         @CheckForNull
         X previous)

  This method is called to update the given previous result of the assembly with the given cause.

  Parameters:

  cause - A(nother) cause exception to add to the assembly.

  previous - The previous result of the assembly or null if this is the first call since the creation of this instance or the last assembly has been checked out.

  Returns:

  The assembled exception. null is not permitted.

• warn

  public final 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.

  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.

  Note that the implementation in the class AbstractExceptionBuilder does not throw an exception.

  Specified by:

  warn in interface ExceptionBuilder<C extends Exception,X extends Exception>

  Specified by:

  warn in interface ExceptionHandler<C extends Exception,X extends Exception>

  Parameters:

  cause - the exception to handle.

  See Also:

  update(Exception, Exception)