Class FormUtils


  • public final class FormUtils
    extends java.lang.Object
    A library-internal class that consists only of static utility methods. Note: This class is not part of the public Forms API. It's intended for library implementation purposes only. The class's API may change at any time.
    Since:
    1.2
    Version:
    $Revision: 1.11 $
    Author:
    Karsten Lentzsch
    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static void assertNotBlank​(java.lang.String text, java.lang.String description)
      Throws an exception if the specified text is blank using the given text description.
      static void assertNotNull​(java.lang.Object object, java.lang.String description)
      Throws an NPE if the given object is null that uses the specified text to describe the object.
      static void clearLookAndFeelBasedCaches()
      Clears cached internal Forms state that is based on the Look&Feel, for example dialog base units.
      static boolean equals​(java.lang.Object o1, java.lang.Object o2)
      Checks and answers if the two objects are both null or equal.
      static boolean isBlank​(java.lang.String str)
      Checks and answers if the given string is whitespace, empty (""), or null.
      static boolean isLafAqua()
      Lazily checks and answers whether the Aqua look&feel is active.
      static boolean isNotBlank​(java.lang.String str)
      Checks and answers if the given string is not empty (""), not null and not whitespace only.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Method Detail

      • assertNotBlank

        public static void assertNotBlank​(java.lang.String text,
                                          java.lang.String description)
        Throws an exception if the specified text is blank using the given text description.
        Parameters:
        text - the text to check
        description - describes the text, used in the exception message
        Throws:
        java.lang.NullPointerException - if text is null
        java.lang.IllegalArgumentException - if text is empty, or blank
      • assertNotNull

        public static void assertNotNull​(java.lang.Object object,
                                         java.lang.String description)
        Throws an NPE if the given object is null that uses the specified text to describe the object.
        Parameters:
        object - the text to check
        description - describes the object, used in the exception message
        Throws:
        java.lang.NullPointerException - if object is null
      • equals

        public static boolean equals​(java.lang.Object o1,
                                     java.lang.Object o2)
        Checks and answers if the two objects are both null or equal.
         #equals(null, null)  == true
         #equals("Hi", "Hi")  == true
         #equals("Hi", null)  == false
         #equals(null, "Hi")  == false
         #equals("Hi", "Ho")  == false
         
        Parameters:
        o1 - the first object to compare
        o2 - the second object to compare
        Returns:
        boolean true if and only if both objects are null or equal
      • isBlank

        public static boolean isBlank​(java.lang.String str)
        Checks and answers if the given string is whitespace, empty (""), or null.
         FormUtils.isBlank(null)    == true
         FormUtils.isBlank("")      == true
         FormUtils.isBlank(" ")     == true
         FormUtils.isBlank(" abc")  == false
         FormUtils.isBlank("abc ")  == false
         FormUtils.isBlank(" abc ") == false
         
        Parameters:
        str - the string to check, may benull
        Returns:
        true if the string is whitespace, empty, or null
      • isNotBlank

        public static boolean isNotBlank​(java.lang.String str)
        Checks and answers if the given string is not empty (""), not null and not whitespace only.
         FormUtils.isNotBlank(null)    == false
         FormUtils.isNotBlank("")      == false
         FormUtils.isNotBlank(" ")     == false
         FormUtils.isNotBlank(" abc")  == true
         FormUtils.isNotBlank("abc ")  == true
         FormUtils.isNotBlank(" abc ") == true
         
        Parameters:
        str - the string to check, may be null
        Returns:
        true if the string is not empty and not null and not whitespace only
      • isLafAqua

        public static boolean isLafAqua()
        Lazily checks and answers whether the Aqua look&feel is active.
        Returns:
        true if the current look&feel is Aqua
      • clearLookAndFeelBasedCaches

        public static void clearLookAndFeelBasedCaches()
        Clears cached internal Forms state that is based on the Look&Feel, for example dialog base units.

        There's typically no need to call this method directly. It'll be invoked automatically, if the L&F has been changed via UIManager.setLookAndFeel(javax.swing.LookAndFeel) and cached data is requested. It's been made public to allow cache invalidation for cases where the L&F is changed temporarily by replacing the UIDefaults, for example in a visual editor.

        Since:
        1.2.1