Application Client Deployment Descriptor editor

The Application Client deployment descriptor editor is organized with scrollable pages and collapsible sections that represent the various properties and settings that can be defined in the deployment descriptor (application-client.xml) and other extensions and bindings files. The editor is dynamic, and sections and pages are created based on the Application Client deployment descriptor version and the workbench capabilities preferences. To open the editor, right click the deployment descriptor for your project and select Open With > Deployment Descriptor Editor.

The core function is typically located at the top of the page. The extensions and bindings are typically nested sections at the bottom of the editor pages. Collapsing a section hides the content, but leaves the heading information. This is useful in filtering through the data and properties on each page.

Depending on the properties of the project and the enabled capabilities, the Application Client deployment descriptor editor typically helps you to modify the following resources:

application-client.xml
ibm-application-client-bnd.xmi
ibm-application-client-ext.xmi
ibm-application-client-ext-pme.xml

The Application Client deployment descriptor editor typically displays the following pages:

Overview page

The Overview page in the Application Client editor provides a quick summary of the contents in the Application Client deployment descriptor. This page includes the following sections:

General Information section: Use the General Information section to view and edit the display name and description for the application Application Client.
References section: The References section shows the currently defined references and links you to the References page of the editor.
Environment Variables: Use the Environment Variables section to define environment variables for the application Application Client module.
Icons section: Use the Icons section to choose icons that represent your Application Client application. These icons are used for identification on the server. In order to use an icon, you must first import the graphic file into the enterprise application project (it must be contained inside the EAR file in order for it to be found at deploy time). Once the file has been imported into the project, you can select it within the icon dialog on the Application Client deployment descriptor editor. If you do not import the file into the project, you do not see any icons within the dialogs.
Main Class section: Use the Main Class section to edit or refresh the Main Class for the application client. Clicking Edit opens the Manifest editor where the Main Class attribute is defined. Clicking Refresh forces an update of the field in the application client editor.
Callback Handler: For J2EE 1.3 and 1.4 only, use the Callback Handler section to specify the class that the application client uses for handling callback.
WebSphere® Extensions: This section shows additional extension properties that you can define specifically for the WebSphere Application Server. For example, you could specify whether you want to allow JTA demarcation.
Message Driven Destinations: Use this section to define a message driven destination for the application client. Message driven destinations are elements that specify logical message destinations within an application.

References page

Use the References page to define references for the application client deployment descriptor. See Defining references for J2EE modules for more information.

On this page, you can also define a JNDI name for the reference. This is a WebSphere Application Server binding property. For more information, see the WebSphere Application Server documentation.

WS Extension page

For J2EE 1.4 project only, use this page to define Web service client security extensions for WebSphere Application Server.

WS Binding page

For J2EE 1.4 project only, use this page to define Web service client bindings for WebSphere Application Server.

WS Handler page

For J2EE 1.3 and 1.4 project only, use the Handlers page to define Web service handlers for each Web service reference that is defined for the enterprise beans in the EJB module. See Defining Web service handlers for more information.

Extended Services page

Use this page to view, add, edit, or remove application-managed tasks and container-managed tasks associated with the project.

Source page

Use the Source page to view and modify the XML source code directly. The XML on the source page changes dynamically when the deployment descriptor is edited, and the other pages of the application deployment descriptor editor reflect changes that you make on the Source page. Editing the XML source is not the recommended method for editing the deployment descriptor. It is suggested that you make as many changes as possible using the other pages and sections of the editor.

Feedback