IntelliJ

A rough guide on how to develop molgenis in IntelliJ IDEA. This was created using IntelliJ IDEA 2016.1 Ultimate, courteously provided to us by JetBrains on an open source license. Most of the time we use the latest IntelliJ version.

Middleware

Before you start, make sure the following middleware is installed on your system.

• Java 8 JDK (latest version available from Oracle)
• Maven >= 3.1.0 (The built-in maven version of IntelliJ is too old to compile molgenis.)
• Apache Tomcat 7 or 8
• PostGreSQL server.
• ElasticSearch See quickstart for details

Create a molgenis superuser in postgres.

 create user molgenis superuser password ‘molgenis’;

Create a database called molgenis as user molgenis.

 create database molgenis owner molgenis;

Molgenis settings

You'll need a molgenis-server.properties file. In your home dir, create a folder .molgenis. Put a file in there called molgenis-server.properties and fill it with this information:

    db_user=molgenis  
    db_password=molgenis  
    db_uri=jdbc\:postgresql\://localhost/molgenis
    admin.password=admin  
    user.password=admin

Set the maven home dir in IntelliJ

• Open Preferences, Build Execution Deployment, Maven
• Set the home dir to where your >= 3.1.0 maven installation lives.

Creating the molgenis project

• File, New, Project from version control, Git (or Github)
• Pick https://github.com/molgenis/molgenis.git for the repository URL.
• In the Event log: Non-managed pom.xml file found. Choose "Add as Maven Project". (You'll also see 'JPA framework is detected'. Ignore that.)

You now should have a Project called molgenis with a module for each maven module.

Set the project JDK

Open File, Project Structure. For the entire project:

• (Add and) select Java 8 JDK.
• Set language level to Java 8.

Create maven run configuration

For normal operation, IntelliJ can compile the sources for you. But some classes get generated so you'll need to run the maven build at least once.

• Run, Edit Configurations...
• Press +, add new maven run config, call it molgenis [clean install]
• Set the project location as run directory
• Command line is clean install
• In the tool bar, select the molgenis[clean install] configuration and press the play button. Molgenis now should compile and test. In particular the molgenis-core-ui module may take a while the first time it is run.

Build in IntelliJ

Build, Make project should work fine now and spew out no errors, only warnings.

Java Code Style settings

• In the root folder of the molgenis project, you'll find eclipse-java-molgenis-style.xml. Open Settings, Editor, Code Style, and import it as the molgenis profile. Select it for the molgenis project.

Use MOLGENIS file-templates

• Make sure that your .idea project folder lives inside your molgenis git project root! Only then will we be able to auto-share templates.
• Goto 'New / Edit file templates' and switch from 'Default' to 'Project'-scope.
• Restart IntelliJ after setting the .idea directory and changing the settings

Usage

Adds two file templates for creating Package and EntityType classes. The templates can be accessed from the 'New' menu, when right-clicking a java package:

When choosing EntityType and filling out the form...

... a file is created with the necessary boilerplate:

package org.molgenis.test;

import org.molgenis.data.Entity;
import org.molgenis.data.meta.SystemEntityType;
import org.molgenis.data.meta.model.EntityType;
import org.molgenis.data.support.StaticEntity;
import org.springframework.stereotype.Component;
import org.molgenis.data.AbstractSystemEntityFactory;
import org.molgenis.data.populate.EntityPopulator;

import static java.util.Objects.requireNonNull;
import static org.molgenis.data.meta.model.EntityType.AttributeRole.ROLE_ID;
import static org.molgenis.data.meta.model.Package.PACKAGE_SEPARATOR;
import static org.molgenis.test.PigeonEncounterMetadata.ID;
import static org.molgenis.test.InterestingDataPackage.PACKAGE_INTERESTING_DATA;

@Component
public class PigeonEncounterMetadata extends SystemEntityType
{
    private static final String SIMPLE_NAME = "PigeonEncounter";
    public static final String PIGEON_ENCOUNTER = PACKAGE_INTERESTING_DATA + PACKAGE_SEPARATOR + SIMPLE_NAME;

    public static final String ID = "id";

    private final InterestingDataPackage interestingDataPackage;

    public PigeonEncounterMetadata(InterestingDataPackage interestingDataPackage)
    {
        super(SIMPLE_NAME, PACKAGE_INTERESTING_DATA);
        this.interestingDataPackage = requireNonNull(interestingDataPackage);
    }

    @Override
    public void init()
    {
        setPackage(interestingDataPackage);

        setLabel("Pigeon Encounter");
        //TODO setDescription("");

        addAttribute(ID, ROLE_ID).setLabel("Identifier");
    }
}

public class PigeonEncounter extends StaticEntity
{
    public PigeonEncounter(Entity entity)
    {
        super(entity);
    }

    public PigeonEncounter(EntityType entityType)
    {
        super(entityType);
    }

    public PigeonEncounter(String id, EntityType entityType)
    {
        super(entityType);
        setId(id);
    }

    public void setId(String id)
    {
        set(ID, id);
    }

    public String getId()
    {
        return getString(ID);
    }
}

@Component
public class PigeonEncounterFactory extends AbstractSystemEntityFactory<PigeonEncounter, PigeonEncounterMetadata, String>
{
    PigeonEncounterFactory(PigeonEncounterMetadata pigeonEncounterMetadata, EntityPopulator entityPopulator)
    {
        super(PigeonEncounter.class, pigeonEncounterMetadata, entityPopulator);
    }
}

Sadly, it's not possible to generate multiple files from one template, so the Metadata and Factory classes have to be manually moved to separate files. (Tip: Set your cursor to the class name and use Refactor > Move... or press F6)

Deploy / Run in Tomcat server

• Run, Edit configurations..., +, Tomcat, Local.
• Call it molgenis-app [exploded]
• (Add and) select your Tomcat installation
• VM options: -Dmolgenis.home=<path to dir containing molgenis-server.properties> -Xmx4g -Des.discovery.zen.ping.multicast.enabled=false -Des.network.host=localhost
• Deployment: Select + -> artifact -> molgenis-app:war exploded
• Application context: Select /
• Go back to the first tab, you should now have more options in the update and frame deactivation pulldowns.
• Select On Update: Redeploy, don't ask (This is the action that will triggered when you press the blue reload button in the run view)
• Select On frame deactivation: Update resources (This is the action that will be triggered whenever you tab out of IntelliJ) (If you get update classes and resources to work, let us know!!)
• Select your favorite browser in the pulldown.
• Save the configuration
• In the tool bar, select the molgenis-app [exploded] configuration and press the play button.

This'll build and deploy molgenis to tomcat and open it in the browser. Whenever you tab from molgenis to the browser, all modified resources will be copied to the deployed exploded war. A browser reload should display the changes.

Security

See also the MOLGENIS Security settings

Webpack watch run configuration

• Open molgenis-core-ui/target/classes/js.
• Right-click the dist folder, Mark directory as..., cancel exclusion.
• Open molgenis-core-ui/package.json
• Select the scripts / watch key in the json configuration
• Right-click it and select the NPM create watch option from the menu.
• SaveIn the tool bar, select the npm watch configuration and press the play button to start webpack watch.

Now, whenever you make changes to one or more JavaScript files, the corresponding js bundle file will get rebuilt by the npm watch task. Once it's built, tab out of IntelliJ to trigger a refresh of the exploded war. As soon as IntelliJ loses focus, you'll see a task progress bar in the bottom right corner of IntelliJ. Wait for that task to finish and then refresh the browser. The changes will be loaded.