Table of Contents Previous Next PDF

Introducing Oracle Jolt

Introducing Oracle Jolt
Oracle Jolt is a Java-based interface to the Oracle Tuxedo system that extends the functionality of existing Oracle Tuxedo applications to include Intranet- and Internet-wide availability. Using Jolt, you can now easily transform any Oracle Tuxedo application so that its services are available to customers using an ordinary browser on the Internet. Jolt interfaces with existing and new Oracle Tuxedo applications and services to allow secure, scalable, intranet/Internet transactions between client and server. Jolt enables you to build client applications and applets that can remotely invoke existing Oracle Tuxedo services, such as application messaging, component management, and distributed transaction processing.
Because you develop your applications with the Jolt API and the Jolt Repository Editor, which use Oracle Tuxedo and the Java programming language, the Jolt documentation is written with the assumption that you are familiar with Oracle Tuxedo and Java programming. This documentation is intended for system administrators, network administrators, and developers.
This topic includes the following sections:
Oracle Jolt Components
Oracle Jolt is a Java class library and API that provides an interface to Oracle Tuxedo from remote Java clients. Oracle Jolt consists of the following components for creating Java-based client programs that access Oracle Tuxedo services:
Jolt Serversone or more Jolt servers listen for network connections from clients, translate Jolt messages, multiplex multiple clients into a single process, and submit and retrieve requests to and from Oracle Tuxedo-based applications running on one or more Oracle Tuxedo servers.
Jolt Class Librarythe Jolt class library is a Java package containing the class files that implement the Jolt API. These classes enable Java applications and applets to invoke Oracle Tuxedo services. The Jolt class library includes functionality to set, retrieve, manage, and invoke communication attributes, notifications, network connections, transactions, and services.
JoltBeansOracle JoltBeans provides a JavaBeans-compliant interface to Oracle Jolt. JoltBeans are Beans components that you can use in JavaBeans-enabled integrated development environments (IDEs) to construct Oracle Jolt clients. Jolt Beans consists of two sets of Java Beans: JoltBeans toolkit (a JavaBeans-compliant interface to Oracle Jolt that includes the JoltServiceBean, JoltSessionBean, and JoltUserEventBean) and Jolt GUI beans, which consist of Jolt-aware Abstract Window Toolkit (AWT) and Swing-based beans.
Jolt Repositorya central repository contains definitions of Oracle Tuxedo services. These repository definitions are used by Jolt at run time to access Oracle Tuxedo services. You can export services to a Jolt client application or unexport services by hiding the definitions from the Jolt client. Using the Repository Editor, you can test new and existing Oracle Tuxedo services independently of the client applications.
Jolt Internet Relaythe Jolt Internet Relay is a component that routes messages from a Jolt client to a Jolt Server Listener (JSL) or Jolt Server Handler (JSH). This component eliminates the need for the JSH and Oracle Tuxedo to run on the same machine as the Web server. The Jolt Internet Relay consists of the Jolt Relay (JRLY) and the Jolt Relay Adapter (JRAD).
Key Features
With Oracle Jolt, you can leverage existing Oracle Tuxedo services and extend your transaction environment to the corporate intranet or world-wide Internet. The key feature of Jolt architecture is its simplicity. You can build, deploy, and maintain robust, modular, and scalable electronic commerce systems that operate over the Internet.
Oracle Jolt includes the following features:
Java-based API for simplified developmentwith its Java-based API, Oracle Jolt simplifies application design by providing well-designed object interfaces. Jolt supports the Java 2 Software Development Kit (SDK) and is fully compatible with Java threads. Jolt enables Java programmers to build graphical front-ends that use the Oracle Tuxedo application and transaction services without having to understand detailed transactional semantics or rewrite existing Oracle Tuxedo applications.
Pure Java client developmentusing Jolt, you can build a pure Java client that runs in any Java-enabled browser. Jolt automatically converts from Java to native Oracle Tuxedo data types and buffers, and from Oracle Tuxedo back to Java. As a pure Java client, your applet or application does not need resident client-side libraries or installation; thus, you can download client applications from the network.
Easy access to Oracle Tuxedo services through Jolt Repositorythe Oracle Jolt Repository facilitates Java application development by managing and presenting Oracle Tuxedo service definitions that you can use in your Java client. A Jolt Repository bulk loading utility lets you quickly integrate your existing Oracle Tuxedo services into the Jolt development environment. Jolt and Oracle Tuxedo simplify network and application scalability, while encouraging the reuse of application components.
GUI-Based maintenance and distribution of Oracle Tuxedo servicesthe Jolt Repository Editor lets you manage Oracle Tuxedo service definitions such as service names, inputs and outputs. The Jolt Repository Editor provides support for different input and output names for services defined in the Jolt Repository.
Encryption for secure transaction processingOracle Jolt allows you to encrypt data transmitted between Jolt clients and the JSL/JSH. Jolt encryption helps ensure secure Internet transaction processing.
Added security through Internet Relaynetwork administrators can use the Oracle Jolt Internet Relay component to separate their Web server and Oracle Tuxedo application server. Web servers are generally considered insecure because they often exist outside a corporate firewall. Using the Jolt Internet Relay, you can locate your Oracle Tuxedo server in a secure location or environment on your network, yet still handle transactions from Jolt clients on the Internet.
Event Subscription SupportJolt Event Subscription enables you to receive event notifications from Oracle Tuxedo services and Oracle Tuxedo clients. Jolt Event Subscription lets you subscribe to two types of Oracle Tuxedo application events:
Unsolicited Event Notificationsa Jolt client can receive these notifications when an Oracle Tuxedo client or service subscribes to unsolicited events and an Oracle Tuxedo client issues a broadcast or a directly targeted message.
Brokered Event Notificationsthe Jolt client receives these notifications through the Oracle Tuxedo Event Broker. The Jolt client receives these notifications only when it subscribes to an event and any Oracle Tuxedo client or server posts an event.
How Oracle Jolt Works
Oracle Jolt connects Java clients to applications that are built using the Oracle Tuxedo system. The Oracle Tuxedo system provides a set of modular services, each offering specific functionality related to the application as a whole.
The end-to-end view of the Oracle Jolt architecture, as well as related Oracle Tuxedo components and their interactions, is illustrated in the figure “Oracle Jolt Architecture” on page 1‑5.
Using Figure 1‑1 as an example, a simple banking application might have services such as INQUIRY, WITHDRAW, TRANSFER, and DEPOSIT. Typically, service requests are implemented in C or COBOL as a sequence of calls to a program library. Accessing a library from a native program means installing the library for the specific combination of CPU and operating system release on the client machine, a situation that Java was expressly designed to avoid. The Jolt Server implementation acts as a proxy for the Jolt client, invoking the Oracle Tuxedo service on behalf of the client. The Oracle Jolt Server accepts requests from the Jolt clients and maps those requests into Oracle Tuxedo service requests.
Figure 1‑1 Oracle Jolt Architecture
Jolt Servers
The following Jolt Server components act in concert to pass Jolt client transaction processing requests to the Oracle Tuxedo application.
The JSL handles the initial Jolt client connection, and assigns a Jolt client to the Jolt Server Handler.
The JSH manages network connectivity, executes service requests on behalf of the client and translates Oracle Tuxedo buffer data into the Jolt buffer, as well as Jolt buffer data into the Tuxedo buffer.
The JREPSVR retrieves Jolt service definitions from the Jolt Repository and returns the service definitions to the JSH. The JREPSVR also updates or adds Jolt service definitions.
Figure 1‑2 illustrates the Jolt Server and Jolt Repository components.
Figure 1‑2 Jolt Server and Repository Components
Jolt Class Library
The Oracle Jolt Class Library is a set of classes that you can use in your Java application or applet to make service requests to the Oracle Tuxedo system from a Java-enabled client. You access Oracle Tuxedo transaction services by using Jolt class objects.
When developing a Jolt client application, you only need to know about the classes that Jolt provides and the Oracle Tuxedo services that are exported by the Jolt Repository. Jolt hides the underlying application details. To use Jolt and the Jolt Class Library, you do not need to understand: the underlying transactional semantics, the language in which the services were coded, buffer manipulation, the location of services, or the names of databases used.
The Jolt API is a Java class library and has the benefits that Java provides: applets are downloaded dynamically and are only resident during run time. As a result, there is no need for client installation, administration, management, or version control. If services are changed, the client application notes the changes at the next call to the Jolt Repository.
Figure 1‑3 shows the flow of activity from a Jolt client to and from the Oracle Tuxedo system. The call-out numbers correspond to descriptions of the activity in the table “Using the Jolt Class Library” on page 1‑7.
Figure 1‑3 Using the Jolt Class Library to Access Oracle Tuxedo Services
Table 1‑1 briefly describes the flow of activity involved in using the Jolt Class Library to access Oracle Tuxedo services, as shown in the previous figure “Using the Jolt Class Library to Access Oracle Tuxedo Services.”
Oracle Jolt now includes JoltBeans, Java beans components that you use in a Java-enabled integrated development environment (IDE) to construct Oracle Jolt clients. Using JoltBeans, and popular JavaBeans-enabled development tools such as Symantec Visual Café, you can graphically create client applications.
Oracle JoltBeans provide a JavaBeans-compliant interface to Oracle Jolt that enables you to develop a fully functional Oracle Jolt client without writing any code. You can drag and drop JoltBeans from the component palette of a development tool and position them on the Java form (or forms) of the Jolt client application you are creating. You can populate the properties of the beans and graphically establish event source-listener relationships between various beans of the application or applet. Typically, the development tool is used to generate the event hook-up code, or you can code the hook-up manually. Client development with JoltBeans is integrated with the Oracle Jolt Repository, which provides easy access to available Oracle Tuxedo functions.
Jolt Server and Jolt Client Communication
The Jolt system handles all communication between the Jolt Server and the Jolt client using the Oracle Jolt Protocol. The communication process between the Jolt Server and the Jolt client applet or applications functions as follows:
Jolt Repository
The Jolt Repository is a database where Oracle Tuxedo services are defined, such as name, number, type, parameter size, and permissions. The repository functions as a central database of definitions for Oracle Tuxedo services and permits new and existing Oracle Tuxedo services to be made available to Jolt client applications. An Oracle Tuxedo application can have many services or service definitions, such as ADD_CUSTOMER, GET_ACCOUNTBALANCE, CHANGE_LOCATION, and GET_STATUS. All or only a few of these definitions can be exported to the Jolt Repository. Within the Jolt Repository, the developer or system administrator uses the Jolt Repository Editor to export these services to the Jolt client application.
All Repository services that are exported to one client are exported to all clients. Oracle Tuxedo handles the cases where subsets of services may be needed for one client and not others.
Figure 1‑4 illustrates how the Jolt Repository brokers Oracle Tuxedo services to multiple Jolt client applications. (Four Oracle Tuxedo services are shown; however, the WITHDRAW service is not defined in the repository and the TRANSFER service is defined but not exported.)
Figure 1‑4 Distributing Oracle Tuxedo Services Through Jolt
Jolt Repository Editor
The Jolt Repository Editor is a Java-based GUI administration tool that gives the application administrator access to individual Oracle Tuxedo services. You use the Editor to define, test, and export services to Jolt clients.
The Jolt Repository Editor lets you extend and distribute Oracle Tuxedo services to Jolt clients without having to modify many lines of code. You can modify parameters for Oracle Tuxedo services, logically group Oracle Tuxedo services into packages, and remove services from created packages. You can also make the services available to browser-based Jolt applets or Jolt applications by exporting the services.
Jolt Internet Relay
The Jolt Internet Relay is a component that routes messages from a Jolt client to the Jolt Server. The Jolt Internet Relay consists of the Jolt Relay (JRLY) and the Jolt Relay Adapter (JRAD). JRLY is a stand-alone software component that routes Jolt messages to the Jolt Relay Adapter. Requiring only minimal configuration to work with Jolt clients, the Jolt Relay eliminates the need for the Oracle Tuxedo system to run on the same machine as the Web server.
The JRAD is an Oracle Tuxedo system server, but does not include any Oracle Tuxedo services. It requires command-line arguments to allow it to work with the JSH and the Oracle Tuxedo system. JRAD receives client requests from JRLY, and forwards the request to the appropriate JSH. Replies from the JSH are forwarded back to the JRAD, which sends the response back to the JRLY. A single Jolt Internet Relay (JRLY/JRAD pair) handles multiple clients concurrently.
Creating a Jolt Client to Access Oracle Tuxedo Applications
The main steps for creating and deploying a Jolt client, are described in the following procedure and in the figure “Creating a Jolt Application” on page 1‑13.
For information about installing Oracle Tuxedo and creating an Oracle Tuxedo application, refer to Installing the Oracle Tuxedo System and Setting Up an Oracle Tuxedo Application.
Refer to Installing the Oracle Tuxedo System.
For information on using this utility, see “Bulk Loading Tuxedo Services.”
Table 1‑2 shows the mapping relationship between the Jolt repository data types and Tuxedo services data types.
The long type size of Tuxedo service can be 32 bits or 64 bits. If the Tuxedo service uses 32-bit long type, map it to integer in Jolt Client. Otherwise, if the Tuxedo service uses 64-bit long type, map it to long in Jolt Client.
Since Java does not support unsigned data type, to use the unsigned data types in Tuxedo services, you need to map them to Jolt data types, which have the same storage space. For example, "unsigned int" should be mapped to "integer" in Jolt client. Besides, if you want to show the exact value of unsigned data type in Jolt client, you need to do additional casting works in Java.
For information about configuring the Jolt Repository Editor and making Oracle Tuxedo services available to Jolt, see Chapter 4, “Using the Jolt Repository Editor”
The following documentation shows you how to program your client application using the Jolt Class Library:
Figure 1‑5 Creating a Jolt Application

Copyright © 1994, 2017, Oracle and/or its affiliates. All rights reserved.