Package edu.ucsb.nceas.metacat

Class DBSAXHandler

java.lang.Object

org.xml.sax.helpers.DefaultHandler

edu.ucsb.nceas.metacat.DBSAXHandler

All Implemented Interfaces:

ContentHandler, DTDHandler, EntityResolver, ErrorHandler, DeclHandler, LexicalHandler

public class DBSAXHandler
extends DefaultHandler
implements LexicalHandler, DeclHandler

A database aware Class implementing callback bethods for the SAX parser to call when processing the XML stream and generating events.

Field Summary

Fields

Modifier and Type	Field	Description
protected boolean	atFirstElement
protected String	catalogid
protected String	docname
protected String	doctype
static final String	ECOGRID
protected long	endNodeId
protected boolean	hitTextNode
static final int	MAXDATACHARS
protected Hashtable<String,String>	namespaces
static final long	NODE_ID
protected boolean	processingDTD
protected Vector<XMLSchema>	schemaList
protected static final String	SCHEMALOCATIONKEYWORD
protected String	systemid
protected StringBuffer	textBuffer

Constructor Summary

Constructors

Constructor	Description
DBSAXHandler()	Construct an instance of the handler class

Method Summary

Modifier and Type	Method	Description
void	attributeDecl(String eName, String aName, String type, String valueDefault, String value)	SAX Handler that receives notification of attribute declarations
void	characters(char[] cbuf, int start, int len)	SAX Handler that is called for each XML text node
void	comment(char[] ch, int start, int length)	SAX Handler that receives notification of comments in the DTD
void	elementDecl(String name, String model)	SAX Handler that receives notification of element declarations
void	endCDATA()	SAX Handler that receives notification of the end of CDATA sections
void	endDocument()	SAX Handler that receives notification of end of the document
void	endDTD()	SAX Handler that receives notification of end of DTD
void	endElement(String uri, String localName, String qName)	SAX Handler that is called at the end of each XML element
void	endEntity(String name)	SAX Handler that receives notification of the end of entities
void	error(SAXParseException exception)	SAX Handler that receives notification of recoverable parsing errors
void	externalEntityDecl(String name, String publicId, String systemId)	SAX Handler that receives notification of external entity declarations
void	fatalError(SAXParseException exception)	SAX Handler that receives notification of fatal parsing errors
String	getDocname()	get the document name
String	getDocumentName()	Get the name of the document
void	ignorableWhitespace(char[] cbuf, int start, int len)	SAX Handler that is called for each XML text node that is Ignorable white space
void	internalEntityDecl(String name, String value)	SAX Handler that receives notification of internal entity declarations
boolean	processingDTD()	get the document processing state
void	processingInstruction(String target, String data)	SAX Handler called once for each processing instruction found: node that PI may occur before or after the root element.
void	startCDATA()	SAX Handler that receives notification of the start of CDATA sections
void	startDocument()	SAX Handler that receives notification of beginning of the document
void	startDTD(String name, String publicId, String systemId)	SAX Handler that receives notification of DOCTYPE.
void	startElement(String uri, String localName, String qName, Attributes atts)	SAX Handler that is called at the start of each XML element
void	startEntity(String name)	SAX Handler that receives notification of the start of entities
void	startPrefixMapping(String prefix, String uri)	SAX Handler that is called at the start of Namespace
void	warning(SAXParseException exception)	SAX Handler that receives notification of warnings

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

endPrefixMapping, notationDecl, resolveEntity, setDocumentLocator, skippedEntity, unparsedEntityDecl

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.xml.sax.ContentHandler

declaration

Field Details

NODE_ID

public static final long NODE_ID

See Also:

• Constant Field Values

atFirstElement

protected boolean atFirstElement

processingDTD

protected boolean processingDTD

docname

protected String docname

doctype

protected String doctype

catalogid

protected String catalogid

systemid

protected String systemid

namespaces

protected Hashtable<String,String> namespaces

hitTextNode

protected boolean hitTextNode

textBuffer

protected StringBuffer textBuffer

MAXDATACHARS

public static final int MAXDATACHARS

See Also:

• Constant Field Values

SCHEMALOCATIONKEYWORD

protected static final String SCHEMALOCATIONKEYWORD

See Also:

• Constant Field Values

endNodeId

protected long endNodeId

schemaList

protected Vector<XMLSchema> schemaList

ECOGRID

public static final String ECOGRID

See Also:

• Constant Field Values

Constructor Details

DBSAXHandler

public DBSAXHandler()

Construct an instance of the handler class

Method Details

startDocument

public void startDocument()
                   throws SAXException

SAX Handler that receives notification of beginning of the document

Specified by:

startDocument in interface ContentHandler

Overrides:

startDocument in class DefaultHandler

Throws:

SAXException

endDocument

public void endDocument()
                 throws SAXException

SAX Handler that receives notification of end of the document

Specified by:

endDocument in interface ContentHandler

Overrides:

endDocument in class DefaultHandler

Throws:

SAXException

startPrefixMapping

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

SAX Handler that is called at the start of Namespace

Specified by:

startPrefixMapping in interface ContentHandler

Overrides:

startPrefixMapping in class DefaultHandler

Throws:

SAXException

startElement

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

SAX Handler that is called at the start of each XML element

Specified by:

startElement in interface ContentHandler

Overrides:

startElement in class DefaultHandler

Throws:

SAXException

characters

public void characters(char[] cbuf,
 int start,
 int len)
                throws SAXException

SAX Handler that is called for each XML text node

Specified by:

characters in interface ContentHandler

Overrides:

characters in class DefaultHandler

Throws:

SAXException

ignorableWhitespace

public void ignorableWhitespace(char[] cbuf,
 int start,
 int len)
                         throws SAXException

SAX Handler that is called for each XML text node that is Ignorable white space

Specified by:

ignorableWhitespace in interface ContentHandler

Overrides:

ignorableWhitespace in class DefaultHandler

Throws:

SAXException

processingInstruction

public void processingInstruction(String target,
 String data)
                           throws SAXException

SAX Handler called once for each processing instruction found: node that PI may occur before or after the root element.

Specified by:

processingInstruction in interface ContentHandler

Overrides:

processingInstruction in class DefaultHandler

Throws:

SAXException

endElement

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

SAX Handler that is called at the end of each XML element

Specified by:

endElement in interface ContentHandler

Overrides:

endElement in class DefaultHandler

Throws:

SAXException

startDTD

public void startDTD(String name,
 String publicId,
 String systemId)
              throws SAXException

SAX Handler that receives notification of DOCTYPE. Sets the DTD

Specified by:

startDTD in interface LexicalHandler

Throws:

SAXException

endDTD

public void endDTD()
            throws SAXException

SAX Handler that receives notification of end of DTD

Specified by:

endDTD in interface LexicalHandler

Throws:

SAXException

comment

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

SAX Handler that receives notification of comments in the DTD

Specified by:

comment in interface LexicalHandler

Throws:

SAXException

startCDATA

public void startCDATA()
                throws SAXException

SAX Handler that receives notification of the start of CDATA sections

Specified by:

startCDATA in interface LexicalHandler

Throws:

SAXException

endCDATA

public void endCDATA()
              throws SAXException

SAX Handler that receives notification of the end of CDATA sections

Specified by:

endCDATA in interface LexicalHandler

Throws:

SAXException

startEntity

public void startEntity(String name)
                 throws SAXException

SAX Handler that receives notification of the start of entities

Specified by:

startEntity in interface LexicalHandler

Throws:

SAXException

endEntity

public void endEntity(String name)
               throws SAXException

SAX Handler that receives notification of the end of entities

Specified by:

endEntity in interface LexicalHandler

Throws:

SAXException

elementDecl

public void elementDecl(String name,
 String model)
                 throws SAXException

SAX Handler that receives notification of element declarations

Specified by:

elementDecl in interface DeclHandler

Throws:

SAXException

attributeDecl

public void attributeDecl(String eName,
 String aName,
 String type,
 String valueDefault,
 String value)
                   throws SAXException

SAX Handler that receives notification of attribute declarations

Specified by:

attributeDecl in interface DeclHandler

Throws:

SAXException

internalEntityDecl

public void internalEntityDecl(String name,
 String value)
                        throws SAXException

SAX Handler that receives notification of internal entity declarations

Specified by:

internalEntityDecl in interface DeclHandler

Throws:

SAXException

externalEntityDecl

public void externalEntityDecl(String name,
 String publicId,
 String systemId)
                        throws SAXException

SAX Handler that receives notification of external entity declarations

Specified by:

externalEntityDecl in interface DeclHandler

Throws:

SAXException

fatalError

public void fatalError(SAXParseException exception)
                throws SAXException

SAX Handler that receives notification of fatal parsing errors

Specified by:

fatalError in interface ErrorHandler

Overrides:

fatalError in class DefaultHandler

Throws:

SAXException

error

public void error(SAXParseException exception)
           throws SAXException

SAX Handler that receives notification of recoverable parsing errors

Specified by:

error in interface ErrorHandler

Overrides:

error in class DefaultHandler

Throws:

SAXException

warning

public void warning(SAXParseException exception)
             throws SAXException

SAX Handler that receives notification of warnings

Specified by:

warning in interface ErrorHandler

Overrides:

warning in class DefaultHandler

Throws:

SAXException

getDocname

public String getDocname()

get the document name

processingDTD

public boolean processingDTD()

get the document processing state

getDocumentName

public String getDocumentName()

Get the name of the document

Returns:

the name of the document