java.nio.charset.spi
クラス CharsetProvider

java.lang.Object
  |
  +--java.nio.charset.spi.CharsetProvider

public abstract class CharsetProvider

extends Object

文字セットサービスプロバイダクラスです。

文字セットプロバイダは、このクラスの具象サブクラスであり、ゼロ引数コンストラクタといくつかの対応する文字セット実装クラスを備えています。文字セットプロバイダは、拡張機能 (通常の拡張ディレクトリに配置される jar ファイル) として、Java プラットフォームのインスタンスにインストールできます。このプロバイダは、アプレットやアプリケーションのクラスパスに追加する方法や、その他のプラットフォーム固有の方法で利用できます。文字セットプロバイダの検索には、現在のスレッドのコンテキストクラスローダを使用します。

文字セットプロバイダの識別情報は、リソースディレクトリ META-INF/services 内のプロバイダ構成ファイル java.nio.charset.spi.CharsetProvider に定義されます。このファイルには、具象文字セットプロバイダクラスの完全修飾名が 1 行に 1 つずつ記述されます。行の終端は、改行 ('¥n')、キャリッジリターン ('¥r')、またはキャリッジリターンと改行の組み合わせによって表されます。個々の名前の前後の空白文字とタブ文字と、空の行は無視されます。コメント文字は '#' ('\u0023') です。行頭にコメント文字が挿入されている場合、その行のすべての文字は無視されます。ファイルのエンコード方式は常に UTF-8 です。

特定の具象文字セットプロバイダクラスが複数の構成ファイル内、または同じ構成ファイル内で繰り返し指定されている場合、重複した指定は無視されます。特定のプロバイダを指定した構成ファイルを、プロバイダ自体と同じ jar ファイルまたはその他の配布単位に配置する必要はありません。このプロバイダには、構成ファイルを検索したときに最初に照会されたクラスローダからアクセスできなければなりません。なお、このクラスローダが、ファイルをロードしたクラスローダであるとは限りません。

導入されたバージョン:

1.4

関連項目:

Charset

コンストラクタの概要

protected

CharsetProvider() 新しい文字セットプロバイダを初期化します。

メソッドの概要

abstract Charset	charsetForName(String charsetName) 指定された文字セット名の文字セットを取得します。
abstract Iterator	charsets() このプロバイダがサポートする文字セットに対して使用する反復子を作成します。

クラス java.lang.Object から継承したメソッド

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

コンストラクタの詳細

CharsetProvider

protected CharsetProvider()

新しい文字セットプロバイダを初期化します。

例外:

SecurityException - セキュリティマネージャがインストールされていて、RuntimePermission("charsetProvider") を拒否した場合

メソッドの詳細

charsets

public abstract Iterator charsets()

このプロバイダがサポートする文字セットに対して使用する反復子を作成します。このメソッドは、Charset.availableCharsets メソッドの実装に使用されます。

戻り値:

新しい反復子

charsetForName

public abstract Charset charsetForName(String charsetName)

指定された文字セット名の文字セットを取得します。

パラメータ:

charsetName - 要求された文字セットの名前 (正規名または別名)

戻り値:

指定された文字セットの Charset オブジェクトか、このプロバイダが指定された文字セットをサポートしていない場合は null