JavaTM 2
Platform
Std. Ed. v1.4.0

org.xml.sax.helpers
クラス ParserAdapter

java.lang.Object
  |
  +--org.xml.sax.helpers.ParserAdapter
すべての実装インタフェース:
DocumentHandler, XMLReader

public class ParserAdapter
extends Object
implements XMLReader, DocumentHandler

SAX1 Parser を SAX2 XMLReader として適応させます。

このモジュールは、ソースコード、文書ともに公開ドメインに置かれています。したがって、内容に関する保証は一切提供されません

このクラスは、SAX1 Parser をラップして、機能、プロパティ、名前空間を利用できる SAX 2 XMLReader として動作させます。ただし、skippedEntity イベントの報告は行われません。これは、この情報が SAX1 では提供されないためです。

名前空間修飾子付きの属性名が重複している環境におけるこのアダプタの動作は未検証です。

導入されたバージョン:
SAX 2.0
関連項目:
XMLReaderAdapter, XMLReader, Parser

コンストラクタの概要
ParserAdapter()
          新しいパーサアダプタを構築します。
ParserAdapter(Parser parser)
          新しいパーサアダプタを構築します。
 
メソッドの概要
 void characters(char[] ch, int start, int length)
          SAX1 の文字イベントを適応させます。
 void endDocument()
          SAX1 の文書終了イベントを適応させます。
 void endElement(String qName)
          SAX1 の要素終了イベントを適応させます。
 ContentHandler getContentHandler()
          現在のコンテンツハンドラを返します。
 DTDHandler getDTDHandler()
          現在の DTD ハンドラを返します。
 EntityResolver getEntityResolver()
          現在のエンティティリゾルバを返します。
 ErrorHandler getErrorHandler()
          現在のエラーハンドラを返します。
 boolean getFeature(String name)
          パーサ機能をチェックします。
 Object getProperty(String name)
          パーサプロパティを取得します。
 void ignorableWhitespace(char[] ch, int start, int length)
          SAX1 の無視できる空白文字イベントを適応させます。
 void parse(InputSource input)
          XML 文書を構文解析します。
 void parse(String systemId)
          XML 文書を構文解析します。
 void processingInstruction(String target, String data)
          SAX1 の処理命令イベントを適応させます。
 void setContentHandler(ContentHandler handler)
          コンテンツハンドラを設定します。
 void setDocumentLocator(Locator locator)
          SAX1 の文書ロケータイベントを適応させます。
 void setDTDHandler(DTDHandler handler)
          DTD ハンドラを設定します。
 void setEntityResolver(EntityResolver resolver)
          エンティティリゾルバを設定します。
 void setErrorHandler(ErrorHandler handler)
          エラーハンドラを設定します。
 void setFeature(String name, boolean state)
          パーサの機能を設定します。
 void setProperty(String name, Object value)
          パーサプロパティを設定します。
 void startDocument()
          SAX1 の文書開始イベントを適応させます。
 void startElement(String qName, AttributeList qAtts)
          SAX1 の要素開始イベントを適応させます。
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

ParserAdapter

public ParserAdapter()
              throws SAXException
新しいパーサアダプタを構築します。

"org.xml.sax.parser" プロパティを使って組み込み SAX1 ドライバを特定します。

例外:
SAXException - 組み込みドライバをインスタンス化できない場合、または org.xml.sax.parser プロパティが指定されなかった場合

ParserAdapter

public ParserAdapter(Parser parser)
新しいパーサアダプタを構築します。

アダプタの作成後は、組み込みパーサを変更できません。ほかのパーサを組み込むには、新しい ParserAdapter を割り当てます。

パラメータ:
parser - 組み込む SAX1 パーサ
例外:
NullPointerException - パーサパラメータが null の場合
メソッドの詳細

setFeature

public void setFeature(String name,
                       boolean state)
                throws SAXNotRecognizedException,
                       SAXNotSupportedException
パーサの機能を設定します。

サポートされている機能は名前空間と名前空間前置修飾子のみです。

定義:
インタフェース XMLReader 内の setFeature
パラメータ:
name - 機能名を示す完全な URI
state - 要求された機能の状態
例外:
SAXNotRecognizedException - 機能名が不明の場合
SAXNotSupportedException - その機能の状態がサポートされていない場合
関連項目:
XMLReader.setFeature(java.lang.String, boolean)

getFeature

public boolean getFeature(String name)
                   throws SAXNotRecognizedException,
                          SAXNotSupportedException
パーサ機能をチェックします。

サポートされている機能は名前空間と名前空間前置修飾子のみです。

定義:
インタフェース XMLReader 内の getFeature
パラメータ:
name - 機能名を示す完全な URI
戻り値:
現在の機能の状態
例外:
SAXNotRecognizedException - 機能名が不明の場合
SAXNotSupportedException - 機能の状態の照会がサポートされていない場合
関連項目:
XMLReader.setFeature(java.lang.String, boolean)

setProperty

public void setProperty(String name,
                        Object value)
                 throws SAXNotRecognizedException,
                        SAXNotSupportedException
パーサプロパティを設定します。

現時点では特殊なプロパティはサポートされていません。

定義:
インタフェース XMLReader 内の setProperty
パラメータ:
name - プロパティ名
value - プロパティの値
例外:
SAXNotRecognizedException - 機能名が不明の場合
SAXNotSupportedException - その機能の状態がサポートされていない場合
関連項目:
XMLReader.setProperty(java.lang.String, java.lang.Object)

getProperty

public Object getProperty(String name)
                   throws SAXNotRecognizedException,
                          SAXNotSupportedException
パーサプロパティを取得します。

現時点では特殊なプロパティはサポートされていません。

定義:
インタフェース XMLReader 内の getProperty
パラメータ:
name - プロパティ名
戻り値:
プロパティの値
例外:
SAXNotRecognizedException - 機能名が不明の場合
SAXNotSupportedException - その機能の状態がサポートされていない場合
関連項目:
XMLReader.getProperty(java.lang.String)

setEntityResolver

public void setEntityResolver(EntityResolver resolver)
エンティティリゾルバを設定します。

定義:
インタフェース XMLReader 内の setEntityResolver
パラメータ:
resolver - 新しいエンティティリゾルバ
例外:
NullPointerException - エンティティリゾルバパラメータが null の場合
関連項目:
XMLReader.setEntityResolver(org.xml.sax.EntityResolver)

getEntityResolver

public EntityResolver getEntityResolver()
現在のエンティティリゾルバを返します。

定義:
インタフェース XMLReader 内の getEntityResolver
戻り値:
現在のエンティティリゾルバ。提供されなかった場合は null
関連項目:
XMLReader.getEntityResolver()

setDTDHandler

public void setDTDHandler(DTDHandler handler)
DTD ハンドラを設定します。

定義:
インタフェース XMLReader 内の setDTDHandler
パラメータ:
handler - DTD ハンドラ
例外:
NullPointerException - DTD ハンドラパラメータが null の場合
関連項目:
XMLReader.setEntityResolver(org.xml.sax.EntityResolver)

getDTDHandler

public DTDHandler getDTDHandler()
現在の DTD ハンドラを返します。

定義:
インタフェース XMLReader 内の getDTDHandler
戻り値:
現在の DTD ハンドラ。提供されなかった場合は null
関連項目:
XMLReader.getEntityResolver()

setContentHandler

public void setContentHandler(ContentHandler handler)
コンテンツハンドラを設定します。

定義:
インタフェース XMLReader 内の setContentHandler
パラメータ:
handler - コンテンツハンドラ
例外:
NullPointerException - コンテンツハンドラパラメータが null の場合
関連項目:
XMLReader.setEntityResolver(org.xml.sax.EntityResolver)

getContentHandler

public ContentHandler getContentHandler()
現在のコンテンツハンドラを返します。

定義:
インタフェース XMLReader 内の getContentHandler
戻り値:
現在のコンテンツハンドラ。提供されなかった場合は null
関連項目:
XMLReader.getEntityResolver()

setErrorHandler

public void setErrorHandler(ErrorHandler handler)
エラーハンドラを設定します。

定義:
インタフェース XMLReader 内の setErrorHandler
パラメータ:
handler - エラーハンドラ
例外:
NullPointerException - エラーハンドラパラメータが null の場合
関連項目:
XMLReader.setEntityResolver(org.xml.sax.EntityResolver)

getErrorHandler

public ErrorHandler getErrorHandler()
現在のエラーハンドラを返します。

定義:
インタフェース XMLReader 内の getErrorHandler
戻り値:
現在のエラーハンドラ。提供されなかった場合は null
関連項目:
XMLReader.getEntityResolver()

parse

public void parse(String systemId)
           throws IOException,
                  SAXException
XML 文書を構文解析します。

定義:
インタフェース XMLReader 内の parse
パラメータ:
systemId - 文書の絶対 URL
例外:
IOException - 文書の raw コンテンツの読み込み時に問題が発生した場合
SAXException - 文書処理時に問題が発生した場合
関連項目:
parse(org.xml.sax.InputSource), Parser.parse(java.lang.String)

parse

public void parse(InputSource input)
           throws IOException,
                  SAXException
XML 文書を構文解析します。

定義:
インタフェース XMLReader 内の parse
パラメータ:
input - 文書の入力ソース
例外:
IOException - 文書の raw コンテンツの読み込み時に問題が発生した場合
SAXException - 文書処理時に問題が発生した場合
関連項目:
parse(java.lang.String), Parser.parse(org.xml.sax.InputSource)

setDocumentLocator

public void setDocumentLocator(Locator locator)
SAX1 の文書ロケータイベントを適応させます。

定義:
インタフェース DocumentHandler 内の setDocumentLocator
パラメータ:
locator - 文書ロケータ
関連項目:
ContentHandler.setDocumentLocator(org.xml.sax.Locator)

startDocument

public void startDocument()
                   throws SAXException
SAX1 の文書開始イベントを適応させます。

定義:
インタフェース DocumentHandler 内の startDocument
例外:
SAXException - クライアントで処理例外が発生する可能性がある
関連項目:
DocumentHandler.startDocument()

endDocument

public void endDocument()
                 throws SAXException
SAX1 の文書終了イベントを適応させます。

定義:
インタフェース DocumentHandler 内の endDocument
例外:
SAXException - クライアントで処理例外が発生する可能性がある
関連項目:
DocumentHandler.endDocument()

startElement

public void startElement(String qName,
                         AttributeList qAtts)
                  throws SAXException
SAX1 の要素開始イベントを適応させます。

必要に応じて、名前空間処理を行います。

定義:
インタフェース DocumentHandler 内の startElement
パラメータ:
qName - 前置修飾子付きの修飾名
qAtts - XML 1.0 属性リスト (修飾名付き)
例外:
SAXException - SAX 例外。ほかの例外をラップしている可能性がある
関連項目:
DocumentHandler.endElement(java.lang.String), AttributeList

endElement

public void endElement(String qName)
                throws SAXException
SAX1 の要素終了イベントを適応させます。

定義:
インタフェース DocumentHandler 内の endElement
パラメータ:
qName - 前置修飾子付きの修飾名
例外:
SAXException - クライアントで処理例外が発生する可能性がある
関連項目:
DocumentHandler.endElement(java.lang.String)

characters

public void characters(char[] ch,
                       int start,
                       int length)
                throws SAXException
SAX1 の文字イベントを適応させます。

定義:
インタフェース DocumentHandler 内の characters
パラメータ:
ch - 文字配列
start - 配列内の開始位置
length - 使用する文字数
例外:
SAXException - クライアントで処理例外が発生する可能性がある
関連項目:
DocumentHandler.characters(char[], int, int)

ignorableWhitespace

public void ignorableWhitespace(char[] ch,
                                int start,
                                int length)
                         throws SAXException
SAX1 の無視できる空白文字イベントを適応させます。

定義:
インタフェース DocumentHandler 内の ignorableWhitespace
パラメータ:
ch - 文字配列
start - 配列内の開始位置
length - 使用する文字数
例外:
SAXException - クライアントで処理例外が発生する可能性がある
関連項目:
DocumentHandler.ignorableWhitespace(char[], int, int)

processingInstruction

public void processingInstruction(String target,
                                  String data)
                           throws SAXException
SAX1 の処理命令イベントを適応させます。

定義:
インタフェース DocumentHandler 内の processingInstruction
パラメータ:
target - 処理命令のターゲット
data - 処理命令を受けるデータ
例外:
SAXException - クライアントで処理例外が発生する可能性がある
関連項目:
DocumentHandler.processingInstruction(java.lang.String, java.lang.String)

JavaTM 2
Platform
Std. Ed. v1.4.0

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

Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.