com.healthmarketscience.jackcess.util

Class DebugErrorHandler

java.lang.Object

com.healthmarketscience.jackcess.util.ReplacementErrorHandler

com.healthmarketscience.jackcess.util.DebugErrorHandler

All Implemented Interfaces:

ErrorHandler

public class DebugErrorHandler
extends ReplacementErrorHandler

Implementation of ErrorHandler which is useful for generating debug information about bad row data (great for bug reports!). After logging a debug entry for the failed column, it will return some sort of replacement value, see ReplacementErrorHandler.

Nested Class Summary

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

ErrorHandler.Location

Field Summary

Fields

Modifier and Type	Field and Description
private static org.apache.commons.logging.Log	LOG

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

DEFAULT

Constructor Summary

Constructors

Constructor and Description
DebugErrorHandler() Constructs a DebugErrorHandler which replaces all errored values with null.
DebugErrorHandler(java.lang.Object replacement) Constructs a DebugErrorHandler which replaces all errored values with the given Object.

Method Summary

Modifier and Type	Method and Description
java.lang.Object	handleRowError(Column column, byte[] columnData, ErrorHandler.Location location, java.lang.Exception error) Handles an error encountered while reading a column of data from a Table row.

Methods inherited from class java.lang.Object

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

Field Detail

LOG

private static final org.apache.commons.logging.Log LOG

Constructor Detail

DebugErrorHandler

public DebugErrorHandler()

Constructs a DebugErrorHandler which replaces all errored values with null.

DebugErrorHandler

public DebugErrorHandler(java.lang.Object replacement)

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

Method Detail

handleRowError

public java.lang.Object handleRowError(Column column,
                                       byte[] columnData,
                                       ErrorHandler.Location location,
                                       java.lang.Exception error)
                                throws java.io.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

Overrides:

handleRowError in class ReplacementErrorHandler

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:

java.io.IOException