Base64编码是一种基于64个可打印字符来表示二进制数据的编码方式，在Java开发中常用于处理图片、文件等二进制数据的传输和存储，是数据加密与传输安全领域的基础技术之一。它的核心原理是将3个8位的字节转换为4个6位的字节，再对应到Base64字符表中得到最终的可打印字符串。
Java实现Base64编码的常用方法
1. 使用JDK8及之后版本的标准API
JDK8在java.util包中新增了Base64类，提供了更完善、高效的Base64编码解码功能，分为基本编码、URL安全编码和MIME编码三种模式，是现在推荐的首选实现方式。
基本编码模式的实现代码如下：
import java.util.Base64;
public class Base64Demo {
public static void main(String[] args) {
// 待编码的原始字符串
String originalStr = "Java Base64编码测试";
// 将字符串转换为字节数组
byte[] originalBytes = originalStr.getBytes();
// 获取Base64编码器
Base64.Encoder encoder = Base64.getEncoder();
// 执行编码操作
String encodedStr = encoder.encodeToString(originalBytes);
System.out.println("编码后的字符串：" + encodedStr);
// 解码操作
Base64.Decoder decoder = Base64.getDecoder();
byte[] decodedBytes = decoder.decode(encodedStr);
String decodedStr = new String(decodedBytes);
System.out.println("解码后的字符串：" + decodedStr);
}
}
如果需要处理URL场景下的编码，可以使用URL安全的编码器，它会将标准Base64中的+替换为-，/替换为_，避免URL解析出现问题：
import java.util.Base64;
public class Base64UrlDemo {
public static void main(String[] args) {
String originalStr = "test?param=1&name=张三";
byte[] originalBytes = originalStr.getBytes();
// 获取URL安全的Base64编码器
Base64.Encoder urlEncoder = Base64.getUrlEncoder();
String encodedStr = urlEncoder.encodeToString(originalBytes);
System.out.println("URL安全编码结果：" + encodedStr);
// URL安全解码
Base64.Decoder urlDecoder = Base64.getUrlDecoder();
byte[] decodedBytes = urlDecoder.decode(encodedStr);
System.out.println("URL安全解码结果：" + new String(decodedBytes));
}
}
2. 使用早期JDK的sun.misc.BASE64Encoder
在JDK8之前，很多开发者会使用sun.misc.BASE64Encoder类实现Base64编码，不过这个类属于JDK的内部API，不同厂商的JDK实现可能存在差异，不建议在生产环境中使用。
实现示例如下：
import sun.misc.BASE64Encoder;
import sun.misc.BASE64Decoder;
import java.io.IOException;
public class OldBase64Demo {
public static void main(String[] args) throws IOException {
String originalStr = "早期Base64编码实现";
// 编码
BASE64Encoder encoder = new BASE64Encoder();
String encodedStr = encoder.encode(originalStr.getBytes());
System.out.println("编码结果：" + encodedStr);
// 解码
BASE64Decoder decoder = new BASE64Decoder();
byte[] decodedBytes = decoder.decodeBuffer(encodedStr);
System.out.println("解码结果：" + new String(decodedBytes));
}
}
3. 使用第三方库Apache Commons Codec
如果项目已经引入了Apache Commons Codec依赖，也可以使用其中的Base64类实现编码，这种方式在兼容性上表现较好，适合需要兼容低版本JDK的场景。
实现代码如下：
import org.apache.commons.codec.binary.Base64;
public class CommonsBase64Demo {
public static void main(String[] args) {
String originalStr = "第三方库Base64编码";
byte[] originalBytes = originalStr.getBytes();
// 编码
byte[] encodedBytes = Base64.encodeBase64(originalBytes);
String encodedStr = new String(encodedBytes);
System.out.println("编码结果：" + encodedStr);
// 解码
byte[] decodedBytes = Base64.decodeBase64(encodedStr);
System.out.println("解码结果：" + new String(decodedBytes));
}
}
Base64编码的注意事项
- Base64编码并不是真正的加密算法，它只是数据的编码转换方式，编码后的数据可以通过对应的解码方法直接还原，不能用于敏感数据的加密存储。
- 编码后的数据体积会比原始数据增加约1/3，因为每3个字节会被转换为4个字符，传输或存储时需要考虑额外的空间开销。
- 处理二进制文件（如图片、压缩包）时，需要先读取文件的字节数组再进行编码，避免出现字符编码不一致导致的乱码问题。
- 选择实现方式时优先使用JDK8及以上的标准
java.util.Base64类，避免依赖内部API或者不必要的第三方库。
实际应用场景
Base64编码在Java开发中的常见应用场景包括：在JSON中传输二进制数据、邮件附件的编码、简单的数据混淆（非加密）、URL中传递复杂参数等。比如在HTTP接口中返回图片的Base64字符串，前端可以直接通过该字符串渲染图片，不需要额外的文件下载请求。
以下是一个将本地图片转换为Base64字符串的示例：
import java.util.Base64;
import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
public class ImageToBase64 {
public static void main(String[] args) throws IOException {
File imageFile = new File("test.jpg");
FileInputStream fis = new FileInputStream(imageFile);
byte[] imageBytes = new byte[(int) imageFile.length()];
fis.read(imageBytes);
fis.close();
// 编码图片字节数组
String base64Image = Base64.getEncoder().encodeToString(imageBytes);
System.out.println("图片Base64字符串前100位：" + base64Image.substring(0, Math.min(100, base64Image.length())));
}
}