org.owasp.esapi.codecs

Class Hex

java.lang.Object

org.owasp.esapi.codecs.Hex

public class Hex
extends java.lang.Object

Encode and decode to/from hexadecimal strings to byte arrays.

Constructor Summary

Constructors

Constructor and Description
Hex()

Method Summary

Modifier and Type	Method and Description
static byte[]	decode(java.lang.String hexStr) Decode hexadecimal-encoded string and return raw byte array.
static java.lang.String	encode(byte[] b, boolean leading0x) Output byte representation as hexadecimal representation.
static byte[]	fromHex(java.lang.String hexStr) Decode hexadecimal-encoded string and return raw byte array.
static java.lang.String	toHex(byte[] b, boolean leading0x) Output byte representation as hexadecimal representation.

Methods inherited from class java.lang.Object

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

Constructor Detail

Hex

public Hex()

Method Detail

toHex

public static java.lang.String toHex(byte[] b,
                                     boolean leading0x)

Output byte representation as hexadecimal representation.

Parameters:

b - Bytes to encode to hexadecimal representation.

leading0x - If true, return with leading "0x".

Returns:

Hexadecimal representation of specified bytes.

encode

public static java.lang.String encode(byte[] b,
                                      boolean leading0x)

Output byte representation as hexadecimal representation. Alias for toHex() method.

Parameters:

b - Bytes to encode to hexadecimal representation.

leading0x - If true, return with leading "0x".

Returns:

Hexadecimal representation of specified bytes.

fromHex

public static byte[] fromHex(java.lang.String hexStr)

Decode hexadecimal-encoded string and return raw byte array. Important note: This method preserves leading 0 filled bytes on the conversion process, which is important for cryptographic operations in dealing with things like keys, initialization vectors, etc. For example, the string "0x0000face" is going to return a byte array whose length is 4, not 2.

Parameters:

hexStr - Hexadecimal-encoded string, with or without leading "0x".

Returns:

The equivalent byte array.

decode

public static byte[] decode(java.lang.String hexStr)

Decode hexadecimal-encoded string and return raw byte array. Alias for fromHex() method.

Parameters:

hexStr - Hexadecimal-encoded string, with or without leading "0x".

Returns:

The equivalent byte array.