Java Call-In

Uniface provides Java call-in functionality that allows Java applications to call Uniface components as if they were native Java components.

Uniface enables you to generate wrapper Java classes and JavaBeans for each Uniface component that you want to call from Java. The methods available on these classes and beans correspond to the operations of the component.

Instantiating one of these classes in your Java application causes Uniface to create an instance of the component. Calling a method activates the corresponding operation.

By default, these calls are handled by the Uniface Virtual Machine, but the Java Virtual Machine can also be used. The Uniface URB ensures that Java method-calling conventions and data types are converted to the calling standards and data types used by Uniface.

To configure the environment in which Uniface application components run, a Configuration Manager is provided as a JavaBean. This can be used to set the call handler (virtual machine) and its properties, such as the Uniface application name, assignment and initialization files, and working directory.

Java Call-In Facilities

Uniface support for call-in from Java applications includes the following:

  • Java call-in implementations for Uniface components—the signatures of Uniface components that are called by Java applications must specify a Java component implementation.

    You can use the Signature Editor to add a Java call-in implementation and, optionally, to define custom mappings between Uniface components, operations and parameters and Java classes, methods, and parameters.

    For more information, see Defining Java Implementations for Uniface Components.

  • Java code generator—using the /sto /lan=jav command line switch, you can generate Java files for the component wrapper classes and JavaBeans. These enable Java applications to treat Uniface components as Java objects. For more information, see Generated Files for Java Call-In.
  • Java Call-In API—classes and methods for creating your own Java class wrappers (if you do not want to use the ones generated by Uniface) and for marshaling operation parameters. For more information, see Java Call-in API.
  • Configuration Manager—manages the Uniface environment within which the Uniface component runs, including the call-in handler and configuration files. For more information, see Configuration Manager and Call Handlers.

The Java class files for the Java Call-in API and Configuration Manager are all available in the package com.compuware.uniface, which is located in the ujci20.jar in \common\bin directory of the Uniface installation.

Requirements

The Uniface Java call-in functionality is available only on Microsoft Windows and Linux platforms.

You must use a Java Developer Kit (JDK) such as the OpenJDK delivered with Uniface, or Oracle Java SE 8 (LTS) and 11 (LTS).