Libraries for Programmatic Clients Accessing BC4J

When using any of the client wizards in JDeveloper to create a web or GUI client, JDeveloper adds the required BC4J runtime libraries to the project. However, if you want to create your own programmatic client to access the BC4J middle tier, you'll need to manually add the required BC4J 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
  • BC4J Oracle9iAS Client

 
  • BC4J EJB Client
  • Server-specific runtime libraries. For example, if BC4J is deployed to WebLogic, you'll need to include weblogic.jar.
Local
  • BC4J Runtime
  • Oracle JDBC
  • BC4J Runtime
  • Oracle JDBC

Type Mappings

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

Type Mapping Required Library
Java BC4J Generic Domains
Oracle

BC4J 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 BC4J libraries for programmatic clients accessing BC4J:

  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_icon <projectname>.jpr in which you want to create the programmatic client.
  4. Right-click and choose Project Settings.
  5. Expand Configurations and click Libraries to display the Library Manager.
  6. In the Available Libraries list, select the appropriate BC4J, 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 BC4J in local mode:

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

To setup your programmatic client to access BC4J in remote mode:

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

Related topics

Creating a Deployment Profile for BC4J Web Clients