Package org.miaixz.bus.core.lang

Class Charset

java.lang.Object

org.miaixz.bus.core.lang.Charset

public class Charset
extends Object

字符集工具类

Since:

Java 17+

Author:

Kimi Liu

Field Summary

Fields

Modifier and Type	Field	Description
static final Charset	DEFAULT	默认字符集信息
static final String	DEFAULT_CHARSET
static final String	DEFAULT_GB_18030	GB18030 编码
static final String	DEFAULT_GB_2312	GB2312 转换格式
static final String	DEFAULT_GBK	GBK UCS 转换格式
static final String	DEFAULT_ISO_8859_1	ISO拉丁字母第1号，即ISO- Latin -1
static final String	DEFAULT_US_ASCII	7位ASCII码，即ISO646-US，也就是Unicode字符集的基本拉丁字符块
static final String	DEFAULT_UTF_16	16位UCS转换格式，字节顺序由可选的字节顺序标记标识
static final String	DEFAULT_UTF_16_BE	16位UCS转换格式，大写字节顺序
static final String	DEFAULT_UTF_16_LE	16位UCS转换格式，小写字节顺序
static final String	DEFAULT_UTF_32_BE	32位UCS转换格式，大写字节顺序
static final String	DEFAULT_UTF_32_LE	32位UCS转换格式，小写字节顺序
static final String	DEFAULT_UTF_8	8位UCS转换格式
static final Charset	GB_18030
static final Charset	GB_2312
static final Charset	GBK
static final Charset	ISO_8859_1
static final Charset	US_ASCII
static final Charset	UTF_16
static final Charset	UTF_16_BE
static final Charset	UTF_16_LE
static final Charset	UTF_32_BE
static final Charset	UTF_32_LE
static final Charset	UTF_8

Constructor Summary

Constructors

Constructor	Description
Charset()

Method Summary

Modifier and Type	Method	Description
static Charset	charset(String charsetName)	转换为Charset对象
static File	convert(File file, Charset srcCharset, Charset destCharset)	转换文件编码 此方法用于转换文件编码，读取的文件实际编码必须与指定的srcCharset编码一致，否则导致乱码
static String	convert(String source, String srcCharset, String destCharset)	转换字符串的字符集编码
static String	convert(String source, Charset srcCharset, Charset destCharset)	转换字符串的字符集编码 当以错误的编码读取为字符串时，打印字符串将出现乱码。
static Charset	defaultCharset()	系统默认字符集编码
static String	defaultCharsetName()	系统默认字符集编码
static Charset	detect(int bufferSize, InputStream in, Charset... charsets)	探测编码 注意：此方法会读取流的一部分，然后关闭流，如重复使用流，请使用使用支持reset方法的流
static Charset	detect(InputStream in, Charset... charsets)	探测编码 注意：此方法会读取流的一部分，然后关闭流，如重复使用流，请使用使用支持reset方法的流
static CharsetDecoder	newDecoder(Charset charset, CodingErrorAction action)	创建一个新的CharsetDecoder实例，配置指定的字符集和错误处理行为。
static CharsetEncoder	newEncoder(Charset charset, CodingErrorAction action)	创建一个新的CharsetEncoder实例，配置指定的字符集和错误处理策略。
static Charset	parse(String charsetName)	解析字符串编码为Charset对象，解析失败返回系统默认编码
static Charset	parse(String charsetName, Charset defaultCharset)	解析字符串编码为Charset对象，解析失败返回默认编码
static Charset	systemCharset()	系统字符集编码，如果是Windows，则默认为GBK编码，否则取 defaultCharsetName()
static String	systemCharsetName()	系统字符集编码，如果是Windows，则默认为GBK编码，否则取 defaultCharsetName()

Methods inherited from class java.lang.Object

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

Field Details

DEFAULT

public static final Charset DEFAULT

默认字符集信息

DEFAULT_CHARSET

public static final String DEFAULT_CHARSET

DEFAULT_ISO_8859_1

public static final String DEFAULT_ISO_8859_1

ISO拉丁字母第1号，即ISO- Latin -1

See Also:

• Constant Field Values

ISO_8859_1

public static final Charset ISO_8859_1

DEFAULT_US_ASCII

public static final String DEFAULT_US_ASCII

7位ASCII码，即ISO646-US，也就是Unicode字符集的基本拉丁字符块

See Also:

• Constant Field Values

US_ASCII

public static final Charset US_ASCII

DEFAULT_GBK

public static final String DEFAULT_GBK

GBK UCS 转换格式

See Also:

• Constant Field Values

GBK

public static final Charset GBK

DEFAULT_GB_2312

public static final String DEFAULT_GB_2312

GB2312 转换格式

See Also:

• Constant Field Values

GB_2312

public static final Charset GB_2312

DEFAULT_GB_18030

public static final String DEFAULT_GB_18030

GB18030 编码

See Also:

• Constant Field Values

GB_18030

public static final Charset GB_18030

DEFAULT_UTF_8

public static final String DEFAULT_UTF_8

8位UCS转换格式

See Also:

• Constant Field Values

UTF_8

public static final Charset UTF_8

DEFAULT_UTF_16

public static final String DEFAULT_UTF_16

16位UCS转换格式，字节顺序由可选的字节顺序标记标识

See Also:

• Constant Field Values

UTF_16

public static final Charset UTF_16

DEFAULT_UTF_16_BE

public static final String DEFAULT_UTF_16_BE

16位UCS转换格式，大写字节顺序

See Also:

• Constant Field Values

UTF_16_BE

public static final Charset UTF_16_BE

DEFAULT_UTF_16_LE

public static final String DEFAULT_UTF_16_LE

16位UCS转换格式，小写字节顺序

See Also:

• Constant Field Values

UTF_16_LE

public static final Charset UTF_16_LE

DEFAULT_UTF_32_BE

public static final String DEFAULT_UTF_32_BE

32位UCS转换格式，大写字节顺序

See Also:

• Constant Field Values

UTF_32_BE

public static final Charset UTF_32_BE

DEFAULT_UTF_32_LE

public static final String DEFAULT_UTF_32_LE

32位UCS转换格式，小写字节顺序

See Also:

• Constant Field Values

UTF_32_LE

public static final Charset UTF_32_LE

Constructor Details

Charset

public Charset()

Method Details

charset

public static Charset charset(String charsetName)
                       throws UnsupportedCharsetException

转换为Charset对象

Parameters:

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

Returns:

Charset

Throws:

UnsupportedCharsetException - 编码不支持

parse

public static Charset parse(String charsetName)

解析字符串编码为Charset对象，解析失败返回系统默认编码

Parameters:

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

Returns:

Charset

parse

public static Charset parse(String charsetName,
 Charset defaultCharset)

解析字符串编码为Charset对象，解析失败返回默认编码

Parameters:

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

defaultCharset - 解析失败使用的默认编码

Returns:

Charset

convert

public static String convert(String source,
 String srcCharset,
 String destCharset)

转换字符串的字符集编码

Parameters:

source - 字符串

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

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

Returns:

转换后的字符集

convert

public static String convert(String source,
 Charset srcCharset,
 Charset destCharset)

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

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

Parameters:

source - 字符串

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

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

Returns:

转换后的字符集

convert

public static File convert(File file,
 Charset srcCharset,
 Charset destCharset)

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

Parameters:

file - 文件

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

destCharset - 转码后的编码

Returns:

被转换编码的文件

systemCharsetName

public static String systemCharsetName()

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

Returns:

系统字符集编码

See Also:

• defaultCharsetName()

systemCharset

public static Charset systemCharset()

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

Returns:

系统字符集编码

See Also:

• defaultCharsetName()

defaultCharsetName

public static String defaultCharsetName()

系统默认字符集编码

Returns:

系统字符集编码

defaultCharset

public static Charset defaultCharset()

系统默认字符集编码

Returns:

系统字符集编码

detect

public static Charset detect(InputStream in,
 Charset... charsets)

探测编码 注意：此方法会读取流的一部分，然后关闭流，如重复使用流，请使用使用支持reset方法的流

Parameters:

in - 流，使用后关闭此流

charsets - 需要测试用的编码，null或空使用默认的编码数组

Returns:

编码

See Also:

• CharsetDetector.detect(InputStream, java.nio.charset.Charset...)

detect

public static Charset detect(int bufferSize,
 InputStream in,
 Charset... charsets)

探测编码 注意：此方法会读取流的一部分，然后关闭流，如重复使用流，请使用使用支持reset方法的流

Parameters:

bufferSize - 自定义缓存大小，即每次检查的长度

in - 流，使用后关闭此流

charsets - 需要测试用的编码，null或空使用默认的编码数组

Returns:

编码

See Also:

• CharsetDetector.detect(int, InputStream, java.nio.charset.Charset...)

newEncoder

public static CharsetEncoder newEncoder(Charset charset,
 CodingErrorAction action)

创建一个新的CharsetEncoder实例，配置指定的字符集和错误处理策略。

Parameters:

charset - 指定的字符集，不允许为null。

action - 对于不合法的字符或无法映射的字符的处理策略，不允许为null

Returns:

配置好的CharsetEncoder实例

newDecoder

public static CharsetDecoder newDecoder(Charset charset,
 CodingErrorAction action)

创建一个新的CharsetDecoder实例，配置指定的字符集和错误处理行为。

Parameters:

charset - 指定的字符集，不允许为null。

action - 当遇到不合法的字符编码或不可映射字符时采取的行动，例如忽略、替换等。

Returns:

配置好的CharsetDecoder实例，用于解码字符。