org.spf4j.base

Class Base64

java.lang.Object

org.spf4j.base.Base64

public final class Base64
extends Object

"improved" implementation based on DataTypeConverterImpl performance should be same/slightly faster than the JDK equivalent But most importantly you can encode/decode parts of a String, which should reduce the need of copying objects and reduce the amount of garbage created.

Author:

zoly

Method Summary

Modifier and Type	Method and Description
static byte[]	decodeBase64(char[] text, int from, int len)
static byte[]	decodeBase64(CharSequence text)
static byte[]	decodeBase64(CharSequence text, int from, int len)
static byte[]	decodeBase64(String text)
static byte[]	decodeBase64(String text, int from, int length)
static byte[]	decodeBase64V2(String text, int from, int length)
static char	encode(int i)
static String	encodeBase64(byte[] input)
static String	encodeBase64(byte[] input, int offset, int len)
static void	encodeBase64(byte[] input, int offset, int len, Appendable result)
static int	encodeBase64(byte[] input, int offset, int len, byte[] out, int cptr) Encodes a byte array into another byte array by first doing base64 encoding then encoding the result in ASCII.
static int	encodeBase64(byte[] input, int offset, int len, char[] output, int cptr) Encodes a byte array into a char array by doing base64 encoding.
static CharSequence	encodeBase64V2(byte[] input, int offset, int len) Alternate implementation, should be better for large data.
static byte	encodeByte(int i)

Methods inherited from class java.lang.Object

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

Method Detail

decodeBase64

public static byte[] decodeBase64(CharSequence text)

decodeBase64

public static byte[] decodeBase64(String text)

decodeBase64

public static byte[] decodeBase64(String text,
                                  int from,
                                  int length)

decodeBase64V2

public static byte[] decodeBase64V2(String text,
                                    int from,
                                    int length)

decodeBase64

public static byte[] decodeBase64(CharSequence text,
                                  int from,
                                  int len)

Parameters:

text - base64Binary data is likely to be long, and decoding requires each character to be accessed twice (once for counting length, another for decoding.)

from - the index of the first character in the sequence.

len - - the number of characters to decode.

Returns:

- the decoded byte array.

decodeBase64

public static byte[] decodeBase64(char[] text,
                                  int from,
                                  int len)

encode

public static char encode(int i)

encodeByte

public static byte encodeByte(int i)

encodeBase64

public static String encodeBase64(byte[] input)

encodeBase64

public static String encodeBase64(byte[] input,
                                  int offset,
                                  int len)

encodeBase64V2

public static CharSequence encodeBase64V2(byte[] input,
                                          int offset,
                                          int len)

Alternate implementation, should be better for large data.

Parameters:

input - - the byte array to encode

offset - - the index of the first byte that is to be encoded.

len - - the number of bytes to encode.

Returns:

- the encoded String.

encodeBase64

public static void encodeBase64(byte[] input,
                                int offset,
                                int len,
                                Appendable result)
                         throws IOException

Throws:

IOException

encodeBase64

public static int encodeBase64(byte[] input,
                               int offset,
                               int len,
                               char[] output,
                               int cptr)

Encodes a byte array into a char array by doing base64 encoding. The caller must supply a big enough buffer.

Parameters:

input - - the byte array to encode.

offset - - the index of the first byte to encode.

len - - the number of bytes to encode.

output - - the destination character array to encode to.

cptr - - the index of the first character to encode to.

Returns:

the value of ptr+((len+2)/3)*4, which is the new offset in the output buffer where the further bytes should be placed.

encodeBase64

public static int encodeBase64(byte[] input,
                               int offset,
                               int len,
                               byte[] out,
                               int cptr)

Encodes a byte array into another byte array by first doing base64 encoding then encoding the result in ASCII. The caller must supply a big enough buffer.

Parameters:

input - - the byte array to encode.

offset - - the index of the first byte to encode.

len - - the number of bytes to encode.

out - - the destination byte array that represents an ASCII string to encode to.

cptr - - the index of the first byte in the destination array to encode to.

Returns:

the value of ptr+((len+2)/3)*4, which is the new offset in the output buffer where the further bytes should be placed.