Server User Manual

Table Of Contents

88 Developing Applications for J2EE Servers

Editing the JBoss service module deployment descriptor

Once you’ve created a JBoss service module, you edit the module’s deployment

descriptor using JBuilder’s JBoss Service Module DD Editor. To display the editor,

double-click the new service module that appears in the project pane:

Now you can customize the service module deployment descriptor (

jboss-service.xml)

with the values you need for your new service. The JBoss Service Module DD Editor

works just like the other J2EE DD Editors in JBuilder. To learn how to add pages and

edit them in the DD Editor, see Chapter 11, “Editing J2EE deployment descriptors.”

In the structure pane, you can see that there are JBoss-specific nodes for Classpaths,

Local Directories, and MBeans. Add a Classpath, Local Directory, or MBean by right-

clicking the category of the item you are adding and choosing Add on the context menu

that appears. Then double-click that new entry in the structure pane to display a page

for it in the JBoss Service Module DD Editor. For assistance filling in the fields on these

pages, display the page and press F1. You’ll find JBoss documentation useful in filling

in the fields, too.

At any time you can view the

jboss-service.xml descriptor in its source form. Expand

the service module node in the project pane to see the Deployment Descriptors node

and then expand that node too. The

jboss-service.xml node becomes visible. Double-

click it to see the it in the content pane. You can edit the file by hand, if you wish.

MBeans

All JBoss services are in MBeans. So your service module will have one or more

MBeans. Once you’ve added an MBean entry to the module, expand the entry in the

structure pane to see Attributes, Depends Items, and Depends Lists nodes. Add

entries to these categories by right-clicking them and choosing Add. Press F1 for help

filling in the fields.

Starting the server

To prepare to start the server from within JBuilder, create a server runtime

configuration. Follow these steps:

1 Choose Run|Configurations.

2 In the dialog box that appears, click the New button.