org.griphyn.cPlanner.parser.dax
Interface Callback

All Known Implementing Classes:

DAX2CDAG, DAX2Graph, DAX2LabelGraph, DAX2Metadata, DAX2NewGraph

public interface Callback

This interfaces defines the callback calls from DAX parsing. A slim and memory-efficient parser of DAX is expected to implement these callbacks, and generate its own information on the fly.

Version:

$Revision: 50 $

Author:

Karan Vahi, Jens-S. V??ckler

Method Summary

void	cbDocument(Map attributes) Callback when the opening tag was parsed.
void	cbDone() Callback when the parsing of the document is done.
void	cbJob(SubInfo job) Callback for the job from section 2 jobs.
void	cbParents(String child, List parents) Callback for child and parent relationships from section 3.
Object	getConstructedObject() Return a object that is constructed during the parsing of the object.

Method Detail

getConstructedObject

Object getConstructedObject()

Return a object that is constructed during the parsing of the object. The type of the object that is constructed is determined by the implementing callback handler. For example, it could be an Adag object used by Pegasus or a map containing the graph structure of the dax. The implementing classes should keep a boolean flag that signifies whether the corresponding object has been created by the implementing class or not. The variable should be set when the implementing callback handler deems that it has enough data to construct that object.

cbDocument

void cbDocument(Map attributes)

Callback when the opening tag was parsed. This contains all attributes and their raw values within a map. This callback can also be used to initialize callback-specific resources.

Parameters:

attributes - is a map of attribute key to attribute value

cbJob

void cbJob(SubInfo job)

Callback for the job from section 2 jobs. These jobs are completely assembled, but each is passed separately.

Parameters:

job - is the DAX-style job.

cbParents

void cbParents(String child,
               List parents)

Callback for child and parent relationships from section 3.

Parameters:

child - is the IDREF of the child element.

parents - is a list of IDREFs of the included parents.

cbDone

void cbDone()

Callback when the parsing of the document is done. While this state could also be determined from the return of the invocation of the parser, that return may be hidden in another place of the code. This callback can be used to free callback-specific resources.