depends.org.apache.commons.codec.binary

类 Hex

java.lang.Object

depends.org.apache.commons.codec.binary.Hex

所有已实现的接口:

BinaryDecoder, BinaryEncoder, Decoder, Encoder

public class Hex
extends java.lang.Object
implements BinaryEncoder, BinaryDecoder

Converts hexadecimal Strings. The charset used for certain operation can be set, the default is set in DEFAULT_CHARSET_NAME

从以下版本开始:

1.1

字段概要

字段

限定符和类型	字段和说明
static java.lang.String	DEFAULT_CHARSET_NAME Default charset name is CharEncoding.UTF_8

构造器概要

构造器

构造器和说明
Hex() Creates a new codec with the default charset name DEFAULT_CHARSET_NAME
Hex(java.lang.String csName) Creates a new codec with the given charset name.

方法概要

方法

限定符和类型	方法和说明
byte[]	decode(byte[] array) Converts an array of character bytes representing hexadecimal values into an array of bytes of those same values.
java.lang.Object	decode(java.lang.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.
java.lang.Object	encode(java.lang.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 java.lang.String	encodeHexString(byte[] data) Converts an array of bytes into a String representing the hexadecimal values of each byte in order.
java.lang.String	getCharsetName() Gets the charset name.
protected static int	toDigit(char ch, int index) Converts a hexadecimal character to an integer.
java.lang.String	toString() Returns a string representation of the object, which includes the charset name.

从类继承的方法 java.lang.Object

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

字段详细资料

DEFAULT_CHARSET_NAME

public static final java.lang.String DEFAULT_CHARSET_NAME

Default charset name is CharEncoding.UTF_8

从以下版本开始:

1.4

另请参阅:

常量字段值

构造器详细资料

Hex

public Hex()

Creates a new codec with the default charset name DEFAULT_CHARSET_NAME

Hex

public Hex(java.lang.String csName)

Creates a new codec with the given charset name.

参数:

csName - the charset name.

从以下版本开始:

1.4

方法详细资料

decodeHex

public static byte[] decodeHex(char[] data)
                        throws DecoderException

Converts an array of characters representing hexadecimal values into an array of bytes of those same values. The returned array will be half the length of the passed array, as it takes two characters to represent any given byte. An exception is thrown if the passed char array has an odd number of elements.

参数:

data - An array of characters containing hexadecimal digits

返回:

A byte array containing binary data decoded from the supplied char array.

抛出:

DecoderException - Thrown if an odd number or illegal of characters is supplied

encodeHex

public static char[] encodeHex(byte[] data)

Converts an array of bytes into an array of characters representing the hexadecimal values of each byte in order. The returned array will be double the length of the passed array, as it takes two characters to represent any given byte.

参数:

data - a byte[] to convert to Hex characters

返回:

A char[] containing hexadecimal characters

encodeHex

public 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. The returned array will be double the length of the passed array, as it takes two characters to represent any given byte.

参数:

data - a byte[] to convert to Hex characters

toLowerCase - true converts to lowercase, false to uppercase

返回:

A char[] containing hexadecimal characters

从以下版本开始:

1.4

encodeHex

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. The returned array will be double the length of the passed array, as it takes two characters to represent any given byte.

参数:

data - a byte[] to convert to Hex characters

toDigits - the output alphabet

返回:

A char[] containing hexadecimal characters

从以下版本开始:

1.4

encodeHexString

public static java.lang.String encodeHexString(byte[] data)

Converts an array of bytes into a String representing the hexadecimal values of each byte in order. The returned String will be double the length of the passed array, as it takes two characters to represent any given byte.

参数:

data - a byte[] to convert to Hex characters

返回:

A String containing hexadecimal characters

从以下版本开始:

1.4

toDigit

protected static int toDigit(char ch,
          int index)
                      throws DecoderException

Converts a hexadecimal character to an integer.

参数:

ch - A character to convert to an integer digit

index - The index of the character in the source

返回:

An integer

抛出:

DecoderException - Thrown if ch is an illegal hex character

decode

public byte[] decode(byte[] array)
              throws DecoderException

Converts an array of character bytes representing hexadecimal values into an array of bytes of those same values. The returned array will be half the length of the passed array, as it takes two characters to represent any given byte. An exception is thrown if the passed char array has an odd number of elements.

指定者:

decode 在接口中 BinaryDecoder

参数:

array - An array of character bytes containing hexadecimal digits

返回:

A byte array containing binary data decoded from the supplied byte array (representing characters).

抛出:

DecoderException - Thrown if an odd number of characters is supplied to this function

另请参阅:

decodeHex(char[])

decode

public java.lang.Object decode(java.lang.Object object)
                        throws DecoderException

Converts a String or an array of character bytes representing hexadecimal values into an array of bytes of those same values. The returned array will be half the length of the passed String or array, as it takes two characters to represent any given byte. An exception is thrown if the passed char array has an odd number of elements.

指定者:

decode 在接口中 Decoder

参数:

object - A String or, an array of character bytes containing hexadecimal digits

返回:

A byte array containing binary data decoded from the supplied byte array (representing characters).

抛出:

DecoderException - Thrown if an odd number of characters is supplied to this function or the object is not a String or char[]

另请参阅:

decodeHex(char[])

encode

public 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. The returned array will be double the length of the passed array, as it takes two characters to represent any given byte.

The conversion from hexadecimal characters to the returned bytes is performed with the charset named by getCharsetName().

指定者:

encode 在接口中 BinaryEncoder

参数:

array - a byte[] to convert to Hex characters

返回:

A byte[] containing the bytes of the hexadecimal characters

抛出:

java.lang.IllegalStateException - if the charsetName is invalid. This API throws IllegalStateException instead of UnsupportedEncodingException for backward compatibility.

另请参阅:

encodeHex(byte[])

encode

public java.lang.Object encode(java.lang.Object object)
                        throws EncoderException

Converts a String or an array of bytes into an array of characters representing the hexadecimal values of each byte in order. The returned array will be double the length of the passed String or array, as it takes two characters to represent any given byte.

The conversion from hexadecimal characters to bytes to be encoded to performed with the charset named by getCharsetName().

指定者:

encode 在接口中 Encoder

参数:

object - a String, or byte[] to convert to Hex characters

返回:

A char[] containing hexadecimal characters

抛出:

EncoderException - Thrown if the given object is not a String or byte[]

另请参阅:

encodeHex(byte[])

getCharsetName

public java.lang.String getCharsetName()

Gets the charset name.

返回:

the charset name.

从以下版本开始:

1.4

toString

public java.lang.String toString()

Returns a string representation of the object, which includes the charset name.

覆盖:

toString 在类中 java.lang.Object

返回:

a string representation of the object.