Developing Adapters
The ADK provides a set of robust tools to assist you in developing adapters and the design-time GUI. This section describes these tools. Specifically, it includes information about the following subjects:
To help you start building an adapter, the ADK provides a sample adapter with code examples that are not specific to EIS. Do not confuse this sample adapter with the DBMS sample adapters that are also provided by WebLogic Integration; the DBMS sample adapters are documented in Learning to Develop Adapters Using the DBMS Sample Adapters. You can find the DBMS sample adapters in WLI_HOME
/adapters/dbms
.
The purpose of the sample adapter is to free you from much of the coding necessary to build an adapter. It provides concrete implementations of key abstract classes that require customization only to meet the requirements of the EIS you are using. In addition, the ADK provides GenerateAdapterTemplate
, a utility with which you can quickly clone the sample adapter development tree for use by the adapter you are developing. See GenerateAdapterTemplate Utility.
A concrete implementation of the Connection
interface that represents an application-level handle used by a client to access the underlying physical connection.
A class that demonstrates how to implement a design pattern using the DesignTimeInteractionSpecImpl
class.
An interface that provides a base implementation that you can extend by using getter and setter methods for the standard interaction properties.
sample.eis.EIS
sample.eis.EISConnection
sample.eis.EISEvent
sample.eis.EISListener
A concrete extension to AbstractPullEventGenerator
that shows how to extend the ADK base class to construct an event generator.
Note: For details about the classes extended by those in the sample adapter, see the ADK Javadocs at the following URL:
http://download.oracle.com/docs/cd/E13214_01/wli/docs81/javadoc/adk/
To facilitate use of the sample adapter, the ADK provides GenerateAdapterTemplate
, a command-line utility you can use to create a new adapter development tree by cloning the sample tree. For complete instructions on using this tool, see Creating a Custom Development Environment.
ADK classes, interfaces, methods, and constructors are defined in the development kit's Javadoc. The ADK Javadoc is located at the following URL:
http://download.oracle.com/docs/cd/E13214_01/wli/docs81/javadoc/adk/
The Javadoc for the ADK is not specific to a single adapter. For additional information on specific sample adapter, refer to comments in the adapter source code provided in WLI_HOME
/adapters/
ADAPTER
/src
where ADAPTER
is the specific adapter directory.
The ADK employs a build process based on Ant, a 100% pure Java-based build tool. For the ADK, Ant does the following:
Traditionally, build tools are shell-based. Like shell commands, they evaluate a set of dependencies and then execute various tasks. While the advantage of such tools is that it is simple to extend them by using or writing any program for your operating system (OS), the disadvantage is that you are limited to that OS.
Ant is preferable to shell-based make tools for the following reasons:
For complete instructions for setting up Ant, see Step 2c: Set Up the Build Process.
The ADK includes the XML Toolkit, a set of two XML development tools that are considered part of the metadata support layer for the design-time framework:
IDocument
, this API provides the x-path interface to a document object model (DOM) document.For instructions on using these tools, see XML Toolkit.
WebLogic Integration provides Javadoc for both APIs:
com.bea.schema
packagecom.bea.document
package