Programming Guide

Introduction to Oracle SALT Programming

Oracle SALT Web Services Programming

Oracle SALT Proxy Service

Oracle SALT Message Conversion

Oracle SALT Programming Tasks Quick Index

Oracle SALT SCA Programming

Data Type Mapping and Message Conversion

Overview of Data Type Mapping and Message Conversion

Understanding Oracle SALT Message Conversion

Inbound Message Conversion

Outbound Message Conversion

Tuxedo-to-XML Data Type Mapping for Tuxedo Services

Tuxedo STRING Typed Buffers

Tuxedo CARRAY Typed Buffers

Mapping Example Using base64Binary

Mapping Example Using MIME Attachment

Tuxedo MBSTRING Typed Buffers

Tuxedo XML Typed Buffers

Tuxedo VIEW/VIEW32 Typed Buffers

VIEW/VIEW32 Considerations

Tuxedo FML/FML32 Typed Buffers

FML Data Mapping Example

FML32 Data Mapping Example

FML/FML32 Considerations

Tuxedo X_C_TYPE Typed Buffers

Tuxedo X_COMMON Typed Buffers

Tuxedo X_OCTET Typed Buffers

Custom Typed Buffers

XML-to-Tuxedo Data Type Mapping for External Web Services

XML Schema Built-In Simple Data Type Mapping

XML Schema User Defined Data Type Mapping

WSDL Message Mapping

Web Service Client Programming

Overview

Oracle SALT Web Service Client Programming Tips

Oracle WebLogic Web Service Client Programming Toolkit

Apache Axis for Java Web Service Client Programming Toolkit

Microsoft .NET Web Service Client Programming Toolkit

Web Service Client Programming References

Online References

Tuxedo ATMI Programming for Web Services

Overview

Converting WSDL Model Into Tuxedo Model

WSDL-to-Tuxedo Object Mapping

Invoking SALT Proxy Services

Oracle SALT Supported Communication Pattern

Tuxedo Outbound Call Programming: Main Steps

Managing Error Code Returned from GWWS

Handling Fault Messages in a Tuxedo Outbound Application

Using Oracle SALT Plug-Ins

Understanding Oracle SALT Plug-Ins

Plug-In Elements

Plug-In ID

Plug-In Name

Plug-In Implementation Functions

Plug-In Register Functions

Information Providing Function

Initiating Function

Exiting Function

vtable Setting Function

Developing a Plug-In Interface

Developing a Plug-In Shared Library

Defining a Plug-In interface in SALT configuration file

Programming Message Conversion Plug-ins

How Message Conversion Plug-ins Work

How Message Conversion Plug-in Works in an Inbound Call Scenario

How Message Conversion Plug-in Works in an Outbound Call Scenario

When Do We Need Message Conversion Plug-in

Developing a Message Conversion Plug-in Instance

Converting a SOAP Message Payload to a Tuxedo Buffer

Converting a Tuxedo Buffer to a SOAP Message Payload

SALT 1.1 Custom Buffer Type Conversion Plug-in Compatibility

Programming Outbound Authentication Plug-Ins

How Outbound Authentication Plug-Ins Work

Implementing a Credential Mapping Interface Plug-In

Mapping the Tuxedo UID and HTTP Username

Oracle SALT SCA Programming

Overview

SCA Utilities

SCA Client Programming

SCA Client Programming Steps

Setting Up the Client Directory Structure

Developing the Client Application

Composing the SCDL Descriptor

Building the Client Application (Using buildscaclient)

Running the Client Application

Invoking Existing Tuxedo Services

Handling TPFAIL Data

SCA Component Programming

SCA Component Programming Steps

Setting Up the Component Directory Structure

Developing the Component Implementation

Composing the SCDL Descriptor

Compiling and Linking the Components

Building the Tuxedo Server Host

Web Services Binding

SCA Remote Protocol Support

/WS

/Domains

Java ATMI (JATMI) Binding

Tuxedo SCA Interoperability

SCA Transactions

SCA Security

SCA ATMI Binding

SCA ATMI Binding Data Type Mapping

Simple Tuxedo Buffer Data Mapping

Multibyte String Data Mapping

Receiving a Multibyte String Buffer

Sending a Multibyte String Buffer