fm.last.commons.test

Class LastAssertions

java.lang.Object

fm.last.commons.test.LastAssertions

public final class LastAssertions
extends Object

Additional test assertions that provide Last.fm specific functionality or additional functionality not found in JUnit.

Field Summary

Fields

Modifier and Type	Field and Description
static String	TEST_DB_SUFFIX Last.fm standard is to name all unit tests with the name of the original database and then this suffix.

Method Summary

Modifier and Type	Method and Description
static void	assertFileEquals(File file1, File file2) Asserts that the *contents* of the passed files are equal.
static void	assertFileEquals(String message, File expectedFile, Charset expectedFileEncoding, File actualFile, Charset actualFileEncoding) Asserts that the *contents* of the passed files are equal.
static void	assertFileEquals(String message, File expectedFile, File actualFile) Asserts that the *contents* of the passed files are equal.
static void	assertFilesEquivalent(File expected, Charset expectedFileEncoding, File actual, Charset actualFileEncoding) Asserts that the contents of the files are equivalent - i.e.
static void	assertFilesEquivalent(File expected, File actual) Asserts that the contents of the files are equivalent - i.e.
static void	assertFilesNotEqual(File expectedFile, File actualFile) Asserts that the *contents* of the passed files are not equal.
static void	assertFilesNotEqual(String message, File file1, File file2) Asserts that the *contents* of the passed files are not equal.
static void	assertTestDatabase(DataSource dataSource) Asserts that the database that the passed DataSource has been configured to use is a unit test database.
static void	assertValues(String expectedValue, Object[] values) Assert that all Objects in the passed array match the expected value.

Methods inherited from class java.lang.Object

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

Field Detail

TEST_DB_SUFFIX

public static final String TEST_DB_SUFFIX

Last.fm standard is to name all unit tests with the name of the original database and then this suffix.

See Also:

Constant Field Values

Method Detail

assertTestDatabase

public static void assertTestDatabase(DataSource dataSource)
                               throws SQLException

Asserts that the database that the passed DataSource has been configured to use is a unit test database.

Parameters:

dataSource - Configured DataSource.

Throws:

SQLException - If an error occurs connecting to the database to retrieve the database name.

assertFileEquals

public static void assertFileEquals(File file1,
                                    File file2)
                             throws IOException

Asserts that the *contents* of the passed files are equal.

Parameters:

file1 - File to compare.

file2 - File to compare.

Throws:

IOException - If an error occurs comparing the file contents.

assertFileEquals

public static void assertFileEquals(String message,
                                    File expectedFile,
                                    File actualFile)
                             throws IOException

Asserts that the *contents* of the passed files are equal.

Parameters:

message - Failure message.

expectedFile - File containing expected data.

actualFile - File to compare.

Throws:

IOException - If an error occurs comparing the file contents.

assertFileEquals

public static void assertFileEquals(String message,
                                    File expectedFile,
                                    Charset expectedFileEncoding,
                                    File actualFile,
                                    Charset actualFileEncoding)
                             throws IOException

Asserts that the *contents* of the passed files are equal.

Parameters:

message - Failure message.

expectedFile - File containing expected data.

expectedFileEncoding - Encoding of expected file.

actualFile - File to compare.

actualFileEncoding - Encoding of actual file.

Throws:

IOException - If an error occurs comparing the file contents.

assertFilesNotEqual

public static void assertFilesNotEqual(File expectedFile,
                                       File actualFile)
                                throws IOException

Asserts that the *contents* of the passed files are not equal.

Parameters:

expectedFile - File containing expected data.

actualFile - File to compare.

Throws:

IOException - If an error occurs comparing the file contents.

assertFilesNotEqual

public static void assertFilesNotEqual(String message,
                                       File file1,
                                       File file2)
                                throws IOException

Asserts that the *contents* of the passed files are not equal.

Parameters:

message - Failure message.

file1 - File to compare.

file2 - File to compare.

Throws:

IOException - If an error occurs comparing the file contents.

assertValues

public static void assertValues(String expectedValue,
                                Object[] values)

Assert that all Objects in the passed array match the expected value.

Parameters:

expectedValue - Expected value.

values - Array of Objects to compare.

assertFilesEquivalent

public static void assertFilesEquivalent(File expected,
                                         File actual)
                                  throws IOException

Asserts that the contents of the files are equivalent - i.e. the same lines but not necessarily in the same order. This allows you to compare files with contents that might be sorted differently. The default Charset is used for reading the files.

Parameters:

expected - File containing expected data.

actual - File to compare.

Throws:

IOException - If an error occurs comparing the file contents.

assertFilesEquivalent

public static void assertFilesEquivalent(File expected,
                                         Charset expectedFileEncoding,
                                         File actual,
                                         Charset actualFileEncoding)
                                  throws IOException

Asserts that the contents of the files are equivalent - i.e. the same lines but not necessarily in the same order. This allows you to compare files with contents that might be sorted differently.

Parameters:

expected - File containing expected data.

expectedFileEncoding - Encoding of expected file.

actual - File to compare.

actualFileEncoding - Encoding of actual file.

Throws:

IOException - If an error occurs comparing the file contents.