13.10 `xml.sax.handler` -- Classe di base per gestori SAX

Nuovo nella versione 2.0.

L'API SAX definisce quattro tipi di gestori: gestori del contenuto, gestori DTD, gestori di errori, e risolutori di entità. Le applicazioni necessitano soltanto di implementare queste interfacce per gli eventi per i quali vengono interessate; queste possono implementare le interfacce in un oggetto singolo o in oggetti multipli. Le implementazioni dei gestori devono ereditare dalla classe di base fornita nel modulo xml.sax, cosicché tutti i metodi ricevano la stessa implementazione.

class ContentHandler: Questa è l'interfaccia principale di callback per SAX e una delle più importanti nelle applicazioni. L'ordine di eventi in questa interfaccia ricalca l'ordine delle informazioni nel documento.

class DTDHandler: Gestisce eventi DTD.
Questa interfaccia specifica solo quegli eventi DTD richiesti per l'analisi di base (entità non analizzate ed attributi).

class EntityResolver: Interfaccia di base per le entità in risoluzione. Se si crea un oggetto implementando questa interfaccia, si registra quindi l'oggetto con il proprio Parser, che chiamerà il metodo nel proprio oggetto per risolvere tutte le entità esterne.

class ErrorHandler: Interfaccia usata dal parser per presentare l'errore ed i messaggi di avviso alle applicazioni. I metodi di questo oggetto controllano che gli errori vengano convertiti immediatamente in eccezioni o se debbano essere gestiti in qualche altro modo.

In aggiunta a queste classi, xml.sax.handler fornisce costanti simboliche per le caratteristiche avanzate e nomi di proprietà.

feature_namespaces: Valore: "http://xml.org/sax/features/namespaces"
vero: Processa lo spazio dei nomi.
falso: Facoltativamente non processa lo spazio dei nomi (richiede il prefisso dello spazio dei nomi; predefinito).
accesso: (analisi) sola lettura; (non analisi) lettura/scrittura.

feature_namespace_prefixes: Valore: "http://xml.org/sax/features/namespace-prefixes"
vero: Riporta il nome del prefisso originale e gli attributi usati dalla dichiarazione dello spazio dei nomi.
falso: Non riporta gli attributi usati dalla dichiarazione dello spazio dei nomi e, facoltativamente non riporta il prefisso originale (predefinito).
accesso: (analisi) sola lettura; (non analisi) lettura/scrittura.

feature_string_interning: Valore: "http://xml.org/sax/features/string-interning" vero: Tutti i nomi degli elementi, prefissi, nomi di attributo, URI di spazi dei nomi e nomi locali vengono acquisiti usando la funzione built-in intern.
falso: I nomi non vengono necessariamente acquisiti tramite intern, oppure lo possono essere (predefinito).
accesso: (analisi) sola lettura; (non analisi) lettura/scrittura.

feature_validation: Valore: "http://xml.org/sax/features/validation"
vero: Riporta tutti gli errori di validazione (incluse le external-general-entitites e le external-parameter-entities).
falso: Non riporta gli errori di validazione.
accesso: (analisi) sola lettura; (non analisi) lettura/scrittura.

feature_external_ges: Valore: "http://xml.org/sax/features/external-general-entities"
vero: Include tutte le entità (testo) generali esterne.
falso: Non include le entità generali esterne.
accesso: (analisi) sola lettura; (non analisi) lettura/scrittura.

feature_external_pes: Valore: "http://xml.org/sax/features/external-parameter-entities"
vero: Include tutte le entità di parametri esterni, inclusi i sotto insiemi dei DTD esterni.
falso: Non include le entità generali esterne tranne i sottoinsiemi di DTD esterni.
accesso: (analisi) sola lettura; (non analisi) lettura/scrittura.

all_features: Elenco delle funzionalità.

property_lexical_handler: Valore: "http://xml.org/sax/properties/lexical-handler"
tipo di dato: xml.sax.sax2lib.LexicalHandler (non supportato in Python 2)
descrizione: Una facoltativa estensione per gestire eventi lessicali come fossero commenti.
accesso: lettura/scrittura

property_declaration_handler: Valore: "http://xml.org/sax/properties/declaration-handler"
tipo di dato: xml.sax.sax2lib.DeclHandler (non supportato in Python 2)
descrizione: un'estensione gestore facoltativa, per eventi correlati a DTD oltreché notazioni ed entità non analizzate.
Accesso: lettura/scrittura

property_dom_node: Valore: "http://xml.org/sax/properties/dom-node"
tipo di dato: org.w3c.dom.Node (non supportato in Python 2) descrizione: quando viene analizzato, il corrente nodo DOM viene visitato se è un iteratore DOM; quando non analizza per iterazione la directory root del nodo DOM.
Accesso: (analisi) in sola lettura, (nessuna analisi) lettura/scrittura

property_xml_string: Valore: "http://xml.org/sax/properties/xml-string"
tipo di dato: Stringa
descrizione: la stringa costante dei caratteri che erano il sorgente per l'evento corrente.
Accesso: in sola lettura.

all_properties: Elenco di tutti i nomi delle proprietà.

Vedete Circa questo documento... per informazioni su modifiche e suggerimenti.

13.10 xml.sax.handler -- Classe di base per gestori SAX

13.10 `xml.sax.handler` -- Classe di base per gestori SAX