com.healthmarketscience.jackcess.util

Interface ErrorHandler

All Known Implementing Classes:

DebugErrorHandler, ReplacementErrorHandler

public interface ErrorHandler

Handler for errors encountered while reading a column of row data from a Table. An instance of this class may be configured at the Database, Table, or Cursor level to customize error handling as desired. The default instance used is DEFAULT, which just rethrows any exceptions encountered.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	ErrorHandler.Location Provides location information for an error.

Field Summary

Fields

Modifier and Type	Field and Description
static ErrorHandler	DEFAULT default error handler used if none provided (just rethrows exception)

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.

Field Detail

DEFAULT

static final ErrorHandler DEFAULT

default error handler used if none provided (just rethrows exception)

Method Detail

handleRowError

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

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).

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