Base64
public class Base64
extends Object
| java.lang.Object | |
| ↳ | android.util.Base64 |
Utilities for encoding and decoding the Base64 representation of binary data. See RFCs 2045 and 3548.
Summary
Constants | |
|---|---|
int | CRLF Encoder flag bit to indicate lines should be terminated with a CRLF pair instead of just an LF. |
int | DEFAULT Default values for encoder/decoder flags. |
int | NO_CLOSE Flag to pass to |
int | NO_PADDING Encoder flag bit to omit the padding '=' characters at the end of the output (if any). |
int | NO_WRAP Encoder flag bit to omit all line terminators (i.e., the output will be on one long line). |
int | URL_SAFE Encoder/decoder flag bit to indicate using the "URL and filename safe" variant of Base64 (see RFC 3548 section 4) where |
Public methods | |
|---|---|
static byte[] | decode(String str, int flags) Decode the Base64-encoded data in input and return the data in a new byte array. |
static byte[] | decode(byte[] input, int flags) Decode the Base64-encoded data in input and return the data in a new byte array. |
static byte[] | decode(byte[] input, int offset, int len, int flags) Decode the Base64-encoded data in input and return the data in a new byte array. |
static byte[] | encode(byte[] input, int flags) Base64-encode the given data and return a newly allocated byte[] with the result. |
static byte[] | encode(byte[] input, int offset, int len, int flags) Base64-encode the given data and return a newly allocated byte[] with the result. |
static String | encodeToString(byte[] input, int offset, int len, int flags) Base64-encode the given data and return a newly allocated String with the result. |
static String | encodeToString(byte[] input, int flags) Base64-encode the given data and return a newly allocated String with the result. |
Inherited methods | |
|---|---|
Constants
CRLF
public static final int CRLF
Encoder flag bit to indicate lines should be terminated with a CRLF pair instead of just an LF. Has no effect if NO_WRAP is specified as well.
Constant Value: 4 (0x00000004)
DEFAULT
public static final int DEFAULT
Default values for encoder/decoder flags.
Constant Value: 0 (0x00000000)
NO_CLOSE
public static final int NO_CLOSE
Flag to pass to Base64OutputStream to indicate that it should not close the output stream it is wrapping when it itself is closed.
Constant Value: 16 (0x00000010)
NO_PADDING
public static final int NO_PADDING
Encoder flag bit to omit the padding '=' characters at the end of the output (if any).
Constant Value: 1 (0x00000001)
NO_WRAP
public static final int NO_WRAP
Encoder flag bit to omit all line terminators (i.e., the output will be on one long line).
Constant Value: 2 (0x00000002)
URL_SAFE
public static final int URL_SAFE
Encoder/decoder flag bit to indicate using the "URL and filename safe" variant of Base64 (see RFC 3548 section 4) where - and _ are used in place of + and /.
Constant Value: 8 (0x00000008)
Public methods
decode
public static byte[] decode (String str, int flags)
Decode the Base64-encoded data in input and return the data in a new byte array.
The padding '=' characters at the end are considered optional, but if any are present, there must be the correct number of them.
| Parameters | |
|---|---|
str | String: the input String to decode, which is converted to bytes using the default charset |
flags | int: controls certain features of the decoded output. Pass DEFAULT to decode standard Base64. |
| Returns | |
|---|---|
byte[] | |
| Throws | |
|---|---|
IllegalArgumentException | if the input contains incorrect padding |
decode
public static byte[] decode (byte[] input, int flags)
Decode the Base64-encoded data in input and return the data in a new byte array.
The padding '=' characters at the end are considered optional, but if any are present, there must be the correct number of them.
| Parameters | |
|---|---|
input | byte: the input array to decode |
flags | int: controls certain features of the decoded output. Pass DEFAULT to decode standard Base64. |
| Returns | |
|---|---|
byte[] | |
| Throws | |
|---|---|
IllegalArgumentException | if the input contains incorrect padding |
decode
public static byte[] decode (byte[] input, int offset, int len, int flags)
Decode the Base64-encoded data in input and return the data in a new byte array.
The padding '=' characters at the end are considered optional, but if any are present, there must be the correct number of them.
| Parameters | |
|---|---|
input | byte: the data to decode |
offset | int: the position within the input array at which to start |
len | int: the number of bytes of input to decode |
flags | int: controls certain features of the decoded output. Pass DEFAULT to decode standard Base64. |
| Returns | |
|---|---|
byte[] | |
| Throws | |
|---|---|
IllegalArgumentException | if the input contains incorrect padding |
encode
public static byte[] encode (byte[] input, int flags)
Base64-encode the given data and return a newly allocated byte[] with the result.
| Parameters | |
|---|---|
input | byte: the data to encode |
flags | int: controls certain features of the encoded output. Passing DEFAULT results in output that adheres to RFC 2045. |
| Returns | |
|---|---|
byte[] | |
encode
public static byte[] encode (byte[] input, int offset, int len, int flags)
Base64-encode the given data and return a newly allocated byte[] with the result.
| Parameters | |
|---|---|
input | byte: the data to encode |
offset | int: the position within the input array at which to start |
len | int: the number of bytes of input to encode |
flags | int: controls certain features of the encoded output. Passing DEFAULT results in output that adheres to RFC 2045. |
| Returns | |
|---|---|
byte[] | |
encodeToString
public static String encodeToString (byte[] input, int offset, int len, int flags)
Base64-encode the given data and return a newly allocated String with the result.
| Parameters | |
|---|---|
input | byte: the data to encode |
offset | int: the position within the input array at which to start |
len | int: the number of bytes of input to encode |
flags | int: controls certain features of the encoded output. Passing DEFAULT results in output that adheres to RFC 2045. |
| Returns | |
|---|---|
String | |
encodeToString
public static String encodeToString (byte[] input, int flags)
Base64-encode the given data and return a newly allocated String with the result.
| Parameters | |
|---|---|
input | byte: the data to encode |
flags | int: controls certain features of the encoded output. Passing DEFAULT results in output that adheres to RFC 2045. |
| Returns | |
|---|---|
String | |