- java.lang.Object
-
- java.nio.charset.spi.CharsetProvider
-
public abstract class CharsetProvider extends Object
文字セット・サービス・プロバイダ・クラスです。文字セット・プロバイダは、ゼロ引数コンストラクタといくつかの関連文字セット実装クラスを備えた、このクラスの具象サブクラスです。 文字セット・プロバイダは、拡張として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()
このプロバイダがサポートする文字セットに対するイテレータを作成します。
-
-
-
コンストラクタの詳細
-
CharsetProvider
protected CharsetProvider()
新しい文字セット・プロバイダを初期化します。- 例外:
SecurityException
- セキュリティ・マネージャがインストールされており、それがRuntimePermission
("charsetProvider")
を拒否した場合
-
-
メソッドの詳細
-
charsets
public abstract Iterator<Charset> charsets()
このプロバイダがサポートする文字セットに対するイテレータを作成します。 このメソッドは、Charset.availableCharsets
メソッドの実装に使用されます。- 戻り値:
- 新しいイテレータ
-
-