モジュール 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
    新しい文字セット・プロバイダを初期化します。
  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    abstract Charset
    charsetForName(String charsetName)
    指定された文字セット名に対する文字セットを取得します。
    abstract Iterator<Charset>
    このプロバイダがサポートする文字セットに対するイテレータを作成します。

    クラス 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