SALTサンプル・ガイド

SALTをインストールすると、SALTのサンプル・ディレクトリにUNIXおよびWindowsのサンプル・アプリケーションが格納されます。各サンプルには詳細なreadmeファイルがあります。

UNIXサンプル: $TUXDIR/samples/salt
Windowsサンプル: %TUXDIR%\samples\salt

SALT Webサービス・サンプル・アプリケーション

SALTでは、外部Webアプリケーションを使用してネイティブTuxedoサービス(受信)を呼び出したり、Tuxedoアプリケーションを使用して外部Webサービス(送信)を呼び出したりできます。SALTには、10種類のWebサービス・サンプル・アプリケーションがバンドルされています。これらのアプリケーションは、Oracle WebLogic、Apache Axis、またはMicrosoft .NETツールキットを使用してSALTを呼び出す方法を示します。

着信のサンプル

発信のサンプル

着信のサンプル

基本サンプル: simpapp

基本サンプルでは、単純なTuxedoサービスをWebサービスとしてエクスポートする方法を示します。Webサービスとしてエクスポートする既存のアプリケーションとして、Tuxedoのsimpappサンプルを使用します。

このサンプルには、simpservサーバーのTOUPPERサービスをWebサービスとして構成およびエクスポートするために必要なすべてのファイルが含まれています。Webサービスは、1つの文字列パラメータを受け付けて大文字に変換します。クライアントはサービスを呼び出し、返された文字列を出力します。

このサンプルを使用すると、GWWSサーバーおよびそのWebサービスの実行とアクセスの基本を習得できます。

使用できるクライアント・プログラム : Oracle WebLogic、Apache Axis for Java、Microsoft .NET。

添付ファイル・サンプル: attachapp

添付ファイル・サンプルでは、SALT WebサービスでCARRAYバッファ・タイプをMIME添付ファイルとしてSwA (SOAP with Attachment)プロトコルに従って転送する方法を示します。Webサービスとしてエクスポートする既存のアプリケーションとして、Tuxedoのsimpappサンプルを使用します。このサンプルには、simpservサーバーのTOUPPERサービスをWebサービスとして設定およびエクスポートするために必要なすべてのファイルが含まれています。

カスタム・タイプ・サンプル: custtypeapp

SALTカスタム・タイプ・プラグイン・サンプルでは、SALTプラグインの拡張機能を使用して、Tuxedoカスタム型付きバッファとXMLドキュメント間のマッピング・ルールをカスタマイズする方法を示します。

データ型サンプル: datatypeapp

日付型サンプルでは、SALTでTuxedoの型付きバッファを使用する方法を示します。FMLおよびVIEWバッファとそれらのサブフィールドをTuxedoサービス・メタデータ・リポジトリでどのように定義するか、また、WSDL文書でどのように表現するかを示します。このサンプルでは、WSDL文書ファイルの生成ユーティリティとしてtmwsdlgenを使用します。

このサンプルには、Webサービス・クライアント・プログラミングの理解に役立つWebLogicクライアント・プログラムも含まれています。Tuxedoアプリケーション・サーバーは、FMLまたはVIEWバッファを確認して入力データを返す単純なエコー・サービスです。

信頼性のあるメッセージング・サンプル: wsrmapp

このReliableMessagingサンプルでは、SALTのWS信頼できるメッセージングのサポートとWSアドレスとの非同期通信を使用する方法を示します。Tuxedoアプリケーション・サービス・プロバイダとしてTuxedoのbankappサンプルを使用します。WebLogic ServerのWebサービス・クライアントおよびスタンドアロンJava Webサービス・クライアントもこのサンプルに含まれています。

Weblogic Serverの信頼性のあるメッセージングの使用法については、http://e-docs.bea.com/wls/docs103/webserv_adv_rpc/rm.htmlを参照してください。

セキュリティ・サンプル: secsapp

セキュリティ・サンプルでは、株価照会シナリオで既存のTuxedoのxmlstockappサンプルを利用します。GWWSサーバーを使用して、STOCKQUOTEサービスをWebサービスとしてエクスポートします。

SALTでは、SSL/HTTPSを使用してトランスポートやメッセージを保護します。HTTP基本認証によるTuxedo認証もサポートしています。このサンプルを使用して、セキュリティ転送の設定方法と2つのTuxedo認証パターン(アプリケーション・パスワードとユーザー認証)によるユーザーの認証方法を習得できます。

サンプル・コードと、WSDL文書から生成されたスタブ・コードを組み合わせて、クライアント・プログラムを開発できます。WSDL文書ファイルは、SALT構成ファイルとtmwsdlgenユーティリティを使用して生成されます。

エラーの処理: faultapp

エラーの処理サンプルでは、SALTにおいてFAULTとユーザー・データの処理方法を示します。

WS-Security 1.1 : wsseapp

SALTはWS-Security 1.1の一部を実装しています。ユーザー名トークンおよびX.509トークンの認証ならびに着信メッセージ署名の検証がサポートされます。このサンプルでは、GWWSを通じてTuxedoドメインによってエクスポートされたWebサービスとWS-Securityポリシーのバインド方法を示します。このサンプルでは、3つのタイプのセキュリティをそれぞれ3つのWebサービスに適用されています。

TOUPPER :ユーザー名トークンの認証。
TOLOWER :ユーザー名トークンおよびX.509トークンの認証。署名されたSoap本文によって保護されたメッセージの完全性。
REVERT : X.509トークン認証。署名されたSoap本文によって保護されたメッセージの完全性。

必須のACLセキュリティはTuxedo domainで適用されます。X.509トークンは、ユーザー名として証明書の共通名を使用してTuxedoユーザーにマッピングされます。

発信のサンプル

発信認証マッピング: obauthmapp

SALT着信認証マッピング・プラグイン・サンプルでは、SALTプラグインの拡張機能を使用して、TuxedoユーザーIDおよびグループIDからHTTP基本認証マッピングを実装する方法を示します。

発信Webサービス: obwsapp

このサンプルでは、SALTの発信Webサービス機能を使用してWebサービスを呼び出すためにTuxedoクライアント・プログラムの開発方法を示します。環境でAxis2を使用して単純なWebサービスの「計算機」をデプロイできます。この「計算機」サービスでは、「追加」の作業があり、2つの入力整数を追加し、結果を返します。

サンプル・ガイド