JavaTM Platform
Standard Ed. 6

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

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。