Web-based textual PCM editor for the next-generation IDE Eclipse Che

Archived due to:

• Main developer not active in this organization
• No dependencies to other projects
• Potential security vulnerabilities
• Not used by others in this organization
• No active development since 2020

This repository aims to automatically generate an Eclipse Che workspace template supporting Palladio domain-specific language(DSL).

It consists of a Palladio DSL support extension for VS Code and the corresponding Eclipse Che devfile generator.

This project is based on the Palladio Language Server.

Usage

Prerequisites

• Java version 8 or higher
• Maven

Generate VS Code extension and Eclipse Che devfile

1. Specify the necessary variables in gradle.properties Where:

   • version: the version of the VS Code extension and the corresponding Eclipse Che plug-in (they have the same version).
   • lsp_download_url: URL of a runable language server generated by Palladio-Addons-TextBasedModelGenerator.
   • vsix_url: URL where you will place the generated vsix file. Need to be set in advance.
   • plugin_yaml_url: URL where you will place the generated palladio-lsp.yaml file. Need to be set in advance.

2. Build the project.

3. Put target/palladio-languageserver.vsix and palladio-devfiles/devfile.yaml on the server and their addresses must be the same as previously set.

Using Palladio DSL workspace

Getting Started with Eclipse Che

Obviously, to use the Palladio support plug-in, you need a running Eclipse Che. Here you can find links on how to get started with Eclipse Che:

• Use Eclipse Che online
• Run Eclipse Che on your own K8S cluster

Using Palladio DSL workspace

There are two ways to use the template. You can import the devfile.yaml or paste its content when creating a new workspace in Eclipse Che.

Or you can create a workspace factory, follow these steps:

1. Log in to Eclipse Che

2. In a web browser, load the following URL: https://<CHE_HOST>/f?url=<DEVFILE_URL> Where:

   • https://<CHE_HOST> specifies the Che Server URL, for example https://che.openshift.io.
   • /f?url= factory mechanism links the Che Server URL to the devfile URL.
   • <DEVFILE_URL> is the URL where you put your devfile.

3. Press Enter and wait for the workspace to initialize. A workspace is created with Eclipse Che Palladio plug-in available.

Example

Create a new text file with the ending .trepo in any project.

Repository textualRepository

import myRepository.*

Types {
    struct MyType  {
        key : STRING
        value : STRING
        type: STRING
    }
    collection MyCollection of STRING
}

Interface IConsumer {
    String invoke (foo: BOOL, bar: BYTE)
    commit
}

Interface IDatabase {
    MyCollection query
}


Component MyConsumer
    provides IConsumer as consumer
    requires IDatabase as database
{
    SEFF on consumer invoke {
        ACQ threadPool
        EXT database -> query
        REL threadPool

  }
  PassiveResource threadPool (10)
}

Development & Continue

To automate the build process, this project use Gradleas build tool initially. But to keep consistent with the Palladio Language Server project, which was built with Maven, I need to run Gradle inside Maven. With reference to this article, I was finally able to invoke Gradle using Maven. In the root directory we have to spefify modules(or subprojects) for both Maven and Gradle.

For more details, please see the README files of the subproject:

• Palladio DSL support extension for VS Code
• Eclipse Che devfile generator