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