Hello Example Project

This page describes creating and testing a Hello World project in Eclipse.  Please refer to the Hello Example documentation page for application architecture and configuration details.

 Creating the project

File -> New -> Project...

On the Next page, enter a project name of "hello". 

If a Mule distribution location has not been previously configured, click on "Configure Default..." and use the "Add Full Distribution..." button to add the location of a Mule 1.4.x installation directory.

In the Mule Project dialog, check "Add content from a Mule distribution sample project" and select "Hello Example" in the combo box.

 
Click Finish.  A hello project will be added to your workspace containing a mule configuration file and the hello example java files.

 Project Libraries

You can view the library jars that have been added to the project build path by going to the project directory in Package Explorer and opening the Mule Libraries folder. 

Right-clicking on the Mule Libraries folder and selecting "Configure..." will bring up a dialog that can be used to add and remove support for Mule modules and transports.  Note that for the Hello project, the spring module and http, stream, tcp and vm transports have been preselected.

 Testing

To run and debug the project, you will first need to create a Mule launch configuration.

In the Run menu select "Open Debug Dialog..."

Select "Local Mule Server" and click the "New Launch Configuration" button.

Give the configuration a name, select the hello project, and select hello-config.xml and click Apply.

 
You are now ready to launch a mule server which loads the hello-config.xml configuration. 
 
Click Debug.  In the Eclipse Console view you will see Mule server's commandline output.
 
Enter a name to execute the hello service.
 

 
Now let's set a breakpoint that will allow us to step through component execution and examine java variables.

Open Greeter.java

Click on the first line of the greet() method.  In the Run menu, select "Toggle Breakpoint".  Alternatively, right-click in the left-hand sidebar, or use Ctrl+Shift+B.

 
Enter a name in the Console.  The breakpoint will be hit and Eclipse will offer to take you into the Debug perspective.  From the Debug view you can step through code and browse thread call stacks.  Variable values will be displayed in the Variables view.
 
To terminate the mule server and your debug session, click the red Terminate button in the Console or Debug view, or use Run | Terminate.