utils.ptplot5_2.ptolemy.plot.plotml
Class PlotMLParser

java.lang.Object
  |
  +--utils.ptplot5_2.com.microstar.xml.HandlerBase
        |
        +--utils.ptplot5_2.ptolemy.plot.plotml.PlotBoxMLParser
              |
              +--utils.ptplot5_2.ptolemy.plot.plotml.PlotMLParser
All Implemented Interfaces:
XmlHandler
Direct Known Subclasses:
HistogramMLParser

public class PlotMLParser
extends PlotBoxMLParser

This class constructs a plot from specifications in PlotML (Plot Markup Language), which is an XML language. This class supports extends the base class to support the subset that applies to the Plot class. It ignores unrecognized elements in the DTD. The class contains an instance of the Microstar Ælfred XML parser and implements callback methods to interpret the parsed XML. The way to use this class is to construct it with a reference to a Plot object and then call its parse() method.

Since:
Ptolemy II 0.4
Version:
$Id: PlotMLParser.html,v 1.1.1.1 2003/07/10 12:20:41 dsagnol Exp $
Author:
Edward A. Lee

Field Summary
 
Fields inherited from class utils.ptplot5_2.ptolemy.plot.plotml.PlotBoxMLParser
PlotML_DTD_1
 
Constructor Summary
PlotMLParser(Plot plot)
          Construct an parser to parse commands for the specified plot object.
 
Method Summary
 void endElement(java.lang.String elementName)
          End an element.
 void startDocument()
          Start a document.
 void startElement(java.lang.String elementName)
          Start an element.
 
Methods inherited from class utils.ptplot5_2.ptolemy.plot.plotml.PlotBoxMLParser
attribute, charData, endDocument, error, parse, parse, parse, resolveEntity, startExternalEntity
 
Methods inherited from class utils.ptplot5_2.com.microstar.xml.HandlerBase
doctypeDecl, endExternalEntity, ignorableWhitespace, processingInstruction
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

PlotMLParser

public PlotMLParser(Plot plot)
Construct an parser to parse commands for the specified plot object.

Parameters:
plot - The plot object to which to apply the commands.
Method Detail

endElement

public void endElement(java.lang.String elementName)
                throws java.lang.Exception
End an element. This method calls the appropriate Plot methods. Ælfred will call this method at the end of each element (including EMPTY elements).

Specified by:
endElement in interface XmlHandler
Overrides:
endElement in class PlotBoxMLParser
Parameters:
elementName - The element type name.
java.lang.Exception

startDocument

public void startDocument()
Start a document. This method is called just before the parser attempts to read the first entity (the root of the document). It is guaranteed that this will be the first method called.

Specified by:
startDocument in interface XmlHandler
Overrides:
startDocument in class PlotBoxMLParser
See Also:
com.microstar.xml.XmlHandler#startDocument

startElement

public void startElement(java.lang.String elementName)
                  throws XmlException
Start an element. This is called at the beginning of each XML element. By the time it is called, all of the attributes for the element will already have been reported using the attribute() method. Unrecognized elements are ignored.

Specified by:
startElement in interface XmlHandler
Overrides:
startElement in class PlotBoxMLParser
Parameters:
elementName - The element type name.
Throws:
XmlException - If the element produces an error in constructing the model.