Package org.atlanmod.commons.primitive

Class Strings

java.lang.Object

org.atlanmod.commons.primitive.Strings

@ParametersAreNonnullByDefault
public final class Strings
extends Object

Static utility methods related to String.

Field Summary

Fields

Modifier and Type	Field	Description
static String	EMPTY	The empty string "".
static String	LR	A string for a line separator character, dependencing on the system.
static String	SPACE	A string for a space character.

Method Summary

Modifier and Type	Method	Description
static String	emptyToNull(String s)	Returns the given string if it is nonempty; null otherwise.
static boolean	isBinary(String value)	Returns true if the value represents an hexadecimal value.
static boolean	isNullOrEmpty(String s)	Returns true if the given string is null or is the empty string.
static String	nullToEmpty(String s)	Returns the given string if it is non-null; the empty string otherwise.
static byte[]	toBytes(String value)	Encodes a String to a byte array.
static byte[]	toBytesBinary(String value)	Encodes a String to a byte array, where each byte is represented as a two-digit unsigned hexadecimal number in lower case.

Methods inherited from class java.lang.Object

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

Field Detail

EMPTY

@Nonnull
public static final String EMPTY

The empty string "".

See Also:

Constant Field Values

SPACE

@Nonnull
public static final String SPACE

A string for a space character.

See Also:

Constant Field Values

LR

@Nonnull
public static final String LR

A string for a line separator character, dependencing on the system.

See Also:

System.lineSeparator()

Method Detail

isNullOrEmpty

public static boolean isNullOrEmpty(@Nullable
                                    String s)

Returns true if the given string is null or is the empty string.

Parameters:

s - a string reference to check

Returns:

true if the string is null or is the empty string

nullToEmpty

@Nonnull
public static String nullToEmpty(@Nullable
                                 String s)

Returns the given string if it is non-null; the empty string otherwise.

Parameters:

s - the string to test and possibly return

Returns:

s itself if it is non-null; EMPTY if it is null

emptyToNull

@CheckForNull
public static String emptyToNull(@Nullable
                                 String s)

Returns the given string if it is nonempty; null otherwise.

Parameters:

s - the string to test and possibly return

Returns:

s itself if it is nonempty; null if it is empty or null

toBytes

@Nonnull
public static byte[] toBytes(String value)

Encodes a String to a byte array.

Parameters:

value - the value to encode

Returns:

a byte array

Throws:

NullPointerException - if the value is null

IllegalArgumentException - if StandardCharsets.UTF_8 is not a supported encoding

toBytesBinary

@Nonnull
public static byte[] toBytesBinary(String value)

Encodes a String to a byte array, where each byte is represented as a two-digit unsigned hexadecimal number in lower case.

Parameters:

value - the value to encode

Returns:

a byte array

Throws:

NullPointerException - if the value is null

IllegalArgumentException - if the length of the value is not even.

See Also:

Bytes.toStringBinary(byte[])

isBinary

public static boolean isBinary(String value)

Returns true if the value represents an hexadecimal value.

Parameters:

value - the string to test

Returns:

true if the value represents an hexadecimal value