Package com.jgoodies.forms.util
Class FormUtils
java.lang.Object
com.jgoodies.forms.util.FormUtils
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
Modifier and TypeMethodDescriptionstatic 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 isnull
that uses the specified text to describe the object.static void
Clears cached internal Forms state that is based on the Look&Feel, for example dialog base units.static boolean
Checks and answers if the two objects are bothnull
or equal.static boolean
Checks and answers if the given string is whitespace, empty (""), ornull
.static boolean
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 (""), notnull
and not whitespace only.
-
Method Details
-
assertNotBlank
Throws an exception if the specified text is blank using the given text description.- Parameters:
text
- the text to checkdescription
- describes the text, used in the exception message- Throws:
NullPointerException
- iftext
isnull
IllegalArgumentException
- iftext
is empty, or blank
-
assertNotNull
Throws an NPE if the given object isnull
that uses the specified text to describe the object.- Parameters:
object
- the text to checkdescription
- describes the object, used in the exception message- Throws:
NullPointerException
- ifobject
isnull
-
equals
Checks and answers if the two objects are bothnull
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 compareo2
- the second object to compare- Returns:
- boolean
true
if and only if both objects arenull
or equal
-
isBlank
Checks and answers if the given string is whitespace, empty (""), ornull
.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, ornull
-
isNotBlank
Checks and answers if the given string is not empty (""), notnull
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 benull
- Returns:
true
if the string is not empty and notnull
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
-