org.eclipse.californium.elements.util

Class StringUtil

java.lang.Object

org.eclipse.californium.elements.util.StringUtil

public class StringUtil
extends Object

String utils (as there are so many already out).

Field Summary

Fields

Modifier and Type	Field and Description
static String	lineSeparator Workaround too support android API 16-18.
static char	NO_SEPARATOR Special character to signal, that no separator should be used when byte array are converted to hexadecimal strings.
static boolean	SUPPORT_HOST_STRING Flag indicating, that InetSocketAddress supports "getHostString".

Constructor Summary

Constructors

Constructor and Description
StringUtil()

Method Summary

Methods

Modifier and Type	Method and Description
static String	byteArray2Hex(byte[] byteArray) Byte array to hexadecimal string without separator.
static String	byteArray2HexString(byte[] byteArray, char sep, int max) Byte array to hexadecimal display string.
static byte[]	hex2ByteArray(String hex) Convert hexadecimal String into decoded byte array.
static char[]	hex2CharArray(String hex) Convert hexadecimal String into decoded character array.
static boolean	isValidHostName(String name) Checks if a given string is a valid host name as defined by RFC 1123.
static String	lineSeparator() Return line separator.
static String	toString(InetAddress address) Get address as string for logging.
static String	toString(InetSocketAddress address) Get socket address as string for logging.
static String	trunc(String text, int maxLength) Truncate provided string.

Methods inherited from class java.lang.Object

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

Field Detail

NO_SEPARATOR

public static final char NO_SEPARATOR

Special character to signal, that no separator should be used when byte array are converted to hexadecimal strings.

See Also:

byteArray2HexString(byte[], char, int), Constant Field Values

lineSeparator

public static final String lineSeparator

Workaround too support android API 16-18.

See Also:

lineSeparator()

SUPPORT_HOST_STRING

public static final boolean SUPPORT_HOST_STRING

Flag indicating, that InetSocketAddress supports "getHostString".

Constructor Detail

StringUtil

public StringUtil()

Method Detail

lineSeparator

public static String lineSeparator()

Return line separator.

Returns:

line separator

See Also:

lineSeparator

hex2CharArray

public static char[] hex2CharArray(String hex)

Convert hexadecimal String into decoded character array. Intended to be used for passwords.

Parameters:

hex - hexadecimal string. e.g. "4130010A"

Returns:

character array with decoded hexadecimal input parameter. e.g. char[] { 'A', '0', 0x01, '\n' }.

Throws:

IllegalArgumentException - if the parameter length is odd or contains non hexadecimal characters.

hex2ByteArray

public static byte[] hex2ByteArray(String hex)

Convert hexadecimal String into decoded byte array.

Parameters:

hex - hexadecimal string. e.g. "4130010A"

Returns:

byte array with decoded hexadecimal input parameter.

Throws:

IllegalArgumentException - if the parameter length is odd or contains non hexadecimal characters.

See Also:

byteArray2Hex(byte[])

byteArray2Hex

public static String byteArray2Hex(byte[] byteArray)

Byte array to hexadecimal string without separator.

Parameters:

byteArray - byte array to be converted to string.

Returns:

hexadecimal string, e.g "0142A3". null, if the provided byte array is null. "", if provided byte array is empty.

See Also:

hex2ByteArray(String)

byteArray2HexString

public static String byteArray2HexString(byte[] byteArray,
                         char sep,
                         int max)

Byte array to hexadecimal display string.

Parameters:

byteArray - byte array to be converted to string

sep - separator. If NO_SEPARATOR, then no separator is used between the bytes.

max - maximum bytes to be converted. 0 to convert all bytes.

Returns:

hexadecimal string, e.g "01:45:A4", if ':' is used as separator. "--", if byte array is null or empty.

trunc

public static String trunc(String text,
           int maxLength)

Truncate provided string.

Parameters:

text - string to be truncated, if length is over the provided maxLength

maxLength - maximum length of string. (0 doesn't truncate)

Returns:

truncated or original string

toString

public static String toString(InetAddress address)

Get address as string for logging.

Parameters:

address - address to be converted to string

Returns:

the host address, or null, if address is null.

toString

public static String toString(InetSocketAddress address)

Get socket address as string for logging.

Parameters:

address - socket address to be converted to string

Returns:

the host string, if available, otherwise the host address, both appended with ":" and the port. Or null, if address is null.

isValidHostName

public static boolean isValidHostName(String name)

Checks if a given string is a valid host name as defined by RFC 1123.

Parameters:

name - The name to check.

Returns:

true if the name is a valid host name.