Class Assertions


  • public final class Assertions
    extends Object
    Utility class with design by contract checks.
    Since:
    v3.13
    • Method Detail

      • notNull

        public static <T> T notNull​(String name,
                                    T notNull)
                             throws IllegalArgumentException
        Throw an IllegalArgumentException if the string is null
        Parameters:
        name - added to the exception
        notNull - should not be null
        Returns:
        argument being checked.
        Throws:
        IllegalArgumentException - if null
      • containsNoNulls

        public static <C extends Iterable<?>> C containsNoNulls​(String name,
                                                                C containsNoNulls)
                                                         throws IllegalArgumentException
        Throw an IllegalArgumentException if the passed collection is null or contains any null values.
        Parameters:
        name - name added to the exception.
        containsNoNulls - the collection to check.
        Returns:
        the passed in Iterable.
        Throws:
        IllegalArgumentException - if the passed collection is null or contains any null.
      • containsNoNulls

        public static <C> C[] containsNoNulls​(String name,
                                              C[] containsNoNulls)
                                       throws IllegalArgumentException
        Throw an IllegalArgumentException if the passed array is null or contains any null values.
        Parameters:
        name - name added to the exception.
        containsNoNulls - the collection to check.
        Returns:
        the passed in Iterable.
        Throws:
        IllegalArgumentException - if the passed collection is null or contains any null.
      • notBlank

        public static String notBlank​(String name,
                                      String string)
                               throws IllegalArgumentException
        Throw an IllegalArgumentException if the string is null or blank (only contains whitespace)
        Parameters:
        name - added to the exception
        string - should not be null or blank
        Returns:
        argument being checked.
        Throws:
        IllegalArgumentException - if null or blank
      • containsNoBlanks

        public static <C extends Iterable<String>> C containsNoBlanks​(String name,
                                                                      C stringsNotBlank)
        Throw and IllegalArgumentException if the passed collection is null or contains any blank Strings.
        Type Parameters:
        C - the type of the collection of strings.
        Parameters:
        name - name added to the exception
        stringsNotBlank - the collection of strings that should not be blank.
        Returns:
        the passed argument.
        Throws:
        IllegalArgumentException - if the passed collection is null or contains any blank strings.
      • not

        public static void not​(String name,
                               boolean condition)
                        throws IllegalArgumentException
        Throw an IllegalArgumentException if the condition is true
        Parameters:
        name - added to the exception
        condition - should be false
        Throws:
        IllegalArgumentException - if true
      • stateTrue

        public static void stateTrue​(String name,
                                     boolean condition)
                              throws IllegalStateException
        State check. Throw an IllegalStateException if the condition is false
        Parameters:
        name - added to the exception
        condition - should be true
        Throws:
        IllegalStateException - if false
      • stateNotNull

        public static <T> T stateNotNull​(String name,
                                         T notNull)
        State check. Throw an IllegalStateException if the supplied argument is null.
        Parameters:
        name - added to the exception
        notNull - should not be null
        Returns:
        argument being checked.
        Throws:
        IllegalStateException - if false