WebSphere Adapter for JDBC

Creating the adapter project in WebSphere Integration Developer

To begin the process of creating and deploying a module, you create an adapter project. The adapter project contains the adapter itself plus other related artifacts. You create the project by importing the RAR file, which was copied to your local file system during installation, into WebSphere® Integration Developer.

Before you begin

Make sure you have installed the Adapter for JDBC and that you have created an authentication alias.

About this task

Create an adapter project (called a connector project in WebSphere Integration Developer) to contain the adapter (which you import from the adapter installation directory) as well as artifacts related to it. All projects are self-contained; they do not refer to objects outside of the project.

To create an adapter project, use the following procedure.

How to perform this task

  1. If WebSphere Integration Developer is not currently running, start it now.
    1. Click Start > Programs > IBM WebSphere > Integration Developer V6.0.2 > WebSphere Integration Developer V6.0.2.
    2. If you are prompted to specify a workspace, accept the default value.

      The workspace is a directory where WebSphere Integration Developer stores your project.

    3. When the WebSphere Integration Developer window is displayed, close the Welcome page.
  2. Switch to the J2EE perspective:
    1. Click Window > Open Perspective > Other.
    2. Click J2EE.

      If J2EE is not displayed in the Select Perspective window, select the Show all check box, click J2EE, and click OK.

    3. If you see the Confirm Enablement window, select Always enable capabilities and don't ask me again.
    4. Click OK.
  3. Import the RAR file by right-clicking Connector Projects and clicking Import > RAR file.
    Figure 1. Importing the RAR file
    This screen capture is described in surrounding text.
  4. From the Connector Import window, click Browse and navigate to the directory in which the Adapter for JDBC was installed.
  5. Click CWYBC_JDBC.rar.

    The connector project has the same name as the RAR file.

    If a project named CWYBC_JDBC.rar already exists in this workspace, the name in the Connector project field has a number appended to it (for example, CWYBC_JDBC1).

  6. Optional: In the Connector project field, type another name for the project or accept the default value.
  7. Optional: In the Target server field, select the server to which the adapter will be deployed or accept the default value.
  8. Clear the Add module to an EAR project check box.
    Figure 2. Clearing the Add module to an EAR project check box
    This screen capture is described in the surrounding text.

    Notice that the EAR project field becomes unavailable after you remove the check mark.

  9. Click Finish.
  10. Add the JDBC driver to the connector project.

    You must add the JDBC driver to the connector project so that it becomes part of the EAR file that you deploy to the application server. You can do this either after you import the RAR file, or after you install the EAR on the application server.

    Option Description
    To add the JDBC driver after you import the RAR file Add the JAR file to the appropriate folder in the workspace. For example, the JAR file could be added to this location: c:\workspace\CWYBC_JDBC\connectorModule
    To add the JDBC driver after you install the EAR on the application server After you install the application, add the JAR file to the RAR subdirectory of the installedApps directory of WebSphere Process Server or WebSphere Enterprise Service Bus. For details on installing the application on the application server, see "Deploying the module."

Result

A new J2EE Connector project is created. To see its contents, expand the project in Project Explorer. For example, if the connector project is named CWYBC_JDBC, expand CWYBC_JDBC.
Figure 3. The connector project in the Project Explorer window
This screen capture is described in the surrounding text.

What to do next

Add the required external dependencies to the project.

Terms of use |

Last updated: Tue 12 Dec 2006 03:32:39

(c) Copyright IBM Corporation 2005, 2006.
This information center is powered by Eclipse technology (http://www.eclipse.org)