org.xbrlapi.sax

Class ContentHandlerImpl

java.lang.Object

org.xml.sax.helpers.DefaultHandler

org.xbrlapi.sax.BaseContentHandlerImpl

org.xbrlapi.sax.ContentHandlerImpl

All Implemented Interfaces:

org.xml.sax.ContentHandler, org.xml.sax.DTDHandler, org.xml.sax.EntityResolver, org.xml.sax.ErrorHandler

Direct Known Subclasses:

ContentHandlerImpl

public class ContentHandlerImpl
extends BaseContentHandlerImpl
implements ContentHandler

SAX content handler used to parse a document into an XBRL API data store. The content handler is responsible for identifying XML fragments to be loaded into the data store, as they are parsed and then passing them over to the data loader for creation and storage. The content handler needs to be supplied with a variety of helpers to assist with data storage and XLink processing. These are supplied by the loader.

Author:

Geoffrey Shuetrim (geoff@galexy.net)

Constructor Summary

Constructors

Constructor and Description
ContentHandlerImpl(Loader loader, java.net.URI uri) Creates the content handler, starting out by identifying the DTS structure that the content handler is discovering.
ContentHandlerImpl(Loader loader, java.net.URI uri, java.lang.String xml) Creates the content handler, starting out by identifying the data structure that the content handler is discovering.

Method Summary

Methods

Modifier and Type	Method and Description
void	characters(char[] buf, int offset, int len) Copy characters (trimming white space as required) to the DTSImpl.
void	endElement(java.lang.String namespaceURI, java.lang.String lName, java.lang.String qName) The end of an element triggers processing of an extended link if we have reached the end of an extended link.
void	ignorableWhitespace(char[] buf, int offset, int len) Ignore ignorable whitespace
void	processingInstruction(java.lang.String target, java.lang.String data) Copy across processing instructions to the DTSImpl
void	setDocumentLocator(org.xml.sax.Locator locator) The locator for a document is stored to facilitate resolution of CacheURIImpl's relative to that location.
void	startDocument() On starting to parse a document the Base URI resolver is set up with the documents absolute URI.
void	startElement(java.lang.String namespaceURI, java.lang.String lName, java.lang.String qName, org.xml.sax.Attributes attrs) Sets the element state.

Methods inherited from class org.xbrlapi.sax.BaseContentHandlerImpl

error, fatalError, getElementState, getIdentifiers, getLoader, getURI, setElementState, setLoader, setURI, warning

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

endDocument, endPrefixMapping, notationDecl, resolveEntity, skippedEntity, startPrefixMapping, unparsedEntityDecl

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.xbrlapi.sax.ContentHandler

error, fatalError, getElementState, getIdentifiers, getLoader, getURI, setElementState, setLoader, setURI, warning

Methods inherited from interface org.xml.sax.ContentHandler

endDocument, endPrefixMapping, skippedEntity, startPrefixMapping

Constructor Detail

ContentHandlerImpl

public ContentHandlerImpl(Loader loader,
                  java.net.URI uri)
                   throws XBRLException

Creates the content handler, starting out by identifying the DTS structure that the content handler is discovering.

Parameters:

loader - The DTS loader that is using this content handler.

uri - The URI of the document being parsed.

Throws:

XBRLException - if any of the parameters are null.

ContentHandlerImpl

public ContentHandlerImpl(Loader loader,
                  java.net.URI uri,
                  java.lang.String xml)
                   throws XBRLException

Creates the content handler, starting out by identifying the data structure that the content handler is discovering.

Parameters:

loader - The data loader that is using this content handler.

uri - The URI of the document being parsed.

xml - The string representation of the XML document being parsed.

Throws:

XBRLException - if any of the parameters are null.

Method Detail

startDocument

public void startDocument()
                   throws org.xml.sax.SAXException

On starting to parse a document the Base URI resolver is set up with the documents absolute URI. The fragment identifiers are also instantiated and initialised.

Specified by:

startDocument in interface org.xml.sax.ContentHandler

Overrides:

startDocument in class org.xml.sax.helpers.DefaultHandler

Throws:

org.xml.sax.SAXException

startElement

public void startElement(java.lang.String namespaceURI,
                java.lang.String lName,
                java.lang.String qName,
                org.xml.sax.Attributes attrs)
                  throws org.xml.sax.SAXException

Sets the element state. Increment the fragment children via the loader ???? Stash xsi:schemaLocation attribute URIs for discovery if required. Identifies any new fragment. Adds the fragment, if one is found, to the stack of fragments being built by the loader. Update the map of defined namespaces. Add the element to the current fragment.

Specified by:

startElement in interface org.xml.sax.ContentHandler

Overrides:

startElement in class org.xml.sax.helpers.DefaultHandler

Throws:

org.xml.sax.SAXException

See Also:

ContentHandler.startElement(String, String, String, Attributes)

endElement

public void endElement(java.lang.String namespaceURI,
              java.lang.String lName,
              java.lang.String qName)
                throws org.xml.sax.SAXException

The end of an element triggers processing of an extended link if we have reached the end of an extended link. Otherwise, we step up to the parent element unless the element that is ending did not ever become the current element.

Specified by:

endElement in interface org.xml.sax.ContentHandler

Overrides:

endElement in class org.xml.sax.helpers.DefaultHandler

Throws:

org.xml.sax.SAXException

ignorableWhitespace

public void ignorableWhitespace(char[] buf,
                       int offset,
                       int len)
                         throws org.xml.sax.SAXException

Ignore ignorable whitespace

Specified by:

ignorableWhitespace in interface org.xml.sax.ContentHandler

Overrides:

ignorableWhitespace in class org.xml.sax.helpers.DefaultHandler

Throws:

org.xml.sax.SAXException

processingInstruction

public void processingInstruction(java.lang.String target,
                         java.lang.String data)
                           throws org.xml.sax.SAXException

Copy across processing instructions to the DTSImpl

Specified by:

processingInstruction in interface org.xml.sax.ContentHandler

Overrides:

processingInstruction in class org.xml.sax.helpers.DefaultHandler

Throws:

org.xml.sax.SAXException

characters

public void characters(char[] buf,
              int offset,
              int len)
                throws org.xml.sax.SAXException

Copy characters (trimming white space as required) to the DTSImpl.

Specified by:

characters in interface org.xml.sax.ContentHandler

Overrides:

characters in class org.xml.sax.helpers.DefaultHandler

Throws:

org.xml.sax.SAXException

setDocumentLocator

public void setDocumentLocator(org.xml.sax.Locator locator)

The locator for a document is stored to facilitate resolution of CacheURIImpl's relative to that location.

Specified by:

setDocumentLocator in interface org.xml.sax.ContentHandler

Overrides:

setDocumentLocator in class org.xml.sax.helpers.DefaultHandler