About Libraries for Programmatic Clients Accessing ADF Business Components

When using any of the client wizards in JDeveloper to create a web or GUI client, JDeveloper adds the required ADF runtime libraries to the project. However, if you want to create your own programmatic client to access the Business Components middle tier, you'll need to manually add the required Business Components libraries to your project. The following table summarizes which libraries you'll require for programmatic clients running in EJB mode and in local mode:

Mode Required Libraries for Oracle Application Server Required Libraries for Other Application Servers
EJB
  • Business Components Oracle Application Server Client

 

  • Business Components EJB Client
  • Server-specific runtime libraries. For example, if a Business Components project is deployed to WebLogic, you'll need to include weblogic.jar.
Local
  • ADF Business Components runtime
  • Oracle JDBC
  • ADF Business Components runtime
  • Oracle JDBC

Type Mappings

Depending on how you built your Business Components middle tier project, you'll need to include the appropriate library:

Type Mapping Required Library
Java Business Components Generic Domains
Oracle

Business Components Oracle Domains

Note: If you are using interMedia Text for Oracle Application Server deployments, you'll need to add the Oracle interMedia library.

To add Business Components libraries for programmatic clients:

  1. If not already done, create a workspace and project.
  2. If not already done, create a new Business component project.
  3. In the Navigator, select the project in which you want to create the programmatic client.
  4. Right-click and choose Project Properties .
  5. Expand the active profile and click Libraries to display the Library Manager.
  6. In the Available Libraries list, select the appropriate Business Components, type mapping, and/or interMedia Text libraries as appropriate for your particular client and mode and move them to the Selected Libraries list. See table above for details.
  7. Click OK to accept these project settings.

To setup your programmatic client to access Business Components libraries in local mode:

  1. Create a project dependency that makes the Business Components middle tier project's classes available to the client project.
  2. If you are running in local mode, you'll need to include the Business Components middle tier project files with the client files.
    In the Project Properties dialog, click the Dependencies node to configure the project dependencies.
  3. Select the <projectname>.jpr which contains the Business Components middle tier files.
  4. Click OK to accept these project settings.

To setup your programmatic client to access Business Components libraries in remote mode:

  1. Create a Deployment Profile for Business Components EJBs.
  2. If you are running in remote mode, you'll need to set up the client to depend on the Business Components middle tier deployment profile.
    In the Project Properties dialog, click the Dependencies node to configure the project dependencies.
  3. Expand the <ProjectNameEJB>. bcdeploy deployment profile to display the subprofiles.
  4. Select the <ProjectNameCommon>.deploy which contains the files shared between the business components and the client. This sets up the client's classpath to access the Business Components middle tier.
  5. Click OK to accept these project settings.

About J2EE Deployment
About ADF Business Components Deployment
About UIX Deployment-Specific Initialization Parameters
About UIX Deployment Dependencies
Packaging J2EE Applications
Deploying J2EE Applications
Deploying Applications to J2EE Application Servers

 

Copyright © 1997, 2004, Oracle. All rights reserved.