PCM Development/Getting Started

Aus SDQ-Wiki
Wechseln zu: Navigation, Suche
Dialog-warning.png
The information on this page is deprecated: The manual is outdated. Especially, the source code part is not valid anymore.


Useful hints on PCM development

Getting Started

This article gives initial information of how to change the PCM Bench implementation (Either develop new features for the PCM, fix bugs or change things).
The Palladio sources are managed in a Subversion system and we recommend to use the Subversive Eclipse plugin to access the sources. (Subversive Installation Guide)

The three basic option to work with Palladio code are:

  1. Working with a PCM Installation (recommended)
  2. Working with Source Code Only (Materialise Palladio Core using Buckminster Feature)

Working with a PCM Installation

  1. Install the PCM Nightly as described at PCM_Installation#PCM_Nightly
  2. Only check out and open projects (plugins) you want to change
    • Background information: Installed Eclipse plugins are overwritten by compiled plugins in the Eclipse workspace when compiling and running your changed project code (see below)
  3. Select "Run as Eclipse application"
    • All opened plugin projects will be compiled and integrated in the started Eclipse.
    • Switch to the Java perspective to see the run configuration.

Working with Source Code Only

As an alternative to installing the PCM and some source code (as described at PCM_Installation#PCM_Nightly), you might want to omit the PCM installation and check out the whole source code instead. This is useful if you want to avoid any incompatibilities between installed and checked out PCM plugins, or if you want a full overview over all source code affected by your change. Proceed as follows:

  1. Install a supported Eclipse (2019-06)
  2. Install required Eclipse features:
    1. TODO: Describe required features
  3. Check out the source code from Github
    1. curl -s https://api.github.com/orgs/PalladioSimulator/repos?per_page=200 | perl -ne 'print "$1\n" if (/"ssh_url": "([^"]+)/)' | xargs -n 1 git clone
    2. Import the projects via the import feature for existing projects of Eclipse

Notes:

  1. Ensure that your project is configured to UTF-8 file encoding

Creating PCM model elements from code

You can instantiate one of the model factories, and then use this factory to create model elements defined in the meta model. see Example PCM Model Factories for an example project.

  • de.uka.ipd.sdq.pcm.repository.RepositoryFactory (for repositories, components, interfaces, roles)
  • de.uka.ipd.sdq.pcm.resourcetype.ResourcetypeFactory (for abstract resource types, such as processing or communication resources)
  • de.uka.ipd.sdq.pcm.seff.SeffFactory (for resource demanding service effect specifications)
  • de.uka.ipd.sdq.pcm.system.SystemFactory (for system containers)
  • de.uka.ipd.sdq.pcm.usagemodel.UsagemodelFactory (for user behaviour)
  • ...

Code Overview

If you want to find specific PCM plugins, check the PCM_Code_Overview to find our in which folder in the SVN the plugin is located.

Licenses

A list of the used Licenses in PCM.

See also

Background: Eclipse Plugins, Features and Extension Points