sk.uniba.euromath.gene
Class GeneDataProvider

java.lang.Object
  sk.uniba.euromath.gene.GeneDataProvider

public final class GeneDataProvider
extends Object

Acts as a GENE coordinator. Collects GENE output, instantiates and initializes renderers, and fires events on document change.

Implementation of GENE output handler

The object produces a special tree (using the Coordinator#partialResultEvent(DocumentFragment, NamespacePath, Source, String, CoordinatorInputKey) function), that is processed by the object itself on Coordinator#finishExport() function. This tree is intended to capture the tree structure of nametrees in output document (and renderers, rendering these nametrees).

Each Coordinator#partialResultEvent(DocumentFragment, NamespacePath, Source, String, CoordinatorInputKey) constructs (or updates) a renderer, associates it with the key and produces some elements. These elements must be able to provide:

• a mapping from GENE-providen ID (given to the renderer via the gene-ref PI to the key (we must be able to provide child renderers to a renderer, that uses ID as their identification key), and
• a parent-child relation for renderers, to verify renderers requirements for child renderers.

These nodes are produced:

• ref element - serves for identification of the renderer. Contains attribute id that uniquely identifies key in the renderer tree.
• We must store ids for each child nametree. Thus, each gene-ref PI is copied and placed in child-renderer. This CHILD_RENDERER_ELEMENT_NAME element will contain ID attribute - a copy of gene-ref PI value.

ref element will receive same namespace as the input of the renderer it references. All child child-renderer elements will have same namespace as their parent ref. This will allow GENE to provide correct namespace paths.

Following this algorithm (when GENE resolves all gene-ref PI elements) we receive this document in the Coordinator#finishExport() method: root element is keyref identifying root renderer. Each keyref contains zero or more child-renderer elements, containing ids of children renderers. Each child-renderer contains one keyref element, identifying this renderer, etc.

Author:

Martin Vysny

Nested Class Summary

class

GeneDataProvider.RendererSite Represents the renderer with its environment.

Constructor Summary

GeneDataProvider(RendererSelector selector, XMLAccess xmlAccess, IEditorDataReceiver edr)
Constructor.

Method Summary

ICoordinator	getCoordinator() Returns the coordinator instance - this object receives GENE output.
CoordinatorInfo	getCoordinatorInfo() Returns the coordinator information instance for the GENE coordinator.

Methods inherited from class java.lang.Object

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

Constructor Detail

GeneDataProvider

public GeneDataProvider(RendererSelector selector,
                        XMLAccess xmlAccess,
                        IEditorDataReceiver edr)

Constructor.

Parameters:

selector - the renderer selector.

xmlAccess - the transformed document.

edr - the data receiver.

Method Detail

getCoordinator

public ICoordinator getCoordinator()

Returns the coordinator instance - this object receives GENE output.

Returns:

GENE's coordinator instance.

getCoordinatorInfo

public CoordinatorInfo getCoordinatorInfo()

Returns the coordinator information instance for the GENE coordinator.

Returns:

coordinator info for this coordinator.