在Java开发中,字符编码处理是避免乱码问题的核心环节,Charset类作为Java NIO包中处理字符集的核心工具,提供了字符集的查询、编码、解码等完整能力。

Charset类基本概念
Charset类位于java.nio.charset包下,代表一个字符集,每个Charset实例都对应一种具体的字符编码规则,比如UTF-8、GBK、ISO-8859-1等。它提供了标准的方式来处理字符和字节之间的映射关系,替代了早期String类中不规范的编码处理方式。
我们可以通过Charset类的静态方法获取指定字符集的实例,也可以通过它查询当前Java环境支持的所有字符集。常用的标准字符集都有对应的名称,比如UTF-8的名称就是"UTF-8",GBK的名称是"GBK"。
获取Charset实例的两种方式
1. 使用forName方法获取指定字符集
forName是Charset类最常用的静态方法,传入字符集的名称即可获取对应的Charset实例,如果传入的字符集名称不存在,会抛出IllegalCharsetNameException异常。
import java.nio.charset.Charset;
import java.nio.charset.IllegalCharsetNameException;
public class CharsetDemo {
public static void main(String[] args) {
try {
// 获取UTF-8字符集实例
Charset utf8Charset = Charset.forName("UTF-8");
System.out.println("UTF-8字符集名称:" + utf8Charset.name());
// 获取GBK字符集实例
Charset gbkCharset = Charset.forName("GBK");
System.out.println("GBK字符集名称:" + gbkCharset.name());
} catch (IllegalCharsetNameException e) {
e.printStackTrace();
}
}
}
2. 使用默认字符集
Charset类还提供了defaultCharset方法,用于获取当前Java虚拟机的默认字符集,默认字符集通常和操作系统环境有关,不同环境下可能不同,所以开发中尽量不要依赖默认字符集,显式指定字符集更稳妥。
import java.nio.charset.Charset;
public class DefaultCharsetDemo {
public static void main(String[] args) {
// 获取默认字符集
Charset defaultCharset = Charset.defaultCharset();
System.out.println("当前默认字符集:" + defaultCharset.name());
}
}
使用Charset完成编码转换
Charset类的核心能力就是实现字符到字节的编码,以及字节到字符的解码,这两个过程就是编码转换的基础。
编码:字符转字节
编码是将字符串(字符序列)按照指定字符集转换为字节数组的过程,通过Charset的encode方法可以实现。encode方法接收CharBuffer或者String作为参数,返回ByteBuffer对象,再通过array方法即可获取字节数组。
import java.nio.charset.Charset;
import java.nio.ByteBuffer;
public class EncodeDemo {
public static void main(String[] args) {
String content = "Java字符编码测试";
// 使用UTF-8编码
Charset utf8Charset = Charset.forName("UTF-8");
ByteBuffer utf8Buffer = utf8Charset.encode(content);
byte[] utf8Bytes = utf8Buffer.array();
System.out.println("UTF-8编码后的字节长度:" + utf8Bytes.length);
// 使用GBK编码
Charset gbkCharset = Charset.forName("GBK");
ByteBuffer gbkBuffer = gbkCharset.encode(content);
byte[] gbkBytes = gbkBuffer.array();
System.out.println("GBK编码后的字节长度:" + gbkBytes.length);
}
}
解码:字节转字符
解码是编码的逆过程,将字节数组按照指定字符集转换为字符串,通过Charset的decode方法实现,decode方法接收ByteBuffer作为参数,返回CharBuffer,再通过toString方法即可得到字符串。
import java.nio.charset.Charset;
import java.nio.ByteBuffer;
public class DecodeDemo {
public static void main(String[] args) {
String content = "Java编码转换";
Charset utf8Charset = Charset.forName("UTF-8");
// 先编码
ByteBuffer buffer = utf8Charset.encode(content);
byte[] bytes = buffer.array();
// 再解码,使用相同的UTF-8字符集
String decodeContent = utf8Charset.decode(ByteBuffer.wrap(bytes)).toString();
System.out.println("解码后的内容:" + decodeContent);
}
}
编码转换常见场景示例
实际开发中最常见的编码转换场景是不同字符集之间的转换,比如将GBK编码的字节数组转换为UTF-8编码的字节数组,核心思路就是先按原字符集解码得到字符串,再按目标字符集编码得到目标字节数组。
import java.nio.charset.Charset;
import java.nio.ByteBuffer;
public class CharsetConvertDemo {
public static void main(String[] args) {
String content = "编码转换测试内容";
// 原始内容用GBK编码
Charset gbkCharset = Charset.forName("GBK");
byte[] gbkBytes = gbkCharset.encode(content).array();
// 将GBK字节数组转换为UTF-8字节数组
// 第一步:GBK解码得到字符串
String middleContent = gbkCharset.decode(ByteBuffer.wrap(gbkBytes)).toString();
// 第二步:UTF-8编码得到目标字节数组
Charset utf8Charset = Charset.forName("UTF-8");
byte[] utf8Bytes = utf8Charset.encode(middleContent).array();
System.out.println("GBK字节长度:" + gbkBytes.length);
System.out.println("UTF-8字节长度:" + utf8Bytes.length);
// 验证转换后的内容是否正确
String result = utf8Charset.decode(ByteBuffer.wrap(utf8Bytes)).toString();
System.out.println("转换后解码的内容:" + result);
}
}
编码转换注意事项
- 解码时使用的字符集必须和编码时的字符集一致,否则会出现乱码,比如用GBK编码的内容用UTF-8解码,得到的字符串就是乱码。
- 部分字符集不支持某些特殊字符,比如ISO-8859-1字符集不支持中文,用该字符集编码中文会出现丢失字符的问题。
- Charset类的实例是不可变的,是线程安全的,可以在多线程环境下共享使用,不需要额外加锁。
- 避免使用String类的getBytes(String charsetName)和new String(byte[] bytes, String charsetName)时传入不存在的字符集名称,尽量先通过Charset.forName校验字符集是否存在。
支持的字符集查询
如果需要查看当前Java环境支持的所有字符集,可以通过Charset类的availableCharsets静态方法获取,该方法返回一个有序的映射,键是字符集名称,值是Charset实例。
import java.nio.charset.Charset;
import java.util.Map;
import java.util.SortedMap;
public class AvailableCharsetDemo {
public static void main(String[] args) {
SortedMap<String, Charset> charsetMap = Charset.availableCharsets();
System.out.println("当前环境支持的字符集:");
for (Map.Entry<String, Charset> entry : charsetMap.entrySet()) {
System.out.println("名称:" + entry.getKey() + ",别名:" + entry.getValue().aliases());
}
}
}