Package org.apache.jackrabbit.core.xml

Class ImportHandler

java.lang.Object

org.xml.sax.helpers.DefaultHandler

org.apache.jackrabbit.core.xml.ImportHandler

All Implemented Interfaces:

ContentHandler, DTDHandler, EntityResolver, ErrorHandler

public class ImportHandler
extends DefaultHandler

An ImportHandler instance can be used to import serialized data in System View XML or Document View XML. Processing of the XML is handled by specialized ContentHandlers (i.e. SysViewImportHandler and DocViewImportHandler).

The actual task of importing though is delegated to the implementation of the Importer interface.

Important Note:

These SAX Event Handlers expect that Namespace URI's and local names are reported in the start/endElement events and that start/endPrefixMapping events are reported (i.e. default SAX2 Namespace processing).

Field Summary

Fields

Modifier and Type	Field	Description
protected Importer	importer
protected Locator	locator

Constructor Summary

Constructors

Constructor	Description
ImportHandler(Importer importer, Session session)

Method Summary

Modifier and Type	Method	Description
void	characters(char[] ch, int start, int length)
void	endDocument()
void	endElement(String namespaceURI, String localName, String qName)	Delegates the call to the underlying target handler and asks the handler to end the current namespace context.
void	error(SAXParseException e)
void	fatalError(SAXParseException e)
void	setDocumentLocator(Locator locator)
void	startElement(String namespaceURI, String localName, String qName, Attributes atts)
void	startPrefixMapping(String prefix, String uri)	Records the given namespace mapping to be included in the local namespace context.
void	warning(SAXParseException e)

Methods inherited from class org.xml.sax.helpers.DefaultHandler

endPrefixMapping, ignorableWhitespace, notationDecl, processingInstruction, resolveEntity, skippedEntity, startDocument, unparsedEntityDecl

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

importer

protected final Importer importer

locator

protected Locator locator

Constructor Detail

ImportHandler

public ImportHandler(Importer importer,
                     Session session)
              throws RepositoryException

Throws:

RepositoryException

Method Detail

warning

public void warning(SAXParseException e)
             throws SAXException

Specified by:

warning in interface ErrorHandler

Overrides:

warning in class DefaultHandler

Throws:

SAXException

error

public void error(SAXParseException e)
           throws SAXException

Specified by:

error in interface ErrorHandler

Overrides:

error in class DefaultHandler

Throws:

SAXException

fatalError

public void fatalError(SAXParseException e)
                throws SAXException

Specified by:

fatalError in interface ErrorHandler

Overrides:

fatalError in class DefaultHandler

Throws:

SAXException

endDocument

public void endDocument()
                 throws SAXException

Specified by:

endDocument in interface ContentHandler

Overrides:

endDocument in class DefaultHandler

Throws:

SAXException

startPrefixMapping

public void startPrefixMapping(String prefix,
                               String uri)
                        throws SAXException

Records the given namespace mapping to be included in the local namespace context. The local namespace context is instantiated in startElement(String, String, String, Attributes) using all the the namespace mappings recorded for the current XML element.

The namespace is also recorded in the persistent namespace registry unless it is already known.

Specified by:

startPrefixMapping in interface ContentHandler

Overrides:

startPrefixMapping in class DefaultHandler

Parameters:

prefix - namespace prefix

uri - namespace URI

Throws:

SAXException

startElement

public void startElement(String namespaceURI,
                         String localName,
                         String qName,
                         Attributes atts)
                  throws SAXException

Specified by:

startElement in interface ContentHandler

Overrides:

startElement in class DefaultHandler

Throws:

SAXException

characters

public void characters(char[] ch,
                       int start,
                       int length)
                throws SAXException

Specified by:

characters in interface ContentHandler

Overrides:

characters in class DefaultHandler

Throws:

SAXException

endElement

public void endElement(String namespaceURI,
                       String localName,
                       String qName)
                throws SAXException

Delegates the call to the underlying target handler and asks the handler to end the current namespace context.

Specified by:

endElement in interface ContentHandler

Overrides:

endElement in class DefaultHandler

Throws:

SAXException

setDocumentLocator

public void setDocumentLocator(Locator locator)

Specified by:

setDocumentLocator in interface ContentHandler

Overrides:

setDocumentLocator in class DefaultHandler