|
|
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.
sample.cci.ConnectionImpl
Connection interface that represents an application-level handle used by a client to access the underlying physical connection.
sample.cci.InteractionImpl
DesignTimeInteractionSpecImpl class.
sample.cci.InteractionSpecImpl
sample.client.ApplicationViewClient
sample.eis.EIS
sample.eis.EISConnection
sample.eis.EISEvent
sample.eis.EISListener
sample.event.EventGenerator
AbstractPullEventGenerator that shows how to extend the ADK base class to construct an event generator.
sample.event.OfflineEventGeneratorTestCase
sample.spi.ManagedConnectionFactoryImpl
sample.spi.ManagedConnectionImpl
sample.spi.ConnectionMetaDataImpl
sample.spi.NonManagedScenarioTestCase
sample.spi.ResourceAdapterImpl
sample.web.DesignTimeRequestHandler
AbstractDesignTimeRequestHandler that shows how to add an event or service at design time.
| Note: | For details about the classes extended by those in the sample adapter, see the ADK Javadocs at the following URL: |
| Note: | http://download.oracle.com/docs/cd/E13214_01/wli/docs92/wli.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/docs92/wli.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:
http://download.oracle.com/docs/cd/E13214_01/wli/docs92/wli.javadoc/ and select the com.bea.schema package
http://download.oracle.com/docs/cd/E13214_01/wli/docs92/wli.javadoc/ and select the com.bea.document package
|