Top Description Constructors Methods
com.opencsv.bean.exceptionhandler

public final Class ExceptionHandlerQueue

extends Object
implements CsvExceptionHandler
Class Inheritance
All Implemented Interfaces
com.opencsv.bean.exceptionhandler.CsvExceptionHandler
Imports
com.opencsv.exceptions.CsvException

An exception handler that always queues exceptions raised.
Author
Andrew Rucker Jones
Since
5.2

Constructor Summary

AccessConstructor and Description
public
ExceptionHandlerQueue()

Default Constructor.

Method Summary

Modifier and TypeMethod and Description
public CsvException
handleException(CsvException e)

Implements com.opencsv.bean.exceptionhandler.CsvExceptionHandler.handleException.

Determines how opencsv will handle exceptions that crop up during bean creation or writing.

Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Constructor Detail

ExceptionHandlerQueueback to summary
public ExceptionHandlerQueue()

Default Constructor.

Method Detail

handleExceptionback to summary
public CsvException handleException(CsvException e)

Implements com.opencsv.bean.exceptionhandler.CsvExceptionHandler.handleException.

Doc from com.opencsv.bean.exceptionhandler.CsvExceptionHandler.handleException.

Determines how opencsv will handle exceptions that crop up during bean creation or writing. There are three ways of dealing with an exception:

  1. Ignore the exception. In this case, return null.
  2. Queue the exception. In this case, return either the original exception thrown, or a new exception that meets your needs better.
  3. Halt processing by throwing the exception. In this case, throw the exception or a new exception that meets your needs better.

Please be cautioned: Due to the multi-threaded nature of opencsv's conversion routines, there is no guarantee that the exception thrown, if your chosen error handler throws exceptions, is the error in the input that would have caused the exception to be thrown if the input were processed in strict sequential order. That is, if there are four errors in the input and your error handler queues the first three but throws the fourth, the exception thrown might relate to any of the four errors in the input.

If your exception handler queues a certain number of exceptions before throwing one, opencsv makes a best-faith effort to make sure all of the exceptions marked for queueing are actually available via CsvToBean#getCapturedExceptions() or StatefulBeanToCsv#getCapturedExceptions() after processing, but there are no absolute guarantees.

This method must be thread-safe.

Annotations
@Override