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<Charset>	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<Charset> charsets()

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

戻り値:

新しいイテレータ

charsetForName

public abstract Charset charsetForName(String charsetName)

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

パラメータ:

charsetName - 要求された文字セットの名前。正規名か別名

戻り値:

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