com.tomtom.speedtools.checksums

Class HexString

java.lang.Object

com.tomtom.speedtools.checksums.HexString

public final class HexString
extends Object

Utility class for hexadecimal representation of strings and arrays of bytes.

Method Summary

Modifier and Type	Method and Description
static byte[]	getHexByteArray(String hexValue) Convert a hex value string to an array of bytes
static String	getHexString(byte[] bytes) Convert an array of bytes to a hex value string.
static String	getHexString(String textValue) String to hexify.

Methods inherited from class java.lang.Object

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

Method Detail

getHexString

@Nonnull
public static String getHexString(@Nonnull
                                           String textValue)

String to hexify.

Parameters:

textValue - Input textual string (eg. "something"). Cannot be null, cannot be empty.

Returns:

Hexadecimal representation of string; the length of the string is always even, as all characters are represented by 2-char hex digits. Cannot be null, cannot be empty.

getHexString

@Nonnull
public static String getHexString(@Nonnull
                                           byte[] bytes)

Convert an array of bytes to a hex value string.

Parameters:

bytes - Input bytes. Cannot be null, cannot be empty.

Returns:

Hexadecimal representation of string (eg. "2abc"); the length of the string is always even as every byte is encoded as a 2-char hex digit pair. Cannot be null, cannot be empty.

getHexByteArray

@Nonnull
public static byte[] getHexByteArray(@Nonnull
                                              String hexValue)

Convert a hex value string to an array of bytes

Parameters:

hexValue - Input hex value string (eg. "2abc"). Cannot be null, cannot be empty. Number 0-9 and both upper- and lowercase hex characters a-f are accepted. If the input value string length is not even, a '0' is prepended to it and the string is interpreted as consisting of 2-char hex digit pairs.

Returns:

Decoded bytes, or null of the input string was empty.

Throws:

IllegalArgumentException - If the hexValue string contains non-hex characters.