-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9         // Decimal 244 - 255 */    };/* ********  O R D E R E D   B A S E 6 4   A L P H A B E T  ******** */    /**     * I don't get the point of this technique, but someone requested it,     * and it is described here:     * <a href="http://www.faqs.org/qa/rfcc-1940.html">http://www.faqs.org/qa/rfcc-1940.html</a>.     */    private final static byte[] _ORDERED_ALPHABET = {      (byte)'-',      (byte)'0', (byte)'1', (byte)'2', (byte)'3', (byte)'4',      (byte)'5', (byte)'6', (byte)'7', (byte)'8', (byte)'9',      (byte)'A', (byte)'B', (byte)'C', (byte)'D', (byte)'E', (byte)'F', (byte)'G',      (byte)'H', (byte)'I', (byte)'J', (byte)'K', (byte)'L', (byte)'M', (byte)'N',      (byte)'O', (byte)'P', (byte)'Q', (byte)'R', (byte)'S', (byte)'T', (byte)'U',      (byte)'V', (byte)'W', (byte)'X', (byte)'Y', (byte)'Z',      (byte)'_',      (byte)'a', (byte)'b', (byte)'c', (byte)'d', (byte)'e', (byte)'f', (byte)'g',      (byte)'h', (byte)'i', (byte)'j', (byte)'k', (byte)'l', (byte)'m', (byte)'n',      (byte)'o', (byte)'p', (byte)'q', (byte)'r', (byte)'s', (byte)'t', (byte)'u',      (byte)'v', (byte)'w', (byte)'x', (byte)'y', (byte)'z'    };	    /**     * Used in decoding the "ordered" dialect of Base64.     */    private final static byte[] _ORDERED_DECODABET = {      -9,-9,-9,-9,-9,-9,-9,-9,-9,                 // Decimal  0 -  8      -5,-5,                                      // Whitespace: Tab and Linefeed      -9,-9,                                      // Decimal 11 - 12      -5,                                         // Whitespace: Carriage Return      -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,     // Decimal 14 - 26      -9,-9,-9,-9,-9,                             // Decimal 27 - 31      -5,                                         // Whitespace: Space      -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,              // Decimal 33 - 42      -9,                                         // Plus sign at decimal 43      -9,                                         // Decimal 44      0,                                          // Minus sign at decimal 45      -9,                                         // Decimal 46      -9,                                         // Slash at decimal 47      1,2,3,4,5,6,7,8,9,10,                       // Numbers zero through nine      -9,-9,-9,                                   // Decimal 58 - 60      -1,                                         // Equals sign at decimal 61      -9,-9,-9,                                   // Decimal 62 - 64      11,12,13,14,15,16,17,18,19,20,21,22,23,     // Letters 'A' through 'M'      24,25,26,27,28,29,30,31,32,33,34,35,36,     // Letters 'N' through 'Z'      -9,-9,-9,-9,                                // Decimal 91 - 94      37,                                         // Underscore at decimal 95      -9,                                         // Decimal 96      38,39,40,41,42,43,44,45,46,47,48,49,50,     // Letters 'a' through 'm'      51,52,53,54,55,56,57,58,59,60,61,62,63,     // Letters 'n' through 'z'      -9,-9,-9,-9                                 // Decimal 123 - 126      /*,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,     // Decimal 127 - 139        -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,     // Decimal 140 - 152        -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,     // Decimal 153 - 165        -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,     // Decimal 166 - 178        -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,     // Decimal 179 - 191        -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,     // Decimal 192 - 204        -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,     // Decimal 205 - 217        -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,     // Decimal 218 - 230        -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,     // Decimal 231 - 243        -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9         // Decimal 244 - 255 */    };	/* ********  D E T E R M I N E   W H I C H   A L H A B E T  ******** */    /**     * Returns one of the _SOMETHING_ALPHABET byte arrays depending on     * the options specified.     * It's possible, though silly, to specify ORDERED <b>and</b> URLSAFE     * in which case one of them will be picked, though there is     * no guarantee as to which one will be picked.     */    private final static byte[] getAlphabet( int options ) {        if ((options & URL_SAFE) == URL_SAFE) {            return _URL_SAFE_ALPHABET;        } else if ((options & ORDERED) == ORDERED) {            return _ORDERED_ALPHABET;        } else {            return _STANDARD_ALPHABET;        }    }	// end getAlphabet    /**     * Returns one of the _SOMETHING_DECODABET byte arrays depending on     * the options specified.     * It's possible, though silly, to specify ORDERED and URL_SAFE     * in which case one of them will be picked, though there is     * no guarantee as to which one will be picked.     */    private final static byte[] getDecodabet( int options ) {        if( (options & URL_SAFE) == URL_SAFE) {            return _URL_SAFE_DECODABET;        } else if ((options & ORDERED) == ORDERED) {            return _ORDERED_DECODABET;        } else {            return _STANDARD_DECODABET;        }    }	// end getAlphabet        /** Defeats instantiation. */    private Base64(){}            /* ********  E N C O D I N G   M E T H O D S  ******** */                /**     * Encodes up to the first three bytes of array <var>threeBytes</var>     * and returns a four-byte array in Base64 notation.     * The actual number of significant bytes in your array is     * given by <var>numSigBytes</var>.     * The array <var>threeBytes</var> needs only be as big as     * <var>numSigBytes</var>.     * Code can reuse a byte array by passing a four-byte array as <var>b4</var>.     *     * @param b4 A reusable byte array to reduce array instantiation     * @param threeBytes the array to convert     * @param numSigBytes the number of significant bytes in your array     * @return four byte array in Base64 notation.     * @since 1.5.1     */    private static byte[] encode3to4( byte[] b4, byte[] threeBytes, int numSigBytes, int options ) {        encode3to4( threeBytes, 0, numSigBytes, b4, 0, options );        return b4;    }   // end encode3to4        /**     * <p>Encodes up to three bytes of the array <var>source</var>     * and writes the resulting four Base64 bytes to <var>destination</var>.     * The source and destination arrays can be manipulated     * anywhere along their length by specifying      * <var>srcOffset</var> and <var>destOffset</var>.     * This method does not check to make sure your arrays     * are large enough to accomodate <var>srcOffset</var> + 3 for     * the <var>source</var> array or <var>destOffset</var> + 4 for     * the <var>destination</var> array.     * The actual number of significant bytes in your array is     * given by <var>numSigBytes</var>.</p>	 * <p>This is the lowest level of the encoding methods with	 * all possible parameters.</p>     *     * @param source the array to convert     * @param srcOffset the index where conversion begins     * @param numSigBytes the number of significant bytes in your array     * @param destination the array to hold the conversion     * @param destOffset the index where output will be put     * @return the <var>destination</var> array     * @since 1.3     */    private static byte[] encode3to4(     byte[] source, int srcOffset, int numSigBytes,    byte[] destination, int destOffset, int options ) {        	byte[] ALPHABET = getAlphabet( options ); 	        //           1         2         3          // 01234567890123456789012345678901 Bit position        // --------000000001111111122222222 Array position from threeBytes        // --------|    ||    ||    ||    | Six bit groups to index ALPHABET        //          >>18  >>12  >> 6  >> 0  Right shift necessary        //                0x3f  0x3f  0x3f  Additional AND                // Create buffer with zero-padding if there are only one or two        // significant bytes passed in the array.        // We have to shift left 24 in order to flush out the 1's that appear        // when Java treats a value as negative that is cast from a byte to an int.        int inBuff =   ( numSigBytes > 0 ? ((source[ srcOffset     ] << 24) >>>  8) : 0 )                     | ( numSigBytes > 1 ? ((source[ srcOffset + 1 ] << 24) >>> 16) : 0 )                     | ( numSigBytes > 2 ? ((source[ srcOffset + 2 ] << 24) >>> 24) : 0 );        switch( numSigBytes )        {            case 3:                destination[ destOffset     ] = ALPHABET[ (inBuff >>> 18)        ];                destination[ destOffset + 1 ] = ALPHABET[ (inBuff >>> 12) & 0x3f ];                destination[ destOffset + 2 ] = ALPHABET[ (inBuff >>>  6) & 0x3f ];                destination[ destOffset + 3 ] = ALPHABET[ (inBuff       ) & 0x3f ];                return destination;                            case 2:                destination[ destOffset     ] = ALPHABET[ (inBuff >>> 18)        ];                destination[ destOffset + 1 ] = ALPHABET[ (inBuff >>> 12) & 0x3f ];                destination[ destOffset + 2 ] = ALPHABET[ (inBuff >>>  6) & 0x3f ];                destination[ destOffset + 3 ] = EQUALS_SIGN;                return destination;                            case 1:                destination[ destOffset     ] = ALPHABET[ (inBuff >>> 18)        ];                destination[ destOffset + 1 ] = ALPHABET[ (inBuff >>> 12) & 0x3f ];                destination[ destOffset + 2 ] = EQUALS_SIGN;                destination[ destOffset + 3 ] = EQUALS_SIGN;                return destination;                            default:                return destination;        }   // end switch    }   // end encode3to4    /**     * Performs Base64 encoding on the <code>raw</code> ByteBuffer,     * writing it to the <code>encoded</code> ByteBuffer.     * This is an experimental feature. Currently it does not     * pass along any options (such as {@link #DO_BREAK_LINES}     * or {@link #GZIP}.     *     * @param raw input buffer     * @param encoded output buffer     * @since 2.3     */    public static void encode( ByteBuffer raw, ByteBuffer encoded ){        byte[] raw3 = new byte[3];        byte[] enc4 = new byte[4];        while( raw.hasRemaining() ){            int rem = Math.min(3,raw.remaining());            raw.get(raw3,0,rem);            Base64.encode3to4(enc4, raw3, rem, Base64.NO_OPTIONS );            encoded.put(enc4);        }   // end input remaining    }    /**     * Performs Base64 encoding on the <code>raw</code> ByteBuffer,     * writing it to the <code>encoded</code> CharBuffer.     * This is an experimental feature. Currently it does not     * pass along any options (such as {@link #DO_BREAK_LINES}     * or {@link #GZIP}.     *     * @param raw input buffer     * @param encoded output buffer     * @since 2.3     */    public static void encode( ByteBuffer raw, CharBuffer encoded ){        byte[] raw3 = new byte[3];        byte[] enc4 = new byte[4];        while( raw.hasRemaining() ){            int rem = Math.min(3,raw.remaining());            raw.get(raw3,0,rem);            Base64.encode3to4(enc4, raw3, rem, Base64.NO_OPTIONS );            for( int i = 0; i < 4; i++ ){                encoded.put( (char)(enc4[i] & 0xFF) );            }        }   // end input remaining    }            /**     * Serializes an object and returns the Base64-encoded     * version of that serialized object.       *       * <p>As of v 2.3, if the object     * cannot be serialized or there is another error,     * the method will throw an java.io.IOException. <b>This is new to v2.3!</b>     * In earlier versions, it just returned a null value, but     * in retrospect that's a pretty poor way to handle it.</p>     *      * The object is not GZip-compressed before being encoded.     *     * @param serializableObject The object to encode     * @return The Base64-encoded object     * @throws java.io.IOException if there is an error     * @throws NullPointerException if serializedObject is null     * @since 1.4     */    public static String encodeObject( java.io.Serializable serializableObject )    throws java.io.IOException {        return encodeObject( serializableObject, NO_OPTIONS );    }   // end encodeObject        /**     * Serializes an object and returns the Base64-encoded     * version of that serialized object.     *       * <p>As of v 2.3, if the object     * cannot be serialized or there is another error,     * the method will throw an java.io.IOException. <b>This is new to v2.3!</b>     * In earlier versions, it just returned a null value, but     * in retrospect that's a pretty poor way to handle it.</p>     *      * The object is not GZip-compressed before being encoded.     * <p>     * Example options:<pre>     *   GZIP: gzip-compresses object before encoding it.     *   DO_BREAK_LINES: break lines at 76 characters     * </pre>     * <p>