Charset

Charset

Charset (String canonicalName, 
                String[] aliases)

使用给定的规范名称和别名集初始化新的字符集。

aliases

Set<String> aliases ()

返回包含此字符集别名的集合。

availableCharsets

SortedMap<String, Charset> availableCharsets ()

构造从规范字符集名称到字符集对象的有序映射。

此方法返回的映射对于当前Java虚拟机中可用的每个字符集都有一个条目。 如果两个或更多支持的字符集具有相同的规范名称，则结果地图将只包含其中的一个; 哪一个它将包含未指定。

调用此方法以及随后使用生成的映射可能会导致耗时的磁盘或网络I / O操作发生。 该方法是为需要枚举所有可用字符集的应用程序提供的，例如允许用户选择字符集。 forName方法不使用此方法，而是使用高效的增量查找算法。

如果将新的字符集提供程序动态提供给当前的Java虚拟机，则此方法可能会在不同的时间返回不同的结果。 在没有这种变化的情况下，这种方法返回的字符集正是那些可以通过forName方法检索的字符集。

canEncode

boolean canEncode ()

告诉这个字符集是否支持编码。

几乎所有的字符集都支持编码。 主要的例外是特殊用途的自动检测字符集，其解码器可以通过检查输入字节序列来确定正在使用几种可能编码方案中的哪一种。 这样的字符集不支持编码，因为没有办法确定应该在输出上使用哪种编码。 这些字符集的实现应该重写此方法以返回false 。

compareTo

int compareTo (Charset that)

将这个字符集与另一个字符比较。

字符集按其规范名称排序，而不考虑大小写。

contains

boolean contains (Charset cs)

告诉这个字符集是否包含给定的字符集。

如果并且只有在D中可表示的每个字符也可以用C表示，则字符集C被认为包含字符集D. 如果这种关系成立，则保证每个可以在D中编码的字符串也可以用C编码，而不用执行任何替换。

C包含 D并不意味着每个可由 C表示的特定字节序列的字符在 D中由相同的字节序列表示，尽管有时情况如此。

每个charset都包含它自己。

此方法计算包含关系的近似值：如果返回true，那么已知此字符集包含给定的字符集; 但是，如果它返回false ，那么不一定是这个字符集中不包含给定的字符集。

decode

CharBuffer decode (ByteBuffer bb)

将此字符集中的字节解码为Unicode字符的便捷方法。

在字符集 cs上调用此方法将返回与表达式相同的结果

     cs.newDecoder()
       .onMalformedInput(CodingErrorAction.REPLACE)
       .onUnmappableCharacter(CodingErrorAction.REPLACE)
       .decode(bb); 

This method always replaces malformed-input and unmappable-character sequences with this charset's default replacement byte array. In order to detect such sequences, use the decode(java.nio.ByteBuffer) method directly.

defaultCharset

Charset defaultCharset ()

返回此Java虚拟机的默认字符集。

默认字符集是在虚拟机启动时确定的，通常取决于底层操作系统的区域设置和字符集。

displayName

String displayName ()

返回此字符集的默认语言环境的人类可读名称。

这个方法的默认实现只是返回这个字符集的规范名称。 该类的具体子类可以重写此方法以提供本地化的显示名称。

displayName

String displayName (Locale locale)

为给定语言环境返回此字符集的人类可读名称。

这个方法的默认实现只是返回这个字符集的规范名称。 该类的具体子类可以重写此方法以提供本地化的显示名称。

encode

ByteBuffer encode (String str)

在此字符集中将字符串编码为字节的便捷方法。

在字符集 cs上调用此方法将返回与表达式相同的结果

     cs.encode(CharBuffer.wrap(s)); 

encode

ByteBuffer encode (CharBuffer cb)

在此字符集中将Unicode字符编码为字节的便捷方法。

在字符集 cs上调用此方法将返回与表达式相同的结果

     cs.newEncoder()
       .onMalformedInput(CodingErrorAction.REPLACE)
       .onUnmappableCharacter(CodingErrorAction.REPLACE)
       .encode(bb); 

此方法始终用此字符集的默认替换字符串替换格式错误的输入和不可映射字符序列。 为了检测这些序列，请直接使用encode(java.nio.CharBuffer)方法。

equals

boolean equals (Object ob)

告诉这个对象是否与另一个对象相等。

如果且仅当它们具有相同的规范名称时，两个字符集才是相等的。 字符集永远不会与任何其他类型的对象相同。

forName

Charset forName (String charsetName)

返回指定字符集的字符集对象。

hashCode

int hashCode ()

计算此字符集的哈希码。

isRegistered

boolean isRegistered ()

告诉这个字符集是否在 IANA Charset Registry中注册。

isSupported

boolean isSupported (String charsetName)

告诉是否支持指定的字符集。

name

String name ()

返回此字符集的规范名称。

newDecoder

CharsetDecoder newDecoder ()

为这个字符集构造一个新的解码器。

newEncoder

CharsetEncoder newEncoder ()

为这个字符集构造一个新的编码器。

toString

String toString ()

返回描述此字符集的字符串。