SequentialIOExceptionBuilder (TrueZIP Kernel 7.7.10 API)

java.lang.Object
- de.schlichtherle.truezip.util.AbstractExceptionBuilder<C,X>
- - de.schlichtherle.truezip.io.SequentialIOExceptionBuilder<C,X>

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

All Implemented Interfaces:

ExceptionBuilder<C,X>, ExceptionHandler<C,X>

Direct Known Subclasses:

FsSyncExceptionBuilder
```
@NotThreadSafe
public class SequentialIOExceptionBuilder<C extends Exception,X extends SequentialIOException>
extends AbstractExceptionBuilder<C,X>
```
Assembles a SequentialIOException from one or more Exceptions by chaining them. When the assembly is thrown or returned later, it is sorted by priority.

Author:

Christian Schlichtherle

Constructor Summary

Constructors
Constructor and Description

SequentialIOExceptionBuilder(Class<C> causeClass, Class<X> assemblyClass)

Constructors
Constructor and Description
`SequentialIOExceptionBuilder(Class<C> causeClass, Class<X> assemblyClass)`

Method Summary

Methods
Modifier and Type	Method and Description
`static SequentialIOExceptionBuilder<Exception,SequentialIOException>`	`create()` Static constructor provided for comforting the most essential use case.
`static <C extends Exception> SequentialIOExceptionBuilder<C,SequentialIOException>`	`create(Class<C> clazz)`
`static <C extends Exception,X extends SequentialIOException> SequentialIOExceptionBuilder<C,X>`	`create(Class<C> cause, Class<X> assembly)`
`protected X`	`post(X assembly)` This method is called to post-process the given result of the assembly after it has been checked out.
`protected X`	`update(C cause, X previous)` Chains the given exceptions and returns the result.

Methods inherited from class de.schlichtherle.truezip.util.AbstractExceptionBuilder
check, fail, warn

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - SequentialIOExceptionBuilder
```
public SequentialIOExceptionBuilder(Class<C> causeClass,
                            Class<X> assemblyClass)
```
- Method Detail
  - create
```
public static SequentialIOExceptionBuilder<Exception,SequentialIOException> create()
```
    Static constructor provided for comforting the most essential use case.
    
    Returns:
    A new sequential I/O exception builder.
  - create
```
public static <C extends Exception> SequentialIOExceptionBuilder<C,SequentialIOException> create(Class<C> clazz)
```
  - create
```
public static <C extends Exception,X extends SequentialIOException> SequentialIOExceptionBuilder<C,X> create(Class<C> cause,
                                                                                             Class<X> assembly)
```
  - post
```
protected final 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.
    Sorts the given exception chain by priority and returns the result.
    
    Overrides:
    
    post in class AbstractExceptionBuilder<C extends Exception,X extends SequentialIOException>
    
    Parameters:
    assembly - The checked out result of the exception assembly.
    
    Returns:
    The post-processed checked out result of the exception assembly.
  - update
```
protected final X update(C cause,
       X previous)
```
    Chains the given exceptions and returns the result.
    
    Specified by:
    
    update in class AbstractExceptionBuilder<C extends Exception,X extends SequentialIOException>
    
    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, never null.
    
    Throws:
    
    IllegalStateException - if cause.SequentialIOException.getPredecessor() is already initialized by a previous call to SequentialIOException.initPredecessor(SequentialIOException).

Class SequentialIOExceptionBuilder<C extends Exception,X extends SequentialIOException>

Constructor Summary

Method Summary

Methods inherited from class de.schlichtherle.truezip.util.AbstractExceptionBuilder

Methods inherited from class java.lang.Object

Constructor Detail

SequentialIOExceptionBuilder

Method Detail

create

create

create

post

update