Overview of application-component development

This section provides the following information about the development process for a J2EE application component:

Stages in application-component development

To develop a J2EE application component that communicates with an ICS-managed EIS through a WebSphere Access Resource Adapter, you code the application-component source file(s) and complete other tasks. The task of creating an application component that communicates with an ICS-managed EIS includes the following general steps:

  1. Set up the development environment. Install the application-server software and IBM WebSphere InterChange Server Access for J2EE, including configuring the development environment for use with an Access Resource Adapter. For more information, see Installing Server Access for J2EE.
  2. Within ICS, configure ports of the collaboration to be used as access and execution by call-triggered flows. This step involves configuring external collaboration ports, which handle access clients.
  3. Implement and debug the application component (such as an EJB) that executes the CCI calls to use an Access Resource Adapter and execute a collaboration. Implement Java code to establish a connection, create an

    input record, request execution of a collaboration, and access the returned output record.

Figure 6 provides a visual overview of the application-component development process and provides a quick reference to chapters where you can find information on specific topics.

Figure 6. Overview of the application-component development task

The figure shows an overview of the development of application-components. On the left is a vertical flow of tasks. Each of these tasks is connected to a node under the heading "steps" and each of these steps has a reference indicated on the right-hand side where the step is discussed. The first row has the following: Task = Set up development environment. Steps = Install development software, Install IBM WebSphere InterChange Server for Enterprise JavaBeans. Refer to = Chapter 3. The second row has the following elements: Task = Configure IBM WebSphere collaborations. Steps = Configure collaboration object properties, Designate collaboration ports for call-triggered flow, Map business objects to call-triggered ports. Refer to = Access Development Guide. The penultimate row comprises: Task = Code the application component. Steps = Create session of a WebSphere Access EJB, Create input data to act as the triggering event, Send input data to an ICS-managed EIS application, Access the received output data. Refer to = Chapter 4. The final row has: Task = Test and debug. Steps = Invoke the client component, Verify that connection is established, Verify that requested data is obtained.

Development support for client components

To support development of an application component that requires communication with an ICS-managed EIS, Server Access for J2EE provides the features in Table 4.

Table 4. Support for client components and an Access Resource Adapter

Server Access for J2EE support Description
WebSphere Access Resource Adapter: CWResourceAdapter.rar Provides the application component with ICS-specific implementation of CCI interfaces

For more information, see "IBM WebSphere Access Resource Adapter".

Application-component sample Includes the following:
  • Sample EJB client
  • Sample client application that issues requests to the EJB client

To support development of a J2EE application component that uses an Access Resource Adapter, Server Access for J2EE provides the solutions in the following subdirectory of the product:

DevelopmentKits\j2ee\ResourceAdapter\samples

This directory contains deployable code and samples for Server Access for J2EE. The samples help you integrate a WebSphere Access Resource Adapter into the J2EE application.

Important:
This sample EJB has been written to execute in the managed environment of the J2EE Connector Architecture specification 1.0..

This samples subdirectory contains the following files:

Important:
For information on how to deploy and run the EJB client, refer to the readme.txt files included in the samples directory and its subdirectories.

The sample application component provides an EJB that runs within the context of the application server and can look up the adapter and use it. The EJB client demonstrates how the Access Resource Adapter can execute a WebSphere Business Integration Collaboration. This sample contains code to perform the following tasks:

Copyright IBM Corp. 1997, 2004