Introduction to Oracle SALT Programming

This section includes the following topics:

•	Oracle SALT Web Services Programming

•	Oracle SALT SCA Programming

Oracle SALT Web Services Programming

Oracle SALT provides bi-directional connectivity between Oracle Tuxedo applications and Web service applications. Existing Oracle Tuxedo services can be easily exposed as Web Services without requiring additional programming tasks. Oracle SALT generates a WSDL file that describes the Oracle Tuxedo Web service contract so that any standard Web service client toolkit can be used to access Oracle Tuxedo services.

Web service applications (described using a WSDL document) can be imported as if they are standard Oracle Tuxedo services and invoked using Oracle Tuxedo ATMIs from various Oracle Tuxedo applications (for example, Oracle Tuxedo ATMI clients, ATMI servers, Jolt clients, COBOL clients, .NET wrapper clients and so on).

Oracle SALT Proxy Service

Oracle SALT proxy services are Oracle Tuxedo service entries advertised by the Oracle SALT Gateway, GWWS. The proxy services are converted from the Web service application WSDL file. Each WSDL file wsdl:operation object is mapped as one SALT proxy service.

The Oracle SALT proxy service is defined using the Service Metadata Repository service definition syntax. These service definitions must be loaded into the Service Metadata Repository. To invoke an proxy service from an Oracle Tuxedo application, you must refer to the Oracle Tuxedo Service Metadata Repository to get the service contract description.

For more information, see ?$paratext>?.

Oracle SALT Message Conversion

To support Oracle Tuxedo application and Web service application integration, the Oracle SALT gateway converts SOAP messages into Oracle Tuxedo typed buffers, and vice versa. The message conversion between SOAP messages and Oracle Tuxedo typed buffers is subject to a set of SALT pre-defined basic data type mapping rules.

When exposing Oracle Tuxedo services as Web services, a set of Tuxedo-to-XML data type mapping rules are defined. The message conversion process conforms to Tuxedo-to-XML data type mapping rules is called “Inbound Message Conversion”.

When importing external Web services as SALT proxy services, a set of XML-to-Tuxedo data type mapping rules are defined. The message conversion process conforms to XML-to-Tuxedo data type mapping rules is called “Outbound Message Conversion”.

For more information about SALT message conversion and data type mapping, see ?$paratext>?.

Oracle SALT Programming Tasks Quick Index

Table 1‑1 lists a quick index of Oracle SALT programming tasks. You can locate your programming tasks first and then click on the corresponding link for detailed description.

 

Table 1‑1 Oracle SALT Programming Tasks Quick Index

	Tasks	Refer to ...
Invoking Oracle Tuxedo services (inbound) through Oracle SALT	Develop Web service client programs for Oracle Tuxedo services invocation	?$paratext>? on page 3‑2
	Understand inbound message conversion and data type mapping rules	?$paratext>? on page 2‑2 ?$paratext>? on page 2‑3
	Develop inbound message conversion plug-in	?$paratext>? on page 6‑7
Invoking external Web services (outbound) through Oracle SALT	Understand the general outbound service programming concepts	?$paratext>? on page 5‑1
	Understand outbound message conversion and data type mapping rules	?$paratext>? on page 2‑2 ?$paratext>? on page 2‑28
	Develop outbound message conversion plug-in	?$paratext>? on page 6‑7
	Develop your own plug-in to map Oracle Tuxedo user name with user name for outbound HTTP basic authentication	?$paratext>? on page 6‑17

Oracle SALT SCA Programming

SCA components run on top of the Oracle Tuxedo infrastructure using ATMI binding allowing you to better blend high-output, high-availability and scalable applications in your SOA environment. The Oracle Tuxedo SCA container is built on top of Tuscany SCA Native and Tuscany SDO C++ ((Assembly: 0.96, Client and Implementation Model 0.95) and SDO (2.01)).

The ATMI binding implementation provides native Oracle Tuxedo communications between SCA components as well as SCA components and Oracle Tuxedo programs (clients and servers). Runtime checks are encapsulated in an exception defined in a header (tuxsca.h) provided with the ATMI binding. This exception (ATMIBindingException), is derived from ServiceRuntimeException (so that programs not aware of the ATMI binding can still catch ServiceRuntimeException) and thrown back to the caller.

SCA deployment is handled by the following build commands:

•	buildscaclient

•	buildscacomponent

•	buildscaserver

SCA clients can be stand-alone or part of a server, similar to Oracle Tuxedo ATMI clients. Components are first built using buildscacomponent and then Oracle Tuxedo-enabled using buildscaserver. SCA administration is performed using common Oracle Tuxedo commands (for example, tmadmin), and the scaadmin command for SCA-specific tasks.

For more information, see:

•	Oracle SALT Administration Guide

•	Oracle SALT Reference Guide

•	SCA Service Component Architecture Client and Implementation Model Specification for C++