diva.sketch.recognition

Class MSTrainingParser

java.lang.Object

diva.util.aelfred.HandlerBase

diva.sketch.recognition.MSTrainingParser

All Implemented Interfaces:

XmlHandler, ModelParser

public class MSTrainingParser
extends HandlerBase
implements ModelParser

MSTrainingParser (Multi-Stroke Training Parser) reads in an XML file and parses it into a MSTrainingModel. The XML file should conform to multiStrokeTrain.dtd format so that it can be parsed correctly.

Version:

$Revision: 1.2 $

Author:

Heloise Hse (hwawen@eecs.berkeley.edu)

Field Summary

Fields

Modifier and Type	Field and Description
static String	DTD_1 The DTD for sketch files.
static String	DTD_URL The URL where the DTD is stored.
static String	EXAMPLE_TAG Indicate an example.
static String	LABEL_TAG Indicate the label (positive or negative) for an example.
static String	MODEL_TAG Indicate that the file contains a training model.
static String	NAME_TAG Indicate the name of a type.
static String	NUM_STROKE_TAG Indicate the number of strokes in an example.
static String	POINTS_TAG Indicate a set of points in a stroke.
static String	PUBLIC_ID The public identity of the sketch dtd file.
static String	STROKE_TAG Indicate a stroke path.
static String	TYPE_TAG Indicate a type in the training model.
static String	VERSION_TAG Indicate the version of this training model.

Constructor Summary

Constructors

Constructor and Description
MSTrainingParser()

Method Summary

Modifier and Type	Method and Description
void	attribute(String name, String value, boolean isSpecified) Handle an attribute value assignment.
void	endElement(String name) Handle the end of an element.
Object	parse(Reader reader) Create the full path string for the url and parses the file into a MSTrainingModel object.
Object	resolveEntity(String publicID, String systemID) Resolve an external entity.
void	startElement(String name) Handle the start of an element.

Methods inherited from class diva.util.aelfred.HandlerBase

charData, doctypeDecl, endDocument, endExternalEntity, error, ignorableWhitespace, processingInstruction, startDocument, startExternalEntity

Methods inherited from class java.lang.Object

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

Field Detail

PUBLIC_ID

public static final String PUBLIC_ID

The public identity of the sketch dtd file.

See Also:

Constant Field Values

DTD_URL

public static final String DTD_URL

The URL where the DTD is stored.

See Also:

Constant Field Values

DTD_1

public static final String DTD_1

The DTD for sketch files.

See Also:

Constant Field Values

MODEL_TAG

public static final String MODEL_TAG

Indicate that the file contains a training model.

See Also:

Constant Field Values

VERSION_TAG

public static final String VERSION_TAG

Indicate the version of this training model.

See Also:

Constant Field Values

TYPE_TAG

public static final String TYPE_TAG

Indicate a type in the training model.

See Also:

Constant Field Values

NAME_TAG

public static final String NAME_TAG

Indicate the name of a type.

See Also:

Constant Field Values

EXAMPLE_TAG

public static final String EXAMPLE_TAG

Indicate an example.

See Also:

Constant Field Values

LABEL_TAG

public static final String LABEL_TAG

Indicate the label (positive or negative) for an example.

See Also:

Constant Field Values

NUM_STROKE_TAG

public static final String NUM_STROKE_TAG

Indicate the number of strokes in an example.

See Also:

Constant Field Values

POINTS_TAG

public static final String POINTS_TAG

Indicate a set of points in a stroke.

See Also:

Constant Field Values

STROKE_TAG

public static final String STROKE_TAG

Indicate a stroke path.

See Also:

Constant Field Values

Constructor Detail

MSTrainingParser

public MSTrainingParser()

Method Detail

attribute

public void attribute(String name,
                      String value,
                      boolean isSpecified)

Handle an attribute value assignment.

Specified by:

attribute in interface XmlHandler

Overrides:

attribute in class HandlerBase

value - The value of the attribute, or null if the attribute is #IMPLIED.

isSpecified - True if the value was specified, false if it was defaulted from the DTD.

See Also:

com.microstar.xml.XmlHandler#attribute

startElement

public void startElement(String name)

Description copied from class: HandlerBase

Handle the start of an element.

The default implementation does nothing.

Specified by:

startElement in interface XmlHandler

Overrides:

startElement in class HandlerBase

Parameters:

name - The element type name.

See Also:

XmlHandler.startElement(java.lang.String)

endElement

public void endElement(String name)

Handle the end of an element.

Specified by:

endElement in interface XmlHandler

Overrides:

endElement in class HandlerBase

Parameters:

name - The element type name.

See Also:

com.microstar.xml.XmlHandler#endElement

parse

public Object parse(Reader reader)
             throws Exception

Create the full path string for the url and parses the file into a MSTrainingModel object.

Specified by:

parse in interface ModelParser

Throws:

Exception

resolveEntity

public Object resolveEntity(String publicID,
                            String systemID)

Resolve an external entity. If the first argument is the name of the MoML PUBLIC DTD ("-//UC Berkeley//DTD train 1//EN"), then return a StringReader that will read the locally cached version of this DTD (the public variable DTD_1). Otherwise, return null, which has the effect of deferring to Ælfred for resolution of the URI. Derived classes may return a a modified URI (a string), an InputStream, or a Reader. In the latter two cases, the input character stream is provided.

Specified by:

resolveEntity in interface XmlHandler

Overrides:

resolveEntity in class HandlerBase

Parameters:

publicId - The public identifier, or null if none was supplied.

systemId - The system identifier.

Returns:

Null, indicating to use the default system identifier.

See Also:

XmlHandler.resolveEntity(java.lang.String, java.lang.String)