Advanced Guide

The power of Jolorun is that you can create a full Java EE 6 application very easily just by adding some information, and you can also customize it to fit your needs.

Create a customized project

As seen in the Getting Started Guide, you need to set up Jolorun and enter the jolorun create-project command line. This will pop up a form that will let you customize your application.

Complete all the basic information and, instead of creating your project by clicking on Create Project, click on >> to go to the next form. A second screen will show up.

Here you can select the client technologies you want to use and customize your EJB layer:

• Rich client : your application can have a JSF front end as well as a rich client one. That means Jolorun will generate a graphical user interface in Swing, Java FX or Flex that will communicate with the EJB service layer. When you choose to have a rich client, all the Remote check boxes are automatically checked.
• Web tier : if you need a web application, check the JSP and/or JSF boxes, you can then add :
  • WebBeans : uses WebBeans to glue JSF and EJB
  • Servlet : to have row Servlet 3.0
• EJB tier : select the kind of EJBs you want to have. Remember that in Java EE 6 local interfaces are optional.
  • Stateless EJBs : with local and/or remote interfaces
  • Stateful EJBs : with local and/or remote interfaces
  • Singleton EJBs : with local and/or remote interfaces
  • Timer service : generates an EJB using Timer Service
  • Interceptors : adds logging and audit interceptors to the EJBs
  • Asynchronous calls : if you need an EJB with asynchronous calls

On this screen you can add a messaging layer, web services or choose common components :

• JMS & MDB : will generate a JMS producer and an MDB as a consumer on Topics and/or Queues
• Web Services : will generate a WebService client and service
• RESTful service : will generate a REST client and service
• Common components that are part of Jolorun :
  • User management : for secured applications this allows to manage users and roles
  • Email : adds a component to send emails with JavaMail

Jolorun projects are described in an XML format. This XML is stored in the jolorun.xml file once you've clicked on Create Project (or if you use the File -> Save As menu). This file contains all the necessary information to create the same project again. This is very handy when you want to share project skeletons between teams and you want to use the command line. In this case just type the following command :

C:\> jolorun create-project -xml jolorun.xml
Project MyProject generated at C:\Tools\Project

At any time during the customization of your project, you can save the XML file, get some help or quit Jolorun user interface by using the menu.