モジュール java.xml
パッケージ org.xml.sax.ext

インタフェースLocator2

すべてのスーパー・インタフェース:
Locator
既知のすべての実装クラス:
Locator2Impl
public interface Locator2 extends Locator
SAX2拡張機能。Locatorを介して提供されるエンティティ情報を拡張します。 実装がこの拡張をサポートしている場合、ContentHandler.setDocumentLocator() で提供されるロケータはこのインタフェースを実装し、http://xml.org/sax/features/use-locator2機能フラグは値trueを持ちます。

XMLReader実装はこの情報のサポートに必要ありません。これはSAX2のコア・ディストリビューションだけに含まれるものではありません。

導入されたバージョン:
1.5, SAX 2.0 (extensions 1.1 alpha)

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    String
    getEncoding()
    エンティティの文字エンコーディングの名前を返します。
    String
    getXMLVersion()
    エンティティに使用されるXMLのバージョンを返します。

    インタフェース org.xml.sax.Locatorで宣言されたメソッド

    getColumnNumber, getLineNumber, getPublicId, getSystemId

  • メソッドの詳細

    • getXMLVersion

      String getXMLVersion()
      エンティティに使用されるXMLのバージョンを返します。 通常、これは現在のエンティティの<?xml version='...' ...?>宣言からの識別子になるか、パーサーによってデフォルトで設定されます。
      戻り値:
      エンティティのテキスト解釈に使用されているXMLバージョンの識別子。その情報が現在の構文解析状態ではまだ使用できない場合はnull。

    • getEncoding

      String getEncoding()
      エンティティの文字エンコーディングの名前を返します。 エンコーディングが外部(たとえばMIME Content-Typeヘッダー)で宣言された場合は、返された名前になります。 あるいは、文書の開始位置で<?xml ...encoding='...'?>宣言があった場合、そのエンコーディング名が返されます。 そうでない場合は、エンコーディングは推定されるか(通常はUTF-8または一部がUTF-16バリアントになる)、推定された名前が返されます。

      InputSourceを使用してエンティティの文字ストリームを提供する場合、このメソッドはその入力ストリームで提供されたエンコーディングを返します。

      最近のW3C仕様では、「Unicode Normalization Form C」を使用して、一部エンコーディングが行われているテキストを処理する前に正規化する必要があります。 このような正規化はアプリケーションで実行しなければならず、通常はこのメソッドによって返された値に基づいてトリガーされます。

      エンコーディング名は背後のJVMで使用されているもので、比較するには大文字と小文字を区別する必要があります。

      戻り値:
      *エンティティのテキスト解釈に使用されている文字エンコーディングの名前。InputSourceを通して渡された*文字ストリームに提供されなかった場合、あるいは現在の解析状態ではまだ使用できない場合はnull。