Domain-Specific Language Implementation for Conceptual Modeling of Relational Databases
Requirements (for development and/or use)
-
Openjdk version "11.0.7" 2020-04-14
-
OpenJDK Runtime Environment (build 11.0.7+10-post-Ubuntu-3ubuntu1)
-
OpenJDK 64-Bit Server VM (build 11.0.7+10-post-Ubuntu-3ubuntu1, mixed mode, sharing)
-
Eclipse IDE 2020-03 or newer.
-
Xtext 2.17.0 or newer.
Project Building
-
You can fork the repository, creating your local copy. Forking a repository allows you to freely experiment changes without affecting the original project.
-
Alternatively, you can clone this project directly with a simple command:
$ git clone https://github.com/ProjetoDSL/ERDSL.git
-
To build the project, you need to start the Eclipse IDE and open the directory containing the project.
-
There will be 5 more subprojects, the majority of the implementation manually made being contained in the subdirectories.
/org.xtext.unipampa.erdsl/src/org/xtext/unipampa/erdsl
/org.xtext.unipampa.erdsl/src/org/xtext/unipampa/erdsl/generator
/org.xtext.unipampa.erdsl/src/org/xtext/unipampa/erdsl/scoping
/org.xtext.unipampa.erdsl/src/org/xtext/unipampa/erdsl/validation
-
If you want to change some aspect of the grammar of the language, go to:
/org.xtext.unipampa.erdsl/src/org/xtext/unipampa/erdsl/ErDsl.xtext
5.1.After changes or additions, right click ErDsl.xtext file.
5.2. In the context menu select Run As >> Generate Xtext Artifacts.
-
If you want to change any aspect of the generator responsible for the transformation between the models, go to:
/org.xtext.unipampa.erdsl/src/org/xtext/unipampa/erdsl/generator/ErDslGenerator.xtend
-
To generate the language plugin go to the top bar menu:
7.1. Click in File >> Export .
7.2. Type "plugin" in the wizard.
7.3. Select Deployable plugins and fragments.
7.4. For the options that appear, generate at least the plug-in for:
org.xtext.unipampa.erdsl
org.xtext.unipampa.erdsl.ide
org.xtext.unipampa.erdsl.ui
Using the Generated Plugin
-
Move the set of generated plugins in your Eclipse's plugin folder (/eclipse/plugins).
-
Open the Eclipse IDE with a new workspace.
-
Start a empty java project.
-
Create a file with the .erdsl extension in src directory
-
If asked by IDE if you want to change the view mode to the xtext context, accept.
-
Start building your model.
-
When you finish your model, see if the IDE validates it and then save.
-
Look at the src-gen directory and see the generated .html file, the result of transforming the conceptual model into a logical model.
Contributions, suggestions, and bug reports are extremely welcome - please create an issue or contact the maintainer.
Initially made by Jonnathan of LESSE research group. This project is licensed under the EPL-2.0 license.