Resumen del contenido incluido en la página 1
WebSphere® Adapters
Version 6 Release 2
WebSphere Adapter Toolkit User Guide
Version 6 Release 2
Resumen del contenido incluido en la página 2
Resumen del contenido incluido en la página 3
WebSphere® Adapters Version 6 Release 2 WebSphere Adapter Toolkit User Guide Version 6 Release 2
Resumen del contenido incluido en la página 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
Resumen del contenido incluido en la página 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 .....
Resumen del contenido incluido en la página 6
iv WebSphere Adapters: WebSphere Adapter Toolkit User Guide
Resumen del contenido incluido en la página 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
Resumen del contenido incluido en la página 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
Resumen del contenido incluido en la página 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
Resumen del contenido incluido en la página 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
Resumen del contenido incluido en la página 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
Resumen del contenido incluido en la página 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
Resumen del contenido incluido en la página 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
Resumen del contenido incluido en la página 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
Resumen del contenido incluido en la página 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
Resumen del contenido incluido en la página 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
Resumen del contenido incluido en la página 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
Resumen del contenido incluido en la página 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
Resumen del contenido incluido en la página 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
Resumen del contenido incluido en la página 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
