svn commit: r1086987 [6/29] - in /websites/production/commons/content/proper/commons-codec: ./ apidocs/ apidocs/org/apache/commons/codec/ apidocs/org/apache/commons/codec/binary/ apidocs/org/apache/commons/codec/binary/class-use/ apidocs/org/apache/com...

[ggregory]

Modified: 
websites/production/commons/content/proper/commons-codec/apidocs/src-html/org/apache/commons/codec/binary/Base64.html
==============================================================================
--- 
websites/production/commons/content/proper/commons-codec/apidocs/src-html/org/apache/commons/codec/binary/Base64.html
 (original)
+++ 
websites/production/commons/content/proper/commons-codec/apidocs/src-html/org/apache/commons/codec/binary/Base64.html
 Mon Jul 15 22:37:19 2024
@@ -105,7 +105,7 @@
 <span class="source-line-no">092</span><span id="line-92">         * Sets the 
URL-safe encoding policy.</span>
 <span class="source-line-no">093</span><span id="line-93">         *</span>
 <span class="source-line-no">094</span><span id="line-94">         * @param 
urlSafe URL-safe encoding policy, null resets to the default.</span>
-<span class="source-line-no">095</span><span id="line-95">         * @return 
this.</span>
+<span class="source-line-no">095</span><span id="line-95">         * @return 
{@code this} instance.</span>
 <span class="source-line-no">096</span><span id="line-96">         */</span>
 <span class="source-line-no">097</span><span id="line-97">        public 
Builder setUrlSafe(final boolean urlSafe) {</span>
 <span class="source-line-no">098</span><span id="line-98">            return 
setEncodeTable(toUrlSafeEncodeTable(urlSafe));</span>
@@ -232,751 +232,750 @@
 <span class="source-line-no">219</span><span id="line-219">        return new 
Base64().decode(base64String);</span>
 <span class="source-line-no">220</span><span id="line-220">    }</span>
 <span class="source-line-no">221</span><span id="line-221"></span>
-<span class="source-line-no">222</span><span id="line-222">    // 
Implementation of integer encoding used for crypto</span>
-<span class="source-line-no">223</span><span id="line-223">    /**</span>
-<span class="source-line-no">224</span><span id="line-224">     * Decodes a 
byte64-encoded integer according to crypto standards such as W3C's 
XML-Signature.</span>
-<span class="source-line-no">225</span><span id="line-225">     *</span>
-<span class="source-line-no">226</span><span id="line-226">     * @param 
pArray</span>
-<span class="source-line-no">227</span><span id="line-227">     *            a 
byte array containing base64 character data</span>
-<span class="source-line-no">228</span><span id="line-228">     * @return A 
BigInteger</span>
-<span class="source-line-no">229</span><span id="line-229">     * @since 
1.4</span>
-<span class="source-line-no">230</span><span id="line-230">     */</span>
-<span class="source-line-no">231</span><span id="line-231">    public static 
BigInteger decodeInteger(final byte[] pArray) {</span>
-<span class="source-line-no">232</span><span id="line-232">        return new 
BigInteger(1, decodeBase64(pArray));</span>
-<span class="source-line-no">233</span><span id="line-233">    }</span>
-<span class="source-line-no">234</span><span id="line-234"></span>
-<span class="source-line-no">235</span><span id="line-235">    /**</span>
-<span class="source-line-no">236</span><span id="line-236">     * Encodes 
binary data using the base64 algorithm but does not chunk the output.</span>
-<span class="source-line-no">237</span><span id="line-237">     *</span>
-<span class="source-line-no">238</span><span id="line-238">     * @param 
binaryData</span>
-<span class="source-line-no">239</span><span id="line-239">     *            
binary data to encode</span>
-<span class="source-line-no">240</span><span id="line-240">     * @return 
byte[] containing Base64 characters in their UTF-8 representation.</span>
-<span class="source-line-no">241</span><span id="line-241">     */</span>
-<span class="source-line-no">242</span><span id="line-242">    public static 
byte[] encodeBase64(final byte[] binaryData) {</span>
-<span class="source-line-no">243</span><span id="line-243">        return 
encodeBase64(binaryData, false);</span>
-<span class="source-line-no">244</span><span id="line-244">    }</span>
-<span class="source-line-no">245</span><span id="line-245"></span>
-<span class="source-line-no">246</span><span id="line-246">    /**</span>
-<span class="source-line-no">247</span><span id="line-247">     * Encodes 
binary data using the base64 algorithm, optionally chunking the output into 76 
character blocks.</span>
-<span class="source-line-no">248</span><span id="line-248">     *</span>
-<span class="source-line-no">249</span><span id="line-249">     * @param 
binaryData</span>
-<span class="source-line-no">250</span><span id="line-250">     *            
Array containing binary data to encode.</span>
-<span class="source-line-no">251</span><span id="line-251">     * @param 
isChunked</span>
-<span class="source-line-no">252</span><span id="line-252">     *            
if {@code true} this encoder will chunk the base64 output into 76 character 
blocks</span>
-<span class="source-line-no">253</span><span id="line-253">     * @return 
Base64-encoded data.</span>
-<span class="source-line-no">254</span><span id="line-254">     * @throws 
IllegalArgumentException</span>
-<span class="source-line-no">255</span><span id="line-255">     *             
Thrown when the input array needs an output array bigger than {@link 
Integer#MAX_VALUE}</span>
-<span class="source-line-no">256</span><span id="line-256">     */</span>
-<span class="source-line-no">257</span><span id="line-257">    public static 
byte[] encodeBase64(final byte[] binaryData, final boolean isChunked) {</span>
-<span class="source-line-no">258</span><span id="line-258">        return 
encodeBase64(binaryData, isChunked, false);</span>
-<span class="source-line-no">259</span><span id="line-259">    }</span>
-<span class="source-line-no">260</span><span id="line-260"></span>
-<span class="source-line-no">261</span><span id="line-261">    /**</span>
-<span class="source-line-no">262</span><span id="line-262">     * Encodes 
binary data using the base64 algorithm, optionally chunking the output into 76 
character blocks.</span>
-<span class="source-line-no">263</span><span id="line-263">     *</span>
-<span class="source-line-no">264</span><span id="line-264">     * @param 
binaryData</span>
-<span class="source-line-no">265</span><span id="line-265">     *            
Array containing binary data to encode.</span>
-<span class="source-line-no">266</span><span id="line-266">     * @param 
isChunked</span>
-<span class="source-line-no">267</span><span id="line-267">     *            
if {@code true} this encoder will chunk the base64 output into 76 character 
blocks</span>
-<span class="source-line-no">268</span><span id="line-268">     * @param 
urlSafe</span>
-<span class="source-line-no">269</span><span id="line-269">     *            
if {@code true} this encoder will emit - and _ instead of the usual + and / 
characters.</span>
-<span class="source-line-no">270</span><span id="line-270">     *            
&lt;b&gt;Note: no padding is added when encoding using the URL-safe 
alphabet.&lt;/b&gt;</span>
-<span class="source-line-no">271</span><span id="line-271">     * @return 
Base64-encoded data.</span>
-<span class="source-line-no">272</span><span id="line-272">     * @throws 
IllegalArgumentException</span>
-<span class="source-line-no">273</span><span id="line-273">     *             
Thrown when the input array needs an output array bigger than {@link 
Integer#MAX_VALUE}</span>
-<span class="source-line-no">274</span><span id="line-274">     * @since 
1.4</span>
-<span class="source-line-no">275</span><span id="line-275">     */</span>
-<span class="source-line-no">276</span><span id="line-276">    public static 
byte[] encodeBase64(final byte[] binaryData, final boolean isChunked, final 
boolean urlSafe) {</span>
-<span class="source-line-no">277</span><span id="line-277">        return 
encodeBase64(binaryData, isChunked, urlSafe, Integer.MAX_VALUE);</span>
-<span class="source-line-no">278</span><span id="line-278">    }</span>
-<span class="source-line-no">279</span><span id="line-279"></span>
-<span class="source-line-no">280</span><span id="line-280">    /**</span>
-<span class="source-line-no">281</span><span id="line-281">     * Encodes 
binary data using the base64 algorithm, optionally chunking the output into 76 
character blocks.</span>
-<span class="source-line-no">282</span><span id="line-282">     *</span>
-<span class="source-line-no">283</span><span id="line-283">     * @param 
binaryData</span>
-<span class="source-line-no">284</span><span id="line-284">     *            
Array containing binary data to encode.</span>
-<span class="source-line-no">285</span><span id="line-285">     * @param 
isChunked</span>
-<span class="source-line-no">286</span><span id="line-286">     *            
if {@code true} this encoder will chunk the base64 output into 76 character 
blocks</span>
-<span class="source-line-no">287</span><span id="line-287">     * @param 
urlSafe</span>
-<span class="source-line-no">288</span><span id="line-288">     *            
if {@code true} this encoder will emit - and _ instead of the usual + and / 
characters.</span>
-<span class="source-line-no">289</span><span id="line-289">     *            
&lt;b&gt;Note: no padding is added when encoding using the URL-safe 
alphabet.&lt;/b&gt;</span>
-<span class="source-line-no">290</span><span id="line-290">     * @param 
maxResultSize</span>
-<span class="source-line-no">291</span><span id="line-291">     *            
The maximum result size to accept.</span>
-<span class="source-line-no">292</span><span id="line-292">     * @return 
Base64-encoded data.</span>
-<span class="source-line-no">293</span><span id="line-293">     * @throws 
IllegalArgumentException</span>
-<span class="source-line-no">294</span><span id="line-294">     *             
Thrown when the input array needs an output array bigger than 
maxResultSize</span>
-<span class="source-line-no">295</span><span id="line-295">     * @since 
1.4</span>
-<span class="source-line-no">296</span><span id="line-296">     */</span>
-<span class="source-line-no">297</span><span id="line-297">    public static 
byte[] encodeBase64(final byte[] binaryData, final boolean isChunked,</span>
-<span class="source-line-no">298</span><span id="line-298">                    
                  final boolean urlSafe, final int maxResultSize) {</span>
-<span class="source-line-no">299</span><span id="line-299">        if 
(BinaryCodec.isEmpty(binaryData)) {</span>
-<span class="source-line-no">300</span><span id="line-300">            return 
binaryData;</span>
-<span class="source-line-no">301</span><span id="line-301">        }</span>
-<span class="source-line-no">302</span><span id="line-302">        // Create 
this so can use the super-class method</span>
-<span class="source-line-no">303</span><span id="line-303">        // Also 
ensures that the same roundings are performed by the ctor and the code</span>
-<span class="source-line-no">304</span><span id="line-304">        final 
Base64 b64 = isChunked ? new Base64(urlSafe) : new Base64(0, CHUNK_SEPARATOR, 
urlSafe);</span>
-<span class="source-line-no">305</span><span id="line-305">        final long 
len = b64.getEncodedLength(binaryData);</span>
-<span class="source-line-no">306</span><span id="line-306">        if (len 
&gt; maxResultSize) {</span>
-<span class="source-line-no">307</span><span id="line-307">            throw 
new IllegalArgumentException("Input array too big, the output array would be 
bigger (" +</span>
-<span class="source-line-no">308</span><span id="line-308">                len 
+</span>
-<span class="source-line-no">309</span><span id="line-309">                ") 
than the specified maximum size of " +</span>
-<span class="source-line-no">310</span><span id="line-310">                
maxResultSize);</span>
-<span class="source-line-no">311</span><span id="line-311">        }</span>
-<span class="source-line-no">312</span><span id="line-312">        return 
b64.encode(binaryData);</span>
-<span class="source-line-no">313</span><span id="line-313">    }</span>
-<span class="source-line-no">314</span><span id="line-314"></span>
-<span class="source-line-no">315</span><span id="line-315">    /**</span>
-<span class="source-line-no">316</span><span id="line-316">     * Encodes 
binary data using the base64 algorithm and chunks the encoded output into 76 
character blocks</span>
-<span class="source-line-no">317</span><span id="line-317">     *</span>
-<span class="source-line-no">318</span><span id="line-318">     * @param 
binaryData</span>
-<span class="source-line-no">319</span><span id="line-319">     *            
binary data to encode</span>
-<span class="source-line-no">320</span><span id="line-320">     * @return 
Base64 characters chunked in 76 character blocks</span>
-<span class="source-line-no">321</span><span id="line-321">     */</span>
-<span class="source-line-no">322</span><span id="line-322">    public static 
byte[] encodeBase64Chunked(final byte[] binaryData) {</span>
-<span class="source-line-no">323</span><span id="line-323">        return 
encodeBase64(binaryData, true);</span>
-<span class="source-line-no">324</span><span id="line-324">    }</span>
-<span class="source-line-no">325</span><span id="line-325"></span>
-<span class="source-line-no">326</span><span id="line-326">    /**</span>
-<span class="source-line-no">327</span><span id="line-327">     * Encodes 
binary data using the base64 algorithm but does not chunk the output.</span>
-<span class="source-line-no">328</span><span id="line-328">     *</span>
-<span class="source-line-no">329</span><span id="line-329">     * NOTE:  We 
changed the behavior of this method from multi-line chunking 
(commons-codec-1.4) to</span>
-<span class="source-line-no">330</span><span id="line-330">     * single-line 
non-chunking (commons-codec-1.5).</span>
-<span class="source-line-no">331</span><span id="line-331">     *</span>
-<span class="source-line-no">332</span><span id="line-332">     * @param 
binaryData</span>
-<span class="source-line-no">333</span><span id="line-333">     *            
binary data to encode</span>
-<span class="source-line-no">334</span><span id="line-334">     * @return 
String containing Base64 characters.</span>
-<span class="source-line-no">335</span><span id="line-335">     * @since 1.4 
(NOTE:  1.4 chunked the output, whereas 1.5 does not).</span>
-<span class="source-line-no">336</span><span id="line-336">     */</span>
-<span class="source-line-no">337</span><span id="line-337">    public static 
String encodeBase64String(final byte[] binaryData) {</span>
-<span class="source-line-no">338</span><span id="line-338">        return 
StringUtils.newStringUsAscii(encodeBase64(binaryData, false));</span>
-<span class="source-line-no">339</span><span id="line-339">    }</span>
-<span class="source-line-no">340</span><span id="line-340"></span>
-<span class="source-line-no">341</span><span id="line-341">    /**</span>
-<span class="source-line-no">342</span><span id="line-342">     * Encodes 
binary data using a URL-safe variation of the base64 algorithm but does not 
chunk the output. The</span>
-<span class="source-line-no">343</span><span id="line-343">     * url-safe 
variation emits - and _ instead of + and / characters.</span>
-<span class="source-line-no">344</span><span id="line-344">     * 
&lt;b&gt;Note: no padding is added.&lt;/b&gt;</span>
-<span class="source-line-no">345</span><span id="line-345">     * @param 
binaryData</span>
-<span class="source-line-no">346</span><span id="line-346">     *            
binary data to encode</span>
-<span class="source-line-no">347</span><span id="line-347">     * @return 
byte[] containing Base64 characters in their UTF-8 representation.</span>
-<span class="source-line-no">348</span><span id="line-348">     * @since 
1.4</span>
-<span class="source-line-no">349</span><span id="line-349">     */</span>
-<span class="source-line-no">350</span><span id="line-350">    public static 
byte[] encodeBase64URLSafe(final byte[] binaryData) {</span>
-<span class="source-line-no">351</span><span id="line-351">        return 
encodeBase64(binaryData, false, true);</span>
-<span class="source-line-no">352</span><span id="line-352">    }</span>
-<span class="source-line-no">353</span><span id="line-353"></span>
-<span class="source-line-no">354</span><span id="line-354">    /**</span>
-<span class="source-line-no">355</span><span id="line-355">     * Encodes 
binary data using a URL-safe variation of the base64 algorithm but does not 
chunk the output. The</span>
-<span class="source-line-no">356</span><span id="line-356">     * url-safe 
variation emits - and _ instead of + and / characters.</span>
-<span class="source-line-no">357</span><span id="line-357">     * 
&lt;b&gt;Note: no padding is added.&lt;/b&gt;</span>
-<span class="source-line-no">358</span><span id="line-358">     * @param 
binaryData</span>
-<span class="source-line-no">359</span><span id="line-359">     *            
binary data to encode</span>
-<span class="source-line-no">360</span><span id="line-360">     * @return 
String containing Base64 characters</span>
-<span class="source-line-no">361</span><span id="line-361">     * @since 
1.4</span>
-<span class="source-line-no">362</span><span id="line-362">     */</span>
-<span class="source-line-no">363</span><span id="line-363">    public static 
String encodeBase64URLSafeString(final byte[] binaryData) {</span>
-<span class="source-line-no">364</span><span id="line-364">        return 
StringUtils.newStringUsAscii(encodeBase64(binaryData, false, true));</span>
-<span class="source-line-no">365</span><span id="line-365">    }</span>
-<span class="source-line-no">366</span><span id="line-366"></span>
-<span class="source-line-no">367</span><span id="line-367">    /**</span>
-<span class="source-line-no">368</span><span id="line-368">     * Encodes to a 
byte64-encoded integer according to crypto standards such as W3C's 
XML-Signature.</span>
-<span class="source-line-no">369</span><span id="line-369">     *</span>
-<span class="source-line-no">370</span><span id="line-370">     * @param 
bigInteger</span>
-<span class="source-line-no">371</span><span id="line-371">     *            a 
BigInteger</span>
-<span class="source-line-no">372</span><span id="line-372">     * @return A 
byte array containing base64 character data</span>
-<span class="source-line-no">373</span><span id="line-373">     * @throws 
NullPointerException</span>
-<span class="source-line-no">374</span><span id="line-374">     *             
if null is passed in</span>
-<span class="source-line-no">375</span><span id="line-375">     * @since 
1.4</span>
-<span class="source-line-no">376</span><span id="line-376">     */</span>
-<span class="source-line-no">377</span><span id="line-377">    public static 
byte[] encodeInteger(final BigInteger bigInteger) {</span>
-<span class="source-line-no">378</span><span id="line-378">        
Objects.requireNonNull(bigInteger, "bigInteger");</span>
-<span class="source-line-no">379</span><span id="line-379">        return 
encodeBase64(toIntegerBytes(bigInteger), false);</span>
-<span class="source-line-no">380</span><span id="line-380">    }</span>
-<span class="source-line-no">381</span><span id="line-381"></span>
-<span class="source-line-no">382</span><span id="line-382">    /**</span>
-<span class="source-line-no">383</span><span id="line-383">     * Tests a 
given byte array to see if it contains only valid characters within the Base64 
alphabet. Currently the</span>
-<span class="source-line-no">384</span><span id="line-384">     * method 
treats whitespace as valid.</span>
-<span class="source-line-no">385</span><span id="line-385">     *</span>
-<span class="source-line-no">386</span><span id="line-386">     * @param 
arrayOctet</span>
-<span class="source-line-no">387</span><span id="line-387">     *            
byte array to test</span>
-<span class="source-line-no">388</span><span id="line-388">     * @return 
{@code true} if all bytes are valid characters in the Base64 alphabet or if the 
byte array is empty;</span>
-<span class="source-line-no">389</span><span id="line-389">     *         
{@code false}, otherwise</span>
-<span class="source-line-no">390</span><span id="line-390">     * @deprecated 
1.5 Use {@link #isBase64(byte[])}, will be removed in 2.0.</span>
-<span class="source-line-no">391</span><span id="line-391">     */</span>
-<span class="source-line-no">392</span><span id="line-392">    
@Deprecated</span>
-<span class="source-line-no">393</span><span id="line-393">    public static 
boolean isArrayByteBase64(final byte[] arrayOctet) {</span>
-<span class="source-line-no">394</span><span id="line-394">        return 
isBase64(arrayOctet);</span>
-<span class="source-line-no">395</span><span id="line-395">    }</span>
-<span class="source-line-no">396</span><span id="line-396"></span>
-<span class="source-line-no">397</span><span id="line-397">    /**</span>
-<span class="source-line-no">398</span><span id="line-398">     * Returns 
whether or not the {@code octet} is in the base 64 alphabet.</span>
-<span class="source-line-no">399</span><span id="line-399">     *</span>
-<span class="source-line-no">400</span><span id="line-400">     * @param 
octet</span>
-<span class="source-line-no">401</span><span id="line-401">     *            
The value to test</span>
-<span class="source-line-no">402</span><span id="line-402">     * @return 
{@code true} if the value is defined in the base 64 alphabet, {@code false} 
otherwise.</span>
-<span class="source-line-no">403</span><span id="line-403">     * @since 
1.4</span>
-<span class="source-line-no">404</span><span id="line-404">     */</span>
-<span class="source-line-no">405</span><span id="line-405">    public static 
boolean isBase64(final byte octet) {</span>
-<span class="source-line-no">406</span><span id="line-406">        return 
octet == PAD_DEFAULT || octet &gt;= 0 &amp;&amp; octet &lt; DECODE_TABLE.length 
&amp;&amp; DECODE_TABLE[octet] != -1;</span>
-<span class="source-line-no">407</span><span id="line-407">    }</span>
-<span class="source-line-no">408</span><span id="line-408"></span>
-<span class="source-line-no">409</span><span id="line-409">    /**</span>
-<span class="source-line-no">410</span><span id="line-410">     * Tests a 
given byte array to see if it contains only valid characters within the Base64 
alphabet. Currently the</span>
-<span class="source-line-no">411</span><span id="line-411">     * method 
treats whitespace as valid.</span>
-<span class="source-line-no">412</span><span id="line-412">     *</span>
-<span class="source-line-no">413</span><span id="line-413">     * @param 
arrayOctet</span>
-<span class="source-line-no">414</span><span id="line-414">     *            
byte array to test</span>
-<span class="source-line-no">415</span><span id="line-415">     * @return 
{@code true} if all bytes are valid characters in the Base64 alphabet or if the 
byte array is empty;</span>
-<span class="source-line-no">416</span><span id="line-416">     *         
{@code false}, otherwise</span>
-<span class="source-line-no">417</span><span id="line-417">     * @since 
1.5</span>
-<span class="source-line-no">418</span><span id="line-418">     */</span>
-<span class="source-line-no">419</span><span id="line-419">    public static 
boolean isBase64(final byte[] arrayOctet) {</span>
-<span class="source-line-no">420</span><span id="line-420">        for (final 
byte element : arrayOctet) {</span>
-<span class="source-line-no">421</span><span id="line-421">            if 
(!isBase64(element) &amp;&amp; !Character.isWhitespace(element)) {</span>
-<span class="source-line-no">422</span><span id="line-422">                
return false;</span>
-<span class="source-line-no">423</span><span id="line-423">            }</span>
-<span class="source-line-no">424</span><span id="line-424">        }</span>
-<span class="source-line-no">425</span><span id="line-425">        return 
true;</span>
-<span class="source-line-no">426</span><span id="line-426">    }</span>
-<span class="source-line-no">427</span><span id="line-427"></span>
-<span class="source-line-no">428</span><span id="line-428">    /**</span>
-<span class="source-line-no">429</span><span id="line-429">     * Tests a 
given String to see if it contains only valid characters within the Base64 
alphabet. Currently the</span>
-<span class="source-line-no">430</span><span id="line-430">     * method 
treats whitespace as valid.</span>
-<span class="source-line-no">431</span><span id="line-431">     *</span>
-<span class="source-line-no">432</span><span id="line-432">     * @param 
base64</span>
-<span class="source-line-no">433</span><span id="line-433">     *            
String to test</span>
-<span class="source-line-no">434</span><span id="line-434">     * @return 
{@code true} if all characters in the String are valid characters in the Base64 
alphabet or if</span>
-<span class="source-line-no">435</span><span id="line-435">     *         the 
String is empty; {@code false}, otherwise</span>
-<span class="source-line-no">436</span><span id="line-436">     *  @since 
1.5</span>
-<span class="source-line-no">437</span><span id="line-437">     */</span>
-<span class="source-line-no">438</span><span id="line-438">    public static 
boolean isBase64(final String base64) {</span>
-<span class="source-line-no">439</span><span id="line-439">        return 
isBase64(StringUtils.getBytesUtf8(base64));</span>
-<span class="source-line-no">440</span><span id="line-440">    }</span>
-<span class="source-line-no">441</span><span id="line-441"></span>
-<span class="source-line-no">442</span><span id="line-442">    /**</span>
-<span class="source-line-no">443</span><span id="line-443">     * Returns a 
byte-array representation of a {@code BigInteger} without sign bit.</span>
-<span class="source-line-no">444</span><span id="line-444">     *</span>
-<span class="source-line-no">445</span><span id="line-445">     * @param 
bigInt</span>
-<span class="source-line-no">446</span><span id="line-446">     *            
{@code BigInteger} to be converted</span>
-<span class="source-line-no">447</span><span id="line-447">     * @return a 
byte array representation of the BigInteger parameter</span>
-<span class="source-line-no">448</span><span id="line-448">     */</span>
-<span class="source-line-no">449</span><span id="line-449">    static byte[] 
toIntegerBytes(final BigInteger bigInt) {</span>
-<span class="source-line-no">450</span><span id="line-450">        int bitlen 
= bigInt.bitLength();</span>
-<span class="source-line-no">451</span><span id="line-451">        // round 
bitlen</span>
-<span class="source-line-no">452</span><span id="line-452">        bitlen = 
bitlen + 7 &gt;&gt; 3 &lt;&lt; 3;</span>
-<span class="source-line-no">453</span><span id="line-453">        final 
byte[] bigBytes = bigInt.toByteArray();</span>
-<span class="source-line-no">454</span><span id="line-454"></span>
-<span class="source-line-no">455</span><span id="line-455">        if 
(bigInt.bitLength() % 8 != 0 &amp;&amp; bigInt.bitLength() / 8 + 1 == bitlen / 
8) {</span>
-<span class="source-line-no">456</span><span id="line-456">            return 
bigBytes;</span>
-<span class="source-line-no">457</span><span id="line-457">        }</span>
-<span class="source-line-no">458</span><span id="line-458">        // set up 
params for copying everything but sign bit</span>
-<span class="source-line-no">459</span><span id="line-459">        int 
startSrc = 0;</span>
-<span class="source-line-no">460</span><span id="line-460">        int len = 
bigBytes.length;</span>
-<span class="source-line-no">461</span><span id="line-461"></span>
-<span class="source-line-no">462</span><span id="line-462">        // if 
bigInt is exactly byte-aligned, just skip signbit in copy</span>
-<span class="source-line-no">463</span><span id="line-463">        if 
(bigInt.bitLength() % 8 == 0) {</span>
-<span class="source-line-no">464</span><span id="line-464">            
startSrc = 1;</span>
-<span class="source-line-no">465</span><span id="line-465">            
len--;</span>
-<span class="source-line-no">466</span><span id="line-466">        }</span>
-<span class="source-line-no">467</span><span id="line-467">        final int 
startDst = bitlen / 8 - len; // to pad w/ nulls as per spec</span>
-<span class="source-line-no">468</span><span id="line-468">        final 
byte[] resizedBytes = new byte[bitlen / 8];</span>
-<span class="source-line-no">469</span><span id="line-469">        
System.arraycopy(bigBytes, startSrc, resizedBytes, startDst, len);</span>
-<span class="source-line-no">470</span><span id="line-470">        return 
resizedBytes;</span>
-<span class="source-line-no">471</span><span id="line-471">    }</span>
-<span class="source-line-no">472</span><span id="line-472"></span>
-<span class="source-line-no">473</span><span id="line-473">    private static 
byte[] toUrlSafeEncodeTable(final boolean urlSafe) {</span>
-<span class="source-line-no">474</span><span id="line-474">        return 
urlSafe ? URL_SAFE_ENCODE_TABLE : STANDARD_ENCODE_TABLE;</span>
-<span class="source-line-no">475</span><span id="line-475">    }</span>
-<span class="source-line-no">476</span><span id="line-476"></span>
-<span class="source-line-no">477</span><span id="line-477">    /**</span>
-<span class="source-line-no">478</span><span id="line-478">     * Encode table 
to use: either STANDARD or URL_SAFE or custom.</span>
-<span class="source-line-no">479</span><span id="line-479">     * Note: the 
DECODE_TABLE above remains static because it is able</span>
-<span class="source-line-no">480</span><span id="line-480">     * to decode 
both STANDARD and URL_SAFE streams, but the encodeTable must be a member 
variable so we can switch</span>
-<span class="source-line-no">481</span><span id="line-481">     * between the 
two modes.</span>
-<span class="source-line-no">482</span><span id="line-482">     */</span>
-<span class="source-line-no">483</span><span id="line-483">    private final 
byte[] encodeTable;</span>
-<span class="source-line-no">484</span><span id="line-484"></span>
-<span class="source-line-no">485</span><span id="line-485">    /**</span>
-<span class="source-line-no">486</span><span id="line-486">     * Decode table 
to use.</span>
-<span class="source-line-no">487</span><span id="line-487">     */</span>
-<span class="source-line-no">488</span><span id="line-488">    private final 
byte[] decodeTable;</span>
-<span class="source-line-no">489</span><span id="line-489"></span>
-<span class="source-line-no">490</span><span id="line-490">    /**</span>
-<span class="source-line-no">491</span><span id="line-491">     * Line 
separator for encoding. Not used when decoding. Only used if lineLength 
&amp;gt; 0.</span>
-<span class="source-line-no">492</span><span id="line-492">     */</span>
-<span class="source-line-no">493</span><span id="line-493">    private final 
byte[] lineSeparator;</span>
-<span class="source-line-no">494</span><span id="line-494"></span>
-<span class="source-line-no">495</span><span id="line-495">    /**</span>
-<span class="source-line-no">496</span><span id="line-496">     * Convenience 
variable to help us determine when our buffer is going to run out of room and 
needs resizing.</span>
-<span class="source-line-no">497</span><span id="line-497">     * {@code 
encodeSize = 4 + lineSeparator.length;}</span>
-<span class="source-line-no">498</span><span id="line-498">     */</span>
-<span class="source-line-no">499</span><span id="line-499">    private final 
int encodeSize;</span>
-<span class="source-line-no">500</span><span id="line-500"></span>
-<span class="source-line-no">501</span><span id="line-501">    private final 
boolean isUrlSafe;</span>
-<span class="source-line-no">502</span><span id="line-502"></span>
-<span class="source-line-no">503</span><span id="line-503">    /**</span>
-<span class="source-line-no">504</span><span id="line-504">     * Constructs a 
Base64 codec used for decoding (all modes) and encoding in URL-unsafe 
mode.</span>
-<span class="source-line-no">505</span><span id="line-505">     * 
&lt;p&gt;</span>
-<span class="source-line-no">506</span><span id="line-506">     * When 
encoding the line length is 0 (no chunking), and the encoding table is 
STANDARD_ENCODE_TABLE.</span>
-<span class="source-line-no">507</span><span id="line-507">     * 
&lt;/p&gt;</span>
-<span class="source-line-no">508</span><span id="line-508">     * 
&lt;p&gt;</span>
-<span class="source-line-no">509</span><span id="line-509">     * When 
decoding all variants are supported.</span>
-<span class="source-line-no">510</span><span id="line-510">     * 
&lt;/p&gt;</span>
-<span class="source-line-no">511</span><span id="line-511">     */</span>
-<span class="source-line-no">512</span><span id="line-512">    public Base64() 
{</span>
-<span class="source-line-no">513</span><span id="line-513">        
this(0);</span>
-<span class="source-line-no">514</span><span id="line-514">    }</span>
-<span class="source-line-no">515</span><span id="line-515"></span>
-<span class="source-line-no">516</span><span id="line-516">    /**</span>
-<span class="source-line-no">517</span><span id="line-517">     * Constructs a 
Base64 codec used for decoding (all modes) and encoding in the given URL-safe 
mode.</span>
-<span class="source-line-no">518</span><span id="line-518">     * 
&lt;p&gt;</span>
-<span class="source-line-no">519</span><span id="line-519">     * When 
encoding the line length is 76, the line separator is CRLF, and the encoding 
table is STANDARD_ENCODE_TABLE.</span>
-<span class="source-line-no">520</span><span id="line-520">     * 
&lt;/p&gt;</span>
-<span class="source-line-no">521</span><span id="line-521">     * 
&lt;p&gt;</span>
-<span class="source-line-no">522</span><span id="line-522">     * When 
decoding all variants are supported.</span>
-<span class="source-line-no">523</span><span id="line-523">     * 
&lt;/p&gt;</span>
-<span class="source-line-no">524</span><span id="line-524">     *</span>
-<span class="source-line-no">525</span><span id="line-525">     * @param 
urlSafe</span>
-<span class="source-line-no">526</span><span id="line-526">     *            
if {@code true}, URL-safe encoding is used. In most cases this should be set 
to</span>
-<span class="source-line-no">527</span><span id="line-527">     *            
{@code false}.</span>
-<span class="source-line-no">528</span><span id="line-528">     * @since 
1.4</span>
-<span class="source-line-no">529</span><span id="line-529">     */</span>
-<span class="source-line-no">530</span><span id="line-530">    public 
Base64(final boolean urlSafe) {</span>
-<span class="source-line-no">531</span><span id="line-531">        
this(MIME_CHUNK_SIZE, CHUNK_SEPARATOR, urlSafe);</span>
-<span class="source-line-no">532</span><span id="line-532">    }</span>
+<span class="source-line-no">222</span><span id="line-222">    /**</span>
+<span class="source-line-no">223</span><span id="line-223">     * Decodes a 
byte64-encoded integer according to crypto standards such as W3C's 
XML-Signature.</span>
+<span class="source-line-no">224</span><span id="line-224">     *</span>
+<span class="source-line-no">225</span><span id="line-225">     * @param 
pArray</span>
+<span class="source-line-no">226</span><span id="line-226">     *            a 
byte array containing base64 character data</span>
+<span class="source-line-no">227</span><span id="line-227">     * @return A 
BigInteger</span>
+<span class="source-line-no">228</span><span id="line-228">     * @since 
1.4</span>
+<span class="source-line-no">229</span><span id="line-229">     */</span>
+<span class="source-line-no">230</span><span id="line-230">    public static 
BigInteger decodeInteger(final byte[] pArray) {</span>
+<span class="source-line-no">231</span><span id="line-231">        return new 
BigInteger(1, decodeBase64(pArray));</span>
+<span class="source-line-no">232</span><span id="line-232">    }</span>
+<span class="source-line-no">233</span><span id="line-233"></span>
+<span class="source-line-no">234</span><span id="line-234">    /**</span>
+<span class="source-line-no">235</span><span id="line-235">     * Encodes 
binary data using the base64 algorithm but does not chunk the output.</span>
+<span class="source-line-no">236</span><span id="line-236">     *</span>
+<span class="source-line-no">237</span><span id="line-237">     * @param 
binaryData</span>
+<span class="source-line-no">238</span><span id="line-238">     *            
binary data to encode</span>
+<span class="source-line-no">239</span><span id="line-239">     * @return 
byte[] containing Base64 characters in their UTF-8 representation.</span>
+<span class="source-line-no">240</span><span id="line-240">     */</span>
+<span class="source-line-no">241</span><span id="line-241">    public static 
byte[] encodeBase64(final byte[] binaryData) {</span>
+<span class="source-line-no">242</span><span id="line-242">        return 
encodeBase64(binaryData, false);</span>
+<span class="source-line-no">243</span><span id="line-243">    }</span>
+<span class="source-line-no">244</span><span id="line-244"></span>
+<span class="source-line-no">245</span><span id="line-245">    /**</span>
+<span class="source-line-no">246</span><span id="line-246">     * Encodes 
binary data using the base64 algorithm, optionally chunking the output into 76 
character blocks.</span>
+<span class="source-line-no">247</span><span id="line-247">     *</span>
+<span class="source-line-no">248</span><span id="line-248">     * @param 
binaryData</span>
+<span class="source-line-no">249</span><span id="line-249">     *            
Array containing binary data to encode.</span>
+<span class="source-line-no">250</span><span id="line-250">     * @param 
isChunked</span>
+<span class="source-line-no">251</span><span id="line-251">     *            
if {@code true} this encoder will chunk the base64 output into 76 character 
blocks</span>
+<span class="source-line-no">252</span><span id="line-252">     * @return 
Base64-encoded data.</span>
+<span class="source-line-no">253</span><span id="line-253">     * @throws 
IllegalArgumentException</span>
+<span class="source-line-no">254</span><span id="line-254">     *             
Thrown when the input array needs an output array bigger than {@link 
Integer#MAX_VALUE}</span>
+<span class="source-line-no">255</span><span id="line-255">     */</span>
+<span class="source-line-no">256</span><span id="line-256">    public static 
byte[] encodeBase64(final byte[] binaryData, final boolean isChunked) {</span>
+<span class="source-line-no">257</span><span id="line-257">        return 
encodeBase64(binaryData, isChunked, false);</span>
+<span class="source-line-no">258</span><span id="line-258">    }</span>
+<span class="source-line-no">259</span><span id="line-259"></span>
+<span class="source-line-no">260</span><span id="line-260">    /**</span>
+<span class="source-line-no">261</span><span id="line-261">     * Encodes 
binary data using the base64 algorithm, optionally chunking the output into 76 
character blocks.</span>
+<span class="source-line-no">262</span><span id="line-262">     *</span>
+<span class="source-line-no">263</span><span id="line-263">     * @param 
binaryData</span>
+<span class="source-line-no">264</span><span id="line-264">     *            
Array containing binary data to encode.</span>
+<span class="source-line-no">265</span><span id="line-265">     * @param 
isChunked</span>
+<span class="source-line-no">266</span><span id="line-266">     *            
if {@code true} this encoder will chunk the base64 output into 76 character 
blocks</span>
+<span class="source-line-no">267</span><span id="line-267">     * @param 
urlSafe</span>
+<span class="source-line-no">268</span><span id="line-268">     *            
if {@code true} this encoder will emit - and _ instead of the usual + and / 
characters.</span>
+<span class="source-line-no">269</span><span id="line-269">     *            
&lt;b&gt;Note: no padding is added when encoding using the URL-safe 
alphabet.&lt;/b&gt;</span>
+<span class="source-line-no">270</span><span id="line-270">     * @return 
Base64-encoded data.</span>
+<span class="source-line-no">271</span><span id="line-271">     * @throws 
IllegalArgumentException</span>
+<span class="source-line-no">272</span><span id="line-272">     *             
Thrown when the input array needs an output array bigger than {@link 
Integer#MAX_VALUE}</span>
+<span class="source-line-no">273</span><span id="line-273">     * @since 
1.4</span>
+<span class="source-line-no">274</span><span id="line-274">     */</span>
+<span class="source-line-no">275</span><span id="line-275">    public static 
byte[] encodeBase64(final byte[] binaryData, final boolean isChunked, final 
boolean urlSafe) {</span>
+<span class="source-line-no">276</span><span id="line-276">        return 
encodeBase64(binaryData, isChunked, urlSafe, Integer.MAX_VALUE);</span>
+<span class="source-line-no">277</span><span id="line-277">    }</span>
+<span class="source-line-no">278</span><span id="line-278"></span>
+<span class="source-line-no">279</span><span id="line-279">    /**</span>
+<span class="source-line-no">280</span><span id="line-280">     * Encodes 
binary data using the base64 algorithm, optionally chunking the output into 76 
character blocks.</span>
+<span class="source-line-no">281</span><span id="line-281">     *</span>
+<span class="source-line-no">282</span><span id="line-282">     * @param 
binaryData</span>
+<span class="source-line-no">283</span><span id="line-283">     *            
Array containing binary data to encode.</span>
+<span class="source-line-no">284</span><span id="line-284">     * @param 
isChunked</span>
+<span class="source-line-no">285</span><span id="line-285">     *            
if {@code true} this encoder will chunk the base64 output into 76 character 
blocks</span>
+<span class="source-line-no">286</span><span id="line-286">     * @param 
urlSafe</span>
+<span class="source-line-no">287</span><span id="line-287">     *            
if {@code true} this encoder will emit - and _ instead of the usual + and / 
characters.</span>
+<span class="source-line-no">288</span><span id="line-288">     *            
&lt;b&gt;Note: no padding is added when encoding using the URL-safe 
alphabet.&lt;/b&gt;</span>
+<span class="source-line-no">289</span><span id="line-289">     * @param 
maxResultSize</span>
+<span class="source-line-no">290</span><span id="line-290">     *            
The maximum result size to accept.</span>
+<span class="source-line-no">291</span><span id="line-291">     * @return 
Base64-encoded data.</span>
+<span class="source-line-no">292</span><span id="line-292">     * @throws 
IllegalArgumentException</span>
+<span class="source-line-no">293</span><span id="line-293">     *             
Thrown when the input array needs an output array bigger than 
maxResultSize</span>
+<span class="source-line-no">294</span><span id="line-294">     * @since 
1.4</span>
+<span class="source-line-no">295</span><span id="line-295">     */</span>
+<span class="source-line-no">296</span><span id="line-296">    public static 
byte[] encodeBase64(final byte[] binaryData, final boolean isChunked,</span>
+<span class="source-line-no">297</span><span id="line-297">                    
                  final boolean urlSafe, final int maxResultSize) {</span>
+<span class="source-line-no">298</span><span id="line-298">        if 
(BinaryCodec.isEmpty(binaryData)) {</span>
+<span class="source-line-no">299</span><span id="line-299">            return 
binaryData;</span>
+<span class="source-line-no">300</span><span id="line-300">        }</span>
+<span class="source-line-no">301</span><span id="line-301">        // Create 
this so can use the super-class method</span>
+<span class="source-line-no">302</span><span id="line-302">        // Also 
ensures that the same roundings are performed by the ctor and the code</span>
+<span class="source-line-no">303</span><span id="line-303">        final 
Base64 b64 = isChunked ? new Base64(urlSafe) : new Base64(0, CHUNK_SEPARATOR, 
urlSafe);</span>
+<span class="source-line-no">304</span><span id="line-304">        final long 
len = b64.getEncodedLength(binaryData);</span>
+<span class="source-line-no">305</span><span id="line-305">        if (len 
&gt; maxResultSize) {</span>
+<span class="source-line-no">306</span><span id="line-306">            throw 
new IllegalArgumentException("Input array too big, the output array would be 
bigger (" +</span>
+<span class="source-line-no">307</span><span id="line-307">                len 
+</span>
+<span class="source-line-no">308</span><span id="line-308">                ") 
than the specified maximum size of " +</span>
+<span class="source-line-no">309</span><span id="line-309">                
maxResultSize);</span>
+<span class="source-line-no">310</span><span id="line-310">        }</span>
+<span class="source-line-no">311</span><span id="line-311">        return 
b64.encode(binaryData);</span>
+<span class="source-line-no">312</span><span id="line-312">    }</span>
+<span class="source-line-no">313</span><span id="line-313"></span>
+<span class="source-line-no">314</span><span id="line-314">    /**</span>
+<span class="source-line-no">315</span><span id="line-315">     * Encodes 
binary data using the base64 algorithm and chunks the encoded output into 76 
character blocks</span>
+<span class="source-line-no">316</span><span id="line-316">     *</span>
+<span class="source-line-no">317</span><span id="line-317">     * @param 
binaryData</span>
+<span class="source-line-no">318</span><span id="line-318">     *            
binary data to encode</span>
+<span class="source-line-no">319</span><span id="line-319">     * @return 
Base64 characters chunked in 76 character blocks</span>
+<span class="source-line-no">320</span><span id="line-320">     */</span>
+<span class="source-line-no">321</span><span id="line-321">    public static 
byte[] encodeBase64Chunked(final byte[] binaryData) {</span>
+<span class="source-line-no">322</span><span id="line-322">        return 
encodeBase64(binaryData, true);</span>
+<span class="source-line-no">323</span><span id="line-323">    }</span>
+<span class="source-line-no">324</span><span id="line-324"></span>
+<span class="source-line-no">325</span><span id="line-325">    /**</span>
+<span class="source-line-no">326</span><span id="line-326">     * Encodes 
binary data using the base64 algorithm but does not chunk the output.</span>
+<span class="source-line-no">327</span><span id="line-327">     *</span>
+<span class="source-line-no">328</span><span id="line-328">     * NOTE:  We 
changed the behavior of this method from multi-line chunking 
(commons-codec-1.4) to</span>
+<span class="source-line-no">329</span><span id="line-329">     * single-line 
non-chunking (commons-codec-1.5).</span>
+<span class="source-line-no">330</span><span id="line-330">     *</span>
+<span class="source-line-no">331</span><span id="line-331">     * @param 
binaryData</span>
+<span class="source-line-no">332</span><span id="line-332">     *            
binary data to encode</span>
+<span class="source-line-no">333</span><span id="line-333">     * @return 
String containing Base64 characters.</span>
+<span class="source-line-no">334</span><span id="line-334">     * @since 1.4 
(NOTE:  1.4 chunked the output, whereas 1.5 does not).</span>
+<span class="source-line-no">335</span><span id="line-335">     */</span>
+<span class="source-line-no">336</span><span id="line-336">    public static 
String encodeBase64String(final byte[] binaryData) {</span>
+<span class="source-line-no">337</span><span id="line-337">        return 
StringUtils.newStringUsAscii(encodeBase64(binaryData, false));</span>
+<span class="source-line-no">338</span><span id="line-338">    }</span>
+<span class="source-line-no">339</span><span id="line-339"></span>
+<span class="source-line-no">340</span><span id="line-340">    /**</span>
+<span class="source-line-no">341</span><span id="line-341">     * Encodes 
binary data using a URL-safe variation of the base64 algorithm but does not 
chunk the output. The</span>
+<span class="source-line-no">342</span><span id="line-342">     * url-safe 
variation emits - and _ instead of + and / characters.</span>
+<span class="source-line-no">343</span><span id="line-343">     * 
&lt;b&gt;Note: no padding is added.&lt;/b&gt;</span>
+<span class="source-line-no">344</span><span id="line-344">     * @param 
binaryData</span>
+<span class="source-line-no">345</span><span id="line-345">     *            
binary data to encode</span>
+<span class="source-line-no">346</span><span id="line-346">     * @return 
byte[] containing Base64 characters in their UTF-8 representation.</span>
+<span class="source-line-no">347</span><span id="line-347">     * @since 
1.4</span>
+<span class="source-line-no">348</span><span id="line-348">     */</span>
+<span class="source-line-no">349</span><span id="line-349">    public static 
byte[] encodeBase64URLSafe(final byte[] binaryData) {</span>
+<span class="source-line-no">350</span><span id="line-350">        return 
encodeBase64(binaryData, false, true);</span>
+<span class="source-line-no">351</span><span id="line-351">    }</span>
+<span class="source-line-no">352</span><span id="line-352"></span>
+<span class="source-line-no">353</span><span id="line-353">    /**</span>
+<span class="source-line-no">354</span><span id="line-354">     * Encodes 
binary data using a URL-safe variation of the base64 algorithm but does not 
chunk the output. The</span>
+<span class="source-line-no">355</span><span id="line-355">     * url-safe 
variation emits - and _ instead of + and / characters.</span>
+<span class="source-line-no">356</span><span id="line-356">     * 
&lt;b&gt;Note: no padding is added.&lt;/b&gt;</span>
+<span class="source-line-no">357</span><span id="line-357">     * @param 
binaryData</span>
+<span class="source-line-no">358</span><span id="line-358">     *            
binary data to encode</span>
+<span class="source-line-no">359</span><span id="line-359">     * @return 
String containing Base64 characters</span>
+<span class="source-line-no">360</span><span id="line-360">     * @since 
1.4</span>
+<span class="source-line-no">361</span><span id="line-361">     */</span>
+<span class="source-line-no">362</span><span id="line-362">    public static 
String encodeBase64URLSafeString(final byte[] binaryData) {</span>
+<span class="source-line-no">363</span><span id="line-363">        return 
StringUtils.newStringUsAscii(encodeBase64(binaryData, false, true));</span>
+<span class="source-line-no">364</span><span id="line-364">    }</span>
+<span class="source-line-no">365</span><span id="line-365"></span>
+<span class="source-line-no">366</span><span id="line-366">    /**</span>
+<span class="source-line-no">367</span><span id="line-367">     * Encodes to a 
byte64-encoded integer according to crypto standards such as W3C's 
XML-Signature.</span>
+<span class="source-line-no">368</span><span id="line-368">     *</span>
+<span class="source-line-no">369</span><span id="line-369">     * @param 
bigInteger</span>
+<span class="source-line-no">370</span><span id="line-370">     *            a 
BigInteger</span>
+<span class="source-line-no">371</span><span id="line-371">     * @return A 
byte array containing base64 character data</span>
+<span class="source-line-no">372</span><span id="line-372">     * @throws 
NullPointerException</span>
+<span class="source-line-no">373</span><span id="line-373">     *             
if null is passed in</span>
+<span class="source-line-no">374</span><span id="line-374">     * @since 
1.4</span>
+<span class="source-line-no">375</span><span id="line-375">     */</span>
+<span class="source-line-no">376</span><span id="line-376">    public static 
byte[] encodeInteger(final BigInteger bigInteger) {</span>
+<span class="source-line-no">377</span><span id="line-377">        
Objects.requireNonNull(bigInteger, "bigInteger");</span>
+<span class="source-line-no">378</span><span id="line-378">        return 
encodeBase64(toIntegerBytes(bigInteger), false);</span>
+<span class="source-line-no">379</span><span id="line-379">    }</span>
+<span class="source-line-no">380</span><span id="line-380"></span>
+<span class="source-line-no">381</span><span id="line-381">    /**</span>
+<span class="source-line-no">382</span><span id="line-382">     * Tests a 
given byte array to see if it contains only valid characters within the Base64 
alphabet. Currently the</span>
+<span class="source-line-no">383</span><span id="line-383">     * method 
treats whitespace as valid.</span>
+<span class="source-line-no">384</span><span id="line-384">     *</span>
+<span class="source-line-no">385</span><span id="line-385">     * @param 
arrayOctet</span>
+<span class="source-line-no">386</span><span id="line-386">     *            
byte array to test</span>
+<span class="source-line-no">387</span><span id="line-387">     * @return 
{@code true} if all bytes are valid characters in the Base64 alphabet or if the 
byte array is empty;</span>
+<span class="source-line-no">388</span><span id="line-388">     *         
{@code false}, otherwise</span>
+<span class="source-line-no">389</span><span id="line-389">     * @deprecated 
1.5 Use {@link #isBase64(byte[])}, will be removed in 2.0.</span>
+<span class="source-line-no">390</span><span id="line-390">     */</span>
+<span class="source-line-no">391</span><span id="line-391">    
@Deprecated</span>
+<span class="source-line-no">392</span><span id="line-392">    public static 
boolean isArrayByteBase64(final byte[] arrayOctet) {</span>
+<span class="source-line-no">393</span><span id="line-393">        return 
isBase64(arrayOctet);</span>
+<span class="source-line-no">394</span><span id="line-394">    }</span>
+<span class="source-line-no">395</span><span id="line-395"></span>
+<span class="source-line-no">396</span><span id="line-396">    /**</span>
+<span class="source-line-no">397</span><span id="line-397">     * Returns 
whether or not the {@code octet} is in the base 64 alphabet.</span>
+<span class="source-line-no">398</span><span id="line-398">     *</span>
+<span class="source-line-no">399</span><span id="line-399">     * @param 
octet</span>
+<span class="source-line-no">400</span><span id="line-400">     *            
The value to test</span>
+<span class="source-line-no">401</span><span id="line-401">     * @return 
{@code true} if the value is defined in the base 64 alphabet, {@code false} 
otherwise.</span>
+<span class="source-line-no">402</span><span id="line-402">     * @since 
1.4</span>
+<span class="source-line-no">403</span><span id="line-403">     */</span>
+<span class="source-line-no">404</span><span id="line-404">    public static 
boolean isBase64(final byte octet) {</span>
+<span class="source-line-no">405</span><span id="line-405">        return 
octet == PAD_DEFAULT || octet &gt;= 0 &amp;&amp; octet &lt; DECODE_TABLE.length 
&amp;&amp; DECODE_TABLE[octet] != -1;</span>
+<span class="source-line-no">406</span><span id="line-406">    }</span>
+<span class="source-line-no">407</span><span id="line-407"></span>
+<span class="source-line-no">408</span><span id="line-408">    /**</span>
+<span class="source-line-no">409</span><span id="line-409">     * Tests a 
given byte array to see if it contains only valid characters within the Base64 
alphabet. Currently the</span>
+<span class="source-line-no">410</span><span id="line-410">     * method 
treats whitespace as valid.</span>
+<span class="source-line-no">411</span><span id="line-411">     *</span>
+<span class="source-line-no">412</span><span id="line-412">     * @param 
arrayOctet</span>
+<span class="source-line-no">413</span><span id="line-413">     *            
byte array to test</span>
+<span class="source-line-no">414</span><span id="line-414">     * @return 
{@code true} if all bytes are valid characters in the Base64 alphabet or if the 
byte array is empty;</span>
+<span class="source-line-no">415</span><span id="line-415">     *         
{@code false}, otherwise</span>
+<span class="source-line-no">416</span><span id="line-416">     * @since 
1.5</span>
+<span class="source-line-no">417</span><span id="line-417">     */</span>
+<span class="source-line-no">418</span><span id="line-418">    public static 
boolean isBase64(final byte[] arrayOctet) {</span>
+<span class="source-line-no">419</span><span id="line-419">        for (final 
byte element : arrayOctet) {</span>
+<span class="source-line-no">420</span><span id="line-420">            if 
(!isBase64(element) &amp;&amp; !Character.isWhitespace(element)) {</span>
+<span class="source-line-no">421</span><span id="line-421">                
return false;</span>
+<span class="source-line-no">422</span><span id="line-422">            }</span>
+<span class="source-line-no">423</span><span id="line-423">        }</span>
+<span class="source-line-no">424</span><span id="line-424">        return 
true;</span>
+<span class="source-line-no">425</span><span id="line-425">    }</span>
+<span class="source-line-no">426</span><span id="line-426"></span>
+<span class="source-line-no">427</span><span id="line-427">    /**</span>
+<span class="source-line-no">428</span><span id="line-428">     * Tests a 
given String to see if it contains only valid characters within the Base64 
alphabet. Currently the</span>
+<span class="source-line-no">429</span><span id="line-429">     * method 
treats whitespace as valid.</span>
+<span class="source-line-no">430</span><span id="line-430">     *</span>
+<span class="source-line-no">431</span><span id="line-431">     * @param 
base64</span>
+<span class="source-line-no">432</span><span id="line-432">     *            
String to test</span>
+<span class="source-line-no">433</span><span id="line-433">     * @return 
{@code true} if all characters in the String are valid characters in the Base64 
alphabet or if</span>
+<span class="source-line-no">434</span><span id="line-434">     *         the 
String is empty; {@code false}, otherwise</span>
+<span class="source-line-no">435</span><span id="line-435">     *  @since 
1.5</span>
+<span class="source-line-no">436</span><span id="line-436">     */</span>
+<span class="source-line-no">437</span><span id="line-437">    public static 
boolean isBase64(final String base64) {</span>
+<span class="source-line-no">438</span><span id="line-438">        return 
isBase64(StringUtils.getBytesUtf8(base64));</span>
+<span class="source-line-no">439</span><span id="line-439">    }</span>
+<span class="source-line-no">440</span><span id="line-440"></span>
+<span class="source-line-no">441</span><span id="line-441">    /**</span>
+<span class="source-line-no">442</span><span id="line-442">     * Returns a 
byte-array representation of a {@code BigInteger} without sign bit.</span>
+<span class="source-line-no">443</span><span id="line-443">     *</span>
+<span class="source-line-no">444</span><span id="line-444">     * @param 
bigInt</span>
+<span class="source-line-no">445</span><span id="line-445">     *            
{@code BigInteger} to be converted</span>
+<span class="source-line-no">446</span><span id="line-446">     * @return a 
byte array representation of the BigInteger parameter</span>
+<span class="source-line-no">447</span><span id="line-447">     */</span>
+<span class="source-line-no">448</span><span id="line-448">    static byte[] 
toIntegerBytes(final BigInteger bigInt) {</span>
+<span class="source-line-no">449</span><span id="line-449">        int bitlen 
= bigInt.bitLength();</span>
+<span class="source-line-no">450</span><span id="line-450">        // round 
bitlen</span>
+<span class="source-line-no">451</span><span id="line-451">        bitlen = 
bitlen + 7 &gt;&gt; 3 &lt;&lt; 3;</span>
+<span class="source-line-no">452</span><span id="line-452">        final 
byte[] bigBytes = bigInt.toByteArray();</span>
+<span class="source-line-no">453</span><span id="line-453"></span>
+<span class="source-line-no">454</span><span id="line-454">        if 
(bigInt.bitLength() % 8 != 0 &amp;&amp; bigInt.bitLength() / 8 + 1 == bitlen / 
8) {</span>
+<span class="source-line-no">455</span><span id="line-455">            return 
bigBytes;</span>
+<span class="source-line-no">456</span><span id="line-456">        }</span>
+<span class="source-line-no">457</span><span id="line-457">        // set up 
params for copying everything but sign bit</span>
+<span class="source-line-no">458</span><span id="line-458">        int 
startSrc = 0;</span>
+<span class="source-line-no">459</span><span id="line-459">        int len = 
bigBytes.length;</span>
+<span class="source-line-no">460</span><span id="line-460"></span>
+<span class="source-line-no">461</span><span id="line-461">        // if 
bigInt is exactly byte-aligned, just skip signbit in copy</span>
+<span class="source-line-no">462</span><span id="line-462">        if 
(bigInt.bitLength() % 8 == 0) {</span>
+<span class="source-line-no">463</span><span id="line-463">            
startSrc = 1;</span>
+<span class="source-line-no">464</span><span id="line-464">            
len--;</span>
+<span class="source-line-no">465</span><span id="line-465">        }</span>
+<span class="source-line-no">466</span><span id="line-466">        final int 
startDst = bitlen / 8 - len; // to pad w/ nulls as per spec</span>
+<span class="source-line-no">467</span><span id="line-467">        final 
byte[] resizedBytes = new byte[bitlen / 8];</span>
+<span class="source-line-no">468</span><span id="line-468">        
System.arraycopy(bigBytes, startSrc, resizedBytes, startDst, len);</span>
+<span class="source-line-no">469</span><span id="line-469">        return 
resizedBytes;</span>
+<span class="source-line-no">470</span><span id="line-470">    }</span>
+<span class="source-line-no">471</span><span id="line-471"></span>
+<span class="source-line-no">472</span><span id="line-472">    private static 
byte[] toUrlSafeEncodeTable(final boolean urlSafe) {</span>
+<span class="source-line-no">473</span><span id="line-473">        return 
urlSafe ? URL_SAFE_ENCODE_TABLE : STANDARD_ENCODE_TABLE;</span>
+<span class="source-line-no">474</span><span id="line-474">    }</span>
+<span class="source-line-no">475</span><span id="line-475"></span>
+<span class="source-line-no">476</span><span id="line-476">    /**</span>
+<span class="source-line-no">477</span><span id="line-477">     * Encode table 
to use: either STANDARD or URL_SAFE or custom.</span>
+<span class="source-line-no">478</span><span id="line-478">     * Note: the 
DECODE_TABLE above remains static because it is able</span>
+<span class="source-line-no">479</span><span id="line-479">     * to decode 
both STANDARD and URL_SAFE streams, but the encodeTable must be a member 
variable so we can switch</span>
+<span class="source-line-no">480</span><span id="line-480">     * between the 
two modes.</span>
+<span class="source-line-no">481</span><span id="line-481">     */</span>
+<span class="source-line-no">482</span><span id="line-482">    private final 
byte[] encodeTable;</span>
+<span class="source-line-no">483</span><span id="line-483"></span>
+<span class="source-line-no">484</span><span id="line-484">    /**</span>
+<span class="source-line-no">485</span><span id="line-485">     * Decode table 
to use.</span>
+<span class="source-line-no">486</span><span id="line-486">     */</span>
+<span class="source-line-no">487</span><span id="line-487">    private final 
byte[] decodeTable;</span>
+<span class="source-line-no">488</span><span id="line-488"></span>
+<span class="source-line-no">489</span><span id="line-489">    /**</span>
+<span class="source-line-no">490</span><span id="line-490">     * Line 
separator for encoding. Not used when decoding. Only used if lineLength 
&amp;gt; 0.</span>
+<span class="source-line-no">491</span><span id="line-491">     */</span>
+<span class="source-line-no">492</span><span id="line-492">    private final 
byte[] lineSeparator;</span>
+<span class="source-line-no">493</span><span id="line-493"></span>
+<span class="source-line-no">494</span><span id="line-494">    /**</span>
+<span class="source-line-no">495</span><span id="line-495">     * Convenience 
variable to help us determine when our buffer is going to run out of room and 
needs resizing.</span>
+<span class="source-line-no">496</span><span id="line-496">     * {@code 
encodeSize = 4 + lineSeparator.length;}</span>
+<span class="source-line-no">497</span><span id="line-497">     */</span>
+<span class="source-line-no">498</span><span id="line-498">    private final 
int encodeSize;</span>
+<span class="source-line-no">499</span><span id="line-499"></span>
+<span class="source-line-no">500</span><span id="line-500">    private final 
boolean isUrlSafe;</span>
+<span class="source-line-no">501</span><span id="line-501"></span>
+<span class="source-line-no">502</span><span id="line-502">    /**</span>
+<span class="source-line-no">503</span><span id="line-503">     * Constructs a 
Base64 codec used for decoding (all modes) and encoding in URL-unsafe 
mode.</span>
+<span class="source-line-no">504</span><span id="line-504">     * 
&lt;p&gt;</span>
+<span class="source-line-no">505</span><span id="line-505">     * When 
encoding the line length is 0 (no chunking), and the encoding table is 
STANDARD_ENCODE_TABLE.</span>
+<span class="source-line-no">506</span><span id="line-506">     * 
&lt;/p&gt;</span>
+<span class="source-line-no">507</span><span id="line-507">     * 
&lt;p&gt;</span>
+<span class="source-line-no">508</span><span id="line-508">     * When 
decoding all variants are supported.</span>
+<span class="source-line-no">509</span><span id="line-509">     * 
&lt;/p&gt;</span>
+<span class="source-line-no">510</span><span id="line-510">     */</span>
+<span class="source-line-no">511</span><span id="line-511">    public Base64() 
{</span>
+<span class="source-line-no">512</span><span id="line-512">        
this(0);</span>
+<span class="source-line-no">513</span><span id="line-513">    }</span>
+<span class="source-line-no">514</span><span id="line-514"></span>
+<span class="source-line-no">515</span><span id="line-515">    /**</span>
+<span class="source-line-no">516</span><span id="line-516">     * Constructs a 
Base64 codec used for decoding (all modes) and encoding in the given URL-safe 
mode.</span>
+<span class="source-line-no">517</span><span id="line-517">     * 
&lt;p&gt;</span>
+<span class="source-line-no">518</span><span id="line-518">     * When 
encoding the line length is 76, the line separator is CRLF, and the encoding 
table is STANDARD_ENCODE_TABLE.</span>
+<span class="source-line-no">519</span><span id="line-519">     * 
&lt;/p&gt;</span>
+<span class="source-line-no">520</span><span id="line-520">     * 
&lt;p&gt;</span>
+<span class="source-line-no">521</span><span id="line-521">     * When 
decoding all variants are supported.</span>
+<span class="source-line-no">522</span><span id="line-522">     * 
&lt;/p&gt;</span>
+<span class="source-line-no">523</span><span id="line-523">     *</span>
+<span class="source-line-no">524</span><span id="line-524">     * @param 
urlSafe</span>
+<span class="source-line-no">525</span><span id="line-525">     *            
if {@code true}, URL-safe encoding is used. In most cases this should be set 
to</span>
+<span class="source-line-no">526</span><span id="line-526">     *            
{@code false}.</span>
+<span class="source-line-no">527</span><span id="line-527">     * @since 
1.4</span>
+<span class="source-line-no">528</span><span id="line-528">     */</span>
+<span class="source-line-no">529</span><span id="line-529">    public 
Base64(final boolean urlSafe) {</span>
+<span class="source-line-no">530</span><span id="line-530">        
this(MIME_CHUNK_SIZE, CHUNK_SEPARATOR, urlSafe);</span>
+<span class="source-line-no">531</span><span id="line-531">    }</span>
+<span class="source-line-no">532</span><span id="line-532"></span>
 <span class="source-line-no">533</span><span id="line-533"></span>
-<span class="source-line-no">534</span><span id="line-534"></span>
-<span class="source-line-no">535</span><span id="line-535">    /**</span>
-<span class="source-line-no">536</span><span id="line-536">     * Constructs a 
Base64 codec used for decoding (all modes) and encoding in URL-unsafe 
mode.</span>
-<span class="source-line-no">537</span><span id="line-537">     * 
&lt;p&gt;</span>
-<span class="source-line-no">538</span><span id="line-538">     * When 
encoding the line length is given in the constructor, the line separator is 
CRLF, and the encoding table is</span>
-<span class="source-line-no">539</span><span id="line-539">     * 
STANDARD_ENCODE_TABLE.</span>
-<span class="source-line-no">540</span><span id="line-540">     * 
&lt;/p&gt;</span>
-<span class="source-line-no">541</span><span id="line-541">     * 
&lt;p&gt;</span>
-<span class="source-line-no">542</span><span id="line-542">     * Line lengths 
that aren't multiples of 4 will still essentially end up being multiples of 4 
in the encoded data.</span>
-<span class="source-line-no">543</span><span id="line-543">     * 
&lt;/p&gt;</span>
-<span class="source-line-no">544</span><span id="line-544">     * 
&lt;p&gt;</span>
-<span class="source-line-no">545</span><span id="line-545">     * When 
decoding all variants are supported.</span>
-<span class="source-line-no">546</span><span id="line-546">     * 
&lt;/p&gt;</span>
-<span class="source-line-no">547</span><span id="line-547">     *</span>
-<span class="source-line-no">548</span><span id="line-548">     * @param 
lineLength</span>
-<span class="source-line-no">549</span><span id="line-549">     *            
Each line of encoded data will be at most of the given length (rounded down to 
the nearest multiple of</span>
-<span class="source-line-no">550</span><span id="line-550">     *            
4). If lineLength &amp;lt;= 0, then the output will not be divided into lines 
(chunks). Ignored when</span>
-<span class="source-line-no">551</span><span id="line-551">     *            
decoding.</span>
-<span class="source-line-no">552</span><span id="line-552">     * @since 
1.4</span>
-<span class="source-line-no">553</span><span id="line-553">     */</span>
-<span class="source-line-no">554</span><span id="line-554">    public 
Base64(final int lineLength) {</span>
-<span class="source-line-no">555</span><span id="line-555">        
this(lineLength, CHUNK_SEPARATOR);</span>
-<span class="source-line-no">556</span><span id="line-556">    }</span>
-<span class="source-line-no">557</span><span id="line-557"></span>
-<span class="source-line-no">558</span><span id="line-558">    /**</span>
-<span class="source-line-no">559</span><span id="line-559">     * Constructs a 
Base64 codec used for decoding (all modes) and encoding in URL-unsafe 
mode.</span>
-<span class="source-line-no">560</span><span id="line-560">     * 
&lt;p&gt;</span>
-<span class="source-line-no">561</span><span id="line-561">     * When 
encoding the line length and line separator are given in the constructor, and 
the encoding table is</span>
-<span class="source-line-no">562</span><span id="line-562">     * 
STANDARD_ENCODE_TABLE.</span>
-<span class="source-line-no">563</span><span id="line-563">     * 
&lt;/p&gt;</span>
-<span class="source-line-no">564</span><span id="line-564">     * 
&lt;p&gt;</span>
-<span class="source-line-no">565</span><span id="line-565">     * Line lengths 
that aren't multiples of 4 will still essentially end up being multiples of 4 
in the encoded data.</span>
-<span class="source-line-no">566</span><span id="line-566">     * 
&lt;/p&gt;</span>
-<span class="source-line-no">567</span><span id="line-567">     * 
&lt;p&gt;</span>
-<span class="source-line-no">568</span><span id="line-568">     * When 
decoding all variants are supported.</span>
-<span class="source-line-no">569</span><span id="line-569">     * 
&lt;/p&gt;</span>
-<span class="source-line-no">570</span><span id="line-570">     *</span>
-<span class="source-line-no">571</span><span id="line-571">     * @param 
lineLength</span>
-<span class="source-line-no">572</span><span id="line-572">     *            
Each line of encoded data will be at most of the given length (rounded down to 
the nearest multiple of</span>
-<span class="source-line-no">573</span><span id="line-573">     *            
4). If lineLength &amp;lt;= 0, then the output will not be divided into lines 
(chunks). Ignored when</span>
-<span class="source-line-no">574</span><span id="line-574">     *            
decoding.</span>
-<span class="source-line-no">575</span><span id="line-575">     * @param 
lineSeparator</span>
-<span class="source-line-no">576</span><span id="line-576">     *            
Each line of encoded data will end with this sequence of bytes.</span>
-<span class="source-line-no">577</span><span id="line-577">     * @throws 
IllegalArgumentException</span>
-<span class="source-line-no">578</span><span id="line-578">     *             
Thrown when the provided lineSeparator included some base64 characters.</span>
-<span class="source-line-no">579</span><span id="line-579">     * @since 
1.4</span>
-<span class="source-line-no">580</span><span id="line-580">     */</span>
-<span class="source-line-no">581</span><span id="line-581">    public 
Base64(final int lineLength, final byte[] lineSeparator) {</span>
-<span class="source-line-no">582</span><span id="line-582">        
this(lineLength, lineSeparator, false);</span>
-<span class="source-line-no">583</span><span id="line-583">    }</span>
-<span class="source-line-no">584</span><span id="line-584"></span>
-<span class="source-line-no">585</span><span id="line-585">    /**</span>
-<span class="source-line-no">586</span><span id="line-586">     * Constructs a 
Base64 codec used for decoding (all modes) and encoding in URL-unsafe 
mode.</span>
-<span class="source-line-no">587</span><span id="line-587">     * 
&lt;p&gt;</span>
-<span class="source-line-no">588</span><span id="line-588">     * When 
encoding the line length and line separator are given in the constructor, and 
the encoding table is</span>
-<span class="source-line-no">589</span><span id="line-589">     * 
STANDARD_ENCODE_TABLE.</span>
-<span class="source-line-no">590</span><span id="line-590">     * 
&lt;/p&gt;</span>
-<span class="source-line-no">591</span><span id="line-591">     * 
&lt;p&gt;</span>
-<span class="source-line-no">592</span><span id="line-592">     * Line lengths 
that aren't multiples of 4 will still essentially end up being multiples of 4 
in the encoded data.</span>
-<span class="source-line-no">593</span><span id="line-593">     * 
&lt;/p&gt;</span>
-<span class="source-line-no">594</span><span id="line-594">     * 
&lt;p&gt;</span>
-<span class="source-line-no">595</span><span id="line-595">     * When 
decoding all variants are supported.</span>
-<span class="source-line-no">596</span><span id="line-596">     * 
&lt;/p&gt;</span>
-<span class="source-line-no">597</span><span id="line-597">     *</span>
-<span class="source-line-no">598</span><span id="line-598">     * @param 
lineLength</span>
-<span class="source-line-no">599</span><span id="line-599">     *            
Each line of encoded data will be at most of the given length (rounded down to 
the nearest multiple of</span>
-<span class="source-line-no">600</span><span id="line-600">     *            
4). If lineLength &amp;lt;= 0, then the output will not be divided into lines 
(chunks). Ignored when</span>
-<span class="source-line-no">601</span><span id="line-601">     *            
decoding.</span>
-<span class="source-line-no">602</span><span id="line-602">     * @param 
lineSeparator</span>
-<span class="source-line-no">603</span><span id="line-603">     *            
Each line of encoded data will end with this sequence of bytes.</span>
-<span class="source-line-no">604</span><span id="line-604">     * @param 
urlSafe</span>
-<span class="source-line-no">605</span><span id="line-605">     *            
Instead of emitting '+' and '/' we emit '-' and '_' respectively. urlSafe is 
only applied to encode</span>
-<span class="source-line-no">606</span><span id="line-606">     *            
operations. Decoding seamlessly handles both modes.</span>
-<span class="source-line-no">607</span><span id="line-607">     *            
&lt;b&gt;Note: no padding is added when using the URL-safe 
alphabet.&lt;/b&gt;</span>
-<span class="source-line-no">608</span><span id="line-608">     * @throws 
IllegalArgumentException</span>
-<span class="source-line-no">609</span><span id="line-609">     *             
Thrown when the {@code lineSeparator} contains Base64 characters.</span>
-<span class="source-line-no">610</span><span id="line-610">     * @since 
1.4</span>
-<span class="source-line-no">611</span><span id="line-611">     */</span>
-<span class="source-line-no">612</span><span id="line-612">    public 
Base64(final int lineLength, final byte[] lineSeparator, final boolean urlSafe) 
{</span>
-<span class="source-line-no">613</span><span id="line-613">        
this(lineLength, lineSeparator, PAD_DEFAULT, toUrlSafeEncodeTable(urlSafe), 
DECODING_POLICY_DEFAULT);</span>
-<span class="source-line-no">614</span><span id="line-614">    }</span>
-<span class="source-line-no">615</span><span id="line-615"></span>
-<span class="source-line-no">616</span><span id="line-616">    /**</span>
-<span class="source-line-no">617</span><span id="line-617">     * Constructs a 
Base64 codec used for decoding (all modes) and encoding in URL-unsafe 
mode.</span>
-<span class="source-line-no">618</span><span id="line-618">     * 
&lt;p&gt;</span>
-<span class="source-line-no">619</span><span id="line-619">     * When 
encoding the line length and line separator are given in the constructor, and 
the encoding table is</span>
-<span class="source-line-no">620</span><span id="line-620">     * 
STANDARD_ENCODE_TABLE.</span>
-<span class="source-line-no">621</span><span id="line-621">     * 
&lt;/p&gt;</span>
-<span class="source-line-no">622</span><span id="line-622">     * 
&lt;p&gt;</span>
-<span class="source-line-no">623</span><span id="line-623">     * Line lengths 
that aren't multiples of 4 will still essentially end up being multiples of 4 
in the encoded data.</span>
-<span class="source-line-no">624</span><span id="line-624">     * 
&lt;/p&gt;</span>
-<span class="source-line-no">625</span><span id="line-625">     * 
&lt;p&gt;</span>
-<span class="source-line-no">626</span><span id="line-626">     * When 
decoding all variants are supported.</span>
-<span class="source-line-no">627</span><span id="line-627">     * 
&lt;/p&gt;</span>
-<span class="source-line-no">628</span><span id="line-628">     *</span>
-<span class="source-line-no">629</span><span id="line-629">     * @param 
lineLength</span>
-<span class="source-line-no">630</span><span id="line-630">     *            
Each line of encoded data will be at most of the given length (rounded down to 
the nearest multiple of</span>
-<span class="source-line-no">631</span><span id="line-631">     *            
4). If lineLength &amp;lt;= 0, then the output will not be divided into lines 
(chunks). Ignored when</span>
-<span class="source-line-no">632</span><span id="line-632">     *            
decoding.</span>
-<span class="source-line-no">633</span><span id="line-633">     * @param 
lineSeparator</span>
-<span class="source-line-no">634</span><span id="line-634">     *            
Each line of encoded data will end with this sequence of bytes.</span>
-<span class="source-line-no">635</span><span id="line-635">     * @param 
urlSafe</span>
-<span class="source-line-no">636</span><span id="line-636">     *            
Instead of emitting '+' and '/' we emit '-' and '_' respectively. urlSafe is 
only applied to encode</span>
-<span class="source-line-no">637</span><span id="line-637">     *            
operations. Decoding seamlessly handles both modes.</span>
-<span class="source-line-no">638</span><span id="line-638">     *            
&lt;b&gt;Note: no padding is added when using the URL-safe 
alphabet.&lt;/b&gt;</span>
-<span class="source-line-no">639</span><span id="line-639">     * @param 
decodingPolicy The decoding policy.</span>
-<span class="source-line-no">640</span><span id="line-640">     * @throws 
IllegalArgumentException</span>
-<span class="source-line-no">641</span><span id="line-641">     *             
Thrown when the {@code lineSeparator} contains Base64 characters.</span>
-<span class="source-line-no">642</span><span id="line-642">     * @since 
1.15</span>
-<span class="source-line-no">643</span><span id="line-643">     */</span>
-<span class="source-line-no">644</span><span id="line-644">    public 
Base64(final int lineLength, final byte[] lineSeparator, final boolean urlSafe, 
final CodecPolicy decodingPolicy) {</span>
-<span class="source-line-no">645</span><span id="line-645">        
this(lineLength, lineSeparator, PAD_DEFAULT, toUrlSafeEncodeTable(urlSafe), 
decodingPolicy);</span>
-<span class="source-line-no">646</span><span id="line-646">    }</span>
-<span class="source-line-no">647</span><span id="line-647"></span>
-<span class="source-line-no">648</span><span id="line-648">    /**</span>
-<span class="source-line-no">649</span><span id="line-649">     * Constructs a 
Base64 codec used for decoding (all modes) and encoding in URL-unsafe 
mode.</span>
-<span class="source-line-no">650</span><span id="line-650">     * 
&lt;p&gt;</span>
-<span class="source-line-no">651</span><span id="line-651">     * When 
encoding the line length and line separator are given in the constructor, and 
the encoding table is STANDARD_ENCODE_TABLE.</span>
-<span class="source-line-no">652</span><span id="line-652">     * 
&lt;/p&gt;</span>
-<span class="source-line-no">653</span><span id="line-653">     * 
&lt;p&gt;</span>
-<span class="source-line-no">654</span><span id="line-654">     * Line lengths 
that aren't multiples of 4 will still essentially end up being multiples of 4 
in the encoded data.</span>
-<span class="source-line-no">655</span><span id="line-655">     * 
&lt;/p&gt;</span>
-<span class="source-line-no">656</span><span id="line-656">     * 
&lt;p&gt;</span>
-<span class="source-line-no">657</span><span id="line-657">     * When 
decoding all variants are supported.</span>
-<span class="source-line-no">658</span><span id="line-658">     * 
&lt;/p&gt;</span>
-<span class="source-line-no">659</span><span id="line-659">     *</span>
-<span class="source-line-no">660</span><span id="line-660">     * @param 
lineLength     Each line of encoded data will be at most of the given length 
(rounded down to the nearest multiple of 4). If lineLength &amp;lt;= 0,</span>
-<span class="source-line-no">661</span><span id="line-661">     *              
         then the output will not be divided into lines (chunks). Ignored when 
decoding.</span>
-<span class="source-line-no">662</span><span id="line-662">     * @param 
lineSeparator  Each line of encoded data will end with this sequence of bytes; 
the constructor makes a defensive copy. May be null.</span>
-<span class="source-line-no">663</span><span id="line-663">     * @param 
padding        padding byte.</span>
-<span class="source-line-no">664</span><span id="line-664">     * @param 
encodeTable    The manual encodeTable - a byte array of 64 chars.</span>
-<span class="source-line-no">665</span><span id="line-665">     * @param 
decodingPolicy The decoding policy.</span>
-<span class="source-line-no">666</span><span id="line-666">     * @throws 
IllegalArgumentException Thrown when the {@code lineSeparator} contains Base64 
characters.</span>
-<span class="source-line-no">667</span><span id="line-667">     */</span>
-<span class="source-line-no">668</span><span id="line-668">    private 
Base64(final int lineLength, final byte[] lineSeparator, final byte padding, 
final byte[] encodeTable, final CodecPolicy decodingPolicy) {</span>
-<span class="source-line-no">669</span><span id="line-669">        
super(BYTES_PER_UNENCODED_BLOCK, BYTES_PER_ENCODED_BLOCK, lineLength, 
toLength(lineSeparator), padding, decodingPolicy);</span>
-<span class="source-line-no">670</span><span id="line-670">        
Objects.requireNonNull(encodeTable, "encodeTable");</span>
-<span class="source-line-no">671</span><span id="line-671">        if 
(encodeTable.length != ALPHABET_LENGTH) {</span>
-<span class="source-line-no">672</span><span id="line-672">            throw 
new IllegalArgumentException("encodeTable must have exactly 64 
entries.");</span>
-<span class="source-line-no">673</span><span id="line-673">        }</span>
-<span class="source-line-no">674</span><span id="line-674">        
this.isUrlSafe = encodeTable == URL_SAFE_ENCODE_TABLE;</span>
-<span class="source-line-no">675</span><span id="line-675">        if 
(encodeTable == STANDARD_ENCODE_TABLE || this.isUrlSafe) {</span>
-<span class="source-line-no">676</span><span id="line-676">            
decodeTable = DECODE_TABLE;</span>
-<span class="source-line-no">677</span><span id="line-677">            // No 
need of a defensive copy of an internal table.</span>
-<span class="source-line-no">678</span><span id="line-678">            
this.encodeTable = encodeTable;</span>
-<span class="source-line-no">679</span><span id="line-679">        } else 
{</span>
-<span class="source-line-no">680</span><span id="line-680">            
this.encodeTable = encodeTable.clone();</span>
-<span class="source-line-no">681</span><span id="line-681">            
this.decodeTable = calculateDecodeTable(this.encodeTable);</span>
-<span class="source-line-no">682</span><span id="line-682">        }</span>
-<span class="source-line-no">683</span><span id="line-683">        // TODO 
could be simplified if there is no requirement to reject invalid line sep when 
length &lt;=0</span>
-<span class="source-line-no">684</span><span id="line-684">        // @see 
test case Base64Test.testConstructors()</span>
-<span class="source-line-no">685</span><span id="line-685">        if 
(lineSeparator != null) {</span>
-<span class="source-line-no">686</span><span id="line-686">            final 
byte[] lineSeparatorCopy = lineSeparator.clone();</span>
-<span class="source-line-no">687</span><span id="line-687">            if 
(containsAlphabetOrPad(lineSeparatorCopy)) {</span>
-<span class="source-line-no">688</span><span id="line-688">                
final String sep = StringUtils.newStringUtf8(lineSeparatorCopy);</span>
-<span class="source-line-no">689</span><span id="line-689">                
throw new IllegalArgumentException("lineSeparator must not contain base64 
characters: [" + sep + "]");</span>
-<span class="source-line-no">690</span><span id="line-690">            }</span>
-<span class="source-line-no">691</span><span id="line-691">            if 
(lineLength &gt; 0) { // null line-sep forces no chunking rather than throwing 
IAE</span>
-<span class="source-line-no">692</span><span id="line-692">                
this.encodeSize = BYTES_PER_ENCODED_BLOCK + lineSeparatorCopy.length;</span>
-<span class="source-line-no">693</span><span id="line-693">                
this.lineSeparator = lineSeparatorCopy;</span>
-<span class="source-line-no">694</span><span id="line-694">            } else 
{</span>
-<span class="source-line-no">695</span><span id="line-695">                
this.encodeSize = BYTES_PER_ENCODED_BLOCK;</span>
-<span class="source-line-no">696</span><span id="line-696">                
this.lineSeparator = null;</span>
-<span class="source-line-no">697</span><span id="line-697">            }</span>
-<span class="source-line-no">698</span><span id="line-698">        } else 
{</span>
-<span class="source-line-no">699</span><span id="line-699">            
this.encodeSize = BYTES_PER_ENCODED_BLOCK;</span>
-<span class="source-line-no">700</span><span id="line-700">            
this.lineSeparator = null;</span>
-<span class="source-line-no">701</span><span id="line-701">        }</span>
-<span class="source-line-no">702</span><span id="line-702">    }</span>
-<span class="source-line-no">703</span><span id="line-703"></span>
-<span class="source-line-no">704</span><span id="line-704">    /**</span>
-<span class="source-line-no">705</span><span id="line-705">     * Calculates a 
decode table for a given encode table.</span>
-<span class="source-line-no">706</span><span id="line-706">     *</span>
-<span class="source-line-no">707</span><span id="line-707">     * @param 
encodeTable that is used to determine decode lookup table</span>
-<span class="source-line-no">708</span><span id="line-708">     * @return 
decodeTable</span>
-<span class="source-line-no">709</span><span id="line-709">     */</span>
-<span class="source-line-no">710</span><span id="line-710">    private byte[] 
calculateDecodeTable(final byte[] encodeTable) {</span>
-<span class="source-line-no">711</span><span id="line-711">        final 
byte[] decodeTable = new byte[DECODING_TABLE_LENGTH];</span>
-<span class="source-line-no">712</span><span id="line-712">        
Arrays.fill(decodeTable, (byte) -1);</span>
-<span class="source-line-no">713</span><span id="line-713">        for (int i 
= 0; i &lt; encodeTable.length; i++) {</span>
-<span class="source-line-no">714</span><span id="line-714">            
decodeTable[encodeTable[i]] = (byte) i;</span>
-<span class="source-line-no">715</span><span id="line-715">        }</span>
-<span class="source-line-no">716</span><span id="line-716">        return 
decodeTable;</span>
-<span class="source-line-no">717</span><span id="line-717">    }</span>
-<span class="source-line-no">718</span><span id="line-718"></span>
-<span class="source-line-no">719</span><span id="line-719">    /**</span>
-<span class="source-line-no">720</span><span id="line-720">     * 
&lt;p&gt;</span>
-<span class="source-line-no">721</span><span id="line-721">     * Decodes all 
of the provided data, starting at inPos, for inAvail bytes. Should be called at 
least twice: once</span>

[... 680 lines stripped ...]