Adapter architecture

The adapter for ESRI Spatial Database is built using the WebSphere Business Integration Adapter (WBIA) framework and WBIX adapter framework extensions. WebSphere Business Integration extensions (WBIX) are a set of modular components built on top of the WBIA framework and are configured and instantiated at runtime. The adapter uses the XSLT logic module for message processing, the WBI transport receiver and sender for communicating with the integration broker, and the ArcSDE transport for communicating with the ESRI gateway. The adapter's WBIX XML data handler is used to convert between generic business objects and their XML representation for processing by the XSLT logic module. All event notification is handled by the WBI transport and the queue-based transports.

Figure 1. Detail view of the adapter for ESRI Spatial Database architecture

Adapter architecture includes an XML sender and receiver transport module, which communicates with the ESRI ArcSDE gateway using the ArcSDE Java API. On top of those components is the adapter core, which interfaces with the connector profile, the WBIX XML data handler, and one or more XSLT logic modules.

A description of the adapter components follows.

Adapter components

The following are the adapter components:

Adapter Core
The adapter core controls the data and logic flows in the adapter.
Connector Profile
The connector profile describes the connector configuration and its properties. The Connector Configurator, which is a tool with a graphical user interface, enables you to define the configuration and properties.
WBIX XML Data Handler
The WBIX XML data handler provides conversion between generic business objects and their XML representation for processing by the XSLT logic module.
Logic Modules
Logic modules process data inbound from an inbound transport receiver enroute to the outbound transport sender. These modules provide translation functionality between the application and integration broker data formats. For example, an XSLT logic module is provided for the situation where both inbound and outbound format are in XML format.

You can create custom logic modules to provide processing specific to your requirements. For example, you could create a specific XSL file to define a specific grammar transformation. Logic modules can also be chained if you require that capability.

The logic module for this adapter is com.ibm.wbix.adapter.logicmodules.XsltLogicModule.

Transport
A transport provides the interface to the specific application. The XMLSenderReceiver allows for synchronous messaging between the integration broker and ArcSDE.

Because an application might have a mix of different protocols as its integration interface (for example, an SQL database interface for some data and an MQ messaging interface for other data), multiple transports can be loaded with a single adapter to enable the adapter to communicate across disparate protocols. In addition, each transport can house multiple incoming (receivers) and outgoing (senders) endpoints, such as a single receiver or sender for each of the application messaging queues. Transports are provided for some common interfaces. See Transport modules for additional details on the transport component.

Transport modules

The standard WebSphere Business Integration sender and receiver transport modules are used for communication with the integration broker. They expect the body of the message to contain an XML format recognized by the adapter or the WBI transport, which then gets converted into a WebSphere Business Integration business object and sent to the integration broker for processing. The transport component contains modules that communicate with the integration broker and modules that communicate with the application.

Broker transport

For this adapter, the WebSphere Business Integration transport consists of the following components:

com.ibm.wbix.datahandlers.XMLDataHandler
The data handler converts WebSphere business objects to and from WebSphere XML.
com.ibm.wbix.adapter.transports.wbi.WBISender
This module sends messages to the integration broker.
com.ibm.wbix.adapter.transports.wbi.WBIReceiver
This module receives messages from the integration broker.

Application transport

The application transport for this adapter is com.ibm.wbix.adapter.transports.arcsde.xml.XMLSenderReceiver.

Copyright IBM Corp. 1997, 2003