public class Hex extends Object implements BinaryEncoder, BinaryDecoder
DEFAULT_CHARSET_NAME
Modifier and Type | Field and Description |
---|---|
static String |
DEFAULT_CHARSET_NAME
Default charset name is
CharEncoding.UTF_8 |
Constructor and Description |
---|
Hex()
Creates a new codec with the default charset name
DEFAULT_CHARSET_NAME |
Hex(String csName)
Creates a new codec with the given charset name.
|
Modifier and Type | Method and Description |
---|---|
byte[] |
decode(byte[] array)
Converts an array of character bytes representing hexadecimal values into an array of bytes of those same values.
|
Object |
decode(Object object)
Converts a String or an array of character bytes representing hexadecimal values into an array of bytes of those
same values.
|
static byte[] |
decodeHex(char[] data)
Converts an array of characters representing hexadecimal values into an array of bytes of those same values.
|
byte[] |
encode(byte[] array)
Converts an array of bytes into an array of bytes for the characters representing the hexadecimal values of each
byte in order.
|
Object |
encode(Object object)
Converts a String or an array of bytes into an array of characters representing the hexadecimal values of each
byte in order.
|
static char[] |
encodeHex(byte[] data)
Converts an array of bytes into an array of characters representing the hexadecimal values of each byte in order.
|
static char[] |
encodeHex(byte[] data,
boolean toLowerCase)
Converts an array of bytes into an array of characters representing the hexadecimal values of each byte in order.
|
protected static char[] |
encodeHex(byte[] data,
char[] toDigits)
Converts an array of bytes into an array of characters representing the hexadecimal values of each byte in order.
|
static String |
encodeHexString(byte[] data)
Converts an array of bytes into a String representing the hexadecimal values of each byte in order.
|
String |
getCharsetName()
Gets the charset name.
|
protected static int |
toDigit(char ch,
int index)
Converts a hexadecimal character to an integer.
|
String |
toString()
Returns a string representation of the object, which includes the charset name.
|
public static final String DEFAULT_CHARSET_NAME
CharEncoding.UTF_8
public Hex()
DEFAULT_CHARSET_NAME
public Hex(String csName)
csName
- the charset name.public static byte[] decodeHex(char[] data) throws DecoderException
data
- An array of characters containing hexadecimal digitsDecoderException
- Thrown if an odd number or illegal of characters is suppliedpublic static char[] encodeHex(byte[] data)
data
- a byte[] to convert to Hex characterspublic static char[] encodeHex(byte[] data, boolean toLowerCase)
data
- a byte[] to convert to Hex characterstoLowerCase
- true
converts to lowercase, false
to uppercaseprotected static char[] encodeHex(byte[] data, char[] toDigits)
data
- a byte[] to convert to Hex characterstoDigits
- the output alphabetpublic static String encodeHexString(byte[] data)
data
- a byte[] to convert to Hex charactersprotected static int toDigit(char ch, int index) throws DecoderException
ch
- A character to convert to an integer digitindex
- The index of the character in the sourceDecoderException
- Thrown if ch is an illegal hex characterpublic byte[] decode(byte[] array) throws DecoderException
decode
in interface BinaryDecoder
array
- An array of character bytes containing hexadecimal digitsDecoderException
- Thrown if an odd number of characters is supplied to this functiondecodeHex(char[])
public Object decode(Object object) throws DecoderException
decode
in interface Decoder
object
- A String or, an array of character bytes containing hexadecimal digitsDecoderException
- Thrown if an odd number of characters is supplied to this function or the object is not a String or
char[]decodeHex(char[])
public byte[] encode(byte[] array)
The conversion from hexadecimal characters to the returned bytes is performed with the charset named by
getCharsetName()
.
encode
in interface BinaryEncoder
array
- a byte[] to convert to Hex charactersIllegalStateException
- if the charsetName is invalid. This API throws IllegalStateException
instead of
UnsupportedEncodingException
for backward compatibility.encodeHex(byte[])
public Object encode(Object object) throws EncoderException
The conversion from hexadecimal characters to bytes to be encoded to performed with the charset named by
getCharsetName()
.
encode
in interface Encoder
object
- a String, or byte[] to convert to Hex charactersEncoderException
- Thrown if the given object is not a String or byte[]encodeHex(byte[])
public String getCharsetName()
This software is published under the BSD license. Copyright © 2003-${build.year}, CRIXP AG, Switzerland, All rights reserved. Use is subject to license terms.