Summary of the content on the page No. 1
WebSphere® Adapters
Version 6 Release 2
WebSphere Adapter Toolkit User Guide
Version 6 Release 2
Summary of the content on the page No. 2
Summary of the content on the page No. 3
WebSphere® Adapters Version 6 Release 2 WebSphere Adapter Toolkit User Guide Version 6 Release 2
Summary of the content on the page No. 4
Note Before using this information and the product it supports, read the information in “Notices” on page 211. December 2008 This edition applies to version 6, release 2, modification 0 of and to all subsequent releases and modifications until otherwise indicated in new editions. To send us your comments about this document, email mailto://doc-comments@us.ibm.com. We look forward to hearing from you. When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the in
Summary of the content on the page No. 5
Contents Editing deployment descriptor source ....67 WebSphere Adapter Toolkit ......1 Implementing code from the IBM WebSphere IBM WebSphere Adapter Toolkit technology Adapter Toolkit.............68 overviews ...............2 Foundation Classes implementation overview . . 68 IBM WebSphere Adapters.........2 Data model .............69 Architectural overview..........4 Inbound event notification ........79 How metadata is used at build time and run time 7 Inbound callback event notification .....
Summary of the content on the page No. 6
iv WebSphere Adapters: WebSphere Adapter Toolkit User Guide
Summary of the content on the page No. 7
WebSphere Adapter Toolkit ® ® The IBM WebSphere Adapter Toolkit provides the development tools, libraries and sample code to assist you in creating JCA resource adapters. With the toolkit you may create either of the following: v A resource adapter based on the interfaces defined by the JCA Resource Adapter 1.5 specification. Choose this path if your goal is developing a resource adapter that can run either unmanaged or managed within any JCA 1.5 compliant container. v A resource adapter that ex
Summary of the content on the page No. 8
The development process using the IBM WebSphere Adapter Toolkit includes the following as shown in the illustration: 1. Run the New JCA Resource Adapter Project wizard. The wizard generates a resource adapter deployment descriptor and code. The code can include sequence of calls, log and trace messages and comments. 2. Use the Resource Adapter Deployment Descriptor Editor to configure your deployment descriptor. 3. Implement the code to correctly interface with your enterprise information system
Summary of the content on the page No. 9
Inbound event notification complements outbound request processing, enabling adapters to provide bidirectional communication between business processes and EIS applications. WebSphere Process Server Enterprise information system WebSphere Business Adapter J2E component function Files Figure 1. A WebSphere Adapter The IBM WebSphere Adapter portfolio of adapters is based on the Java 2 Platform, Enterprise Edition (J2EE) standard. JCA is a standard architecture for integrating J2EE applications wit
Summary of the content on the page No. 10
WebSphere adapters utilize a format-independent data model for representing data objects. In a WebSphere Process Server or WebSphere Enterprise Service Bus runtime environment, WebSphere adapters use an extension of the service data objects (SDO) for representing data objects. Architectural overview In conjunction with the appropriate EIS-specific subclasses, the WebSphere Adapter Foundation Classes provide a JCA-compliant resource adapter implementation that can be managed by the application se
Summary of the content on the page No. 11
processing performed by each component (and subcomponent) in the model is described in sections that follow the illustration. Application interface Programming SCA J2EE CC Proprietary. . Model SDO DAAPI Metadata Application Data Component Exchange Record Other Common Client Interface (CCI) Connections Common JCA JCA Connector Connector Security Services Transactions DESPI Records Metadata Monitoring Connectivity Adapter Foundation Problem Data exchange Classes Determination Figure 3. Runtime arc
Summary of the content on the page No. 12
The connectivity subcomponent interacts with the target enterprise information system’s specific libraries and functionality. The subcomponent is exposed to the application interface component through standard JCA CCI interfaces, which include Connection, ConnectionFactory, Interaction and InteractionSpec for outbound processing and ResourceAdapter and ActivationSpecWithXid for the inbound event processing. JCA connector Data exchange SPI (DESPI) subcomponent The data exchange subcomponent of th
Summary of the content on the page No. 13
the appropriate programming model. It is responsible for mapping the specific invocation to the invocation of the connector component through the JCA common client interface (CCI). The component developer who has knowledge of the connector invocation interfaces and the runtime programming model, delivers the application component. The application component consists of data exchange, application interface, and metadata elements. Metadata The metadata subcomponent describes the structure of the da
Summary of the content on the page No. 14
Version 1.1 of Enterprise Metadata Discovery includes enhancements for configurable data handlers, function selectors, and data bindings, and a way to build service descriptions using these configured artifacts and existing schemas. For information on implementing interfaces for technology-style adapters, see “Enterprise Metadata Discovery interfaces and implementation for technology adapters” on page 157. IBM WebSphere Adapter Toolkit overview WebSphere Adapter Toolkit contains everything you n
Summary of the content on the page No. 15
– The New Connector Project Wizard - Prompts you to specify information about the resource adapter you wish to develop, and then generates code and a deployment descriptor. The code generated by the wizard can include sequence of calls, log and trace messages and comments. – Resource Adapter Deployment Descriptor Editor - An Eclipse multi-page form editor that allows you to display and configure your deployment descriptor. As changes are made to configuration properties using the editor, the app
Summary of the content on the page No. 16
v Generate a resource adapter deployment descriptor You can view and edit this deployment descriptor using the Resource Adapter Deployment Descriptor Editor. Resource Adapter Deployment Descriptor Editor overview This multi-page editor allows you to display, configure, and validate the resource adapter deployment descriptor generated by the wizard. Figure 5. Resource Adapter Deployment Descriptor The Resource Adapter Deployment Descriptor is an Eclipse plug-in intended for use with WebSphere Int
Summary of the content on the page No. 17
IBM WebSphere Adapter Toolkit tasks The tasks range from installing the toolkit, samples, and Adapter Foundation Classes (using the Eclipse Update Manager in WebSphere Integration Developer) to implementing and validating your code. Table 1. WebSphere Adapter Toolkit tasks Task Task description Validate WebSphere Adapter Toolkit installation See the developerWorks site for WebSphere Adapter Toolkit for requirements hardware and software prerequisites for the toolkit and for specific information
Summary of the content on the page No. 18
Operating system Versions Windows 2000 Windows 2000 Professional (SP4) Windows 2000 Server (SP4) Windows 2000 Advanced Server (SP 4) Windows XP Windows XP SP 2 Windows 2003 Windows Server 2003 Standard Windows Server 2003 Enterprise Hardware requirements The table shows the hardware requirements for supported operating systems. Operating system Hardware requirements ® Linux ® ® v Intel Pentium III 800 MHZ processor or faster ® Windows 2000 v 1024 x 768 display or higher resolution monitor Window
Summary of the content on the page No. 19
This documentation describes how to run the Twine Ball sample only. However, you can apply the instructions for running and testing the Twine Ball sample to the Kite String sample. The sample instructions accommodate creating an adapter for the Twine Ball sample using WebSphere Integration Developer, for deployment to a WebSphere Process Server runtime environment, as well as instructions for creating the adapter for the Twine Ball sample using Rational Application Developer, for deployment to W
Summary of the content on the page No. 20
This launches the Samples. c. From the Samples navigation pane, select Technology samples and expand Java and WebSphere Adapters so that the Twine Ball and Kite String samples display. d. Click Twine Ball to display a description of the Twine Ball sample in the viewing pane of the Technology Samples. 2. From the viewing pane of the Technology samples window, select Import the sample deployable rar. This launches the Connector Import window. Note: You can also import the sample deployable RAR fro
