org.assertj.core.internal

Class Strings

java.lang.Object

org.assertj.core.internal.Strings

public class Strings
extends Object

Reusable assertions for CharSequences.

Author:

Alex Ruiz, Joel Costigliola, Nicolas François, Mikhail Mazursky, Michal Kordas

Constructor Summary

Constructors

Constructor and Description
Strings(ComparisonStrategy comparisonStrategy)

Method Summary

Modifier and Type	Method and Description
void	assertBlank(AssertionInfo info, CharSequence actual) Asserts that the given CharSequence is Null, empty or consists of one or more whitespace characters.
void	assertContains(AssertionInfo info, CharSequence actual, CharSequence... values) Verifies that the given CharSequence contains the given strings.
void	assertContainsIgnoringCase(AssertionInfo info, CharSequence actual, CharSequence sequence) Verifies that the given CharSequence contains the given sequence, ignoring case considerations.
void	assertContainsOnlyDigits(AssertionInfo info, CharSequence actual) Verifies that the given CharSequence contains only digits.
void	assertContainsOnlyOnce(AssertionInfo info, CharSequence actual, CharSequence sequence) Verifies that actual CharSequences contains only once the given sequence.
void	assertContainsOnlyWhitespaces(AssertionInfo info, CharSequence actual) Asserts that the given CharSequence consists of one or more whitespace characters.
void	assertContainsPattern(AssertionInfo info, CharSequence actual, CharSequence regex) Verifies that the given CharSequence contains the given regular expression.
void	assertContainsPattern(AssertionInfo info, CharSequence actual, Pattern pattern) Verifies that the given CharSequence contains the given regular expression.
void	assertContainsSequence(AssertionInfo info, CharSequence actual, CharSequence[] sequence) Verifies that the given charSequence contains the given sequence of charSequence, without any other charSequences between them.
void	assertContainsSubsequence(AssertionInfo info, CharSequence actual, CharSequence[] subsequence) Verifies that the actual CharSequence contains all the given values in the given order (possibly with other values between them).
void	assertContainsWhitespaces(AssertionInfo info, CharSequence actual) Asserts that the given CharSequence contains one or more whitespace characters.
void	assertDoesNotContain(AssertionInfo info, CharSequence actual, CharSequence... values) Verifies that the given CharSequence does not contain any one of the given values.
void	assertDoesNotContainAnyWhitespaces(AssertionInfo info, CharSequence actual) Asserts that the given CharSequence is Null, empty or contains only non-whitespace characters.
void	assertDoesNotContainOnlyWhitespaces(AssertionInfo info, CharSequence actual) Asserts that the given CharSequence is Null, empty or contains at least one non-whitespace character.
void	assertDoesNotContainPattern(AssertionInfo info, CharSequence actual, CharSequence regex) Verifies that the given CharSequence does not contain the given regular expression.
void	assertDoesNotContainPattern(AssertionInfo info, CharSequence actual, Pattern pattern) Verifies that the given CharSequence does not contain the given regular expression.
void	assertDoesNotEndWith(AssertionInfo info, CharSequence actual, CharSequence suffix) Verifies that the given CharSequence does not end with the given suffix.
void	assertDoesNotMatch(AssertionInfo info, CharSequence actual, CharSequence regex) Verifies that the given CharSequence does not match the given regular expression.
void	assertDoesNotMatch(AssertionInfo info, CharSequence actual, Pattern pattern) Verifies that the given CharSequence does not match the given regular expression.
void	assertDoesNotStartWith(AssertionInfo info, CharSequence actual, CharSequence prefix) Verifies that the given CharSequence does not start with the given prefix.
void	assertEmpty(AssertionInfo info, CharSequence actual) Asserts that the given CharSequence is empty.
void	assertEndsWith(AssertionInfo info, CharSequence actual, CharSequence suffix) Verifies that the given CharSequence ends with the given suffix.
void	assertEqualsIgnoringCase(AssertionInfo info, CharSequence actual, CharSequence expected) Verifies that two CharSequences are equal, ignoring case considerations.
void	assertEqualsIgnoringWhitespace(AssertionInfo info, CharSequence actual, CharSequence expected) Verifies that two CharSequences are equal, ignoring any differences in whitespace.
void	assertEqualsNormalizingWhitespace(AssertionInfo info, CharSequence actual, CharSequence expected) Verifies that two CharSequences are equal, after the whitespace of both strings has been normalized.
void	assertHasLineCount(AssertionInfo info, CharSequence actual, int expectedLineCount) Asserts that the line count of the given CharSequence is equal to the expected one.
void	assertHasSameSizeAs(AssertionInfo info, CharSequence actual, CharSequence other)
void	assertHasSameSizeAs(AssertionInfo info, CharSequence actual, Iterable<?> other) Asserts that the number of entries in the given CharSequence has the same size as the other Iterable.
void	assertHasSameSizeAs(AssertionInfo info, CharSequence actual, Object array) Asserts that the number of entries in the given CharSequence has the same size as the other array.
void	assertHasSize(AssertionInfo info, CharSequence actual, int expectedSize) Asserts that the size of the given CharSequence is equal to the expected one.
void	assertHasSizeBetween(AssertionInfo info, CharSequence actual, int lowerBoundary, int higherBoundary) Asserts that the size of the given CharSequence is between the given lower and higher boundary (inclusive).
void	assertHasSizeGreaterThan(AssertionInfo info, CharSequence actual, int expectedMinSizeExcluded) Asserts that the size of the given CharSequence is greater than the expected size
void	assertHasSizeGreaterThanOrEqualTo(AssertionInfo info, CharSequence actual, int expectedMinSizeIncluded) Asserts that the size of the given CharSequence is greater than or equal to the expected size
void	assertHasSizeLessThan(AssertionInfo info, CharSequence actual, int expectedMaxSizeExcluded) Asserts that the size of the given CharSequence is less than the expected size
void	assertHasSizeLessThanOrEqualTo(AssertionInfo info, CharSequence actual, int expectedMaxSizeIncluded) Asserts that the size of the given CharSequence is less than or equal to the expected size
void	assertIsEqualToIgnoringNewLines(AssertionInfo info, CharSequence actual, CharSequence expected) Verifies that actual is equal to expected ignoring new lines
void	assertIsEqualToNormalizingNewlines(AssertionInfo info, CharSequence actual, CharSequence expected) Verifies that two CharSequences are not equal, normalizing newlines.
void	assertIsSubstringOf(AssertionInfo info, CharSequence actual, CharSequence sequence)
void	assertJavaBlank(AssertionInfo info, CharSequence actual) Asserts that the given CharSequence consists of one or more whitespace characters according to Character.isWhitespace(char).
void	assertLowerCase(AssertionInfo info, CharSequence actual)
void	assertMatches(AssertionInfo info, CharSequence actual, CharSequence regex) Verifies that the given CharSequence matches the given regular expression.
void	assertMatches(AssertionInfo info, CharSequence actual, Pattern pattern) Verifies that the given CharSequence matches the given regular expression.
void	assertNotBlank(AssertionInfo info, CharSequence actual) Asserts that the given CharSequence contains at least one non-whitespace character.
void	assertNotEmpty(AssertionInfo info, CharSequence actual) Asserts that the given CharSequence is not empty.
void	assertNotEqualsIgnoringCase(AssertionInfo info, CharSequence actual, CharSequence expected) Verifies that two CharSequences are not equal, ignoring case considerations.
void	assertNotEqualsIgnoringWhitespace(AssertionInfo info, CharSequence actual, CharSequence expected) Verifies that two CharSequences are not equal, ignoring any differences in whitespace.
void	assertNotEqualsNormalizingWhitespace(AssertionInfo info, CharSequence actual, CharSequence expected) Verifies that two CharSequences are not equal, after the whitespace of both strings has been normalized.
void	assertNotJavaBlank(AssertionInfo info, CharSequence actual) Asserts that the given CharSequence is Null, empty or contains at least one non-whitespace character according to Character.isWhitespace(char).
void	assertNullOrEmpty(AssertionInfo info, CharSequence actual) Asserts that the given CharSequence is null or empty.
void	assertStartsWith(AssertionInfo info, CharSequence actual, CharSequence prefix) Verifies that the given CharSequence starts with the given prefix.
void	assertUpperCase(AssertionInfo info, CharSequence actual)
void	assertXmlEqualsTo(AssertionInfo info, CharSequence actualXml, CharSequence expectedXml)
Comparator<?>	getComparator()
static Strings	instance() Returns the singleton instance of this class based on StandardComparisonStrategy.

Methods inherited from class java.lang.Object

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

Constructor Detail

Strings

public Strings(ComparisonStrategy comparisonStrategy)

Method Detail

instance

public static Strings instance()

Returns the singleton instance of this class based on StandardComparisonStrategy.

Returns:

the singleton instance of this class based on StandardComparisonStrategy.

getComparator

public Comparator<?> getComparator()

assertNullOrEmpty

public void assertNullOrEmpty(AssertionInfo info,
                              CharSequence actual)

Asserts that the given CharSequence is null or empty.

Parameters:

info - contains information about the assertion.

actual - the given CharSequence.

Throws:

AssertionError - if the given CharSequence is not null *and* it is not empty.

assertEmpty

public void assertEmpty(AssertionInfo info,
                        CharSequence actual)

Asserts that the given CharSequence is empty.

Parameters:

info - contains information about the assertion.

actual - the given CharSequence.

Throws:

AssertionError - if the given CharSequence is null.

AssertionError - if the given CharSequence is not empty.

assertNotEmpty

public void assertNotEmpty(AssertionInfo info,
                           CharSequence actual)

Asserts that the given CharSequence is not empty.

Parameters:

info - contains information about the assertion.

actual - the given CharSequence.

Throws:

AssertionError - if the given CharSequence is null.

AssertionError - if the given CharSequence is empty.

assertBlank

public void assertBlank(AssertionInfo info,
                        CharSequence actual)

Asserts that the given CharSequence is Null, empty or consists of one or more whitespace characters.

Parameters:

info - contains information about the assertion.

actual - the given CharSequence.

Throws:

AssertionError - if the given CharSequence is not blank.

assertNotBlank

public void assertNotBlank(AssertionInfo info,
                           CharSequence actual)

Asserts that the given CharSequence contains at least one non-whitespace character.

Parameters:

info - contains information about the assertion.

actual - the given CharSequence.

Throws:

AssertionError - if the given CharSequence is blank.

assertContainsWhitespaces

public void assertContainsWhitespaces(AssertionInfo info,
                                      CharSequence actual)

Asserts that the given CharSequence contains one or more whitespace characters.

Parameters:

info - contains information about the assertion.

actual - the given CharSequence.

Throws:

AssertionError - if the given CharSequence does not contain any whitespace characters.

assertContainsOnlyWhitespaces

public void assertContainsOnlyWhitespaces(AssertionInfo info,
                                          CharSequence actual)

Asserts that the given CharSequence consists of one or more whitespace characters.

Parameters:

info - contains information about the assertion.

actual - the given CharSequence.

Throws:

AssertionError - if the given CharSequence is not blank.

assertDoesNotContainAnyWhitespaces

public void assertDoesNotContainAnyWhitespaces(AssertionInfo info,
                                               CharSequence actual)

Asserts that the given CharSequence is Null, empty or contains only non-whitespace characters.

Parameters:

info - contains information about the assertion.

actual - the given CharSequence.

Throws:

AssertionError - if the given CharSequence contains one or more whitespace characters.

assertDoesNotContainOnlyWhitespaces

public void assertDoesNotContainOnlyWhitespaces(AssertionInfo info,
                                                CharSequence actual)

Asserts that the given CharSequence is Null, empty or contains at least one non-whitespace character.

Parameters:

info - contains information about the assertion.

actual - the given CharSequence.

Throws:

AssertionError - if the given CharSequence is blank.

assertJavaBlank

public void assertJavaBlank(AssertionInfo info,
                            CharSequence actual)

Asserts that the given CharSequence consists of one or more whitespace characters according to Character.isWhitespace(char).

Parameters:

info - contains information about the assertion.

actual - the given CharSequence.

Throws:

AssertionError - if the given CharSequence is not blank.

assertNotJavaBlank

public void assertNotJavaBlank(AssertionInfo info,
                               CharSequence actual)

Asserts that the given CharSequence is Null, empty or contains at least one non-whitespace character according to Character.isWhitespace(char).

Parameters:

info - contains information about the assertion.

actual - the given CharSequence.

Throws:

AssertionError - if the given CharSequence is blank.

assertHasSize

public void assertHasSize(AssertionInfo info,
                          CharSequence actual,
                          int expectedSize)

Asserts that the size of the given CharSequence is equal to the expected one.

Parameters:

info - contains information about the assertion.

actual - the given CharSequence.

expectedSize - the expected size of actual.

Throws:

AssertionError - if the given CharSequence is null.

AssertionError - if the size of the given CharSequence is different than the expected one.

assertHasSizeLessThan

public void assertHasSizeLessThan(AssertionInfo info,
                                  CharSequence actual,
                                  int expectedMaxSizeExcluded)

Asserts that the size of the given CharSequence is less than the expected size

Parameters:

info - contains information about the assertion.

actual - the given CharSequence.

expectedMaxSizeExcluded - the expected max size of actual

Throws:

AssertionError - if the given CharSequence is null.

AssertionError - if the size of the given CharSequence is equal to or greater than the expected max size

assertHasSizeLessThanOrEqualTo

public void assertHasSizeLessThanOrEqualTo(AssertionInfo info,
                                           CharSequence actual,
                                           int expectedMaxSizeIncluded)

Asserts that the size of the given CharSequence is less than or equal to the expected size

Parameters:

info - contains information about the assertion.

actual - the given CharSequence.

expectedMaxSizeIncluded - the expected max size of actual

Throws:

AssertionError - if the given CharSequence is null.

AssertionError - if the size of the given CharSequence is greater than the expected max size

assertHasSizeGreaterThan

public void assertHasSizeGreaterThan(AssertionInfo info,
                                     CharSequence actual,
                                     int expectedMinSizeExcluded)

Asserts that the size of the given CharSequence is greater than the expected size

Parameters:

info - contains information about the assertion.

actual - the given CharSequence.

expectedMinSizeExcluded - the expected min size of actual

Throws:

AssertionError - if the given CharSequence is null.

AssertionError - if the size of the given CharSequence is equal to or less than the expected max size

assertHasSizeGreaterThanOrEqualTo

public void assertHasSizeGreaterThanOrEqualTo(AssertionInfo info,
                                              CharSequence actual,
                                              int expectedMinSizeIncluded)

Asserts that the size of the given CharSequence is greater than or equal to the expected size

Parameters:

info - contains information about the assertion.

actual - the given CharSequence.

expectedMinSizeIncluded - the expected min size of actual

Throws:

AssertionError - if the given CharSequence is null.

AssertionError - if the size of the given CharSequence is greater than the expected max size

assertHasSizeBetween

public void assertHasSizeBetween(AssertionInfo info,
                                 CharSequence actual,
                                 int lowerBoundary,
                                 int higherBoundary)

Asserts that the size of the given CharSequence is between the given lower and higher boundary (inclusive).

Parameters:

info - contains information about the assertion.

actual - the given Iterable.

lowerBoundary - the lower boundary compared to which actual size should be greater than or equal to.

higherBoundary - the higher boundary compared to which actual size should be less than or equal to.

Throws:

AssertionError - if the given array is null.

AssertionError - if the number of elements in the given array is not between the boundaries.

assertHasLineCount

public void assertHasLineCount(AssertionInfo info,
                               CharSequence actual,
                               int expectedLineCount)

Asserts that the line count of the given CharSequence is equal to the expected one.

Parameters:

info - contains information about the assertion.

actual - the given CharSequence.

expectedLineCount - the expected line count of actual.

Throws:

AssertionError - if the given CharSequence is null.

AssertionError - if the line count of the given CharSequence is different than the expected one.

assertHasSameSizeAs

public void assertHasSameSizeAs(AssertionInfo info,
                                CharSequence actual,
                                Iterable<?> other)

Asserts that the number of entries in the given CharSequence has the same size as the other Iterable.

Parameters:

info - contains information about the assertion.

actual - the given CharSequence.

other - the group to compare

Throws:

AssertionError - if the given CharSequence is null.

AssertionError - if the given Iterable is null.

AssertionError - if the number of entries in the given CharSequence does not have the same size.

assertHasSameSizeAs

public void assertHasSameSizeAs(AssertionInfo info,
                                CharSequence actual,
                                Object array)

Asserts that the number of entries in the given CharSequence has the same size as the other array.

Parameters:

info - contains information about the assertion.

actual - the given CharSequence.

array - the array to compare

Throws:

AssertionError - if the given CharSequence is null.

AssertionError - if the given array is null.

AssertionError - if the number of entries in the given CharSequence does not have the same size.

assertHasSameSizeAs

public void assertHasSameSizeAs(AssertionInfo info,
                                CharSequence actual,
                                CharSequence other)

assertContains

public void assertContains(AssertionInfo info,
                           CharSequence actual,
                           CharSequence... values)

Verifies that the given CharSequence contains the given strings.

Parameters:

info - contains information about the assertion.

actual - the actual CharSequence.

values - the values to look for.

Throws:

NullPointerException - if the given sequence is null.

IllegalArgumentException - if the given values is empty.

AssertionError - if the given CharSequence is null.

AssertionError - if the actual CharSequence does not contain the given sequence.

assertContainsOnlyDigits

public void assertContainsOnlyDigits(AssertionInfo info,
                                     CharSequence actual)

Verifies that the given CharSequence contains only digits.

Parameters:

info - contains information about the assertion.

actual - the given CharSequence.

Throws:

NullPointerException - if actual is null.

AssertionError - if actual contains non-digit characters or contains no digits at all.

assertContainsIgnoringCase

public void assertContainsIgnoringCase(AssertionInfo info,
                                       CharSequence actual,
                                       CharSequence sequence)

Verifies that the given CharSequence contains the given sequence, ignoring case considerations.

Parameters:

info - contains information about the assertion.

actual - the actual CharSequence.

sequence - the sequence to search for.

Throws:

NullPointerException - if the given sequence is null.

AssertionError - if the given CharSequence is null.

AssertionError - if the actual CharSequence does not contain the given sequence.

assertDoesNotContain

public void assertDoesNotContain(AssertionInfo info,
                                 CharSequence actual,
                                 CharSequence... values)

Verifies that the given CharSequence does not contain any one of the given values.

Parameters:

info - contains information about the assertion.

actual - the actual CharSequence.

values - the values to search for.

Throws:

NullPointerException - if the given list of values is null.

NullPointerException - if any one of the given values is null.

IllegalArgumentException - if the list of given values is empty.

AssertionError - if the actual CharSequence is null.

AssertionError - if the actual CharSequence contains any one of the given values.

assertEqualsIgnoringCase

public void assertEqualsIgnoringCase(AssertionInfo info,
                                     CharSequence actual,
                                     CharSequence expected)

Verifies that two CharSequences are equal, ignoring case considerations.

Parameters:

info - contains information about the assertion.

actual - the actual CharSequence.

expected - the expected CharSequence.

Throws:

AssertionError - if the given CharSequences are not equal.

assertNotEqualsIgnoringCase

public void assertNotEqualsIgnoringCase(AssertionInfo info,
                                        CharSequence actual,
                                        CharSequence expected)

Verifies that two CharSequences are not equal, ignoring case considerations.

Parameters:

info - contains information about the assertion.

actual - the actual CharSequence.

expected - the expected CharSequence.

Throws:

AssertionError - if the given CharSequences are equal ignoring case considerations.

assertIsEqualToNormalizingNewlines

public void assertIsEqualToNormalizingNewlines(AssertionInfo info,
                                               CharSequence actual,
                                               CharSequence expected)

Verifies that two CharSequences are not equal, normalizing newlines.

Parameters:

info - contains information about the assertion.

actual - the actual CharSequence (newlines will be normalized).

expected - the expected CharSequence (newlines will be normalized)..

Throws:

AssertionError - if the given CharSequences are equal after normalizing newlines.

assertEqualsIgnoringWhitespace

public void assertEqualsIgnoringWhitespace(AssertionInfo info,
                                           CharSequence actual,
                                           CharSequence expected)

Verifies that two CharSequences are equal, ignoring any differences in whitespace.

Parameters:

info - contains information about the assertion.

actual - the actual CharSequence.

expected - the expected CharSequence.

Throws:

AssertionError - if the given CharSequences are not equal.

assertNotEqualsIgnoringWhitespace

public void assertNotEqualsIgnoringWhitespace(AssertionInfo info,
                                              CharSequence actual,
                                              CharSequence expected)

Verifies that two CharSequences are not equal, ignoring any differences in whitespace.

Parameters:

info - contains information about the assertion.

actual - the actual CharSequence.

expected - the expected CharSequence.

Throws:

AssertionError - if the given CharSequences are equal.

assertEqualsNormalizingWhitespace

public void assertEqualsNormalizingWhitespace(AssertionInfo info,
                                              CharSequence actual,
                                              CharSequence expected)

Verifies that two CharSequences are equal, after the whitespace of both strings has been normalized.

Parameters:

info - contains information about the assertion.

actual - the actual CharSequence.

expected - the expected CharSequence.

Throws:

AssertionError - if the given CharSequences are not equal.

Since:

2.8.0 / 3.8.0

assertNotEqualsNormalizingWhitespace

public void assertNotEqualsNormalizingWhitespace(AssertionInfo info,
                                                 CharSequence actual,
                                                 CharSequence expected)

Verifies that two CharSequences are not equal, after the whitespace of both strings has been normalized.

Parameters:

info - contains information about the assertion.

actual - the actual CharSequence.

expected - the expected CharSequence.

Throws:

AssertionError - if the given CharSequences are equal.

Since:

2.8.0 / 3.8.0

assertContainsOnlyOnce

public void assertContainsOnlyOnce(AssertionInfo info,
                                   CharSequence actual,
                                   CharSequence sequence)

Verifies that actual CharSequences contains only once the given sequence.

Parameters:

info - contains information about the assertion.

actual - the actual CharSequence.

sequence - the given CharSequence.

Throws:

NullPointerException - if the given sequence is null.

AssertionError - if the given CharSequence is null.

AssertionError - if the actual CharSequence does not contains only once the given CharSequence.

assertStartsWith

public void assertStartsWith(AssertionInfo info,
                             CharSequence actual,
                             CharSequence prefix)

Verifies that the given CharSequence starts with the given prefix.

Parameters:

info - contains information about the assertion.

actual - the actual CharSequence.

prefix - the given prefix.

Throws:

NullPointerException - if the given sequence is null.

AssertionError - if the given CharSequence is null.

AssertionError - if the actual CharSequence does not start with the given prefix.

assertDoesNotStartWith

public void assertDoesNotStartWith(AssertionInfo info,
                                   CharSequence actual,
                                   CharSequence prefix)

Verifies that the given CharSequence does not start with the given prefix.

Parameters:

info - contains information about the assertion.

actual - the actual CharSequence.

prefix - the given prefix.

Throws:

NullPointerException - if the given sequence is null.

AssertionError - if the given CharSequence is null.

AssertionError - if the actual CharSequence starts with the given prefix.

assertEndsWith

public void assertEndsWith(AssertionInfo info,
                           CharSequence actual,
                           CharSequence suffix)

Verifies that the given CharSequence ends with the given suffix.

Parameters:

info - contains information about the assertion.

actual - the actual CharSequence.

suffix - the given suffix.

Throws:

NullPointerException - if the given sequence is null.

AssertionError - if the given CharSequence is null.

AssertionError - if the actual CharSequence does not end with the given suffix.

assertDoesNotEndWith

public void assertDoesNotEndWith(AssertionInfo info,
                                 CharSequence actual,
                                 CharSequence suffix)

Verifies that the given CharSequence does not end with the given suffix.

Parameters:

info - contains information about the assertion.

actual - the actual CharSequence.

suffix - the given suffix.

Throws:

NullPointerException - if the given sequence is null.

AssertionError - if the given CharSequence is null.

AssertionError - if the actual CharSequence ends with the given suffix.

assertMatches

public void assertMatches(AssertionInfo info,
                          CharSequence actual,
                          CharSequence regex)

Verifies that the given CharSequence matches the given regular expression.

Parameters:

info - contains information about the assertion.

actual - the given CharSequence.

regex - the regular expression to which the actual CharSequence is to be matched.

Throws:

NullPointerException - if the given pattern is null.

PatternSyntaxException - if the regular expression's syntax is invalid.

AssertionError - if the given CharSequence is null.

AssertionError - if the actual CharSequence does not match the given regular expression.

assertDoesNotMatch

public void assertDoesNotMatch(AssertionInfo info,
                               CharSequence actual,
                               CharSequence regex)

Verifies that the given CharSequence does not match the given regular expression.

Parameters:

info - contains information about the assertion.

actual - the given CharSequence.

regex - the regular expression to which the actual CharSequence is to be matched.

Throws:

NullPointerException - if the given pattern is null.

PatternSyntaxException - if the regular expression's syntax is invalid.

AssertionError - if the given CharSequence is null.

AssertionError - if the actual CharSequence matches the given regular expression.

assertMatches

public void assertMatches(AssertionInfo info,
                          CharSequence actual,
                          Pattern pattern)

Verifies that the given CharSequence matches the given regular expression.

Parameters:

info - contains information about the assertion.

actual - the given CharSequence.

pattern - the regular expression to which the actual CharSequence is to be matched.

Throws:

NullPointerException - if the given pattern is null.

AssertionError - if the given CharSequence is null.

AssertionError - if the given CharSequence does not match the given regular expression.

assertDoesNotMatch

public void assertDoesNotMatch(AssertionInfo info,
                               CharSequence actual,
                               Pattern pattern)

Verifies that the given CharSequence does not match the given regular expression.

Parameters:

info - contains information about the assertion.

actual - the given CharSequence.

pattern - the regular expression to which the actual CharSequence is to be matched.

Throws:

NullPointerException - if the given pattern is null.

AssertionError - if the given CharSequence matches the given regular expression.

assertContainsSequence

public void assertContainsSequence(AssertionInfo info,
                                   CharSequence actual,
                                   CharSequence[] sequence)

Verifies that the given charSequence contains the given sequence of charSequence, without any other charSequences between them.

Parameters:

info - contains information about the assertion.

actual - the given charSequence.

sequence - the sequence of charSequence to look for.

Throws:

NullPointerException - if the given sequence of charSequence is null.

IllegalArgumentException - if the given sequence of charSequence is empty.

AssertionError - if the given CharSequence is null.

AssertionError - if the given CharSequence does not contain the given sequence of charSequence.

assertContainsSubsequence

public void assertContainsSubsequence(AssertionInfo info,
                                      CharSequence actual,
                                      CharSequence[] subsequence)

Verifies that the actual CharSequence contains all the given values in the given order (possibly with other values between them).

Parameters:

info - contains information about the assertion.

actual - the given CharSequence.

subsequence - the Strings to look for, in order.

Throws:

AssertionError - if the given CharSequence is null.

NullPointerException - if the given subsequence is null.

IllegalArgumentException - if the given subsequence is empty.

AssertionError - if the given CharSequence does not contain the given subsequence of charSequence.

assertXmlEqualsTo

public void assertXmlEqualsTo(AssertionInfo info,
                              CharSequence actualXml,
                              CharSequence expectedXml)

assertIsSubstringOf

public void assertIsSubstringOf(AssertionInfo info,
                                CharSequence actual,
                                CharSequence sequence)

assertContainsPattern

public void assertContainsPattern(AssertionInfo info,
                                  CharSequence actual,
                                  CharSequence regex)

Verifies that the given CharSequence contains the given regular expression.

Parameters:

info - contains information about the assertion.

actual - the given CharSequence.

regex - the regular expression to find in the actual CharSequence.

Throws:

NullPointerException - if the given pattern is null.

PatternSyntaxException - if the regular expression's syntax is invalid.

AssertionError - if the given CharSequence is null.

AssertionError - if the actual CharSequence does not contain the given regular expression.

assertContainsPattern

public void assertContainsPattern(AssertionInfo info,
                                  CharSequence actual,
                                  Pattern pattern)

Verifies that the given CharSequence contains the given regular expression.

Parameters:

info - contains information about the assertion.

actual - the given CharSequence.

pattern - the regular expression to find in the actual CharSequence.

Throws:

NullPointerException - if the given pattern is null.

AssertionError - if the given CharSequence is null.

AssertionError - if the given CharSequence does not contain the given regular expression.

assertDoesNotContainPattern

public void assertDoesNotContainPattern(AssertionInfo info,
                                        CharSequence actual,
                                        CharSequence regex)

Verifies that the given CharSequence does not contain the given regular expression.

Parameters:

info - contains information about the assertion.

actual - the given CharSequence.

regex - the regular expression to find in the actual CharSequence.

Throws:

NullPointerException - if the given pattern is null.

PatternSyntaxException - if the regular expression's syntax is invalid.

AssertionError - if the given CharSequence is null.

AssertionError - if the actual CharSequence contains the given regular expression.

assertDoesNotContainPattern

public void assertDoesNotContainPattern(AssertionInfo info,
                                        CharSequence actual,
                                        Pattern pattern)

Verifies that the given CharSequence does not contain the given regular expression.

Parameters:

info - contains information about the assertion.

actual - the given CharSequence.

pattern - the regular expression to find in the actual CharSequence.

Throws:

NullPointerException - if the given pattern is null.

AssertionError - if the given CharSequence is null.

AssertionError - if the given CharSequence contains the given regular expression.

assertIsEqualToIgnoringNewLines

public void assertIsEqualToIgnoringNewLines(AssertionInfo info,
                                            CharSequence actual,
                                            CharSequence expected)

Verifies that actual is equal to expected ignoring new lines

Parameters:

info - contains information about the assertion.

actual - the actual CharSequence (new lines will be ignored).

expected - the expected CharSequence (new lines will be ignored).

assertLowerCase

public void assertLowerCase(AssertionInfo info,
                            CharSequence actual)

assertUpperCase

public void assertUpperCase(AssertionInfo info,
                            CharSequence actual)