datavisualizer.DetailedOutputFileSetupParseHandler Class Reference

Plugs into the Xerces SAX parser to handle the incoming data when the detailed output setup XML file is parsed. More...

List of all members.

Public Member Functions

 DetailedOutputFileSetupParseHandler (DetailedOutputFileManager oManager)
 Constructor.
void startElement (java.lang.String uri, java.lang.String localName, java.lang.String qName, Attributes attributes) throws SAXException
 Called when the parser hits a new opening tag.
void characters (char[] ch, int start, int length) throws SAXException
 Reads character data from the XML file.
void endElement (java.lang.String sURI, java.lang.String sLocalName, java.lang.String sQName) throws SAXException
 Called at the end of an XML tag.

Private Attributes

DetailedOutputFileManager m_oManager
 Detailed output file manager which owns this parser.
javawrapper.DetailedTreeSettings m_oTreeSettings = null
 Set of tree settings into which to put data.
javawrapper.DetailedGridSettings m_oGridSettings = null
 Set of grid settings into which to put data.
StringBuffer m_sBuf = new StringBuffer()
 String buffer to collect data in our parser.
boolean m_bIsFloat = false
 Indicates the data just parsed is a float data member.
boolean m_bIsInt = false
 Indicates the data just parsed is an int data member.
boolean m_bIsChar = false
 Indicates the data just parsed is a char data member.
boolean m_bIsBool = false
 Indicates the data just parsed is a bool data member.
boolean m_bIsPackage = false
 Indicates that these are grid package values.
boolean m_bReadingSubplot = false
 Indicates that this is a subplot and we are currently reading its area data.


Detailed Description

Plugs into the Xerces SAX parser to handle the incoming data when the detailed output setup XML file is parsed.

Copyright: Copyright (c) Charles D. Canham 2003

Company: Institute of Ecosystem Studies

Author:
Lora E. Murphy
Version:
1.0

Edit history:
------------------
April 28, 2004: Submitted in beta version (LEM)
January 3, 2007: Added better subplot support including specific area calculation (LEM)


Constructor & Destructor Documentation

datavisualizer.DetailedOutputFileSetupParseHandler.DetailedOutputFileSetupParseHandler ( DetailedOutputFileManager  oManager  ) 

Constructor.

This is passed an object into which to put the parsed data.

Parameters:
oManager The DetailedOutputFileViewer object into which the data goes.

Edit history:
------------------
April 28, 2004: Submitted in beta version (LEM)


Member Function Documentation

void datavisualizer.DetailedOutputFileSetupParseHandler.startElement ( java.lang.String  uri,
java.lang.String  localName,
java.lang.String  qName,
Attributes  attributes 
) throws SAXException

Called when the parser hits a new opening tag.

This is overridden from the base class. This function is only interested in the following tags:

Parameters:
uri the Namespace URI (ignored)
localName the local name (what this function looks at)
qName the qualified (prefixed) name (ignored)
attributes The tag's attributes
Exceptions:
SAXException if there are any problems.

Edit history:
------------------
April 28, 2004: Submitted in beta version (LEM)
March 21, 2005: Fixed a bug so that package members could be differentiated (LEM)

void datavisualizer.DetailedOutputFileSetupParseHandler.characters ( char[]  ch,
int  start,
int  length 
) throws SAXException

Reads character data from the XML file.

Whether or not the data is ignored, and what is done with it if it is not ignored, depends on flags that have been set.

If m_bIsFloat is true, AddNewFloat() is called for m_oTreeSettings. If mp_oTreeMapSettings is null, an error is thrown.

If m_bIsInt is true, AddNewInt() is called for m_oTreeSettings. If mp_oTreeMapSettings is null, an error is thrown.

If m_bIsChar is true, AddNewChar() is called for m_oTreeSettings. If mp_oTreeMapSettings is null, an error is thrown.

If m_bIsBool is true, AddNewFloat() is called for m_oTreeSettings. If mp_oTreeMapSettings is null, an error is thrown.

If m_bIsTimesteps is true, the number of timesteps is sent to m_oManager.

After execution any flag turned on is turned back off.

Parameters:
ch The characters from the XML document.
start - The start position in the array.
length - The number of characters to read from the array.
Exceptions:
SAXException if any of the described cases above is true.

Edit history:
------------------
April 28, 2004: Submitted in beta version (LEM)

void datavisualizer.DetailedOutputFileSetupParseHandler.endElement ( java.lang.String  sURI,
java.lang.String  sLocalName,
java.lang.String  sQName 
) throws SAXException

Called at the end of an XML tag.

Whether or not the data is ignored, and what is done with it if it is not ignored, depends on flags that have been set.

If m_bIsFloat is true, AddNewFloat() is called for m_oTreeSettings. If mp_oTreeMapSettings is null, an error is thrown.

If m_bIsInt is true, AddNewInt() is called for m_oTreeSettings. If mp_oTreeMapSettings is null, an error is thrown.

If m_bIsChar is true, AddNewChar() is called for m_oTreeSettings. If mp_oTreeMapSettings is null, an error is thrown.

If m_bIsBool is true, AddNewFloat() is called for m_oTreeSettings. If mp_oTreeMapSettings is null, an error is thrown.

If m_bIsTimesteps is true, the number of timesteps is sent to m_oManager.

After execution any flag turned on is turned back off.

Parameters:
sURI the Namespace URI (ignored)
sLocalName the local name (what this function looks at)
sQName the qualified (prefixed) name (ignored)
Exceptions:
SAXException if there were problems assigning the data.

Edit history:
------------------
April 28, 2004: Submitted in beta version (LEM)
March 21, 2005: Fixed a bug so that package members could be differentiated (LEM)


Member Data Documentation

DetailedOutputFileManager datavisualizer.DetailedOutputFileSetupParseHandler.m_oManager [private]

Detailed output file manager which owns this parser.

javawrapper.DetailedTreeSettings datavisualizer.DetailedOutputFileSetupParseHandler.m_oTreeSettings = null [private]

Set of tree settings into which to put data.

javawrapper.DetailedGridSettings datavisualizer.DetailedOutputFileSetupParseHandler.m_oGridSettings = null [private]

Set of grid settings into which to put data.

StringBuffer datavisualizer.DetailedOutputFileSetupParseHandler.m_sBuf = new StringBuffer() [private]

String buffer to collect data in our parser.

boolean datavisualizer.DetailedOutputFileSetupParseHandler.m_bIsFloat = false [private]

Indicates the data just parsed is a float data member.

boolean datavisualizer.DetailedOutputFileSetupParseHandler.m_bIsInt = false [private]

Indicates the data just parsed is an int data member.

boolean datavisualizer.DetailedOutputFileSetupParseHandler.m_bIsChar = false [private]

Indicates the data just parsed is a char data member.

boolean datavisualizer.DetailedOutputFileSetupParseHandler.m_bIsBool = false [private]

Indicates the data just parsed is a bool data member.

boolean datavisualizer.DetailedOutputFileSetupParseHandler.m_bIsPackage = false [private]

Indicates that these are grid package values.

boolean datavisualizer.DetailedOutputFileSetupParseHandler.m_bReadingSubplot = false [private]

Indicates that this is a subplot and we are currently reading its area data.


The documentation for this class was generated from the following file:
Generated on Fri Feb 1 07:20:50 2008 for SORTIE Java Interface by  doxygen 1.5.2