OpenESB Studio project clone and build

Prerequisites

We deeply recommend the OpenESB developer to use the latest OpenESB studio to develop, improve and build the OpenESB Studio. The project netbeans-soa has been designed to work easily with NetBeans. Nevertheless, another IDE such as Netbeans or IDEA can be used with few modifications. The latest netbeans-soa code has been built and tested with Studio 3.1.0 or NetBeans 8.2. Using other NetBeans version or IDE is at your own risk.

  • Java JDK 1.8
  • OpenESB Studio 3.1.0 + or Netbeans 8.2

Step 01

Use git to download the OpenESB studio source code from the OpenESB Bitbucket directory https://bitbucket.org/openesb/netbeans-soa.git

Type: git clone https://bitbucket.org/openesb/netbeans-soa.git

Step 02: Command line

Use ANT to build the studio. Go to the netbeans-soa directory, then just type "ant". The studio takes more time than the other part to be built

Step 02: Netbeans

Open the OpenESB studio or NetBeans 8.2 and then load the project “OpenESB Studio Community Edition”. The project can be found in your machine at the root of the OpenESB STUDIO source code. Open the project with the IDE and then clean and build it.

Step 03: Command line

When the first build with ant is successful, the studio must be build a second time to generate binaries. Type "ant build-zip"

The zip file can be found in the directory .../netbeans-soa/dist/

 

Step 03: Netbeans

When the first build is complete, generate the package regarding your need. The OpenESB Studio package can be a Zip file (used by the OpenESB distribution), NetBeans Modules (NBM), a Mac OSx Application or Windows or Linux installers. We advise the user to use the Zip file to be compliant with the OpenESB distribution.

The zip file, the installers for Windows and Linux or Mac OS can be found in the directory .../netbeans-soa/dist/

 

Optional: Add GlassFish AS support to OpenESB studio

OpenESB Community Edition Studio does include a GlassFish support and does not allows direct deployment to the application server. Nevertheless, a additional step allows the GlassFish aficionado to add this feature in OpenESB studio. To get the instruction, click on the GlassFish logo.



Tips to debug OpenESB Studio

Debugging the OpenESB studio is slightly different from a classical Java development, it requires some explanation. To run and debug your development, you must start it from OpenESB or NetBeans.

  • Open the module project you want to debug
  • Put breakpoints in your code
  • Click right on the project and then select debug. Notice that OpenESB Studio switch automatically in the Debug mode.
  • After a while a new instance of the studio opens (don’t run or debug from the root project, it will take more time to Start)
  • Run the feature you want to debug
  • OpenESB studio stops at the breakpoint.

Have a look at the OpenESB documentation for further details on the debugger.