org.apache.maven.surefire.util.internal

Class StringUtils

java.lang.Object

org.apache.maven.surefire.util.internal.StringUtils

public class StringUtils
extends java.lang.Object

Common String manipulation routines.

Originally from Turbine and the GenerationJavaCore library.

Since:

1.0

Version:

$Id: StringUtils.java 8001 2009-01-03 13:17:09Z vsiveton $

Field Summary

Fields

Modifier and Type	Field and Description
private static java.nio.charset.Charset	DEFAULT_CHARSET
static java.lang.String	FORK_STREAM_CHARSET_NAME
private static byte[]	HEX_CHARS

Constructor Summary

Constructors

Constructor and Description
StringUtils()

Method Summary

Modifier and Type	Method and Description
static java.lang.String	decode(byte[] toDecode, java.nio.charset.Charset charset)
private static int	digit(char ch)
static byte[]	encode(java.lang.String toEncode, java.nio.charset.Charset charset)
static byte[]	encodeStringForForkCommunication(java.lang.String string)
static int	escapeBytesToPrintable(byte[] out, int outoff, byte[] input, int off, int len) Escapes the bytes in the array str to contain only 'printable' bytes.
static void	escapeToPrintable(java.lang.StringBuilder target, java.lang.CharSequence str) Escape the specified string to a representation that only consists of nicely printable characters, without any newlines and without a comma.
static boolean	isBlank(java.lang.String str) Checks if a (trimmed) String is null or blank.
static boolean	isNotBlank(java.lang.String str) Checks if a (trimmed) String is not null and not blank.
static <T> T	requireNonNull(T obj)
static <T> T	requireNonNull(T obj, java.lang.String message)
static java.lang.String[]	split(java.lang.String text, java.lang.String separator)
static java.nio.ByteBuffer	unescapeBytes(java.lang.String str, java.lang.String charsetName) Reverses the effect of escapeBytesToPrintable(byte[], int, byte[], int, int).
static void	unescapeString(java.lang.StringBuilder target, java.lang.CharSequence str) Reverses the effect of escapeToPrintable(StringBuilder, CharSequence).

Methods inherited from class java.lang.Object

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

Field Detail

HEX_CHARS

private static final byte[] HEX_CHARS

DEFAULT_CHARSET

private static final java.nio.charset.Charset DEFAULT_CHARSET

FORK_STREAM_CHARSET_NAME

public static final java.lang.String FORK_STREAM_CHARSET_NAME

See Also:

Constant Field Values

Constructor Detail

StringUtils

public StringUtils()

Method Detail

split

public static java.lang.String[] split(java.lang.String text,
                                       java.lang.String separator)

isBlank

public static boolean isBlank(java.lang.String str)

Checks if a (trimmed) String is null or blank.

Parameters:

str - the String to check

Returns:

true if the String is null, or length zero once trimmed

isNotBlank

public static boolean isNotBlank(java.lang.String str)

Checks if a (trimmed) String is not null and not blank.

Parameters:

str - the String to check

Returns:

true if the String is not null and length of trimmed str is not zero.

escapeToPrintable

public static void escapeToPrintable(java.lang.StringBuilder target,
                                     java.lang.CharSequence str)

Escape the specified string to a representation that only consists of nicely printable characters, without any newlines and without a comma.

The reverse-method is unescapeString(StringBuilder, CharSequence).

Parameters:

target - target string buffer. The required space will be up to str.getBytes().length * 5 chars.

str - String to escape values in, may be null.

unescapeString

public static void unescapeString(java.lang.StringBuilder target,
                                  java.lang.CharSequence str)

Reverses the effect of escapeToPrintable(StringBuilder, CharSequence).

Parameters:

target - target string buffer

str - the String to un-escape, as created by escapeToPrintable(StringBuilder, CharSequence)

digit

private static int digit(char ch)

escapeBytesToPrintable

public static int escapeBytesToPrintable(byte[] out,
                                         int outoff,
                                         byte[] input,
                                         int off,
                                         int len)

Escapes the bytes in the array str to contain only 'printable' bytes.

Escaping is done by encoding the non-nicely printable bytes to '\' + upperCaseHexBytes(byte).

A save length of out is len * 3 + outoff.

The reverse-method is #unescapeBytes(byte[], String).

Parameters:

out - output buffer

outoff - offset in the output buffer

input - input buffer

off - offset in the input buffer

len - number of bytes to copy from the input buffer

Returns:

number of bytes written to out

unescapeBytes

public static java.nio.ByteBuffer unescapeBytes(java.lang.String str,
                                                java.lang.String charsetName)

Reverses the effect of escapeBytesToPrintable(byte[], int, byte[], int, int).

Parameters:

str - the input String

charsetName - the charset name

Returns:

the number of bytes written to out

decode

public static java.lang.String decode(byte[] toDecode,
                                      java.nio.charset.Charset charset)

encode

public static byte[] encode(java.lang.String toEncode,
                            java.nio.charset.Charset charset)

encodeStringForForkCommunication

public static byte[] encodeStringForForkCommunication(java.lang.String string)

requireNonNull

public static <T> T requireNonNull(T obj,
                                   java.lang.String message)

requireNonNull

public static <T> T requireNonNull(T obj)