cn.hutool.core.util

类 CharsetUtil

java.lang.Object

cn.hutool.core.util.CharsetUtil

public class CharsetUtil
extends java.lang.Object

字符集工具类

作者:

xiaoleilu

字段概要

字段

限定符和类型	字段和说明
static java.nio.charset.Charset	CHARSET_GBK GBK
static java.nio.charset.Charset	CHARSET_ISO_8859_1 ISO-8859-1
static java.nio.charset.Charset	CHARSET_UTF_8 UTF-8
static java.lang.String	GBK GBK
static java.lang.String	ISO_8859_1 ISO-8859-1
static java.lang.String	UTF_8 UTF-8

构造器概要

构造器

构造器和说明
CharsetUtil()

方法概要

方法

限定符和类型	方法和说明
static java.nio.charset.Charset	charset(java.lang.String charsetName) 转换为Charset对象
static java.io.File	convert(java.io.File file, java.nio.charset.Charset srcCharset, java.nio.charset.Charset destCharset) 转换文件编码 此方法用于转换文件编码，读取的文件实际编码必须与指定的srcCharset编码一致，否则导致乱码
static java.lang.String	convert(java.lang.String source, java.nio.charset.Charset srcCharset, java.nio.charset.Charset destCharset) 转换字符串的字符集编码 当以错误的编码读取为字符串时，打印字符串将出现乱码。
static java.lang.String	convert(java.lang.String source, java.lang.String srcCharset, java.lang.String destCharset) 转换字符串的字符集编码
static java.nio.charset.Charset	defaultCharset() 系统默认字符集编码
static java.lang.String	defaultCharsetName() 系统默认字符集编码
static java.nio.charset.Charset	systemCharset() 系统字符集编码，如果是Windows，则默认为GBK编码，否则取 defaultCharsetName()
static java.lang.String	systemCharsetName() 系统字符集编码，如果是Windows，则默认为GBK编码，否则取 defaultCharsetName()

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

ISO_8859_1

public static final java.lang.String ISO_8859_1

ISO-8859-1

另请参阅:

常量字段值

UTF_8

public static final java.lang.String UTF_8

UTF-8

另请参阅:

常量字段值

GBK

public static final java.lang.String GBK

GBK

另请参阅:

常量字段值

CHARSET_ISO_8859_1

public static final java.nio.charset.Charset CHARSET_ISO_8859_1

ISO-8859-1

CHARSET_UTF_8

public static final java.nio.charset.Charset CHARSET_UTF_8

UTF-8

CHARSET_GBK

public static final java.nio.charset.Charset CHARSET_GBK

GBK

构造器详细资料

CharsetUtil

public CharsetUtil()

方法详细资料

charset

public static java.nio.charset.Charset charset(java.lang.String charsetName)
                                        throws java.nio.charset.UnsupportedCharsetException

转换为Charset对象

参数:

charsetName - 字符集，为空则返回默认字符集

返回:

Charset

抛出:

java.nio.charset.UnsupportedCharsetException - 编码不支持

convert

public static java.lang.String convert(java.lang.String source,
                       java.lang.String srcCharset,
                       java.lang.String destCharset)

转换字符串的字符集编码

参数:

source - 字符串

srcCharset - 源字符集，默认ISO-8859-1

destCharset - 目标字符集，默认UTF-8

返回:

转换后的字符集

convert

public static java.lang.String convert(java.lang.String source,
                       java.nio.charset.Charset srcCharset,
                       java.nio.charset.Charset destCharset)

转换字符串的字符集编码
当以错误的编码读取为字符串时，打印字符串将出现乱码。
此方法用于纠正因读取使用编码错误导致的乱码问题。
例如，在Servlet请求中客户端用GBK编码了请求参数，我们使用UTF-8读取到的是乱码，此时，使用此方法即可还原原编码的内容

 客户端 -》 GBK编码 -》 Servlet容器 -》 UTF-8解码 -》 乱码
 乱码 -》 UTF-8编码 -》 GBK解码 -》 正确内容
 

参数:

source - 字符串

srcCharset - 源字符集，默认ISO-8859-1

destCharset - 目标字符集，默认UTF-8

返回:

转换后的字符集

convert

public static java.io.File convert(java.io.File file,
                   java.nio.charset.Charset srcCharset,
                   java.nio.charset.Charset destCharset)

转换文件编码
此方法用于转换文件编码，读取的文件实际编码必须与指定的srcCharset编码一致，否则导致乱码

参数:

file - 文件

srcCharset - 原文件的编码，必须与文件内容的编码保持一致

destCharset - 转码后的编码

返回:

被转换编码的文件

从以下版本开始:

3.1.0

systemCharsetName

public static java.lang.String systemCharsetName()

系统字符集编码，如果是Windows，则默认为GBK编码，否则取 defaultCharsetName()

返回:

系统字符集编码

从以下版本开始:

3.1.2

另请参阅:

defaultCharsetName()

systemCharset

public static java.nio.charset.Charset systemCharset()

系统字符集编码，如果是Windows，则默认为GBK编码，否则取 defaultCharsetName()

返回:

系统字符集编码

从以下版本开始:

3.1.2

另请参阅:

defaultCharsetName()

defaultCharsetName

public static java.lang.String defaultCharsetName()

系统默认字符集编码

返回:

系统字符集编码

defaultCharset

public static java.nio.charset.Charset defaultCharset()

系统默认字符集编码

返回:

系统字符集编码