モジュール java.base
パッケージ java.nio.charset.spi

クラスCharsetProvider

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
関連項目:

  • コンストラクタのサマリー

    コンストラクタ
    修飾子
    コンストラクタ
    説明
    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 - 要求された文字セットの名前。正規名か別名
      戻り値:
      指定された文字セット用の文字セット・オブジェクト、または指定された文字セットがこのプロバイダでサポートされていない場合はnull