概觀  軟體套件   類別  使用  階層樹  已過時  索引  說明 
JavaTM 2 Platform
Standard Ed. 6
 上一個類別   下一個類別 框架    無框架    
摘要： 巢狀 | 欄位 | 建構子 | 方法 詳細資訊： 欄位 | 建構子 | 方法

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 解析器。

此模組（包括源程式碼和文檔）位於公共域中，對該模組不提供擔保。有關更多資訊，請參閱http://www.saxproject.org。

此類別包裹 SAX2 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 解析器類似。

參數：
xmlReader - 要包裹的 SAX2 XMLReader。
拋出：
NullPointerException - 如果參數為 null。
方法詳細資訊

setLocale

public void setLocale(Locale locale)
               throws SAXException
設置錯誤報告的語言環境。

SAX2 中不支持這麼做，並且總是拋出異常。

指定者：
介面 Parser 中的 setLocale
參數：
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 - 如果在讀取文檔的原始內容時存在問題。
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 - 如果在讀取文檔的原始內容時存在問題。
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 - 可由子類別拋出。
另請參見：
ContentHandler.skippedEntity(java.lang.String)
概觀  軟體套件   類別  使用  階層樹  已過時  索引  說明 
JavaTM 2 Platform
Standard Ed. 6
 上一個類別   下一個類別 框架    無框架    
摘要： 巢狀 | 欄位 | 建構子 | 方法 詳細資訊： 欄位 | 建構子 | 方法
提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only。