Creating CORBA Client Applications

 

This topic describes how to create CORBA C++, CORBA Java, and ActiveX client applications for the BEA WebLogic Enterprise^TM (WLE) software. This document introduces important product concepts, provides step-by-step instructions for creating client applications, and includes code examples to illustrate the development process.

 

1. Client Application Development

Overview of Client Applications

OMG IDL

OMG IDL-to-C++ Mapping

OMG IDL-to-Java Mapping

OMG IDL-to-COM Mapping

Static and Dynamic Invocation

Client Stubs

Interface Repository

Domains

Environmental Objects

Bootstrap Object

Factories and the FactoryFinder Object

Naming Conventions and WebLogic Enterprise Extensions to the FactoryFinder Object

SecurityCurrent Object

TransactionCurrent Object

InterfaceRepository Object

Concepts for ActiveX Client Applications

What Is ActiveX?

Views and Bindings

Naming Conventions for ActiveX Views

 

2. Creating CORBA Client Applications

Summary of the Development Process for CORBA C++ Client Applications

Summary of the Development Process for CORBA Java Client Applications

Step 1: Obtaining the OMG IDL File

Step 2: Selecting the Invocation Type

Step 3: Compiling the OMG IDL File

Step 4: Writing the CORBA Client Application

Initializing the ORB

Establishing Communication with the WebLogic Enterprise Domain

Resolving Initial References to the FactoryFinder Object

Using the FactoryFinder Object to Get a Factory

Using a Factory to Get a CORBA Object

Step 5: Building the CORBA Client Application

Server Applications Acting as Client Applications

Using Java2 Applets

 

3. Creating ActiveX Client Applications

Summary of the Development Process for ActiveX Client Applications

The BEA Application Builder

Step 1: Loading the Automation Environmental Objects into the Interface Repository

Step 2: Loading the CORBA Interfaces into the Interface Repository

Step 3: Starting the Interface Repository Server Application

Step 4: Creating ActiveX Bindings for the CORBA Interfaces

Step 5: Loading the Type Library for the ActiveX Bindings

Step 6: Writing the ActiveX Client Application

Including Declarations for the Automation Environmental Objects, Factories, and ActiveX Views of CORBA Objects

Establishing Communication with the WebLogic Enterprise Domain

Obtaining References to the FactoryFinder Object

Using a Factory to Get an ActiveX View

Invoking Operations on the ActiveX View

Step 7: Deploying the ActiveX Client Application

 

4. Using Security

Overview of WebLogic Enterprise Security

Summary of the Development Process for Security

Step 1: Using the Bootstrap Object to Obtain the SecurityCurrent Object

Step 2: Getting the PrincipalAuthenticator Object from the SecurityCurrent Object

Step 3: Obtaining the Authentication Level

Step 4: Logging on to the WebLogic Enterprise Domain with Proper Authentication

Step 5: Logging off the WebLogic Enterprise Domain

 

5. Using Transactions

Overview of WebLogic Enterprise Transactions

Summary of the Development Process for Transactions

Step 1: Using the Bootstrap Object to Obtain the TransactionCurrent Object

Step 2: Using the TransactionCurrent Methods

 

6. Using the Dynamic Invocation Interface

When to Use DII

DII Concepts

Request Objects

Options for Sending Requests

Options for Receiving the Results of Requests

Summary of the Development Process for DII

Step 1: Loading the CORBA Interfaces into the Interface Repository

Step 2: Obtaining the Object Reference for the CORBA Object

Step 3: Creating a Request Object

Using the CORBA::Object::_request Member Function

Using the CORBA::Object::create_request Member Function

Setting Arguments for the Request Object

Setting Input and Output Arguments with the CORBA::NamedValue Member Function

Example of Using CORBA::Object::create_request Member Function

Step 4: Sending a DII Request and Retrieving the Results

Synchronous Requests

Deferred Synchronous Requests

Oneway Requests

Multiple Requests

Step 5: Deleting the Request

Step 6: Using the Interface Repository with DII

 

7. Handling Exceptions

CORBA Exception Handling Concepts

CORBA System Exceptions

CORBA C++ Client Applications

Handling System Exceptions

User Exceptions

CORBA Java Client Applications

System Exceptions

User Exceptions

ActiveX Client Applications