com.jgoodies.forms.util

Class FormUtils

java.lang.Object

com.jgoodies.forms.util.FormUtils

public final class FormUtils
extends java.lang.Object

Consists only of static utility methods. This class may be merged with the FormLayoutUtils extra - or not.

Since:

1.2

Version:

$Revision: 1.5 $

Author:

Karsten Lentzsch

Method Summary

Modifier and Type	Method and 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 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