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。

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

此類別包裹 SAX1 Parser，並使其充當帶有功能、屬性和名稱空間支持的 SAX2 XMLReader。注意，不可能報告 skippedEntity 事件，因為 SAX1 不提供該資訊。

此適配器不對重複的名稱空間限定的屬性進行測試。

從以下版本開始：

SAX 2.0

另請參見：

XMLReaderAdapter, XMLReader, Parser

建構子摘要

ParserAdapter()
建構一個新解析器適配器。

ParserAdapter(Parser parser)
建構一個新的解析器適配器。

方法摘要

void	characters(char[] ch, int start, int length) 適配器實作方法；不調用。
void	endDocument() 適配器實作方法；不調用。
void	endElement(String qName) 適配器實作方法；不調用。
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) 適配器實作方法；不調用。
void	parse(InputSource input) 解析 XML 文檔。
void	parse(String systemId) 解析 XML 文檔。
void	processingInstruction(String target, String data) 適配器實作方法；不調用。
void	setContentHandler(ContentHandler handler) 設置內容處理程序。
void	setDocumentLocator(Locator locator) 適配器實作方法；不調用。
void	setDTDHandler(DTDHandler handler) 設置 DTD 處理程序。
void	setEntityResolver(EntityResolver resolver) 設置實體解析器。
void	setErrorHandler(ErrorHandler handler) 設置錯誤處理程序。
void	setFeature(String name, boolean value) 為解析器設置功能標誌。
void	setProperty(String name, Object value) 設置解析器屬性。
void	startDocument() 適配器實作方法；不調用。
void	startElement(String qName, AttributeList qAtts) 適配器實作方法；不調用。

從類別 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 value)
                throws SAXNotRecognizedException,
                       SAXNotSupportedException

為解析器設置功能標誌。

能識別的功能僅為名稱空間和名稱前綴。

指定者：

介面 XMLReader 中的 setFeature

參數：

name - 功能名稱，作為一個完整的 URI。

value - 請求的功能值。

拋出：

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

另請參見：

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 - the new DTD handler

另請參見：

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 - the new content handler

另請參見：

XMLReader.setEntityResolver(org.xml.sax.EntityResolver)

getContentHandler

public ContentHandler getContentHandler()

返回當前內容處理程序。

指定者：

介面 XMLReader 中的 getContentHandler

返回：

當前內容處理程序，如果未提供，則返回 null。

另請參見：

XMLReader.getEntityResolver()

setErrorHandler

public void setErrorHandler(ErrorHandler handler)

設置錯誤處理程序。

指定者：

介面 XMLReader 中的 setErrorHandler

參數：

handler - 新的錯誤處理程序。

另請參見：

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 - 如果在讀取文檔的原始內容時存在問題。

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 - 如果在讀取文檔的原始內容時存在問題。

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 startElement 事件。

如果必要，則執行 Namespace 處理。

指定者：

介面 DocumentHandler 中的 startElement

參數：

qName - 限定的（前綴）名稱。

qAtts - XML 屬性列表（帶 qnames）。

拋出：

SAXException - 客戶端可能引發處理異常。

另請參見：

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)