Class Strings


  • public class Strings
    extends java.lang.Object
    • Field Detail

      • NON_BREAKING_SPACES

        private static final java.util.Set<java.lang.Character> NON_BREAKING_SPACES
      • INSTANCE

        private static final Strings INSTANCE
      • PUNCTUATION_REGEX

        private static final java.lang.String PUNCTUATION_REGEX
        See Also:
        Constant Field Values
    • Constructor Detail

      • Strings

        Strings()
    • Method Detail

      • instance

        public static Strings instance()
      • getComparator

        public java.util.Comparator<?> getComparator()
      • assertNullOrEmpty

        public void assertNullOrEmpty​(AssertionInfo info,
                                      java.lang.CharSequence actual)
      • assertEmpty

        public void assertEmpty​(AssertionInfo info,
                                java.lang.CharSequence actual)
      • assertNotEmpty

        public void assertNotEmpty​(AssertionInfo info,
                                   java.lang.CharSequence actual)
      • hasContent

        private static boolean hasContent​(java.lang.CharSequence s)
      • assertHasSize

        public void assertHasSize​(AssertionInfo info,
                                  java.lang.CharSequence actual,
                                  int expectedSize)
      • assertHasSizeLessThan

        public void assertHasSizeLessThan​(AssertionInfo info,
                                          java.lang.CharSequence actual,
                                          int expectedMaxSizeExcluded)
      • assertHasSizeLessThanOrEqualTo

        public void assertHasSizeLessThanOrEqualTo​(AssertionInfo info,
                                                   java.lang.CharSequence actual,
                                                   int expectedMaxSizeIncluded)
      • assertHasSizeGreaterThan

        public void assertHasSizeGreaterThan​(AssertionInfo info,
                                             java.lang.CharSequence actual,
                                             int expectedMinSizeExcluded)
      • assertHasSizeGreaterThanOrEqualTo

        public void assertHasSizeGreaterThanOrEqualTo​(AssertionInfo info,
                                                      java.lang.CharSequence actual,
                                                      int expectedMinSizeIncluded)
      • assertHasSizeBetween

        public void assertHasSizeBetween​(AssertionInfo info,
                                         java.lang.CharSequence actual,
                                         int lowerBoundary,
                                         int higherBoundary)
      • assertHasLineCount

        public void assertHasLineCount​(AssertionInfo info,
                                       java.lang.CharSequence actual,
                                       int expectedLineCount)
      • assertHasSameSizeAs

        public void assertHasSameSizeAs​(AssertionInfo info,
                                        java.lang.CharSequence actual,
                                        java.lang.Iterable<?> other)
      • assertHasSameSizeAs

        public void assertHasSameSizeAs​(AssertionInfo info,
                                        java.lang.CharSequence actual,
                                        java.lang.Object array)
      • assertHasSameSizeAs

        public void assertHasSameSizeAs​(AssertionInfo info,
                                        java.lang.CharSequence actual,
                                        java.lang.CharSequence other)
      • assertContains

        public void assertContains​(AssertionInfo info,
                                   java.lang.CharSequence actual,
                                   java.lang.CharSequence... values)
      • assertContainsAnyOf

        public void assertContainsAnyOf​(AssertionInfo info,
                                        java.lang.CharSequence actual,
                                        java.lang.CharSequence[] values)
      • assertContainsOnlyDigits

        public void assertContainsOnlyDigits​(AssertionInfo info,
                                             java.lang.CharSequence actual)
      • checkIsNotNull

        private static void checkIsNotNull​(java.lang.CharSequence... values)
      • checkIsNotEmpty

        private static void checkIsNotEmpty​(java.lang.CharSequence... values)
      • stringContains

        private boolean stringContains​(java.lang.CharSequence actual,
                                       java.lang.CharSequence sequence)
      • assertContainsIgnoringCase

        public void assertContainsIgnoringCase​(AssertionInfo info,
                                               java.lang.CharSequence actual,
                                               java.lang.CharSequence sequence)
      • containsIgnoreCase

        private boolean containsIgnoreCase​(java.lang.CharSequence actual,
                                           java.lang.CharSequence sequence)
      • assertContainsIgnoringNewLines

        public void assertContainsIgnoringNewLines​(AssertionInfo info,
                                                   java.lang.CharSequence actual,
                                                   java.lang.CharSequence... values)
      • assertDoesNotContainIgnoringCase

        public void assertDoesNotContainIgnoringCase​(AssertionInfo info,
                                                     java.lang.CharSequence actual,
                                                     java.lang.CharSequence... values)
      • assertDoesNotContain

        public void assertDoesNotContain​(AssertionInfo info,
                                         java.lang.CharSequence actual,
                                         java.lang.CharSequence... values)
      • checkCharSequenceIsNotNull

        private static void checkCharSequenceIsNotNull​(java.lang.CharSequence sequence)
      • assertEqualsIgnoringCase

        public void assertEqualsIgnoringCase​(AssertionInfo info,
                                             java.lang.CharSequence actual,
                                             java.lang.CharSequence expected)
      • assertNotEqualsIgnoringCase

        public void assertNotEqualsIgnoringCase​(AssertionInfo info,
                                                java.lang.CharSequence actual,
                                                java.lang.CharSequence expected)
      • areEqualIgnoringCase

        private static boolean areEqualIgnoringCase​(java.lang.CharSequence actual,
                                                    java.lang.CharSequence expected)
      • assertIsEqualToNormalizingNewlines

        public void assertIsEqualToNormalizingNewlines​(AssertionInfo info,
                                                       java.lang.CharSequence actual,
                                                       java.lang.CharSequence expected)
      • normalizeNewlines

        private static java.lang.String normalizeNewlines​(java.lang.CharSequence charSequence)
      • assertEqualsIgnoringWhitespace

        public void assertEqualsIgnoringWhitespace​(AssertionInfo info,
                                                   java.lang.CharSequence actual,
                                                   java.lang.CharSequence expected)
      • assertNotEqualsIgnoringWhitespace

        public void assertNotEqualsIgnoringWhitespace​(AssertionInfo info,
                                                      java.lang.CharSequence actual,
                                                      java.lang.CharSequence expected)
      • areEqualIgnoringWhitespace

        private boolean areEqualIgnoringWhitespace​(java.lang.CharSequence actual,
                                                   java.lang.CharSequence expected)
      • removeAllWhitespaces

        public static java.lang.String removeAllWhitespaces​(java.lang.CharSequence toBeStripped)
      • assertEqualsNormalizingWhitespace

        public void assertEqualsNormalizingWhitespace​(AssertionInfo info,
                                                      java.lang.CharSequence actual,
                                                      java.lang.CharSequence expected)
      • assertNotEqualsNormalizingWhitespace

        public void assertNotEqualsNormalizingWhitespace​(AssertionInfo info,
                                                         java.lang.CharSequence actual,
                                                         java.lang.CharSequence expected)
      • normalizeWhitespace

        private static java.lang.String normalizeWhitespace​(java.lang.CharSequence toNormalize)
      • assertEqualsNormalizingPunctuationAndWhitespace

        public void assertEqualsNormalizingPunctuationAndWhitespace​(AssertionInfo info,
                                                                    java.lang.CharSequence actual,
                                                                    java.lang.CharSequence expected)
      • normalizeWhitespaceAndPunctuation

        private static java.lang.String normalizeWhitespaceAndPunctuation​(java.lang.CharSequence input)
      • assertEqualsToNormalizingUnicode

        public void assertEqualsToNormalizingUnicode​(AssertionInfo info,
                                                     java.lang.CharSequence actual,
                                                     java.lang.CharSequence expected)
      • assertContainsOnlyOnce

        public void assertContainsOnlyOnce​(AssertionInfo info,
                                           java.lang.CharSequence actual,
                                           java.lang.CharSequence sequence)
      • countOccurrences

        private int countOccurrences​(java.lang.CharSequence sequenceToSearch,
                                     java.lang.CharSequence actual)
      • assertStartsWith

        public void assertStartsWith​(AssertionInfo info,
                                     java.lang.CharSequence actual,
                                     java.lang.CharSequence prefix)
      • assertStartsWithIgnoringCase

        public void assertStartsWithIgnoringCase​(AssertionInfo info,
                                                 java.lang.CharSequence actual,
                                                 java.lang.CharSequence prefix)
      • assertDoesNotStartWith

        public void assertDoesNotStartWith​(AssertionInfo info,
                                           java.lang.CharSequence actual,
                                           java.lang.CharSequence prefix)
      • assertDoesNotStartWithIgnoringCase

        public void assertDoesNotStartWithIgnoringCase​(AssertionInfo info,
                                                       java.lang.CharSequence actual,
                                                       java.lang.CharSequence prefix)
      • failIfPrefixIsNull

        private static void failIfPrefixIsNull​(java.lang.CharSequence prefix)
      • startsWith

        private boolean startsWith​(java.lang.CharSequence actual,
                                   java.lang.CharSequence prefix,
                                   boolean ignoreCase)
      • assertEndsWith

        public void assertEndsWith​(AssertionInfo info,
                                   java.lang.CharSequence actual,
                                   java.lang.CharSequence suffix)
      • assertEndsWithIgnoringCase

        public void assertEndsWithIgnoringCase​(AssertionInfo info,
                                               java.lang.CharSequence actual,
                                               java.lang.CharSequence suffix)
      • assertDoesNotEndWith

        public void assertDoesNotEndWith​(AssertionInfo info,
                                         java.lang.CharSequence actual,
                                         java.lang.CharSequence suffix)
      • assertDoesNotEndWithIgnoringCase

        public void assertDoesNotEndWithIgnoringCase​(AssertionInfo info,
                                                     java.lang.CharSequence actual,
                                                     java.lang.CharSequence suffix)
      • failIfSuffixIsNull

        private static void failIfSuffixIsNull​(java.lang.CharSequence suffix)
      • endsWith

        private boolean endsWith​(java.lang.CharSequence actual,
                                 java.lang.CharSequence suffix,
                                 boolean ignoreCase)
      • assertMatches

        public void assertMatches​(AssertionInfo info,
                                  java.lang.CharSequence actual,
                                  java.lang.CharSequence regex)
      • assertDoesNotMatch

        public void assertDoesNotMatch​(AssertionInfo info,
                                       java.lang.CharSequence actual,
                                       java.lang.CharSequence regex)
      • checkRegexIsNotNull

        private static void checkRegexIsNotNull​(java.lang.CharSequence regex)
      • assertMatches

        public void assertMatches​(AssertionInfo info,
                                  java.lang.CharSequence actual,
                                  java.util.regex.Pattern pattern)
      • assertMatches

        public void assertMatches​(AssertionInfo info,
                                  java.lang.CharSequence actual,
                                  java.util.regex.Matcher matcher)
      • assertDoesNotMatch

        public void assertDoesNotMatch​(AssertionInfo info,
                                       java.lang.CharSequence actual,
                                       java.util.regex.Pattern pattern)
      • checkIsNotNull

        private static void checkIsNotNull​(java.util.regex.Pattern pattern)
      • patternToMatchIsNull

        private static java.lang.NullPointerException patternToMatchIsNull()
      • checkIsNotNull

        private void checkIsNotNull​(java.util.regex.Matcher matcher)
      • assertNotNull

        private static void assertNotNull​(AssertionInfo info,
                                          java.lang.CharSequence actual)
      • assertContainsSequence

        public void assertContainsSequence​(AssertionInfo info,
                                           java.lang.CharSequence actual,
                                           java.lang.CharSequence[] sequence)
      • assertContainsSubsequence

        public void assertContainsSubsequence​(AssertionInfo info,
                                              java.lang.CharSequence actual,
                                              java.lang.CharSequence[] subsequence)
      • handleNotFound

        private void handleNotFound​(AssertionInfo info,
                                    java.lang.CharSequence actual,
                                    java.lang.CharSequence[] subsequence,
                                    java.util.Map<java.lang.CharSequence,​java.lang.Integer> notFound)
        Handles the scenario where certain subsequences were not found in the actual CharSequence. Depending on the exact mismatch details, it throws appropriate assertion failures.
        Parameters:
        info - Assertion metadata.
        actual - The actual CharSequence being checked.
        subsequence - The expected subsequence to be found in the actual CharSequence.
        notFound - A map containing subsequences that were not found (or not found enough times) and their respective counts.
      • getNotFoundSubsequence

        private java.util.Map<java.lang.CharSequence,​java.lang.Integer> getNotFoundSubsequence​(java.lang.CharSequence actual,
                                                                                                     java.lang.CharSequence[] subsequence)
        Computes and returns a map of subsequence elements that were not found (or not found enough times) in actual.
        Parameters:
        actual - The actual CharSequence being checked.
        subsequence - The expected subsequence to be found in the actual CharSequence.
        Returns:
        A map where the key represents the missing subsequence and the value represents the number of times it appears in 'actual'.
      • removeUpTo

        private java.lang.String removeUpTo​(java.lang.String string,
                                            java.lang.CharSequence toRemove)
      • indexOf

        private int indexOf​(java.lang.String string,
                            java.lang.CharSequence toFind)
      • assertXmlEqualsTo

        public void assertXmlEqualsTo​(AssertionInfo info,
                                      java.lang.CharSequence actualXml,
                                      java.lang.CharSequence expectedXml)
      • assertIsSubstringOf

        public void assertIsSubstringOf​(AssertionInfo info,
                                        java.lang.CharSequence actual,
                                        java.lang.CharSequence sequence)
      • assertContainsPattern

        public void assertContainsPattern​(AssertionInfo info,
                                          java.lang.CharSequence actual,
                                          java.lang.CharSequence regex)
      • assertContainsPattern

        public void assertContainsPattern​(AssertionInfo info,
                                          java.lang.CharSequence actual,
                                          java.util.regex.Matcher matcher)
      • assertContainsPattern

        public void assertContainsPattern​(AssertionInfo info,
                                          java.lang.CharSequence actual,
                                          java.util.regex.Pattern pattern)
      • assertDoesNotContainPattern

        public void assertDoesNotContainPattern​(AssertionInfo info,
                                                java.lang.CharSequence actual,
                                                java.lang.CharSequence regex)
      • assertDoesNotContainPattern

        public void assertDoesNotContainPattern​(AssertionInfo info,
                                                java.lang.CharSequence actual,
                                                java.util.regex.Pattern pattern)
      • checkCharSequenceArrayDoesNotHaveNullElements

        private static void checkCharSequenceArrayDoesNotHaveNullElements​(java.lang.CharSequence[] values)
      • assertIsEqualToIgnoringNewLines

        public void assertIsEqualToIgnoringNewLines​(AssertionInfo info,
                                                    java.lang.CharSequence actual,
                                                    java.lang.CharSequence expected)
      • assertLowerCase

        public void assertLowerCase​(AssertionInfo info,
                                    java.lang.CharSequence actual)
      • isLowerCase

        private boolean isLowerCase​(java.lang.CharSequence actual)
      • assertUpperCase

        public void assertUpperCase​(AssertionInfo info,
                                    java.lang.CharSequence actual)
      • isUpperCase

        private boolean isUpperCase​(java.lang.CharSequence actual)
      • assertMixedCase

        public void assertMixedCase​(AssertionInfo info,
                                    java.lang.CharSequence actual)
      • assertIsBase64

        public void assertIsBase64​(AssertionInfo info,
                                   java.lang.String actual)
      • removeNewLines

        private static java.lang.String removeNewLines​(java.lang.CharSequence text)
      • doCommonCheckForCharSequence

        public static void doCommonCheckForCharSequence​(AssertionInfo info,
                                                        java.lang.CharSequence actual,
                                                        java.lang.CharSequence[] sequence)