Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## com.jgoodies.forms.util
Class FormUtils

    java.lang.Object
      com.jgoodies.forms.util.FormUtils

    public final class FormUtils

extends 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
`static void` | `assertNotBlank(String text, String description)` Throws an exception if the specified text is blank using the given text description.
`static void` | `assertNotNull(Object object, 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(Object o1, Object o2)` Checks and answers if the two objects are both `null` or equal.
`static boolean` | `isBlank(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(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(String text,
                                      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:
    `NullPointerException` - if `text` is `null`
    `IllegalArgumentException` - if `text` is empty, or blank

### assertNotNull

    public static void assertNotNull(Object object,
                                     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:
    `NullPointerException` - if `object` is `null`

### equals

    public static boolean equals(Object o1,
                                 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(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 be`null`
  Returns:
    `true` if the string is whitespace, empty, or `null`

### isNotBlank

    public static boolean isNotBlank(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

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Copyright © 2002-2009 JGoodies Karsten Lentzsch. All Rights Reserved.