Manuals / Brands / Computer Equipment / Network Card / IBM / Computer Equipment / Network Card

IBM WebSphere Adapters manual

1 226

Download 226 pages, 2.45 Mb

1

WebSphere®Adapters

WebSphere Adapter ToolkitUser Guide

Version 6 Release 2

Version6 Release 2



Contents

Main Page Page Page Contents WebSphere Adapter Toolkit ......1 Notices ..............211 Index ...............215 Page WebSphere Adapter Toolkit The purpose of this documentation IBM WebSphere Adapter Toolkit technology overviews 2 IBM WebSphere Adapters WebSphere Process Server Enterprise information system Business function J2E component Architectural overview Runtime architecture component model 4 JCA connector component JCA connector connectivity subcomponent JCA connector Data exchange SPI (DESPI) subcomponent Common services and adapter foundation classes 6 Application interface component Metadata How metadata is used at build time and run time Using Enterprise Metadata Discovery to build services IBM WebSphere Adapter Toolkit overview 8 New Connector Project wizard overview Resource Adapter Deployment Descriptor Editor overview Adapter Foundation Classes overview 10 IBM WebSphere Adapter Toolkit tasks IBM WebSphere Adapter Toolkit installation requirements Operating system requirements Make sure that you meet the operating system requirements shown in the table. Hardware requirements Samples overview Running the Twine Ball sample using WebSphere Integration Developer Import the samples code 14 Run external service discovery for outbound processing Page Page Page Page Run external service discovery for inbound processing 20 Page Page Page Modify the module 24 Test the sample Running the Twine Ball sample using Rational Application Developer Import the samples code into Rational Application Developer and modify the sample for use 26 Test the sample using the universal test client Troubleshooting the samples Errors 28 Known issues Using the New Connector Project wizard Launching the New Connector Project wizard Page Specify project properties Specify project facets Specify connector project module settings 32 Specify resource adapter properties Specify generation options 34 Generating an IBM WebSphere Resource Adapter Outbound adapter classes and associated properties 36 Inbound adapter classes and associated methods Data Binding classes 38 Enterprise Metadata Discovery classes Generating outbound adapter classes 40 Page 42 Generating inbound adapter classes 44 Page 46 Generating enterprise metadata discovery classes Generating data binding classes 48 Generating a JCA resource adapter Outbound JCA resource adapter classes Inbound JCA resource adapter classes JCA Enterprise Metadata Discovery classes 50 Page Generating outbound JCA adapter classes 52 Generating inbound JCA adapter classes Generating JCA enterprise metadata discovery classes 54 Generated code and deployment descriptor Using the Resource Adapter Deployment Descriptor editor Displaying the deployment descriptor 56 Page Using the Overview pane 58 Using the Resource Adapter pane 60 Using the Outbound Adapter pane 62 Page Using the Inbound Adapter pane 64 Page Modifying deployment descriptor properties 66 Generated bean properties Editing deployment descriptor source Implementing code from the IBM WebSphere Adapter Toolkit Foundation Classes implementation overview 68 Data model Relationship of business objects to service data objects After-images versus deltas 70 Verbs Verbs versus operations Business object standards 72 Page 74 Page 76 Page Page Inbound event notification Using the IBM WebSphere Foundation Classes for inbound event notification 80 Event Store Requirements Adapter Requirements Application Requirements Assured once-and-once-only event delivery Implementing an event store in the EIS 82 Page 84 Page Implementing event retrieval in the adapter Implementing an EventStore Interface 86 Transaction Support Methods Possible event store implementations 88 Inbound callback event notification Request and response callback events One way callback events 90 Using the IBM WebSphere adapter foundation classes for inbound callback event processing Callback event sender Callback event processing for basic delivery 92 Page Callback event processing for event delivery with XA transaction 94 Page Callback event processing for event recovery 96 Outbound support Application sign-on 98 Implementing outbound support 100 Page 102 Page Implementing transaction support 104 Example of an XA-enabled adapter implementation of WBIManagedConnection Using command patterns 106 Page 108 Page 110 Page 112 Page 114 Data and metadata XSD and JavaBean structure relationship to DESPI 116 Page 118 The Metadata API Factory classes Interfaces 120 Interface Type: Enterprise metadata implementation 122 Enterprise Metadata Discovery general interfaces and implementation for application adapters Types of enterprise metadata 124 Page Enterprise metadata discovery architecture 126 Metadata discovery Metadata discovery adapter type Metadata discovery connection type OutboundConnectionType 128 InboundConnectionType Discovering System Capabilities MetadataConnection 130 Enterprise metadata discovery description APIs 132 Page 134 Business object structures for enterprise metadata discovery Namespace definition Implementing enterprise metadata discovery classes 136 Page Enterprise metadata discovery implementation samples 138 Page 140 Page 142 Page 144 Page 146 Page 148 Page 150 Page 152 Page 154 Page 156 Enterprise Metadata Discovery interfaces and implementation for technology adapters Building configurable artifacts (data bindings, data handlers, and function selectors) Implementing a data handler 158 Implementing a function selector Implementing a data binding Binding context and configuration Implementing Enterprise Metadata Discovery to build an interface Extending the adapter foundation classes to build services 160 Page Discovery-service.xml Structured record implementation 162 Initialize input method Purpose of the initialize input method Initialize output method Purpose of the initialize output method Set managed connection method Purpose of the set managed connection method 164 Get next method Purpose of the getNext method Clone method Sample Close method Purpose of the close method Extract method Data binding implementation 166 Interfaces setDataObject getDataObject Bidirectional language support Problem determination Fault handling support 168 Page 170 WebSphereAdapter development overview 171 172 Page Logging and tracing messages 174 Support for protecting sensitive user data in log and trace files Inserting log and trace messages 176 Page 178 Page 180 Monitoring and measuring performance 182 Unique Id The Unique Id interface can be used to uniquely identify event points: 184 Page 186 Page 188 Page 190 Page 192 Exception messages Changing the Java logging API settings Validating the code Testing enterprise metadata discovery (EMD) of the adapter Testing the adapter in unmanaged mode 194 JUnit: an open source framework for unit testing Developing JUnit tests Outbound Inbound 196 Build and execute TwineBall JUnit Testing the adapter in managed mode Installing the test client Testing outbound functionality 198 Saving business object data Using an execution trace Testing inbound functionality 200 Page 202 Validating code with Rational Application Developer and WebSphere Application Server Page Page Creating and exporting a resource adapter 206 Page Reference Terminology 208 Page 210 Notices 212 Programming interface information Trademarks and service marks Page Index Special characters Numerics A C D G H 216 I J V W X