Base64 编码解码与 URL/Query 转义

漆黑的莫莫

于 2024-08-18 21:03:53 发布

阅读量636

点赞数 4

分类专栏：计算机网络 Java 文章标签：信息与通信 java

本文链接：https://blog.csdn.net/qq_45831414/article/details/141288446

版权

Java 同时被 2 个专栏收录

60 篇文章 0 订阅

订阅专栏

计算机网络

20 篇文章 0 订阅

订阅专栏

经验笔记：Base64 编码解码与 URL/Query 转义

引言

在 Web 开发中，经常需要将二进制数据转换为文本形式以方便在网络上传输。Base64 编码是一种常用的技术，但它在 URL 和查询字符串中的使用可能会引发一些常见的错误。本文将探讨这些问题，并提供相应的解决方案。

1. Base64 编码解码

定义：Base64 编码是一种将任意二进制数据转换为 ASCII 文本字符串的方法，便于在网络上传输。Base64 字符集包括 A-Z、a-z、0-9、+ 和 /，以及一个等号 (=) 作为填充字符。
用途：常用于邮件附件、图片嵌入 HTML 页面、安全认证等场景。

2. URL 与 Query 转义

定义：URLs 和查询字符串中的特殊字符（如空格、+、=、& 等）需要进行转义处理，以确保它们在 URL 中被正确解析。
转义：使用 %xx 形式表示特殊字符，其中 xx 是该字符的 ASCII 码的十六进制形式。
解码：将 %xx 形式的字符串还原为原始字符。

3. 常见错误

Base64 中的特殊字符问题：Base64 编码包含的 + 和 / 字符在 URL 中具有特殊含义，可能导致解析问题。
URL 转义与解码不匹配：如果 Base64 编码的字符串没有经过适当的 URL 编码，或者 URL 编码后的字符串在客户端没有被正确解码，会导致数据丢失或损坏。

4. 解决方案

使用 URL-safe Base64：使用 URL-safe 版本的 Base64 编码，将 + 替换为 -，/ 替换为 _，从而避免在 URL 中出现特殊字符。
手动 URL 编码：对于标准 Base64 编码，可以在发送给服务器之前手动对字符串进行 URL 编码。
正确的解码顺序：确保服务器端正确解码 URL，然后再解码 Base64 字符串。

5. 示例代码

标准 Base64 编码

import java.util.Base64;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;

// 原始数据
byte[] data = "Hello World!".getBytes(StandardCharsets.UTF_8);

// 标准 Base64 编码
String base64Str = Base64.getEncoder().encodeToString(data);
System.out.println("Standard Base64: " + base64Str);

// 手动 URL 编码
String urlEncodedStr = URLEncoder.encode(base64Str, StandardCharsets.UTF_8);
System.out.println("URL Encoded: " + urlEncodedStr);

// 构建请求字符串
String requestStr = "data=" + urlEncodedStr;
System.out.println("Request String: " + requestStr);

URL-safe Base64 编码

// URL-safe Base64 编码
String urlSafeBase64Str = Base64.getUrlEncoder().encodeToString(data);
System.out.println("URL-Safe Base64: " + urlSafeBase64Str);

// 构建请求字符串
String urlSafeRequestStr = "data=" + urlSafeBase64Str;
System.out.println("URL-Safe Request String: " + urlSafeRequestStr);

6. 解码过程

接收端：服务器接收到请求后，先解码 URL，再解码 Base64 字符串。
示例代码：

import java.util.Base64;
import java.net.URLDecoder;

// 假设服务器接收到的请求字符串
String receivedRequest = "data=SGVsbG8gV29ybGQh";

// 解码 URL
String decodedUrl = URLDecoder.decode(receivedRequest, StandardCharsets.UTF_8);
System.out.println("Decoded URL: " + decodedUrl);

// 提取 Base64 字符串
String base64Str = decodedUrl.split("=")[1];

// 解码 Base64
byte[] decodedData = Base64.getDecoder().decode(base64Str);
String originalData = new String(decodedData, StandardCharsets.UTF_8);
System.out.println("Original Data: " + originalData);