Class B64Code

java.lang.Object
io.protostuff.B64Code
public final class B64Code extends Object
Fast B64 Encoder/Decoder as described in RFC 1421.

Does not insert or interpret whitespace as described in RFC 1521. If you require this you must pre/post process your data.

Note that in a web context the usual case is to not want linebreaks or other white space in the encoded output.

All methods that begin with 'c' will use char arrays (as output on encode, as input on decode).

Author:
Brett Sealey (bretts), Greg Wilkins (gregw), David Yu (dyu)

  • Method Summary

    Modifier and Type
    Method
    Description
    static byte[]
    cdecode(char[] b)
    Fast Base 64 decode as described in RFC 1421.
    static byte[]
    cdecode(char[] input, int inOffset, int inLen)
    Fast Base 64 decode as described in RFC 1421.
    static char[]
    cencode(byte[] input)
    Fast Base 64 encode as described in RFC 1421.
    static char[]
    cencode(byte[] input, int inOffset, int inLen)
    Fast Base 64 encode as described in RFC 1421.
    static byte[]
    decode(byte[] b)
    Fast Base 64 decode as described in RFC 1421.
    static byte[]
    decode(byte[] input, int inOffset, int inLen)
    Fast Base 64 decode as described in RFC 1421.
    static byte[]
    decode(String str)
    Returns the base 64 decoded bytes.
    static byte[]
    decode(String str, int inOffset, int inLen)
    Returns the base 64 decoded bytes.
    static int
    decodeTo(byte[] output, int outOffset, byte[] input, int inOffset, int inLen)
    Returns the length of the decoded base64 input (written to the provided output byte array).
    static int
    decodeTo(byte[] output, int outOffset, String str, int inOffset, int inLen)
    Returns the length of the decoded base64 input (written to the provided output byte array).
    static byte[]
    encode(byte[] input)
    Fast Base 64 encode as described in RFC 1421.
    static byte[]
    encode(byte[] input, int inOffset, int inLen)
    Fast Base 64 encode as described in RFC 1421.
    static LinkedBuffer
    encode(byte[] input, int inOffset, int inLen, WriteSession session, LinkedBuffer lb)
    Encodes the byte array into the LinkedBuffer and grows when full.
    static LinkedBuffer
    sencode(byte[] input, int inOffset, int inLen, WriteSession session, LinkedBuffer lb)
    Encodes the byte array into the LinkedBuffer and flushes to the OutputStream when buffer is full.

    Methods inherited from class Object

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

  • Method Details

    • encode

      public static byte[] encode(byte[] input)
      Fast Base 64 encode as described in RFC 1421.

    • encode

      public static byte[] encode(byte[] input, int inOffset, int inLen)
      Fast Base 64 encode as described in RFC 1421.

    • cencode

      public static char[] cencode(byte[] input)
      Fast Base 64 encode as described in RFC 1421.

    • cencode

      public static char[] cencode(byte[] input, int inOffset, int inLen)
      Fast Base 64 encode as described in RFC 1421.

    • encode

      public static LinkedBuffer encode(byte[] input, int inOffset, int inLen, WriteSession session, LinkedBuffer lb) throws IOException
      Encodes the byte array into the LinkedBuffer and grows when full.
      Throws:
      IOException

    • sencode

      public static LinkedBuffer sencode(byte[] input, int inOffset, int inLen, WriteSession session, LinkedBuffer lb) throws IOException
      Encodes the byte array into the LinkedBuffer and flushes to the OutputStream when buffer is full.
      Throws:
      IOException

    • decode

      public static byte[] decode(byte[] b)
      Fast Base 64 decode as described in RFC 1421.

    • cdecode

      public static byte[] cdecode(char[] b)
      Fast Base 64 decode as described in RFC 1421.

    • decode

      public static byte[] decode(byte[] input, int inOffset, int inLen)
      Fast Base 64 decode as described in RFC 1421.

      Does not attempt to cope with extra whitespace as described in RFC 1521.

      Avoids creating extra copies of the input/output.

      Note this code has been flattened for performance.

      Parameters:
      input - byte array to decode.
      inOffset - the offset.
      inLen - the length.
      Returns:
      byte array containing the decoded form of the input.
      Throws:
      IllegalArgumentException - if the input is not a valid B64 encoding.

    • cdecode

      public static byte[] cdecode(char[] input, int inOffset, int inLen)
      Fast Base 64 decode as described in RFC 1421.

      Does not attempt to cope with extra whitespace as described in RFC 1521.

      Avoids creating extra copies of the input/output.

      Note this code has been flattened for performance.

      Parameters:
      input - char array to decode.
      inOffset - the offset.
      inLen - the length.
      Returns:
      byte array containing the decoded form of the input.
      Throws:
      IllegalArgumentException - if the input is not a valid B64 encoding.

    • decodeTo

      public static int decodeTo(byte[] output, int outOffset, byte[] input, int inOffset, int inLen)
      Returns the length of the decoded base64 input (written to the provided output byte array). The output byte array must have enough capacity or it will fail.

    • decode

      public static byte[] decode(String str)
      Returns the base 64 decoded bytes. The provided str must already be base-64 encoded.

    • decode

      public static byte[] decode(String str, int inOffset, int inLen)
      Returns the base 64 decoded bytes. The provided str must already be base-64 encoded.

    • decodeTo

      public static int decodeTo(byte[] output, int outOffset, String str, int inOffset, int inLen)
      Returns the length of the decoded base64 input (written to the provided output byte array). The output byte array must have enough capacity or it will fail.