Jbpm Plugin For Eclipse Luna

The Jbpm Plugin For Eclipse Luna is a plugin that improves the process management in Eclipse by a result of the usage of the TimeLine Modeler. The goal of this lab project is to support the concept of JBPM (Java Business Process Management)

The Jbpm for Eclipse Luna plugin is an extension to the JBoss Developer Studio that provides a development environment for your Jbpm5 Projects. Discovered and created by Peter Mühlbauer from BPMN Germany Solutions and Thomas Eggenschwiler from MTEC Software.

Today I will tell you about an awesome plugin for eclipse luna called jbpm. This tutorial is meant for JBPM 7.1 plugin. It has many amazing features like custom actions and listeners, new attribute creation and so on. Follow me to find out the amazing things this plugin can do to enhance your functionality.

Jbpm Plugin For Eclipse Luna

19.1. jBPM Eclipse Plugin

he jBPM Eclipse plugin provides developers (and very technical users) with an environment to edit and test processes, and integrate it deeply with their applications. It provides the following features (on top of the Eclipse IDE):

  • Wizards for creation of
    • a jBPM project
    • a BPMN2 process
  • jBPM Perspective (showing the most commonly used views in a predefined layout)
  • Kie Navigator View for managing Kie Server installations and projects

19.1.1. Installation

The jBPM installer is capable of downloading and installing an Eclipse installation, including the Drools and jBPM Eclipse plugin (with a full jBPM runtime preconfigured) and the Eclipse BPMN2 Modeler.

Tip

Using the jBPM installer is definitely the recommended starting point for most users.

You can however also download and install the jBPM Eclipse Plugin manually. To do so, you need to:

  • Download Eclipse (Kepler recommended, but older versions like Indigo or Juno should also still work)
  • Start Eclipse
  • Select “Install New Software …” from the Help menu. Add the Drools and jBPM update site http://downloads.jboss.org/jbpm/release/6.0.1.Final/updatesite/. You should see the plugins as shown below. Note that you can also download and unzip the Drools and jBPM update site to your local file system and use that as local update site instead.Figure 19.1. 
    Select the JBoss jBPM Core and JBoss Drools Core plugins and click “Next >”. Click “Next >” again after reviewing your selecting, accept the terms of the license agreement and click “Finish” to download and install the plugins. If you get a warning about installing software that contains unsigned content, click OK. After successful installation, Eclipse should ask you to restart, click Yes.
  • The plugin should now be installed. To check, check if you can for example see the new jBPM Project wizard: under the “File” menu, select “New Project …” and there you should be able to see “New jBPM Project” under the jBPM category.
  • Register a jBPM runtime to get started, see the section on jBPM runtimes in this chapter for more information.

Note that, when doing a manual install, you still need to manually install the Eclipse BPMN 2.0 Modeler plugin as well. Check out the chapter on the Eclipse BPMN 2.0 Modeler on how to do that.

19.1.2. jBPM Project Wizard

The aim of the new project wizard is to set up an executable sample project to start using processes immediately. This will set up a basic structure, the classpath, sample process and a test case to get you started. To create a new jBPM project, in the “File” menu select “New” and then “Project …” and under the jBPM category, select “jBPM Project”. A dialog as shown below should pop up.

Figure 19.2. 

Fill in a name for your project and if necessary change the location where this project should be located (by default Eclipse will generate it inside your Eclipse workspace folder) and click “Next >”.

Now you can optionally include a sample process in your project to get started. You can select to either use a simple “Hello World” process, a slightly more advanced process including human tasks and persistence or simply an empty project. You can also select to include a JUnit test class that you can use to test your process. These can serve as a starting point, and will give you something executable almost immediately, which you can then modify to your needs.

Figure 19.3. 

Finally, the last page in the wizard allows you select a jBPM runtime, as shown below. You can either use the default runtime (as configured for you workspace, in your workspace preferences), or you can select a specific runtime for this project. For more information about runtimes and how to create them, see the section on jBPM runtimes in this chapter.

You can also select which version of jBPM you want to generate sample code for. By default it will generate an example using the latest jBPM 6.x API, but you could also generate examples using the old jBPM 5.x API. Note that you yourself are responsible for making sure that the code you generate can be understood by the runtime (for example, if you create an example using jBPM6 API but select a jBPM5 runtime, your sample will not compile). Also note that, if you want to execute a jBPM5 example on jBPM6, you will need to have the knowledge-api JAR inside your jBPM6 runtime, as this is responsible for the backwards compatibility of the jBPM5 API in jBPM6.

Figure 19.4. 

When you selected the simple ‘hello world’ example, the result is shown below. Feel free to experiment with the plug-in at this point.

Figure 19.5. New jBPM project artifacts

New jBPM project artifacts

The newly created project contains an example process file (sample.bpmn) in the src/main/resources directory and an example Java file (ProcessTest.java) that can be used to test the process in a jBPM engine. You’ll find this in the folder src/main/java, in the com.sample package. All the other JARs that are necessary during execution are also added to the classpath in a custom classpath container called jBPM Library.

You can also convert an existing Java project to a jBPM project by selecting the “Convert to jBPM Project” action. Right-click the project you want to convert and under the “Configure” category (at the bottom) select “Convert to jBPM Project”. This will add the jBPM Library to your project’s classpath.

19.1.3. New BPMN2 Process Wizard

You can create a new process simply as an empty text file with extension “.bpmn”, or use the “New BPMN2 Process” wizard to do so. To create a new process, in the “File” menu select “New” and then “Other …” and under the jBPM category, select “BPMN2 Process” and click “Next >”. In the next dialog, you should select the folder where the process should be created (for example the src/main/resources folder of your project) and a name for the process. Clicking “Finish” should create your new process (by default it should only contain one start node) and open it so you can start editing it.

19.1.4. jBPM Runtime

A jBPM runtime is a collection of JAR files that represent one specific release of the jBPM project JARs. To create a runtime, download the binary distribution of the version of jBPM you want to use and unzip on your local file system. You must then point the IDE to the release of your choice by selecting the folder where these JARs are located. If you want to create a new runtime based on the latest jBPM project JARs included in the plugin itself, you can also easily do that. You are required to specify a default jBPM runtime for your Eclipse workspace, but each individual project can override the default and select the appropriate runtime for that project specifically.

19.1.4.1. Defining a jBPM Runtime

To define one or more jBPM runtimes using the Eclipse preferences view you open up your Preferences, by selecting the “Preferences” menu item in the menu “Window”. A “Preferences” dialog should show all your settings. On the left side of this dialog, under the jBPM category, select “Installed jBPM runtimes”. The panel on the right should then show the currently defined jBPM runtimes. For example, if you used the jBPM Installer, it should look like the figure below.

To define a new jBPM runtime, click on the “Add” button. A dialog such as the one shown below should pop up, asking for the name of your runtime and the location on your file system where it can be found.

You can change the runtime of a jBPM project at any time by opening the project properties and selecting the jBPM category, as shown below. Mark the “Enable project specific settings” checkbox and select the appropriate runtime from the drop-down box. If you click the “Configure workspace settings …” link, the workspace preferences showing the currently installed jBPM runtimes will be opened, so you can add new runtimes there. If you deselect the “Enable project specific settings” checkbox, it will use the default runtime as defined in your global workspace preferences.

You can change the runtime of a jBPM project at any time by opening the project properties and selecting the jBPM category, as shown below. Mark the “Enable project specific settings” checkbox and select the appropriate runtime from the drop-down box. If you click the “Configure workspace settings …” link, the workspace preferences showing the currently installed jBPM runtimes will be opened, so you can add new runtimes there. If you deselect the “Enable project specific settings” checkbox, it will use the default runtime as defined in your global workspace preferences.

Leave a Comment