Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

VIATRA/DeveloperDocumentation/VIATRA Viewers

IncQuery Viewers

IncQuery Viewers is an extension framework for EMF-IncQuery currently under development. The aim of IncQuery Viewers is to provide an easy-to-use, pattern annotation-based approach to support the live visualization of query results in JFace viewers (through content provides and data bindings). In addition to "core" JFace viewers (such as Lists and Trees), IncQuery Viewers will also support the Zest Graph Visualization framework. With IncQuery Viewers, developers will be able to rapidly create rich views for their EMF domain models.

Development outline

  • Current state
    • interpretative strategy
    • build an intermediate ("view") model based on annotated patterns and an instance model, and pass this through a contentprovider
    • supported viewers: JFace ListViewer, JFace TreeViewer, Zest GraphViewer
    • annotations
      • @Item
      • @Edge
      • @ContainsItem
      • @Format
    • model changes are propagated with EMFIncQuery/UserDocumentation/Databinding Incquery databinding
    • IncQuery Sandbox (development UI) added to the main update site (Zest support to extra)

Most important implementation classes

Creating an Internal Model to Display

  • ViewerModel: parses pattern annotations and prepares Observable Lists for Items, Edges and Containments.
    • Item, Edge, Containment: model representation of the various elements
    • *Converters: helper classes to create Items, Edges and Containments from pattern matches
  • ViewerState: a set of Observable Lists - can be reused between various viewers, and can dispose all its observable lists
  • ViewerFilter: filtering support, see below

Adapting JFace Viewers

  • (*)ContentProvider: content providers for various JFace Viewers
  • QueryLabelProvider: label provider with support of parsing label strings
  • ZestLabelProvider: special Query Label provider with formatting support

Basic filtering support

In version 0.7 there is basic support to define filters. The current implementation is not considered final, it should be used with care. Only available programmatically, the Viewers Sandbox does not support this mode of operation.

  • Basic idea: call patterns with bound parameters
    • For each pattern loaded into the ViewerModel
  • Problem: changing the parameter bindings is equivalent of pattern changes -> full reload is required

Remaining tasks

  • generative support (generate content providers)
  • autorefresh on pattern change (rebuild viewer model)
  • revamp devUI
    • make the View fancier
    • activation should happen through the pattern registry
      • (temporary solution: activate annotated patterns within the same resource from a menu item in the Query Registry)
      • Load model (currently contributed to model editors) should be moved to the Query Explorer

Back to the top