net.obvj.jsonmerge.util

Class StringUtils

java.lang.Object

net.obvj.jsonmerge.util.StringUtils

public class StringUtils
extends Object

Common methods for working with strings.

Since:

1.0.0

Author:

oswaldo.bapvic.jr (Oswaldo Junior)

Method Summary

Modifier and Type	Method and Description
static boolean	isBlank(CharSequence charSequence) Checks if a CharSequence is empty (""), null or whitespace only.
static boolean	isEmpty(CharSequence charSequence) Checks if a CharSequence is empty ("") or null.
static String	requireNonBlankAndTrim(String string, String message) Checks that the specified string is not null, empty (""), or blank (containing whitespace only).

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

requireNonBlankAndTrim

public static String requireNonBlankAndTrim(String string,
                                            String message)

Checks that the specified string is not null, empty (""), or blank (containing whitespace only). If the string is valid, returns a copy of it, trimmed; otherwise, throws an IllegalArgumentException.

This method is designed primarily for doing parameter validation in methods and constructors with multiple parameters, as demonstrated below:

 public Foo(Bar bar)
 {
     this.bar = StringUtils.requireNonBlankAndTrim(bar, "bar must not be blank");
 }
 

Parameters:

string - the string to check

message - detail message for the exception to be used if the string a blank

Returns:

string, trimmed, if not null or blank

Throws:

IllegalArgumentException - if string is null or blank

Since:

1.0.0

isEmpty

public static boolean isEmpty(CharSequence charSequence)

Checks if a CharSequence is empty ("") or null.

Parameters:

charSequence - the CharSequence to check, may be null

Returns:

true if the CharSequence is empty or null

Since:

1.1.0

isBlank

public static boolean isBlank(CharSequence charSequence)

Checks if a CharSequence is empty (""), null or whitespace only.

Parameters:

charSequence - the CharSequence to check, may be null

Returns:

true if the CharSequence is null, empty or whitespace only

Since:

1.1.0