Show TOC

 Adding JARs and ReferencesLocate this document in the navigation structure

Use

A Library project can contain JAR files as well as references to existing J2EE Engine components. You generally only include JARs in a project if these are new JAR files that are not yet contained in another engine component. You use references if a JAR is already available on the J2EE Engine as a library, interface, or service.

Note

Note that each JAR file should only exist once on the J2EE Engine. This also applies if, for example, two different applications utilize helper functions of a JAR. In this case, you must ensure that these helper functions are not packed into the relevant EAR in both applications, but are instead stored in a separate library.

Prerequisites
  • The library project structure is displayed in the J2EE Explorer.
  • The JAR files to be added are in the workspace.
Procedure

Adding JARs

  1. Choose the server/provider.xml node and choose Open from the context menu.

    The multipage editor opens in the right pane.

  2. Choose the Jars tab.
  3. Choose the Jars node followed by Add.
  4. Select one or more JARs from your workspace and confirm by choosing OK.

Adding References

  1. Choose the server/provider.xml node and choose Open from the context menu.

    The multipage editor opens in the right pane.

  2. Choose the References tab.
  3. Choose the References node followed by Add.
  4. You can either create a new reference or select an existing one.

    The differences between the two options and the steps for each option are described in the following table:

    Action Usage Steps

    Creating a new reference

    Create a new reference if the relevant library was not installed together with the engine, but was deployed on it at a later stage. 
    1. Choose the Create new button.
    2. Under Reference target, enter the name of the referenced engine component (library, service, or interface).
    3. Under Reference target type, specify whether the engine component is a library, service, or interface.
    4. Enter the name of the provider in the Provider name field. It is recommended that you derive this name from the Internet domain of the provider (for example, sap.com). 

    Selecting an existing reference

    Select an existing reference if the relevant library was already installed as part of the J2EE Engine or if it is a new Library project from your workspace.
    1. Choose the button Select library/interface/service.
    2. In the list that appears, select the relevant reference and confirm by choosing OK.