org.dbunit.assertion
Class DefaultFailureHandler

java.lang.Object
  org.dbunit.assertion.DefaultFailureHandler

All Implemented Interfaces:

DifferenceListener, FailureFactory, FailureHandler

Direct Known Subclasses:

DiffCollectingFailureHandler

public class DefaultFailureHandler
extends java.lang.Object
implements FailureHandler

Default implementation of the FailureHandler.

Since:

2.4.0

Version:

$Revision: 872 $ $Date: 2008-11-08 16:45:52 +0100 (sab, 08 nov 2008) $

Author:

gommma (gommma AT users.sourceforge.net), Last changed by: $Author: gommma $

Nested Class Summary

static class

DefaultFailureHandler.DefaultFailureFactory Default failure factory which returns DBUnits own assertion error instances.

Constructor Summary

DefaultFailureHandler()
Default constructor which does not provide any additional column information.

DefaultFailureHandler(Column[] additionalColumnInfo)
Create a default failure handler

DefaultFailureHandler(java.lang.String[] additionalColumnInfo)
Create a default failure handler

Method Summary

protected java.lang.String	buildMessage(Difference diff)
java.lang.Error	createFailure(java.lang.String message)
java.lang.Error	createFailure(java.lang.String message, java.lang.String expected, java.lang.String actual) Creates a new failure object which can have different types, depending on the testing framework you are currently using (e.g.
java.lang.String	getAdditionalInfo(ITable expectedTable, ITable actualTable, int row, java.lang.String columnName) Returns a string to be appended to the assertion failure message.
void	handle(Difference diff) Is invoked by the DbUnitAssert when a data cell difference has been found.
void	setFailureFactory(FailureFactory failureFactory)
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultFailureHandler

public DefaultFailureHandler()

Default constructor which does not provide any additional column information.

DefaultFailureHandler

public DefaultFailureHandler(Column[] additionalColumnInfo)

Create a default failure handler

Parameters:

additionalColumnInfo - the column names of the columns for which additional information should be printed when an assertion failed.

DefaultFailureHandler

public DefaultFailureHandler(java.lang.String[] additionalColumnInfo)

Create a default failure handler

Parameters:

additionalColumnInfo - the column names of the columns for which additional information should be printed when an assertion failed.

Method Detail

setFailureFactory

public void setFailureFactory(FailureFactory failureFactory)

Parameters:

failureFactory - The DefaultFailureHandler.DefaultFailureFactory to be used for creating assertion errors.

createFailure

public java.lang.Error createFailure(java.lang.String message,
                                     java.lang.String expected,
                                     java.lang.String actual)

Description copied from interface: FailureFactory

Creates a new failure object which can have different types, depending on the testing framework you are currently using (e.g. JUnit, TestNG, ...)

Specified by:

createFailure in interface FailureFactory

Parameters:

message - The reason for the failure

expected - The expected result

actual - The actual result

Returns:

The comparison failure object for this handler (can be JUnit or some other) which can be thrown on an assertion failure

createFailure

public java.lang.Error createFailure(java.lang.String message)

Specified by:

createFailure in interface FailureFactory

Parameters:

message - The reason for the failure

Returns:

The assertion failure object for this handler (can be JUnit or some other) which can be thrown on an assertion failure

getAdditionalInfo

public java.lang.String getAdditionalInfo(ITable expectedTable,
                                          ITable actualTable,
                                          int row,
                                          java.lang.String columnName)

Description copied from interface: FailureHandler

Returns a string to be appended to the assertion failure message. Is used to provide some more information about a failure (for example to print out some PK columns for identifying the failed rows in the DB).

Specified by:

getAdditionalInfo in interface FailureHandler

row - The row for which the assertion failed

columnName - The column for which the assertion failed

Returns:

A string that is appended to the assertion failure message

handle

public void handle(Difference diff)

Description copied from interface: DifferenceListener

Is invoked by the DbUnitAssert when a data cell difference has been found.

Specified by:

handle in interface DifferenceListener

Parameters:

diff - The difference that has been found

buildMessage

protected java.lang.String buildMessage(Difference diff)

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object