Clicking Next brings us to the wizard page where it's necessary to specify the folder, name and version for the file. We choose, for example, jboss-esb.xml as the name and accept the selected projects folder and default version.

Figure 2.2. Folder, Name and Version

Thus, our file will be created in the selected projects folder by default. If you want to change the folder for your future file click Browse... button to set needed folder or simply type it.

Clicking on Finish results in the file being generated. The wizard creates one xml file.

Chapter 3. ESB Editor

3.1. ESB File Editor

3.2. ESB Editors Features

3.2.1. ESB syntax validation
3.2.2. Support for XML Schema
3.2.3. Content Assist for ESB XML file
3.2.4. Synchronized Source and Visual Editing

ESB editor has lots of useful features, they are described in details in this chapter. In addition you'll get to know with how ESB Editor uses combined visual and source editing of esb files.

3.1. ESB File Editor

ESB File Editor is a powerful and customizable tool. ESB File Editor allows developing an application using ESB technology.

ESB file editor has two tabs: Tree and Source.

You can switch to Tree. The Tree view for the editor displays all ESB artifacts in a tree format. By selecting any node you can see and edit its properties which will appear in the right-hand area. For example, a Provider:

Figure 3.1. Tree View

You can easily switch from Tree to Source by selecting the Source tab at the bottom of the editor and work in Source view.

Figure 3.2. Source View

The Source view for the editor displays a text content of the ESB file. It is always synchronized with Tree view, so any changes made in one of the views will immediately appear in the other.

No matter what view you select, you get full integration with Outline view. For example, you can work in the Source view with the help of the Outline view. The Outline view shows a tree structure of the ESB file. Simply select any element in the Outline view and it will jump to the same place in the Source editor, so you can navigate through the source code with Outline view.

Figure 3.3. Outline View

Adding, editing or deleting of some artifacts operations are available right in the Tree view . Right-click any node and select one of the available actions in the context menu. For example, you can easily add a new Provider:

Figure 3.4. Adding New Provider

You can easily add a new Service too:

Figure 3.5. Adding New Service

The same way you can create a listener for service and other elements of ESB:

Figure 3.6. Adding New Listener for Service

The same actions can be done in the right part of Tree view tab (Form editor) using Add, Edit and Remove buttons.

In order to add a new generic Action to your ESB XML file you should select the Actions node under the Services, then right-click and choose New > Generic Action.

Figure 3.7. Adding New Action in the Tree View

Or instead make use of Add... button in the Form editor on the left.

Figure 3.8. Adding New Action in the Form Editor

As you can see on the bath figures above, the context menu will also prompt you to insert one of the Actions that are supplied out-of-the-box with JBoss ESB. After choosing one an appeared New Action wizard will ask you to fill out a name field and other fields specific for each Action property. For example, for Content Based Router Action the wizard looks as follows:

Figure 3.9. New Action Wizard

After confirming creating the Action you can see it in the Tree under the Actions node and preview as well as edit its settings in the Form editor on the left.