org.apache.commons.codec.binary
Class BinaryCodec

java.lang.Object
  org.apache.commons.codec.binary.BinaryCodec

All Implemented Interfaces:

BinaryDecoder, BinaryEncoder, Decoder, Encoder

public class BinaryCodec

extends Object

implements BinaryDecoder, BinaryEncoder

Translates between byte arrays and strings of "0"s and "1"s.

Since:

1.3

Version:

$Id $

Author:

Apache Software Foundation

Field Summary

private static int	BIT_0 Mask for bit 0 of a byte.
private static int	BIT_1 Mask for bit 1 of a byte.
private static int	BIT_2 Mask for bit 2 of a byte.
private static int	BIT_3 Mask for bit 3 of a byte.
private static int	BIT_4 Mask for bit 4 of a byte.
private static int	BIT_5 Mask for bit 5 of a byte.
private static int	BIT_6 Mask for bit 6 of a byte.
private static int	BIT_7 Mask for bit 7 of a byte.
private static int[]	BITS
private static byte[]	EMPTY_BYTE_ARRAY Empty byte array.
private static char[]	EMPTY_CHAR_ARRAY Empty char array.

Constructor Summary

BinaryCodec()

Method Summary

byte[]	decode(byte[] ascii) Decodes a byte array where each byte represents an ascii '0' or '1'.
Object	decode(Object ascii) Decodes a byte array where each byte represents an ascii '0' or '1'.
byte[]	encode(byte[] raw) Converts an array of raw binary data into an array of ascii 0 and 1 characters.
Object	encode(Object raw) Converts an array of raw binary data into an array of ascii 0 and 1 chars.
static byte[]	fromAscii(byte[] ascii) Decodes a byte array where each byte represents an ascii '0' or '1'.
static byte[]	fromAscii(char[] ascii) Decodes a byte array where each char represents an ascii '0' or '1'.
static byte[]	toAsciiBytes(byte[] raw) Converts an array of raw binary data into an array of ascii 0 and 1 character bytes - each byte is a truncated char.
static char[]	toAsciiChars(byte[] raw) Converts an array of raw binary data into an array of ascii 0 and 1 characters.
static String	toAsciiString(byte[] raw) Converts an array of raw binary data into a String of ascii 0 and 1 characters.
byte[]	toByteArray(String ascii) Decodes a String where each char of the String represents an ascii '0' or '1'.

Methods inherited from class java.lang.Object

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

Field Detail

EMPTY_CHAR_ARRAY

private static final char[] EMPTY_CHAR_ARRAY

Empty char array.

EMPTY_BYTE_ARRAY

private static final byte[] EMPTY_BYTE_ARRAY

Empty byte array.

BIT_0

private static final int BIT_0

Mask for bit 0 of a byte.

See Also:

Constant Field Values

BIT_1

private static final int BIT_1

Mask for bit 1 of a byte.

See Also:

Constant Field Values

BIT_2

private static final int BIT_2

Mask for bit 2 of a byte.

See Also:

Constant Field Values

BIT_3

private static final int BIT_3

Mask for bit 3 of a byte.

See Also:

Constant Field Values

BIT_4

private static final int BIT_4

Mask for bit 4 of a byte.

See Also:

Constant Field Values

BIT_5

private static final int BIT_5

Mask for bit 5 of a byte.

See Also:

Constant Field Values

BIT_6

private static final int BIT_6

Mask for bit 6 of a byte.

See Also:

Constant Field Values

BIT_7

private static final int BIT_7

Mask for bit 7 of a byte.

See Also:

Constant Field Values

BITS

private static final int[] BITS

Constructor Detail

BinaryCodec

public BinaryCodec()

Method Detail

encode

public byte[] encode(byte[] raw)

Converts an array of raw binary data into an array of ascii 0 and 1 characters.

Specified by:

encode in interface BinaryEncoder

Parameters:

raw - the raw binary data to convert

Returns:

0 and 1 ascii character bytes one for each bit of the argument

See Also:

BinaryEncoder.encode(byte[])

encode

public Object encode(Object raw)
              throws EncoderException

Converts an array of raw binary data into an array of ascii 0 and 1 chars.

Specified by:

encode in interface Encoder

Parameters:

raw - the raw binary data to convert

Returns:

0 and 1 ascii character chars one for each bit of the argument

Throws:

EncoderException - if the argument is not a byte[]

See Also:

Encoder.encode(java.lang.Object)

decode

public Object decode(Object ascii)
              throws DecoderException

Decodes a byte array where each byte represents an ascii '0' or '1'.

Specified by:

decode in interface Decoder

Parameters:

ascii - each byte represents an ascii '0' or '1'

Returns:

the raw encoded binary where each bit corresponds to a byte in the byte array argument

Throws:

DecoderException - if argument is not a byte[], char[] or String

See Also:

Decoder.decode(java.lang.Object)

decode

public byte[] decode(byte[] ascii)

Decodes a byte array where each byte represents an ascii '0' or '1'.

Specified by:

decode in interface BinaryDecoder

Parameters:

ascii - each byte represents an ascii '0' or '1'

Returns:

the raw encoded binary where each bit corresponds to a byte in the byte array argument

See Also:

Decoder.decode(Object)

toByteArray

public byte[] toByteArray(String ascii)

Decodes a String where each char of the String represents an ascii '0' or '1'.

Parameters:

ascii - String of '0' and '1' characters

Returns:

the raw encoded binary where each bit corresponds to a byte in the byte array argument

See Also:

Decoder.decode(Object)

fromAscii

public static byte[] fromAscii(char[] ascii)

Decodes a byte array where each char represents an ascii '0' or '1'.

Parameters:

ascii - each char represents an ascii '0' or '1'

Returns:

the raw encoded binary where each bit corresponds to a char in the char array argument

fromAscii

public static byte[] fromAscii(byte[] ascii)

Decodes a byte array where each byte represents an ascii '0' or '1'.

Parameters:

ascii - each byte represents an ascii '0' or '1'

Returns:

the raw encoded binary where each bit corresponds to a byte in the byte array argument

toAsciiBytes

public static byte[] toAsciiBytes(byte[] raw)

Converts an array of raw binary data into an array of ascii 0 and 1 character bytes - each byte is a truncated char.

Parameters:

raw - the raw binary data to convert

Returns:

an array of 0 and 1 character bytes for each bit of the argument

See Also:

BinaryEncoder.encode(byte[])

toAsciiChars

public static char[] toAsciiChars(byte[] raw)

Converts an array of raw binary data into an array of ascii 0 and 1 characters.

Parameters:

raw - the raw binary data to convert

Returns:

an array of 0 and 1 characters for each bit of the argument

See Also:

BinaryEncoder.encode(byte[])

toAsciiString

public static String toAsciiString(byte[] raw)

Converts an array of raw binary data into a String of ascii 0 and 1 characters.

Parameters:

raw - the raw binary data to convert

Returns:

a String of 0 and 1 characters representing the binary data

See Also:

BinaryEncoder.encode(byte[])