com.healthmarketscience.jackcess.util
Class ReplacementErrorHandler

java.lang.Object
  com.healthmarketscience.jackcess.util.ReplacementErrorHandler

All Implemented Interfaces:

ErrorHandler

Direct Known Subclasses:

DebugErrorHandler

public class ReplacementErrorHandler
extends Object
implements ErrorHandler

Simple implementation of an ErrorHandler which always returns the configured object.

Author:

James Ahlborn

Usage:

Intermediate: This class requires moderate API knowledge.

Nested Class Summary

Nested classes/interfaces inherited from interface com.healthmarketscience.jackcess.util.ErrorHandler

ErrorHandler.Location

Field Summary

Fields inherited from interface com.healthmarketscience.jackcess.util.ErrorHandler

DEFAULT

Constructor Summary

ReplacementErrorHandler()
Constructs a ReplacementErrorHandler which replaces all errored values with null.

ReplacementErrorHandler(Object replacement)
Constructs a ReplacementErrorHandler which replaces all errored values with the given Object.

Method Summary

Object

handleRowError(Column column, byte[] columnData, ErrorHandler.Location location, Exception error) Handles an error encountered while reading a column of data from a Table row.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ReplacementErrorHandler

public ReplacementErrorHandler()

Constructs a ReplacementErrorHandler which replaces all errored values with null.

ReplacementErrorHandler

public ReplacementErrorHandler(Object replacement)

Constructs a ReplacementErrorHandler which replaces all errored values with the given Object.

Method Detail

handleRowError

public Object handleRowError(Column column,
                             byte[] columnData,
                             ErrorHandler.Location location,
                             Exception error)
                      throws IOException

Description copied from interface: ErrorHandler

Handles an error encountered while reading a column of data from a Table row. Handler may either throw an exception (which will be propagated back to the caller) or return a replacement for this row's column value (in which case the row will continue to be read normally).

Specified by:

handleRowError in interface ErrorHandler

Parameters:

column - the info for the column being read

columnData - the actual column data for the column being read (which may be null depending on when the exception was thrown during the reading process)

location - the current location of the error

error - the error that was encountered

Returns:

replacement for this row's column

Throws:

IOException