io.undertow.util

Class FlexBase64.Decoder

java.lang.Object

io.undertow.util.FlexBase64.Decoder

Enclosing class:

FlexBase64

public static final class FlexBase64.Decoder
extends Object

Controls the decoding process.

Method Summary

Methods

Modifier and Type	Method and Description
int	decode(byte[] source, int sourcePos, int sourceLimit, byte[] target, int targetPos, int targetLimit) Decodes one Base64 byte array into another byte array.
void	decode(ByteBuffer source, ByteBuffer target) Decodes one Base64 byte buffer into another.
int	decode(String source, byte[] target) Decodes a Base64 encoded string into the passed byte array.
int	decode(String source, int sourcePos, int sourceLimit, byte[] target, int targetPos, int targetLimit) Decodes one Base64 byte array into another byte array.
int	getLastInputPosition() Gets the last position where decoding left off in the last byte array that was used for reading.

Methods inherited from class java.lang.Object

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

Method Detail

decode

public void decode(ByteBuffer source,
          ByteBuffer target)
            throws IOException

Decodes one Base64 byte buffer into another. This method will return and save state if the target does not have the required capacity. Subsequent calls with a new target will resume reading where it last left off (the source buffer's position). Similarly not all of the source data need be available, this method can be repetitively called as data is made available.

The decoder will skip white space, but will error if it detects corruption.

Parameters:

source - the byte buffer to read encoded data from

target - the byte buffer to write decoded data to

Throws:

IOException - if the encoded data is corrupted

getLastInputPosition

public int getLastInputPosition()

Gets the last position where decoding left off in the last byte array that was used for reading. If the target for decoded content does not have the necessary capacity, this method should be used to determine where to start from on subsequent decode calls.

Returns:

the last known read position

decode

public int decode(String source,
         int sourcePos,
         int sourceLimit,
         byte[] target,
         int targetPos,
         int targetLimit)
           throws IOException

Decodes one Base64 byte array into another byte array. If the source limit is hit, this method will return and save the current state, such that future calls can resume the decoding process. Likewise, if the target does not have the capacity, this method will also return and save state for subsequent calls to this method.

When multiple calls are made, getLastInputPosition() should be used to determine what value should be set for sourcePos. Likewise, the returned target position should be used as the targetPos in a subsequent call.

The decoder will skip white space, but will error if it detects corruption.

Parameters:

source - a Base64 encoded string to decode data from

sourcePos - the position in the source array to start decoding from

sourceLimit - the position in the source array to halt decoding when hit (exclusive)

target - the byte buffer to write decoded data to

targetPos - the position in the target byte array to begin writing at

targetLimit - the position in the target byte array to halt writing (exclusive)

Returns:

the position in the target array immediately following the last byte written

Throws:

IOException - if the encoded data is corrupted

decode

public int decode(String source,
         byte[] target)
           throws IOException

Decodes a Base64 encoded string into the passed byte array. This method will return and save state if the target does not have the required capacity. Subsequent calls with a new target will resume reading where it last left off (the source buffer's position). Similarly not all of the source data need be available, this method can be repetitively called as data is made available.

Since this method variant assumes a position of 0 and a limit of the item length, repeated calls will need fresh source and target values. decode(String, int, int, byte[], int, int) would be a better fit if you need reuse

The decoder will skip white space, but will error if it detects corruption.

Parameters:

source - a base64 encoded string to decode from

target - a byte array to write to

Returns:

output position following the last written byte

Throws:

IOException - if the base64 content is malformed

decode

public int decode(byte[] source,
         int sourcePos,
         int sourceLimit,
         byte[] target,
         int targetPos,
         int targetLimit)
           throws IOException

Decodes one Base64 byte array into another byte array. If the source limit is hit, this method will return and save the current state, such that future calls can resume the decoding process. Likewise, if the target does not have the capacity, this method will also return and save state for subsequent calls to this method.

When multiple calls are made, getLastInputPosition() should be used to determine what value should be set for sourcePos. Likewise, the returned target position should be used as the targetPos in a subsequent call.

The decoder will skip white space, but will error if it detects corruption.

  Decoder decoder = FlexBase64.createDecoder();
  byte[] outBuffer = new byte[10];
  byte[] bytes = "aGVsbG8=".getBytes("US-ASCII");
  // Decode only 2 bytes
  int outPosition = decoder.decode(bytes, 0, 8, outBuffer, 5, 7);
  // Resume where we left off and get the rest
  outPosition = decoder.decode(bytes, decoder.getLastInputPosition(), 8, outBuffer, outPosition, 10);
  // Prints "10 : Hello"
  System.out.println(outPosition + " : " + new String(outBuffer, 0, 5, outPosition - 5));
 

Parameters:

source - the byte array to read encoded data from

sourcePos - the position in the source array to start decoding from

sourceLimit - the position in the source array to halt decoding when hit (exclusive)

target - the byte buffer to write decoded data to

targetPos - the position in the target byte array to begin writing at

targetLimit - the position in the target byte array to halt writing (exclusive)

Returns:

the position in the target array immediately following the last byte written

Throws:

IOException - if the encoded data is corrupted