Java Base64编码类推荐

转载 2012年03月23日 02:02:36


Something Sun Should Have Included Long Ago

Download now! (v2.3.7 48KB)

Follow the file release RSS feed... 

This is a Public Domain Java class providing very fast Base64 encoding and decoding in the form of convenience methods and input/output streams.

There are other Base64 utilities on the Internet, some part of proprietary packages, some with various open source licenses. In any event, I hope with one or more of these Base64 tools, you won't have to write your own like I did.

If you use Maven, thank Owen O'Malley from Apache and Matthew from Sensible Development for working up a Base64 Maven Repository.

Thanks to Brian Burton for providing this test class for use with (The test file hasn't been updated in a while.)

You may view the Base64 javadoc API online, if you like.

Version 2.3 is not a drop-in replacement to earlier versions. I finally improved the error handling such that the code will throw exceptions when there is a problem instead of just quietly returning null. Sorry if you like the old style (I did too for a long time), but I changed it and think it's better form this way. There are also some helper methods for encoding data without creating a String object; that should help with very large amounts of data or when memory is tight.


The easiest way to convert some data is with the convenience methods:

String result1 = Base64.encodeObject( mySerializableObject );
String result2 = Base64.encodeBytes( new byte[]{ 3, 34, 116, 9 } );

Or you can use the very efficient streams:

OutputStream out = new Base64.OutputStream( 
                    new FileOutputStream( "out.txt" ) );
// Go on about your outputting...
// ...

InputStream in = new Base64.InputStream( 
                  new FileInputStream( "in.txt" ) );
// Go on about your inputting...
// ...

There are defaults (OutputStream encodes, InputStream decodes), but you can easily override that:

OutputStream out = new Base64.OutputStream( 
                    new FileOutputStream( "out.txt" ), Base64.DECODE );
// Go on about your outputting...
// ...

A Note About Public Domain

I have released this software into the Public Domain. That means you can do whatever you want with it. Really. You don't have to match it up with any other open source license &em; just use it. You can rename the files, move the Java packages, whatever you want. If your lawyers say you have to have a license, contact me, and I'll make a special release to you under whatever reasonable license you desire: MIT, BSD, GPL, whatever.


There are alternative Base64 classes out there. For various reasons you might prefer them. It's OK; you won't hurt my feelings. Keep in mind particularly that there are a lot of "helper functions" in the class available on this page, and if you're doing embedded work, you'll either want to strip out the fluff or just grab a more minimal implementation. Here are some that I've found:


  • v2.3.7 - Fixed subtle bug when base 64 input stream contained the value 01111111, which is an invalid base 64 character but should not throw an ArrayIndexOutOfBoundsException either. Led to discovery of mishandling (or potential for better handling) of other bad input characters. You should now get an IOException if you try decoding something that has bad characters in it.
  • v2.3.6 - Fixed bug when breaking lines and the final byte of the encoded string ended in the last column; the buffer was not properly shrunk and contained an extra (null) byte that made it into the string.
  • v2.3.4 - Fixed bug when working with gzipped streams whereby flushing the Base64.OutputStream closed the Base64 encoding (by padding with equals signs) too soon. Also added an option to suppress the automatic decoding of gzipped streams.
  • v2.3.3 - Changed default char encoding to US-ASCII which reduces the internal Java footprint with its CharEncoders and so forth. Fixed some javadocs that were inconsistent. Removed imports and specified things like explicitly inline.
  • v2.3.2 - Reduced memory footprint! Finally refined the "guessing" of how big the final encoded data will be so that the code doesn't have to create two output arrays: an oversized initial one and then a final, exact-sized one. Big win when using the encodeBytesToBytes(byte[]) family of methods (and not using the gzip options which uses a different mechanism with streams and stuff).
  • v2.3.1 - Added encodeBytesToBytes(byte[], int, int, int) and some similar helper methods to be more efficient with memory by not returning a String but just a byte array.
  • v2.3 - This is not a drop-in replacement! This is two years of comments and bug fixes queued up and finally executed. Thanks to everyone who sent me stuff, and I'm sorry I wasn't able to distribute your fixes to everyone else. Much bad coding was cleaned up including throwing exceptions where necessary instead of returning null values or something similar. Here are some changes that may affect you:
    • Does not break lines, by default. This is to keep in compliance with RFC3548.
    • Throws exceptions instead of returning null values. Because some operations (especially those that may permit the GZIP option) use IO streams, there is a possiblity of an being thrown. After some discussion and thought, I've changed the behavior of the methods to throw rather than return null if ever there's an error. I think this is more appropriate, though it will require some changes to your code. Sorry, it should have been done this way to begin with.
    • Removed all references to System.out, System.err, and the like. Shame on me. All I can say is sorry they were ever there.
    • Throws NullPointerExceptions and IllegalArgumentExceptions as needed such as when passed arrays are null or offsets are invalid.
    • Cleaned up as much javadoc as I could to avoid any javadoc warnings. This was especially annoying before for people who were thorough in their own projects and then had gobs of javadoc warnings on this file.
  • v2.2.2 - Fixed encodeFileToFile and decodeFileToFile to use the Base64.InputStream class to encode and decode on the fly which uses less memory than encoding/decoding an entire file into memory before writing.
  • v2.2.1 - Fixed bug using URL_SAFE and ORDERED encodings. Fixed bug when using very small files (~< 40 bytes).
  • v2.2 - Added some helper methods for encoding/decoding directly from one file to the next. Also added a main() method to support command line encoding/decoding from one file to the next. Also added these Base64 dialects:
    1. The default is RFC3548 format.
    2. Calling Base64.setFormat(Base64.BASE64_FORMAT.URLSAFE_FORMAT) generates URL and file name friendly format as described in Section 4 of RFC3548.
    3. Calling Base64.setFormat(Base64.BASE64_FORMAT.ORDERED_FORMAT) generates URL and file name friendly format that preserves lexical ordering as described in
    Special thanks to Jim Kellerman at for contributing the new Base64 dialects.
  • v2.1 - Cleaned up javadoc comments and unused variables and methods. Added some convenience methods for reading and writing to and from files.
  • v2.0.2 - Now specifies UTF-8 encoding in places where the code fails on systems with other encodings (like EBCDIC).
  • v2.0.1 - Fixed an error when decoding a single byte, that is, when the encoded data was a single byte.
  • v2.0 - I got rid of methods that used booleans to set options. Now everything is more consolidated and cleaner. The code now detects when data that's being decoded is gzip-compressed and will decompress it automatically. Generally things are cleaner. You'll probably have to change some method calls that you were making to support the new options format (ints that you "OR" together).
  • v1.5.1 - Fixed bug when decompressing and decoding to a byte[] using decode( String s, boolean gzipCompressed ). Added the ability to "suspend" encoding in the Output Stream so you can turn on and off the encoding if you need to embed base64 data in an otherwise "normal" stream (like an XML file). This has not been fully tested, so please alert me to bugs.
  • v1.5 - Output stream pases on flush() command but doesn't do anything itself. This helps when using GZIP streams. Added the ability to GZip-compress objects before encoding them.
  • v1.4 - Added some helper methods for reading and writing to/from files.
  • v1.3.6 - Fixed OutputStream.flush() so that 'position' is reset.
  • v1.3.5 - Added flag to turn on and off line breaks. Fixed bug in input stream where last buffer being read, if not completely full, was not returned.
  • v1.3.4 - Fixed when Improperly padded base64 stream exception was incorrectly thrown.
  • A bug has been fixed that kept I/O streams from working at all, really.
  • A bug has been fixed affecting you if you use the Base64.InputStream to encode data.
  • A bug has been fixed where if you specified an offset when encoding an array of bytes, the offset was ignored.


  • luzhenyuxfcy
  • luzhenyuxfcy
  • 2016年02月18日 11:07
  • 1318

Java 进行 RSA 加解密时不得不考虑到的那些事儿

1. 加密的系统不要具备解密的功能,否则 RSA 可能不太合适 公钥加密,私钥解密。加密的系统和解密的系统分开部署,加密的系统不应该同时具备解密的功能,这样即使黑客攻破了加密系统,他拿到的也只是一堆...
  • LANGZI7758521
  • LANGZI7758521
  • 2016年04月21日 21:54
  • 875

Base64编码认识(Java 测试)

简述: Base64的一个转码的实现 原理: Base64编码方法要求把每三个8Bit的字节转换为四个6Bit的字节,其中,转换之后的这四个字节中每6个有效bit为是有效数据,空余的那两...
  • anialy
  • anialy
  • 2013年03月04日 21:06
  • 2678


Base64是一种基于64个字符的编码算法,经过Base64编码的数据会比原始数据略长,为原来长度的4/3倍。Base64算法中,等号用来补位。 URLBase64算法主要是将"+"和"/"替换成了...
  • fcytxdy
  • fcytxdy
  • 2015年07月10日 14:16
  • 2684


简介 Apache Zookeeper是由 Apache Hadoop 的 Zookeeper 子项目发展而来,现在已经成为了 Apache 的顶级项目。Zookeeper 为分布式系统提供...
  • JY_He
  • JY_He
  • 2016年08月27日 11:39
  • 561

Java SimpleDateFormat 线程不安全问题及解决方法

Java SimpleDateFormat 是线程不安全的,当在多线程环境下使用一个DateFormatd
  • suifeng3051
  • suifeng3051
  • 2014年05月07日 16:43
  • 2461


遇到的问题:     今天参考他人代码实现了一下RSA算法。遇到一个问题,网上的RSA工具类中的核心方法大多是需要传入byte[]数组进行处理,而不能直接传入String进行处理,这里对byte[]的...
  • ldld1717
  • ldld1717
  • 2017年05月08日 15:22
  • 720

java Base64加密实现

Base64是网络上最常见的用于传输的8bit字节代码的编码方式,也常将把需要的二进制数据编码放在url中的形式上传,由于可读性差,所编码的数据不会被直接看到信息详情! Base64 是采用字符替换的...
  • axuanqq
  • axuanqq
  • 2016年05月15日 10:58
  • 1154

Android 技术揭秘之滑动移除Activity

一、SwipeBackLayout : package com.base.view.view.swipeback; import; import andro...
  • walid1992
  • walid1992
  • 2016年03月22日 17:55
  • 1430


Base64加密算法/** * Created by Jay-Tang on 2016/6/18. */import sun.misc.BASE64Encoder; import sun.misc...
  • tangsilian
  • tangsilian
  • 2016年06月18日 13:55
  • 979
您举报文章:Java Base64编码类推荐