JavaTM 2
Platform
Std. Ed. v1.4.0

org.xml.sax.helpers
クラス XMLReaderAdapter

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

public class XMLReaderAdapter
extends Object
implements Parser, ContentHandler

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

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

このクラスは、SAX 2 XMLReader をラップして、SAX1 Parser として動作させます。XMLReader は、http://xml.org/sax/features/namespace-prefixes プロパティの値が true であるときの条件をサポートしていなければなりません。サポートしていない場合、構文解析に失敗し、SAXException がスローされます。XMLReader が http://xml.org/sax/features/namespaces プロパティの値が false であるときの条件をサポートしている場合は、このクラスを使って効率性を改善することができます。

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

コンストラクタの概要
XMLReaderAdapter()
          新しいアダプタを作成します。
XMLReaderAdapter(XMLReader xmlReader)
          新しいアダプタを作成します。
 
メソッドの概要
 void characters(char[] ch, int start, int length)
          SAX2 の文字イベントを適応させます。
 void endDocument()
          文書イベントを終了します。
 void endElement(String uri, String localName, String qName)
          SAX2 の要素終了イベントを適応させます。
 void endPrefixMapping(String prefix)
          SAX2 の前置修飾子のマッピング終了イベントを適応させます。
 void ignorableWhitespace(char[] ch, int start, int length)
          SAX2 の無視できる空白文字イベントを適応させます。
 void parse(InputSource input)
          文書を構文解析します。
 void parse(String systemId)
          文書を構文解析します。
 void processingInstruction(String target, String data)
          SAX2 の処理命令イベントを適応させます。
 void setDocumentHandler(DocumentHandler handler)
          SAX1 文書イベントハンドラを登録します。
 void setDocumentLocator(Locator locator)
          文書ロケータを設定します。
 void setDTDHandler(DTDHandler handler)
          DTD イベントハンドラを登録します。
 void setEntityResolver(EntityResolver resolver)
          エンティティリゾルバを登録します。
 void setErrorHandler(ErrorHandler handler)
          エラーイベントハンドラを登録します。
 void setLocale(Locale locale)
          エラー報告のロケールを設定します。
 void skippedEntity(String name)
          SAX2 のスキップされたエンティティイベントを適応させます。
 void startDocument()
          文書イベントを開始します。
 void startElement(String uri, String localName, String qName, Attributes atts)
          SAX2 の要素開始イベントを適応させます。
 void startPrefixMapping(String prefix, String uri)
          SAX2 の前置修飾子のマッピング開始イベントを適応させます。
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

XMLReaderAdapter

public XMLReaderAdapter()
                 throws SAXException
新しいアダプタを作成します。

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

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

XMLReaderAdapter

public XMLReaderAdapter(XMLReader xmlReader)
新しいアダプタを作成します。

SAX2 XMLReader をラップする新しいアダプタを作成します。このアダプタは、XMLReader を SAX1 Parser として機能させます。

パラメータ:
xmlReader - ラップする SAX2 XMLReader
例外:
NullPointerException - 引数が null の場合
メソッドの詳細

setLocale

public void setLocale(Locale locale)
               throws SAXException
エラー報告のロケールを設定します。

このメソッドは、SAX2 ではサポートされていません。このため、常に例外をスローします。

定義:
インタフェース Parser 内の setLocale
パラメータ:
locale - Java Locale オブジェクト
例外:
SAXException - 要求されたロケールがサポートされていない場合、以前の (デフォルトの) ロケールを使って例外をスロー
関連項目:
Parser.setLocale(java.util.Locale)

setEntityResolver

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

定義:
インタフェース Parser 内の setEntityResolver
パラメータ:
resolver - 新しいリゾルバ
関連項目:
Parser.setEntityResolver(org.xml.sax.EntityResolver)

setDTDHandler

public void setDTDHandler(DTDHandler handler)
DTD イベントハンドラを登録します。

定義:
インタフェース Parser 内の setDTDHandler
パラメータ:
handler - 新しい DTD イベントハンドラ
関連項目:
Parser.setDTDHandler(org.xml.sax.DTDHandler)

setDocumentHandler

public void setDocumentHandler(DocumentHandler handler)
SAX1 文書イベントハンドラを登録します。

SAX1 文書ハンドラは名前空間をサポートしません。

定義:
インタフェース Parser 内の setDocumentHandler
パラメータ:
handler - 新しい SAX1 文書イベントハンドラ
関連項目:
Parser.setDocumentHandler(org.xml.sax.DocumentHandler)

setErrorHandler

public void setErrorHandler(ErrorHandler handler)
エラーイベントハンドラを登録します。

定義:
インタフェース Parser 内の setErrorHandler
パラメータ:
handler - 新しいエラーイベントハンドラ
関連項目:
Parser.setErrorHandler(org.xml.sax.ErrorHandler)

parse

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

組み込み XMLReader が http://xml.org/sax/features/namespace-prefixes プロパティをサポートしない場合、このメソッドは例外をスローします。

定義:
インタフェース Parser 内の 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
文書を構文解析します。

組み込み XMLReader が http://xml.org/sax/features/namespace-prefixes プロパティをサポートしない場合、このメソッドは例外をスローします。

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

setDocumentLocator

public void setDocumentLocator(Locator locator)
文書ロケータを設定します。

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

startDocument

public void startDocument()
                   throws SAXException
文書イベントを開始します。

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

endDocument

public void endDocument()
                 throws SAXException
文書イベントを終了します。

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

startPrefixMapping

public void startPrefixMapping(String prefix,
                               String uri)
SAX2 の前置修飾子のマッピング開始イベントを適応させます。

定義:
インタフェース ContentHandler 内の startPrefixMapping
パラメータ:
prefix - マッピングされる前置修飾子
uri - マッピング先の名前空間 URI
関連項目:
ContentHandler.startPrefixMapping(java.lang.String, java.lang.String)

endPrefixMapping

public void endPrefixMapping(String prefix)
SAX2 の前置修飾子のマッピング終了イベントを適応させます。

定義:
インタフェース ContentHandler 内の endPrefixMapping
パラメータ:
prefix - マッピングされる前置修飾子
関連項目:
ContentHandler.endPrefixMapping(java.lang.String)

startElement

public void startElement(String uri,
                         String localName,
                         String qName,
                         Attributes atts)
                  throws SAXException
SAX2 の要素開始イベントを適応させます。

定義:
インタフェース ContentHandler 内の startElement
パラメータ:
uri - 名前空間 URI
localName - 名前空間のローカル名
qName - 前置修飾子付きの修飾名
atts - SAX2 属性
例外:
SAXException - クライアントで処理例外が発生する可能性がある
関連項目:
ContentHandler.endDocument()

endElement

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

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

characters

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

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

ignorableWhitespace

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

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

processingInstruction

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

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

skippedEntity

public void skippedEntity(String name)
                   throws SAXException
SAX2 のスキップされたエンティティイベントを適応させます。

定義:
インタフェース ContentHandler 内の skippedEntity
パラメータ:
name - スキップされたエンティティの名前
例外:
SAXException - SAX 例外。ほかの例外をラップしている可能性がある
関連項目:
ContentHandler.skippedEntity(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.