Understanding the Included Adapters


	BEA Home \| Events \| Solutions \| Partners \| Products \| Services \| Download \| Developer Center \| WebSUPPORT
	http://www.oracle.com/technology/documentation/index.html \| Site Map \| Search \| PDF Files \| Contact \| Glossary

WLI Doc Home \| Application Integration Topics \| Introducing Application Integration \| Previous Topic \| Next Topic \| Contents \| Index \| View as PDF

If you plan on using the BEA WebLogic Integration Adapter Development Kit (ADK) to develop adapters, WebLogic Integration includes three adapters to get you started: the e-mail adapter, the DBMS adapter, and the sample adapter. If you are developing your own adapters using the ADK, you should study these adapters to aid your development efforts. Although these included adapters are generic and simple, they serve as excellent examples of the types of adapters you can build using the ADK.

How the Included Adapters Were Developed

All of the included adapters were developed using the ADK. Using the ADK, it is possible to develop adapters that are far more sophisticated than the included adapters. These adapters were kept simple because their purpose is to be dissected and understood by adapter providers and developers.

How to Use the Included Adapters

If you are an adapter provider or developer, you should study the included adapters to increase your ADK knowledge and to provide a model for your own adapter development projects. Each adapter is summarized below. All are based on version 1.3 of the J2EE (Java 2 Platform, Enterprise Edition) from Sun Microsystems. For details on the ADK, see Developing Adapters.

E-mail Adapter

Application integration includes an e-mail adapter that integrates WebLogic Server with a simple e-mail server. For this e-mail adapter, a simple Java mail server is used as the EIS. If you are an adapter developer or adapter provider, this lets you focus on the details of the adapter and the ADK instead of an unfamiliar e-mail EIS.

Features of the e-mail adapter:

Sending mail
Receiving mail

For more information on the e-mail adapter, see "The E-mail Adapter" in Developing Adapters.

DBMS Adapter

Application integration includes a DBMS adapter that integrates WebLogic Server with a simple relational database. The DBMS adapter uses a simple relational database as its EIS. If you have no existing, suitable database to use with the DBMS adapter, you can use the Cloudscape database included with WebLogic Integration. However, the Cloudscape database is intended to be used only for running sample applications. BEA, Inc. does not support the use of Cloudscape in a production environment. The DBMS adapter serves as a good example for adapter developers and providers who want to understand the adapter and ADK without having to learn an unfamiliar proprietary database system.

Features of the DBMS adapter:

Retrieving all database records
Retrieving sets of database records
Writing database records

For more information on the DBMS adapter, see "The DBMS Adapter" in Developing Adapters.

Sample Adapter

In addition to the e-mail adapter and DBMS adapter, a sample adapter is included. The sample adapter acts as a template that you can use as the starting point for developing a new adapter. The sample adapter includes a design-time component, service adapter, and event adapter. The source code clearly documents the structure of the service adapter and event adapter. The sample adapter also is accompanied by a simple EIS implementation to demonstrate how invoking services can trigger related events. Each of these components contain comments indicating where to supply your own adapter-specific logic.