站内搜索: 请输入搜索关键词
当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

CharsetProvider (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

JavaTM 2 Platform
Standard Ed. 5.0

java.nio.charset.spi
类 CharsetProvider

java.lang.Object
  继承者 java.nio.charset.spi.CharsetProvider

public abstract class CharsetProvider
extends Object

Charset 服务提供程序类。

charset 提供程序是此类的一个具体子类,具有零参数的构造方法和一些相关的 charset 实现类。Charset 提供程序可以作为扩展装入到 Java 平台的实例中,也就是把 jar 文件放入任意常用的扩展目录中。通过把提供程序加入到 applet 或应用程序类路径中,或者通过某些特定于平台的其他方式来使提供程序可用。通过当前线程的上下文类加载器来查找 Charset 提供程序。

charset 提供程序使用资源目录 META-INF/services 下的名称为 java.nio.charset.spi.CharsetProvider 的提供程序配置文件标识它自己。该文件应该包含一个完全限定的具体 charset 提供程序类名的列表,每行一个类名。通过下列字符之一表示某行已终止:换行 ('\n')、回车 ('\r') 或回车后直接跟着换行。忽略各名称周围的空格字符和制表符以及空行。注释字符为 '#' ('\u0023');将忽略每行的第一个注释字符后面的所有字符。文件必须使用 UTF-8 编码。

如果在多个配置文件中命名了一个特定的具体 charset 提供程序类,或在同一配置文件中多次对其命名,则忽略重复的命名。命名特定提供程序的配置文件不必像提供程序本身一样位于同一个 jar 文件或其他的分布式单元中。提供程序必须是从同一个类加载器可访问的,为了查找配置文件而在开始时查询该类加载器;这不必是装载文件的类加载器。

从以下版本开始:
1.4
另请参见:
Charset

构造方法摘要
protected CharsetProvider()
          初始化新的 charset 提供程序。
 
方法摘要
abstract  Charset charsetForName(String charsetName)
          用给定的 charset 名称检索 charset。
abstract  Iterator<Charset> charsets()
          创建在此提供程序所支持的 charset 上进行迭代的迭代器。
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

构造方法详细信息

CharsetProvider

protected CharsetProvider()
初始化新的 charset 提供程序。

抛出:
SecurityException - 如果已安装安全管理器并且它拒绝 RuntimePermission("charsetProvider")
方法详细信息

charsets

public abstract Iterator<Charset> charsets()
创建在此提供程序所支持的 charset 上进行迭代的迭代器。在 Charset.availableCharsets 方法的实现中使用此方法。

返回:
新迭代器

charsetForName

public abstract Charset charsetForName(String charsetName)
用给定的 charset 名称检索 charset。

参数:
charsetName - 请求的 charset 的名称;可以是规范名称或别名
返回:
命名 charset 的 charset 对象;如果此提供程序不支持该命名 charset,则返回 null

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策