Charset (bus-core 6.3.0 API)

java.lang.Object
- org.aoju.bus.core.lang.Charset

```
public class Charset
extends Object
```
编码常量

Since:

JDK 1.8+

Version:

6.3.0

Author:

Kimi Liu

Field Summary

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

Constructor Summary

Constructors
Constructor and Description

Charset()

Constructors
Constructor and Description
`Charset()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static Charset`	`charset(Charset charset)` 返回给定的字符集；如果给定的字符集为null，则返回默认的字符集
`static Charset`	`charset(String charsetName)` 转换为Charset对象
`static File`	`convert(File file, Charset srcCharset, Charset destCharset)` 转换文件编码此方法用于转换文件编码,读取的文件实际编码必须与指定的srcCharset编码一致,否则导致乱码
`static String`	`convert(String source, Charset srcCharset, Charset destCharset)` 转换字符串的字符集编码当以错误的编码读取为字符串时,打印字符串将出现乱码此方法用于纠正因读取使用编码错误导致的乱码问题例如,在Servlet请求中客户端用GBK编码了请求参数,我们使用UTF-8读取到的是乱码,此时,使用此方法即可还原原编码的内容
`static String`	`convert(String source, String srcCharset, String destCharset)` 转换字符串的字符集编码
`static Charset`	`defaultCharset()` 系统默认字符集编码
`static String`	`defaultCharsetName()` 系统默认字符集编码
`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 Detail
  - 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 Detail
  - Charset
```
public Charset()
```
- Method Detail
  - defaultCharset
```
public static Charset defaultCharset()
```
    系统默认字符集编码
    
    Returns:
    
    系统字符集编码
  - defaultCharsetName
```
public static String defaultCharsetName()
```
    系统默认字符集编码
    
    Returns:
    
    系统字符集编码
  - systemCharset
```
public static Charset systemCharset()
```
    系统字符集编码,如果是Windows,则默认为GBK编码,否则取 defaultCharsetName()
    
    Returns:
    
    系统字符集编码
    
    See Also:
    
    defaultCharsetName()
  - systemCharsetName
```
public static String systemCharsetName()
```
    系统字符集编码,如果是Windows,则默认为GBK编码,否则取 defaultCharsetName()
    
    Returns:
    
    系统字符集编码
    
    See Also:
    
    defaultCharsetName()
  - charset
```
public static Charset charset(Charset charset)
```
    返回给定的字符集；如果给定的字符集为null，则返回默认的字符集
    
    Parameters:
    
    charset - 字符集或null
    
    Returns:
    
    给定的字符集；如果给定的字符集为null，则默认为字符集
  - charset
```
public static Charset charset(String charsetName)
```
    转换为Charset对象
    
    Parameters:
    
    charsetName - 字符集,为空则返回默认字符集
    
    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:
    
    被转换编码的文件
  - 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

Class Charset

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

DEFAULT

DEFAULT_CHARSET

DEFAULT_ISO_8859_1

ISO_8859_1

DEFAULT_US_ASCII

US_ASCII

DEFAULT_GBK

GBK

DEFAULT_GB_2312

GB_2312

DEFAULT_GB_18030

GB_18030

DEFAULT_UTF_8

UTF_8

DEFAULT_UTF_16

UTF_16

DEFAULT_UTF_16_BE

UTF_16_BE

DEFAULT_UTF_16_LE

UTF_16_LE

DEFAULT_UTF_32_BE

UTF_32_BE

DEFAULT_UTF_32_LE

UTF_32_LE

Constructor Detail

Charset

Method Detail

defaultCharset

defaultCharsetName

systemCharset

systemCharsetName

charset

charset

convert

convert

convert

parse

parse