HTTP 転送およびポーラー転送ユーザーズ ガイド

転送

さまざまなタイプの転送を使用して、Oracle Service Bus のプロキシ サービスまたはビジネス サービスをコンフィグレーションできます。選択する転送プロトコルは、サービス タイプ、必要な認証のタイプ、呼び出し元のサービスのサービス タイプなどによって異なります。

ポーリング ベースの転送は、転送ポーラーが管理対象サーバに固定されている転送です。これらの転送では、JMS フレームワークを使用して、メッセージの処理が少なくとも 1 回は実行されることを保証します。電子メール、ファイル、FTP、および SFTP は、ポーリング ベースの転送です。この節では、ポーリング ベースの転送と HTTP 転送について説明します。SFTP については、「SFTP 転送」を参照してください。

このドキュメントは、以下の節で構成されています。

HTTP 転送

HTTP 転送は、Oracle Service Bus で http/s プロトコルを使用してクライアントとサービス プロバイダ間でメッセージの送信を行います。また、「REST サポート」で説明されているように、HTTP 転送は REST (Representational State Transfer) 環境での作業のサポートも提供します。

任意のタイプのプロキシ サービスまたはビジネス サービスをコンフィグレーションする場合は、HTTP 転送プロトコルを選択できます。エンドポイント URI の形式は次のとおりです。

ここで、someService はプロキシ サービスまたはビジネス サービスの名前です。

HTTP 転送を使用したプロキシ サービスのコンフィグレーション

プロキシ サービスの HTTP 転送をコンフィグレーションする際に指定できるパラメータを表 1-1 に示します。

HTTP 転送ベースのプロキシ サービスをコンフィグレーションする方法および詳細設定については、『Oracle Service Bus Console の使い方』の「転送コンフィグレーション」を参照してください。

HTTP 転送を使用したビジネス サービスのコンフィグレーション

HTTP に基づく任意のタイプのビジネス サービスをコンフィグレーションするときに、エンドポイント URI が次の形式の場合、転送プロトコルとして HTTP を選択する必要があります。

http://<host:port/someService>

ここで、各項目には以下のものを指定します。

ビジネス サービスの HTTP 転送をコンフィグレーションする際に指定できるすべてのパラメータを表 1-2 に示します。

この転送をコンフィグレーションする詳細については、『Oracle Service Bus Console の使い方』の「転送コンフィグレーション」を参照してください。

REST サポート

HTTP 転送は、Oracle Service Bus を介した REST (Representational State Transfer) 環境での作業をサポートします。このサポートは、非 REST サービス プロバイダと対話する必要がある REST クライアント、REST ベースのサービス プロバイダと対話する必要がある非 REST クライアント、または Oracle Service Bus を介してエクスポーズする必要がある REST-to-REST サービスのいずれにも対応します。

REST のパターンでは、特定の URL にあるリソースに対して HTTP メソッド (GET、PUT、HEAD、POST、DELETE など) を呼び出します。たとえば、REST を使用した Web アプリケーションでユーザがプロファイル情報を更新した場合、POST アクションがサービスの REST API を介してデータベースのユーザ情報を更新します。

Oracle Service Bus では、発信および着信通信の REST ベースの要求を処理するために、次のプレースホルダ変数が用意されています。

プロキシ サービスの REST

Oracle Service Bus プロキシ サービスには、REST ベースの要求を受信するか、REST ベースのアクションを生成するかにかかわらず、REST パターンを操作できる柔軟性があります。

たとえば、REST ベースのアプリケーションを開発し、非 REST サービス プロバイダでサービスを呼び出したい場合は、プロキシ サービスで REST 操作を送り、その操作をサービス プロバイダが認識できる形式に変換するか、非 REST 要求をリソース URL に変換し、REST ベース のサービス プロバイダで操作を呼び出すことができます。

XQuery サンプル

以下は、プロキシ サーバで HTTP 変数を使用して行う URI 解析の XQuery サンプルです。

relative-URI

プロキシ サービスの URI が http://localhost:7001/weather であり、要求の相対的 URI の部分をキャプチャするとします。次の XQuery を作成します。

<relative-URI>
{
for $c in
fn:tokenize($inbound/ctx:transport/ctx:request/http:relative-URI, "/")
where fn:string-length($c) != 0
return
<part>
{$c}
</part>
}
</relative-URI>

要求の URI が http://localhost:7001/weather/temperature/35457 の場合、relative-URI は /temperature/35457 になり、XQuery 出力は次のようになります。

<relative-URI>
    <part>temperature</part>
    <part>35457</part>
</relative-URI>

query-string

プロキシ サービスの URI が http://localhost:7001/weather であり、URL クエリ文字列をキャプチャするとします。次の XQuery を作成します。

<query-params>
{
for $c in
fn:tokenize($inbound/ctx:transport/ctx:request/http:query-string, "&amp;")
return 
<param name="{fn:substring-before($c,"=")}"
value="{fn:substring-after($c,"=")}"></param>
}
</query-params>

要求の URI が http://server:7001/weather?operation=temperature&pincode=35457 の場合、query-string は operation=temperature&pincode=35457 になり、XQuery 出力は次のようになります。

<query-params>
    <param name=’operation’ value=’temperature’/>
    <param name=’pincode’ value=’35457’/>
</query-params>

ヘッダ

サービスにより HTTP/REST メソッドを処理するために固有のヘッダが必要な場合、プロキシ サービスのメッセージ フローにユーザ定義済み HTTP ヘッダ変数を作成します。

ビジネス サービスの REST

Oracle Service Bus ビジネス サービスでは、REST ベースのサービスを呼び出すことができます。

REST 操作で、HTTP 転送は $outbound/transport/request/http:http-method 変数の値を使用します。この変数に HTTP メソッドが指定されていない場合、HTTP 転送では転送コンフィグレーションに含まれる HTTP 要求メソッド (POST、PUT、HEAD、GET、DELETE) のいずれかを選択できます。

$outbound/transport/request-http/http-method 変数を使用して、独自のメソッドを指定することもできます。たとえば、WebDAV (Web-based Distributed Authoring and Versioning) 環境で COPY、MOVE、および LOCK を使用できます。

次のガイドラインを使用して $outbound 変数を設定します。

HTTP ビジネス サービスの応答コード

HTTP 転送には、HTTP メソッドに対する次の応答コードがあります。

電子メール転送

プロキシ サービスまたはビジネス サービスのメッセージング タイプまたは任意の XML サービスをコンフィグレーションするときに、電子メール転送プロトコルを選択できます。以下のトピックでは、電子メール転送を使用して、プロキシ サービスとビジネス サービスをコンフィグレーションする方法について説明します。

電子メール転送を使用したプロキシ サービスのコンフィグレーション

電子メール転送を使用してプロキシ サービスをコンフィグレーションする場合は、エンドポイント URI を次の形式で指定する必要があります。

mailfrom:<mailserver-host:port>

ここで、mailserver-host: は、ホスト メール サーバの名前、port はホスト メール サーバが使用するポートです。

電子メール転送ベースのプロキシ サービスでコンフィグレーションできるパラメータを表 1-3 に示します。

電子メール サービスをコンフィグレーションする詳細については、『Oracle Service Bus Console の使い方』の「転送コンフィグレーション」を参照してください。

電子メール転送を使用したビジネス サービスのコンフィグレーション

電子メール転送を使用してビジネス サービスをコンフィグレーションする場合、エンドポイント URI を次の形式で指定する必要があります。

mailto:<name@domain_name.com>

ここで、<name@domain_name.com> は電子メールの送り先です。

電子メール転送ベースのビジネス サービスでコンフィグレーションできるパラメータを表 1-4 に示します。

この転送をコンフィグレーションする詳細については、『Oracle Service Bus Console の使い方』の「転送コンフィグレーション」を参照してください。

ファイル転送

プロキシ サービスのメッセージング タイプまたは任意の XML サービスをコンフィグレーションするときに、エンドポイント URI が次の形式の場合、ファイル転送プロトコルを選択できます。

file:///<root-dir/dir1>

ここで、root-dir/dir1 は送り先ディレクトリへの絶対パスです。

ファイル転送を使用したプロキシ サービスのコンフィグレーション

プロキシ サービスのファイル転送をコンフィグレーションする際に指定できるパラメータを表 1-5 に示します。

ファイル転送ベースのプロキシ サービスをコンフィグレーションする詳細については、『Oracle Service Bus Console の使い方』の「転送コンフィグレーション」を参照してください。

ファイル転送を使用したビジネス サービスのコンフィグレーション

ファイル転送を使用してビジネス サービスをコンフィグレーションする場合は、エンドポイント URI を次の形式で指定する必要があります。

file:///<root-dir/dir1>

ここで、root-dir/dir1 は送り先ディレクトリへの絶対パスです。

ビジネス サービスのファイル転送をコンフィグレーションする際に指定できるパラメータを表 1-6 に示します。

この転送をコンフィグレーションする詳細については、『Oracle Service Bus Console の使い方』の「転送コンフィグレーション」を参照してください。

FTP 転送

プロキシ サービスのメッセージング タイプまたは任意の XML サービスをコンフィグレーションするときに、エンドポイント URI が次の形式の場合、FTP 転送プロトコルを選択できます。

ftp://<hostname:port/directory>

ここで、各項目には以下のものを指定します。

FTP 転送を使用したプロキシ サービスのコンフィグレーション

プロキシ サービスの FTP 転送をコンフィグレーションする際に指定できるパラメータを表 1-7 に示します。

ファイル転送ベースのプロキシ サービスをコンフィグレーションする詳細については、『Oracle Service Bus Console の使い方』の「転送コンフィグレーション」を参照してください。

FTP 転送を使用したビジネス サービスのコンフィグレーション

ビジネス サービスのメッセージング タイプまたは任意の XML サービスをコンフィグレーションするときに、エンドポイント URI が次の形式の場合、FTP 転送プロトコルを選択できます。

ftp://<hostname:port/directory> 

ここで、各項目には以下のものを指定します。

ビジネス サービスの FTP 転送をコンフィグレーションする際に指定する必要のあるパラメータを表 1-8 に示します。

この転送をコンフィグレーションする詳細については、『Oracle Service Bus Console の使い方』の「転送コンフィグレーション」を参照してください。