java Base64 是什么

Java Base64 是 Java 中用于 Base64 编码/解码 的工具类,它将二进制数据转换为可打印的 ASCII 字符集(A-Z, a-z, 0-9, +, / 和填充符 =),主要用于在文本协议(如 HTTP、XML、JSON)中安全传输二进制数据。

主要特点

  • 二进制 ↔ 文本转换:将任意二进制数据(图片、文件、加密数据等)转换为文本字符串
  • URL安全:某些变体避免使用 URL 不安全的字符(如 + 和 /)
  • MIME兼容:支持邮件传输格式

Java 中的实现方式

1. Java 8+ 标准 API(推荐)

java 复制代码
import java.util.Base64;

public class Base64Example {
    public static void main(String[] args) {
        String original = "Hello, World!";
        
        // 基本编码器
        Base64.Encoder encoder = Base64.getEncoder();
        String encoded = encoder.encodeToString(original.getBytes());
        System.out.println("Encoded: " + encoded); // SGVsbG8sIFdvcmxkIQ==
        
        // 解码
        Base64.Decoder decoder = Base64.getDecoder();
        byte[] decoded = decoder.decode(encoded);
        System.out.println("Decoded: " + new String(decoded));
    }
}

2. 三种编码器类型

java 复制代码
// 1. 基本编码器(标准 Base64)
Base64.Encoder basicEncoder = Base64.getEncoder();

// 2. URL编码器(用 -_ 代替 +/,避免URL冲突)
Base64.Encoder urlEncoder = Base64.getUrlEncoder();
String urlSafe = urlEncoder.encodeToString(data);

// 3. MIME编码器(每76字符换行,邮件格式)
Base64.Encoder mimeEncoder = Base64.getMimeEncoder();

3. Java 8 之前的方式

java 复制代码
// 使用 Apache Commons Codec(需要添加依赖)
import org.apache.commons.codec.binary.Base64;
byte[] encoded = Base64.encodeBase64("text".getBytes());

// 或使用 sun.misc.BASE64Encoder(不推荐,已废弃)

常见用途

1. 传输二进制数据

java 复制代码
// 图片转 Base64
byte[] imageBytes = Files.readAllBytes(Paths.get("image.jpg"));
String base64Image = Base64.getEncoder().encodeToString(imageBytes);

2. URL参数安全传输

java 复制代码
// URL安全编码
String data = "敏感数据#123";
String encoded = Base64.getUrlEncoder().withoutPadding().encodeToString(data.getBytes());
// 结果不含 = + / 等特殊字符

3. 基本认证

java 复制代码
// HTTP Basic Auth
String auth = "username:password";
String encodedAuth = Base64.getEncoder().encodeToString(auth.getBytes());
// 请求头:Authorization: Basic encodedAuth

4. 数据存储

java 复制代码
// 小型数据存储(不建议大型文件)
String serializedData = Base64.getEncoder().encodeToString(objectBytes);

注意事项

  1. 体积增加:Base64 编码后数据体积增加约 33%
  2. 非加密:Base64 只是编码,不是加密,敏感数据需要额外加密
  3. 性能:编解码有性能开销,大文件需谨慎使用
  4. 换行符:某些系统要求每 76 字符换行(MIME 格式)

实用工具方法

java 复制代码
public class Base64Utils {
    
    // 编码字符串
    public static String encode(String str) {
        return Base64.getEncoder().encodeToString(str.getBytes(StandardCharsets.UTF_8));
    }
    
    // 解码字符串
    public static String decode(String base64Str) {
        byte[] decoded = Base64.getDecoder().decode(base64Str);
        return new String(decoded, StandardCharsets.UTF_8);
    }
    
    // URL安全编码(无填充)
    public static String encodeUrlSafe(String str) {
        return Base64.getUrlEncoder().withoutPadding()
            .encodeToString(str.getBytes(StandardCharsets.UTF_8));
    }
}

最佳实践:

  • 优先使用 Java 8+ 的 java.util.Base64
  • URL 参数使用 getUrlEncoder()
  • 传输大文件考虑分块或直接二进制传输
  • 始终指定字符集(如 UTF-8)避免编码问题
相关推荐
hudd66812 分钟前
JavaEE 初阶 - 文件操作和IO
java·开发语言·java-ee
Flynn Liang1 小时前
HikariCP 连接池不是越大越好:I/O 密集型 Java 服务的数据库容量工程
java·数据库·mysql·高并发·连接池·hikaricp·sql 优化
学长毕设1 小时前
基于SpringBoot社区快递驿站物流配送系统-附源码
java·spring boot·后端
Flynt2 小时前
Java4Shell 实测:EPYC 一跑就中招,关掉 Base64 硬件加速,1KB 解码慢 14 倍
java·安全·性能优化
Resean02232 小时前
Spring 源码分析(七)AOP 原理(上):代理的创建
java·后端·spring
Tangq一定可以的2 小时前
Spring AI Advisor 详解 - 给大模型调用加上“切面“,日志/过滤/记忆一键搞定
java·后端·spring
小巫编程室3 小时前
我造了一个 Java 能力包:让 AI 直接调用你的业务代码
java·前端·后端
深入云栈3 小时前
Netty 4.2.x 源码深度解析 (二十四):池化内存分配 —— PoolArena、PoolChunk 与 PoolSubpage
java·后端·架构
惜.己4 小时前
Java结合idea简单使用Playwright
java·开发语言·自动化
Vex2une5 小时前
JDK 8 下载安装与环境变量配置完整指南(Windows新手图文教程)
java·windows·环境配置·环境变量·jdk8·jdk下载安装·java入门教程