com.cloudhopper.commons.util

Class HexString

java.lang.Object

com.cloudhopper.commons.util.HexString

public final class HexString
extends Object

Utility class for representing hex strings. Instances are immutable. Hex digits are always in caps. Primarily used to aid testing, the implementation is naive and not performant. NOT RECOMMENDED FOR USE IN PRODUCTION.

Author:

John Woolf (twitter: @jwoolf330 or http://twitter.com/jwoolf330)

Field Summary

Fields

Modifier and Type	Field and Description
static HexString	NULL

Method Summary

Methods

Modifier and Type	Method and Description
byte[]	asBytes() N.B.
String	asString()
boolean	equals(Object other)
int	hashCode()
String	toString()
static HexString	valueOf(byte[] bytes) Create a new HexString instance from the given byte array.
static HexString	valueOf(String hex) Create a new HexString instance from the given hexadecimal string.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

NULL

public static final HexString NULL

Method Detail

valueOf

public static HexString valueOf(String hex)

Create a new HexString instance from the given hexadecimal string. If null or an empty string is passed, will return a HexString instance with empty hex value and zero-length byte array.

Parameters:

hex - The hexadecimal string

Returns:

Immutable HexString instance encapsulating the hexadecimal string

Throws:

IllegalArgumentException - if malformed hex string (invalid or odd number of characters) is passed

valueOf

public static HexString valueOf(byte[] bytes)

Create a new HexString instance from the given byte array. If null or zero-length byte array is passed, will return a HexString instance with empty hex value and zero-length byte array.

Parameters:

bytes - The byte array

Returns:

Immutable HexString instance encapsulating the byte array

asString

public String asString()

Returns:

The instance as an unformatted hex string - i.e. \"AB45C03F\"

asBytes

public byte[] asBytes()

N.B. asBytes() returns a copy of the underlying byte array

Returns:

The instance as its underlying byte array

toString

public String toString()

Overrides:

toString in class Object

equals

public boolean equals(Object other)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object