Java Proxy Generation (SAP Library - SAP Exchange Infrastructure (BC-XI))

Java Proxy Generation

Java

Use

Using the Java proxy generation function, you can generate Java classes or Java proxy objects from the interface description in the Integration Repository. Using these objects, you can then implement sender and receiver applications in Java; the proxy objects establish the connection to the Exchange Infrastructure at runtime, by means of the Java Proxy Framework.

Features

There are two application instances for which you can generate proxies:

J2EE applications on the SAP Web Application Server. Proxy generation generates J2EE beans and proxy classes for this purpose.
Standalone applications. No J2EE beans are required in this case.

A subset of Java classes are generated for standalone applications. Java proxy generation in the Integration Builder supports the following for both application instances:

Generation of a Jar file for one or more message interfaces of the same software component version.
Opening of existing Jar files to regenerate proxies. Proxy generation knows the original message interfaces for which proxy objects are contained in the Jar file.

Selecting Message Interfaces

You can call Java proxy generation from the design maintenance screen of the Integration Builder in the following ways:

From the main menu, choose Tools ® Java Proxy Generation.
From the context menu, choose Java Proxy Generation... for message interfaces in the navigation tree.

The latter method has the advantage that the selected message interface and the corresponding software component version can be copied directly.

Once the Java proxy generation window is open, you can transfer multiple message interfaces of a software component version to a list for subsequent generation. Use either of the following methods:

Context menu Java Proxy Generation... (see above).
Drag&Drop from the navigation tree to the window.

Activities

Generating New Java Proxies

Navigate to the design maintenance screen of the Integration Builder.

Select the message interfaces for which the Java proxies are to be generated (see above).

The default setting generates J2EE beans. If you do not require any beans, deselect this option.

Choose Recreate Jar File (

) and specify a file name for a new Jar file. If the specified file already exists it will be overwritten.

To start generation, choose Generate Proxy. A Jar file is not generated if errors occur during generation.

Regenerating Java Proxies

If you want to change any data types, message types, or message interfaces, you must do so using the Integration Builder in the Integration Repository. After any such changes, new Java proxies must be generated. You can only regenerate proxy classes for the entire message interface. The procedure is the same as when you generate Java proxies for the first time, with the exception that you must first identify the message interface from which the Jar file was generated. To do so, choose Open Jar File (). In this way, Java proxy generation automatically includes it in the list again.

Result

The resulting Jar file contains the corresponding Java source text files of the Java proxy objects.

Tips

Technically speaking, a Jar archive corresponds to a Zip archive. You can view the contents of the generated Jar archive in Windows, using WinZip, for example. Using the jar command, you can display the contents by using jar -tf <Filename> and read the contents by using jar -xf <Filename>.

To gain an overview of the generated classes, generate it with javadoc HTML documentation.