Jump to: navigation, search

Difference between revisions of "EMFIncQuery"

(EMF-IncQuery User Documentation)
 
(19 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
= EMF-IncQuery Wiki Documentation =
 
= EMF-IncQuery Wiki Documentation =
  
These are the (work-in-progress) wiki pages for the EMF-IncQuery project. At the moment, much of the EMF-IncQuery documentation resides on IncQuery.net, this will change as the development of this wiki progresses.
+
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.
  
== Quick pointers ==
+
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.
  
*[http://eclipse.org/incquery Eclipse.org project website]
 
*[http://incquery.net IncQuery.net portal]
 
*[http://incquery.net/incquery/getting_started Getting Started]
 
*[http://incquery.net/incquery/documentation User Documentation]
 
*[http://incquery.net/incquery/devguide Developer Documentation]
 
*[http://incquery.net/incquery/examples Examples]
 
  
 
== EMF-IncQuery User Documentation ==
 
== EMF-IncQuery User Documentation ==
Line 17: Line 23:
 
** [[EMFIncQuery/UserDocumentation/QueryLanguage|A Short Introduction to the Query Language]]
 
** [[EMFIncQuery/UserDocumentation/QueryLanguage|A Short Introduction to the Query Language]]
 
** [[EMFIncQuery/UserDocumentation/RETE_Visualizer|RETE Visualizer]]
 
** [[EMFIncQuery/UserDocumentation/RETE_Visualizer|RETE Visualizer]]
 +
** [[EMFIncQuery/UserDocumentation/DebuggerTooling|EMF-IncQuery Debugger Tooling]] (since 0.8.0)
 
* Using the EMF-IncQuery Runtime library
 
* Using the EMF-IncQuery Runtime library
 
** [[EMFIncQuery/UserDocumentation/HeadlessExecution|Headless (standalone) execution of EMF-IncQuery queries and unit tests]]
 
** [[EMFIncQuery/UserDocumentation/HeadlessExecution|Headless (standalone) execution of EMF-IncQuery queries and unit tests]]
 
** [[EMFIncQuery/UserDocumentation/API|API documentation]]
 
** [[EMFIncQuery/UserDocumentation/API|API documentation]]
 
** [[EMFIncQuery/UserDocumentation/API/Advanced|Advanced API features]]
 
** [[EMFIncQuery/UserDocumentation/API/Advanced|Advanced API features]]
 +
** [[EMFIncQuery/UserDocumentation/API/RunOnce|Run once querying API documentation]]
 +
** [[EMFIncQuery/UserDocumentation/API/BaseIndexer|IncQuery Base Indexer]]
 
** [[EMFIncQuery/UserDocumentation/AdvancedPatterns|Advanced pattern language constructs]]  
 
** [[EMFIncQuery/UserDocumentation/AdvancedPatterns|Advanced pattern language constructs]]  
 
* Integration Components
 
* Integration Components
Line 27: Line 36:
 
** [[EMFIncQuery/UserDocumentation/Query_Based_Features|Defining Query-based Features]]
 
** [[EMFIncQuery/UserDocumentation/Query_Based_Features|Defining Query-based Features]]
 
** [[EMFIncQuery/UserDocumentation/IncQuery_Viewers|IncQuery Viewers]]
 
** [[EMFIncQuery/UserDocumentation/IncQuery_Viewers|IncQuery Viewers]]
 +
* [[EMFIncQuery/UserDocumentation/Examples|Examples]]
 +
* [[EMFIncQuery/UserDocumentation/Build|EMF-IncQuery in CI Environments]] (since 0.8.0)
 +
* Reporting bugs or requesting new features
 +
** [[EMFIncQuery/UserDocumentation/IssueTracking|Issue tracking]]
  
 
== Contributors Guide ==
 
== Contributors Guide ==
  
* [[EMFIncQuery/DeveloperDocumentation|Developer's Documentation]]
+
* Developer's Documentation
 
** [[EMFIncQuery/DeveloperDocumentation/DevEnvironment|Setting up the Development Environment]]
 
** [[EMFIncQuery/DeveloperDocumentation/DevEnvironment|Setting up the Development Environment]]
 
** [[EMFIncQuery/DeveloperDocumentation/BuildConfig|The EMF-IncQuery Build Configuration]]
 
** [[EMFIncQuery/DeveloperDocumentation/BuildConfig|The EMF-IncQuery Build Configuration]]
 +
** [[EMFIncQuery/DeveloperDocumentation/IssueTracking|Issue Reporting and Management]]
 
* Documentation
 
* Documentation
 
** [[EMFIncQuery/DeveloperDocumentation/Model_connectors|Model Connectors]]
 
** [[EMFIncQuery/DeveloperDocumentation/Model_connectors|Model Connectors]]
 
** [[EMFIncQuery/DeveloperDocumentation/IncQuery_Viewers|IncQuery Viewers]]
 
** [[EMFIncQuery/DeveloperDocumentation/IncQuery_Viewers|IncQuery Viewers]]
 
** [[EMFIncQuery/DeveloperDocumentation/EventDrivenVM|Event-driven Virtual Machine]]
 
** [[EMFIncQuery/DeveloperDocumentation/EventDrivenVM|Event-driven Virtual Machine]]
 +
** [[EMFIncQuery/DeveloperDocumentation/Builder|Builder Architecture]]
 +
** [[EMFIncQuery/DeveloperDocumentation/IncQueryXcore|Notes on IncQuery & Xcore integration]]
 
* Developer Meeting Minutes
 
* Developer Meeting Minutes
 
** [[EMFIncQuery/DeveloperMeetingMinutes|Meeting minutes]]
 
** [[EMFIncQuery/DeveloperMeetingMinutes|Meeting minutes]]
 
  
 
== Releases ==
 
== Releases ==
* Version 0.7.0
+
* Version 0.7.0 ([https://www.eclipse.org/incquery/javadoc/releases/0.7.0/ Javadoc])
 
** [[EMFIncQuery/Releases/MigrateTo0.7|Migration guide]]
 
** [[EMFIncQuery/Releases/MigrateTo0.7|Migration guide]]
 +
** Known issues affecting version 0.7.1 [[EMFIncQuery/Releases/KnownIssuesFor0.7.1|fixed in 0.7.2]]
 +
* Version 0.8.0 ([https://www.eclipse.org/incquery/javadoc/releases/0.8.0/ Javadoc])
 +
** [[EMFIncQuery/Releases/NewAndNoteWorthy0.8|New and Noteworthy]]
 +
** [[EMFIncQuery/Releases/MigrateTo0.8|Migration guide]]
  
 
[[Category:EmfIncQuery]]
 
[[Category:EmfIncQuery]]

Latest revision as of 09:34, 11 July 2014

EMF-IncQuery 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

Contributors Guide

Releases