sofya.ed.semantic
Class SemanticDataHandler

java.lang.Object
  sofya.base.Handler
      sofya.ed.semantic.SemanticDataHandler

public class SemanticDataHandler
extends Handler

Handler for module description and event dispatch data files used by the semantic event dispatcher.

Version:

06/09/2006

Author:

Alex Kinneer

Field Summary

Fields inherited from class sofya.base.Handler

HANDLER_EXTENSIONS, LINE_SEP

Constructor Summary

SemanticDataHandler()

Method Summary

protected static void	prepareTokenizer(java.io.StreamTokenizer stok) Sets the initial configuration of the stream tokenizer used to read the module description file.
SemanticEventData	readDataFile(java.lang.String fileName) Reads an event dispatch data file.
ModuleDescription	readDescriptionFile(java.lang.String fileName) Reads a module description file.

Methods inherited from class sofya.base.Handler

copyFile, createCacheFile, disableParseNumbers, ensureTagExists, formatSignature, isIntAvailable, isStringAvailable, newCache, openCacheFile, openInputFile, openInputFile, openOutputFile, openOutputFile, parseClass, readInt, readIntIgnoreEOL, readJarClasses, readNextLine, readProgFile, readString, readStringIgnoreEOL, readToEOL, readToNextDataLine, toBinary, toHex

Methods inherited from class java.lang.Object

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

Constructor Detail

SemanticDataHandler

public SemanticDataHandler()

Method Detail

readDescriptionFile

public ModuleDescription readDescriptionFile(java.lang.String fileName)
                                      throws BadFileFormatException,
                                             java.io.IOException

Reads a module description file.

Parameters:

fileName - Path to the description file.

Returns:

An ADT representing the module description contained in the specified file.

Throws:

BadFileFormatException - If the specified module description file is malformed or not a module description file.

java.io.IOException - For any other error that prevents successful reading of the specified module description file.

readDataFile

public SemanticEventData readDataFile(java.lang.String fileName)
                               throws BadFileFormatException,
                                      java.io.IOException

Reads an event dispatch data file.

Parameters:

fileName - Path to the data file.

Returns:

An object which provides access to the event dispatch data.

Throws:

BadFileFormatException - If the specified event dispatch data file is corrupted, invalid, or not an event dispatcn data file.

java.io.IOException - For any other I/O error that prevents reading of the file.

prepareTokenizer

protected static void prepareTokenizer(java.io.StreamTokenizer stok)

Sets the initial configuration of the stream tokenizer used to read the module description file.

Parameters:

stok - Tokenizer attached to the module description file stream.