Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
VIATRA/Query
VIATRA Incremental Query Wiki Documentation
For the query language, we reuse the concepts of graph patterns (which is a key concept in many graph transformation tools) as a concise and easy way to specify complex structural model queries. High runtime performance is achieved by adapting incremental graph pattern matching techniques based on the Rete algorithm.
We believe the average programmer using EMF models will like EMF-IncQuery for the following reasons:
- declarative queries can be evaluated over EMF without manually traversing the models,
- complex interrelated constellations of EMF objects can be easily formulated as a graph pattern,
- the language is expressive and provides powerful features such as negation or counting,
- graph patterns are composable and reusable,
- queries can be evaluated with great freedom, i.e. input and output parameters can be selected at run-time,
- some frequently encountered shortcomings of EMF’s interfaces are addressed:
- easy and efficient enumeration of all instances of a class regardless of location,
- simple backwards navigation along all kinds of references (even without eOpposite)
- finding objects based on attribute value,
- the incremental query evaluation mechanism offers a significant performance boost when frequently querying complex structural patterns with a moderate amount of modifications in-between (e.g. during continuous validation),
- from the declarative representation of queries, pattern matcher code is generated which can be distributed as Eclipse plug-ins with very few dependencies.
EMF-IncQuery User Documentation
- Developing Incremental Model Queries using the EMF-IncQuery Tooling
- TODO Installing EMF-IncQuery
- TODO A Short Introduction to the Query Language
- TODO Getting started with Query Development
- Advanced topics
- TODO RETE Visualizer
- TODO Local Search Debugger Tooling
- TODO EMF-IncQuery Debugger Tooling (since 0.8.0)
- TODO Finding query evaluation hotspots (since 1.0.0)
- TODO Pure whitelist (since 1.0.0)
- TODO Advanced pattern language constructs
- Using the EMF-IncQuery Runtime library
- Integration Components
- TODO Examples
- TODO EMF-IncQuery in CI Environments (Maven artifacts) (since 0.8.0)
- Reporting bugs or requesting new features
- TODO Issue tracking
- Frequently Asked Questions
- TODO FAQ
Releases
- Version 0.7.0 (Javadoc)
- TODO Migration guide
- TODO Known issues affecting version 0.7.1 fixed in 0.7.2
- Version 0.8.0 (Javadoc)
- TODO New and Noteworthy
- TODO Migration guide
- TODO Known issues affecting version 0.8.1 fixed in 0.8.2
- Version 0.9.0 (Javadoc)
- TODO New and Noteworthy
- Version 1.0.0 (Javadoc)
- TODO New and Noteworthy
- TODO Migration guide
- Version 1.1.0 (Javadoc)
- TODO New and Noteworthy
- TODO Migration guide