Class Strings

java.lang.Object
org.assertj.core.internal.Strings

public class Strings extends Object
Reusable assertions for CharSequences.
  • Field Details

  • Constructor Details

  • Method Details

    • 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.
    • hasContent

      private static boolean hasContent(CharSequence s)
    • 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.
    • isBlank

      private boolean isBlank(CharSequence actual)
    • containsWhitespaces

      private boolean containsWhitespaces(CharSequence actual)
    • containsOnlyWhitespaces

      private boolean containsOnlyWhitespaces(CharSequence actual)
    • isNullOrEmpty

      private boolean isNullOrEmpty(CharSequence actual)
    • containsOneOrMoreWhitespaces

      private boolean containsOneOrMoreWhitespaces(CharSequence actual)
    • strictlyContainsWhitespaces

      private boolean strictlyContainsWhitespaces(CharSequence actual)
    • 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.
    • isJavaBlank

      private boolean isJavaBlank(CharSequence actual)
    • 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.
    • assertContainsAnyOf

      public void assertContainsAnyOf(AssertionInfo info, CharSequence actual, CharSequence[] values)
    • 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.
    • checkIsNotNull

      private void checkIsNotNull(CharSequence... values)
    • checkIsNotEmpty

      private void checkIsNotEmpty(CharSequence... values)
    • stringContains

      private boolean stringContains(CharSequence actual, CharSequence sequence)
    • 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.
    • containsIgnoreCase

      private boolean containsIgnoreCase(CharSequence actual, CharSequence sequence)
    • assertContainsIgnoringNewLines

      public void assertContainsIgnoringNewLines(AssertionInfo info, CharSequence actual, CharSequence... values)
      Verifies the given CharSequence has the strings, ignoring newlines.
      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 actual CharSequence doesn't have sequence
    • assertContainsIgnoringWhitespaces

      public void assertContainsIgnoringWhitespaces(AssertionInfo info, CharSequence actual, CharSequence... values)
      Verifies that the given CharSequence contains the given strings, ignoring whitespaces.
      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.
    • assertDoesNotContainIgnoringCase

      public void assertDoesNotContainIgnoringCase(AssertionInfo info, CharSequence actual, CharSequence... values)
      Verifies that the given CharSequence does not contain any one of the given values, ignoring case considerations.
      Parameters:
      info - contains information about the assertion.
      actual - the actual CharSequence.
      values - the sequences 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, ignoring case considerations.
    • 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.
    • checkCharSequenceIsNotNull

      private static void checkCharSequenceIsNotNull(CharSequence sequence)
    • 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.
    • areEqualIgnoringCase

      private boolean areEqualIgnoringCase(CharSequence actual, CharSequence expected)
    • assertIsEqualToNormalizingNewlines

      public void assertIsEqualToNormalizingNewlines(AssertionInfo info, CharSequence actual, CharSequence expected)
      Verifies that two CharSequences are 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.
    • normalizeNewlines

      private static String normalizeNewlines(CharSequence actual)
    • 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.
    • areEqualIgnoringWhitespace

      private boolean areEqualIgnoringWhitespace(CharSequence actual, CharSequence expected)
    • removeAllWhitespaces

      private static String removeAllWhitespaces(CharSequence toBeStripped)
    • 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
    • normalizeWhitespace

      private static String normalizeWhitespace(CharSequence toNormalize)
    • assertEqualsNormalizingPunctuationAndWhitespace

      public void assertEqualsNormalizingPunctuationAndWhitespace(AssertionInfo info, CharSequence actual, CharSequence expected)
      Verifies that two CharSequences are equal, after the punctuation of both strings have 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:
      3.16.0
    • normalizeWhitespaceAndPunctuation

      private static String normalizeWhitespaceAndPunctuation(CharSequence toNormalize)
    • assertEqualsToNormalizingUnicode

      public void assertEqualsToNormalizingUnicode(AssertionInfo info, CharSequence actual, CharSequence expected)
      Verifies that two CharSequences are equal, on their canonical form relying on Normalizer. Using Normalizer.Form.NFC for canonical decomposition, followed by canonical composition.

      Examples:

      
       // assertion succeeds
       assertThat("Ä").isEqualToNormalizingUnicode("Ä");
       // assertion fails
       assertThat("Ä").isEqualToNormalizingUnicode("Ä"); 
      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:
      3.19.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.
    • countOccurrences

      private int countOccurrences(CharSequence sequenceToSearch, CharSequence actual)
      Count occurrences of sequenceToSearch in actual CharSequence.
      Parameters:
      sequenceToSearch - the sequence to search in in actual CharSequence.
      actual - the CharSequence to search occurrences in.
      Returns:
      the number of occurrences of sequenceToSearch in actual 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.
    • assertStartsWithIgnoringCase

      public void assertStartsWithIgnoringCase(AssertionInfo info, CharSequence actual, CharSequence prefix)
      Verifies that the given CharSequence starts with the given prefix, ignoring case considerations.
      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, ignoring case.
      Since:
      3.23.0
    • 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.
    • assertDoesNotStartWithIgnoringCase

      public void assertDoesNotStartWithIgnoringCase(AssertionInfo info, CharSequence actual, CharSequence prefix)
      Verifies that the given CharSequence does not start with the given prefix, ignoring case considerations.
      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, ignoring case.
      Since:
      3.23.0
    • failIfPrefixIsNull

      private static void failIfPrefixIsNull(CharSequence prefix)
    • startsWith

      private boolean startsWith(CharSequence actual, CharSequence prefix, boolean ignoreCase)
    • 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.
    • assertEndsWithIgnoringCase

      public void assertEndsWithIgnoringCase(AssertionInfo info, CharSequence actual, CharSequence suffix)
      Verifies that the given CharSequence ends with the given suffix, ignoring case considerations.
      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, ignoring case.
      Since:
      3.23.0
    • 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.
    • assertDoesNotEndWithIgnoringCase

      public void assertDoesNotEndWithIgnoringCase(AssertionInfo info, CharSequence actual, CharSequence suffix)
      Verifies that the given CharSequence does not end with the given suffix, ignoring case considerations.
      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, ignoring case.
      Since:
      3.23.0
    • failIfSuffixIsNull

      private static void failIfSuffixIsNull(CharSequence suffix)
    • endsWith

      private boolean endsWith(CharSequence actual, CharSequence suffix, boolean ignoreCase)
    • 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.
    • checkRegexIsNotNull

      private void checkRegexIsNotNull(CharSequence regex)
    • 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.
    • assertMatches

      public void assertMatches(AssertionInfo info, CharSequence actual, Matcher matcher)
      Verifies that the given CharSequence matches the given regular expression.
      Parameters:
      info - contains information about the assertion.
      actual - the given CharSequence.
      matcher - the matcher to check for matching.
      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.
    • checkIsNotNull

      private void checkIsNotNull(Pattern pattern)
    • patternToMatchIsNull

      private NullPointerException patternToMatchIsNull()
    • checkIsNotNull

      private void checkIsNotNull(Matcher matcher)
    • assertNotNull

      private void assertNotNull(AssertionInfo info, CharSequence actual)
    • 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.
    • removeUpTo

      private String removeUpTo(String string, CharSequence toRemove)
    • indexOf

      private int indexOf(String string, CharSequence toFind)
    • 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, Matcher matcher)
      Verifies that the given CharSequence contains the given regular expression.
      Parameters:
      info - contains information about the assertion.
      actual - the given CharSequence.
      matcher - the matcher for finding 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.
    • checkCharSequenceArrayDoesNotHaveNullElements

      private void checkCharSequenceArrayDoesNotHaveNullElements(CharSequence[] values)
    • 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)
    • isLowerCase

      private boolean isLowerCase(CharSequence actual)
    • assertUpperCase

      public void assertUpperCase(AssertionInfo info, CharSequence actual)
    • isUpperCase

      private boolean isUpperCase(CharSequence actual)
    • assertMixedCase

      public void assertMixedCase(AssertionInfo info, CharSequence actual)
    • assertIsBase64

      public void assertIsBase64(AssertionInfo info, String actual)
      Verifies that actual is a valid Base64 encoded string.
      Parameters:
      info - contains information about the assertion.
      actual - the actual CharSequence (new lines will be ignored).
      Throws:
      AssertionError - if actual is null.
      AssertionError - if actual is not a valid Base64 encoded string.
    • removeNewLines

      private static String removeNewLines(CharSequence text)
    • doCommonCheckForCharSequence

      private void doCommonCheckForCharSequence(AssertionInfo info, CharSequence actual, CharSequence[] sequence)
    • assertVisible

      public void assertVisible(AssertionInfo info, CharSequence actual)