18.2.5 HTTP接続に関する設定

Interstage Application Server/Interstage Web Server J2EE ユーザーズガイド

目次索引

第4部 Webサービス編

> 第18章 Webサービスの開発

> 18.2 Webサービスを呼び出す場合（クライアント機能）の開発

18.2.5 HTTP接続に関する設定

　Webサービスクライアントアプリケーションで追加のHTTP接続情報を設定する方法について以下に説明します。

■接続先URLを指定する方法

　スタブオブジェクトはWSDLで定義されたデフォルトの接続先URLに対してリモート呼び出しを行います。明示的に接続先URLを指定したい場合は、スタブオブジェクトに対してプロパティで接続先のURLを指定します。
　スタブオブジェクトにプロパティで指定するには、javax.xml.rpc.Stubインタフェースの_setPropertyメソッドを使用して、プロパティとして接続先URLを設定します。

import javax.xml.rpc.Stub;

       ..... 
   StockQuoteProviderService abf = (StockQuoteProviderService) sf.loadService(StockQuoteProviderService.class); 
   StockQuoteProvider quoteProvider = abf.getStockQuoteProviderPort();
   ((Stub)quoteProvider)._setProperty("javax.xml.rpc.service.endpoint.address",
              "http://anotherhost/StockService/services/StockQuoteProvider");//接続先URLを指定

   float quote = quoteProvider.getLastTradePrice(tickerID);//指定されたURLに接続

　接続先URLに関するプロパティは、以下のとおりです。

キー	値(java.lang.String)
javax.xml.rpc.service.endpoint.address	接続先のURL（デフォルトはWSDLで指定されたURL）

■Webサービスのユーザ名/パスワードを設定する方法

　WebサービスでHTTP Basic認証を行っている場合は、スタブオブジェクトに対してプロパティとして認証情報を設定します。
　Webサービスのユーザ名/パスワードに関するプロパティは、以下のとおりです。

キー	値(java.lang.String)
javax.xml.rpc.security.auth.username	ユーザ名
javax.xml.rpc.security.auth.password	パスワード

■接続のタイムアウトを指定する方法

　接続先から応答がない場合に接続を切断するタイムアウト時間を指定する場合は、スタブオブジェクトに対してプロパティとしてタイムアウト時間をミリ秒で設定します。
　タイムアウト時間に関するプロパティは、以下のとおりです。

キー	値(java.lang.Integer)
com.fujitsu.interstage.isws.client.connect.timeout	タイムアウト時間(ミリ秒) (デフォルトは10分)

■セション管理の利用を指定する方法

　HTTP Cookieを利用したセション管理の利用を指定する場合は、スタブオブジェクトに対してプロパティとして「利用する・しない」をjava.lang.Booleanオブジェクトで設定します。
　セション管理の利用に関するプロパティは、以下のとおりです。

キー	値(java.lang.Boolean)
javax.xml.rpc.session.maintain	Boolean.TRUE(利用する)・Boolean.FALSE（利用しない＝デフォルト）

セション管理は、呼び出すWebサービスがHTTP Cookieを利用したセション管理を行っている場合に有効です。
Webサービスクライアントアプリケーション終了時、セション管理情報を含むcookieは保存されません。
セションのタイムアウトが発生した後に処理を継続した場合、新規のセションが確立されます。

　スタブオブジェクトのプロパティは、プログラムでの設定以外に外部ファイルでも設定できます。詳細については“スタブ設定ファイル”を参照してください。

■プロキシに関する設定

　“プロキシを経由した接続”を参照してください。

目次索引