xml.sax.handler --- SAX 處理句柄的基類?

ContentHandler 對象?

用戶應(yīng)當子類化 ContentHandler 來支持他們的應(yīng)用程序。 以下方法會由解析器在輸入文檔的適當事件上調(diào)用:

ContentHandler.setDocumentLocator(locator)?

由解析器調(diào)用來給予應(yīng)用程序一個定位器以確定文檔事件來自何處。

強烈建議（雖然不是絕對的要求） SAX 解析器提供一個定位器：如果提供的話，它必須在發(fā)起調(diào)用 DocumentHandler 接口的任何其他方法之前通過發(fā)起調(diào)用此方法來提供定位器。

定位器允許應(yīng)用程序確定任何文檔相關(guān)事件的結(jié)束位置，即使解析器沒有報告錯誤。 通常，應(yīng)用程序?qū)⑹褂眠@些信息來報告它自己的錯誤（例如未匹配到應(yīng)用程序業(yè)務(wù)規(guī)則的字符內(nèi)容）。 定位器所返回的信息可能不足以與搜索引擎配合使用。

請注意定位器只有在發(fā)起調(diào)用此接口中的事件時才會返回正確的信息。 應(yīng)用程序不應(yīng)試圖在其他任何時刻使用它。

ContentHandler.startDocument()?

接收一個文檔開始的通知。

SAX 解析器將只發(fā)起調(diào)用這個方法一次，并且會在調(diào)用這個接口或 DTDHandler 中的任何其他方法之前 (setDocumentLocator() 除外)。

ContentHandler.endDocument()?

接收一個文檔結(jié)束的通知。

SAX 解析器將只發(fā)起調(diào)用這個方法一次，并且它將是在解析過程中最后發(fā)起調(diào)用的方法。 解析器在（因不可恢復(fù)的錯誤）放棄解析或到達輸入的終點之前不應(yīng)發(fā)起調(diào)用這個方法。

ContentHandler.startPrefixMapping(prefix, uri)?

開始一個前綴 URI 命名空間映射的范圍。

來自此事件的信息對于一般命名空間處理來說是不必要的：當 feature_namespaces 特性被啟用時（默認）SAX XML 讀取器將自動為元素和屬性名稱替換前綴。

但是也存在一些情況，當應(yīng)用程序需要在字符數(shù)據(jù)或?qū)傩灾抵惺褂们熬Y，而它們無法被安全地自動擴展；startPrefixMapping() 和 endPrefixMapping() 事件會向應(yīng)用程序提供信息以便在這些上下文內(nèi)部擴展前綴，如果有必要的話。

請注意 startPrefixMapping() 和 endPrefixMapping() 事件并不保證能夠相對彼此被正確地嵌套：所有 startPrefixMapping() 事件都將在對應(yīng)的 startElement() 事件之前發(fā)生，而所有 endPrefixMapping() 事件都將在對應(yīng)的 endElement() 事件之后發(fā)生，但它們的并不保證一致。

ContentHandler.endPrefixMapping(prefix)?

結(jié)束一個前綴 URI 映射的范圍。

請參看 startPrefixMapping() 了解詳情。 此事件將總是會在對應(yīng)的 endElement() 事件之后發(fā)生，但 endPrefixMapping() 事件的順序則并沒有保證。

ContentHandler.startElement(name, attrs)?

在非命令空間模式下指示一個元素的開始。

name 形參包含字符串形式的元素類型原始 XML 1.0 名稱而 attrs 形參存放包含元素屬性的 Attributes 接口對象 (參見 Attributes 接口)。 作為 attrs 傳入的對象可能被解析器所重用；維持一個對它的引用不是保持屬性副本的可靠方式。 要保持這些屬性的一個副本，請使用 attrs 對象的 copy() 方法。

ContentHandler.endElement(name)?

在非命名空間模式下指示一個元素的結(jié)束。

name 形參包含元素類型的名稱，與 startElement() 事件的一樣。

ContentHandler.startElementNS(name, qname, attrs)?

在命名空間模式下指示一個元素的開始。

name 形參包含以 (uri, localname) 元組表示的元素類型名稱，qname 形參包含源文檔中使用的原始 XML 1.0 名稱，而 attrs 形參存放包含元素屬性的 AttributesNS 接口實例 (參見 AttributesNS 接口)。 如果沒有命名空間被關(guān)聯(lián)到元素，則 name 的 uri 部分將為 None。 作為 attrs 傳入的對象可能被解析器所重用；維持一個對它的引用不是保持屬性副本的可靠方式。 要保持這些屬性的一個副本，請使用 attrs 對象的 copy() 方法。

解析器可將 qname 形參設(shè)為 None，除非 feature_namespace_prefixes 特性已被激活。

ContentHandler.endElementNS(name, qname)?

在命名空間模式下指示一個元素的結(jié)束。

name 形參包含元素類型的名稱，與 startElementNS() 方法的一樣，qname 形參也是類似的。

ContentHandler.characters(content)?

接收字符數(shù)據(jù)的通知。

解析器將調(diào)用此方法來報告每一個字符數(shù)據(jù)分塊。 SAX 解析器可以將所有連續(xù)字符數(shù)據(jù)返回為一個單獨分塊，或者將其拆成幾個分塊；但是，在任意單個事件中的所有字符都必須來自同一個外部實體以便定位器提供有用的信息。

content 可以是一個字符串或字節(jié)串實例；expat 讀取器模塊總是會產(chǎn)生字符串。

備注

Python XML 特別關(guān)注小組所提供的早期 SAX 1 接口針對此方法使用了一個更類似于 Java 的接口。 由于 Python 所使用的大多數(shù)解析器都沒有利用老式的接口，因而選擇了更簡單的簽名來替代它。 要將舊代碼轉(zhuǎn)換為新接口，請使用 content 而不要通過舊的 offset 和 length 形參來對內(nèi)容進行切片。

ContentHandler.ignorableWhitespace(whitespace)?

接收元素內(nèi)容中可忽略空白符的通知。

驗證解析器必須使用此方法來報告每個可忽略的空白符分塊（參見 W3C XML 1.0 建議第 2.10 節(jié)）：非驗證解析器如果能夠解析并使用內(nèi)容模型的話也可以使用此方法。

SAX 解析器可以將所有連續(xù)字符數(shù)據(jù)返回為一個單獨分塊，或者將其拆成幾個分塊；但是，在任意單個事件中的所有字符都必須來自同一個外部實體以便定位器提供有用的信息。

ContentHandler.processingInstruction(target, data)?

接受一條處理指令的通知。

解析器將為已找到的每條處理指令發(fā)起調(diào)用該方法一次：請注意處理指令可能出現(xiàn)在主文檔元素之前或之后。

SAX 解析器絕不應(yīng)當使用此方法來報告 XML 聲明（XML 1.0 第 2.8 節(jié)）或文本聲明（XML 1.0 第 4.3.1 節(jié)）。

ContentHandler.skippedEntity(name)?

接收一個已跳過實體的通知。

解析器將為每個已跳過實體發(fā)起調(diào)用此方法一次。 非驗證處理程序可能會跳過未看到聲明的實體（例如，由于實體是在一個外部because, for example, the entity was declared in an external DTD 子集中聲明的）。 所有處理程序都可以跳過外部實體，具體取決于 feature_external_ges 和 feature_external_pes 屬性的值。

DTDHandler 對象?

DTDHandler 實例提供了下列方法:

DTDHandler.notationDecl(name, publicId, systemId)?

處理標注聲明事件。

DTDHandler.unparsedEntityDecl(name, publicId, systemId, ndata)?

處理未解析的實體聲明事件。

EntityResolver 對象?

EntityResolver.resolveEntity(publicId, systemId)?

求解一個實體的系統(tǒng)標識符并返回一個字符串形式的系統(tǒng)標識符作為讀取源，或是一個 InputSource 作為讀取源。 默認的實現(xiàn)會返回 systemId。

ErrorHandler 對象?

帶有這個接口的對象被用于接收來自 XMLReader 的錯誤和警告信息。 如果你創(chuàng)建了一個實現(xiàn)這個接口的對象，然后用你的 XMLReader 注冊這個對象，則解析器將調(diào)用你的對象中的這個方法來報告所有的警告和錯誤。 有三個可用的錯誤級別：警告、（或許）可恢復(fù)的錯誤和不可恢復(fù)的錯誤。 所有方法都接受 SAXParseException 作為唯一的形參。 錯誤和警告可以通過引發(fā)所傳入的異常對象來轉(zhuǎn)換為異常。

ErrorHandler.error(exception)?

當解析器遇到一個可恢復(fù)的錯誤時調(diào)用。 如果此方法沒有引發(fā)異常，則解析可能會繼續(xù)，但是應(yīng)用程序不能預(yù)期獲得更多的文檔信息。 允許解析器繼續(xù)可能會允許在輸入文檔中發(fā)現(xiàn)額外的錯誤。

ErrorHandler.fatalError(exception)?

當解析器遇到一個不可恢復(fù)的錯誤時調(diào)用；在此方法返回時解析應(yīng)當終止。

ErrorHandler.warning(exception)?

當解析器向應(yīng)用程序提供次要警告信息時調(diào)用。 在此方法返回時解析應(yīng)當繼續(xù)，并且文檔信息將繼續(xù)被傳遞給應(yīng)用程序。 在此方法中引發(fā)異常將導(dǎo)致解析結(jié)束。

LexicalHandler 對象?

可選的詞法事件 SAX2 處理句柄。

這個處理句柄被用來獲取一個 XML 文檔的相關(guān)詞法信息。 詞法信息包括描述所使用的文檔編碼格式和嵌入文檔中的 XML 注釋，以及 DTD 和任何 CDATA 部分的節(jié)邊界。 詞法處理句柄的使用方式與內(nèi)容處理句柄相同。

通過使用帶有屬性標識符 'http://xml.org/sax/properties/lexical-handler' 的 setProperty 方法來設(shè)置一個 XMLReader 的 LexicalHandler。

LexicalHandler.comment(content)?

報告在文檔中任何地方（包括 DTD 和文檔元素以外）的注釋。

LexicalHandler.startDTD(name, public_id, system_id)?

如果文檔有關(guān)聯(lián)的 DTD 則報告 DTD 聲明的開始。

LexicalHandler.endDTD()?

報告 DTD 聲明的結(jié)束。

LexicalHandler.startCDATA()?

報告 CDATA 標記部分的開始。

CDATA 標記部分的內(nèi)容將通過字符處理句柄來報告。

LexicalHandler.endCDATA()?

報告 CDATA 標記部分的結(jié)束。