Skip to content

Working with IntelliJ IDEA

Johannes Bachhuber edited this page Dec 30, 2017 · 5 revisions

Installation

You can download IntelliJ here.

Note: We use the Ultimate version (free if you're a student), if you use the community edition some features (e.g. the Run Dashboard) may not be available.

Setting up the project

The repository contains a .idea directory with IntelliJ project files, so you should be able to directly open the repository root. This may take a few minutes the first time as indexes are being built.

Before your first build, you will need to run a full maven build to generate the models from the database. You can do that from the command line by running ./mvnw package from the root directory of the repository.

Using the Run Dashboard

Starting all services

We can run several servers at once by using the Run Dashboard. The repository contains the corresponding configuration, you just need to open the dashboard and click run.

Restarting services

Once you make changes to the view layer or a specific service, you only need to restart that service. To do that, select the service in the dashboard and select one of "Rerun" or "Rerun in debug mode".

Note: If you restarted a service, it helps to also restart the view layer as service discovery is cashed for 30s.

Recompiling sass changes

If you made some changes to the stylesheets (*.scss), you need to recompile them before restarting the view. You can do that by running maven build of the view (./mvnw compile -am -pl view) or by watching the sass files (cd view; gulp watch with gulp-cli installed). The updated stylesheets will be used once you restart the view.

See Working with stylesheets for details.