OpenSOAP Logo OpenSOAP Project
The Middleware as Platform for IT Application Services

メニュー

-トップ
-OpenSOAPについて
-リリース
-ドキュメント

-ダウンロード
-協力
-リンク

-FAQ
-バグ情報
-ロードマップ

-検索
-連絡先
-バグジラ

English version

SSML(Soap Service Mapping Language)

SSMLサンプル解説(Sample.ssml)

<SSML xmlns="x-schema:ssmlSchema.xml">

SSML(Soap Service Mapping Language)の最上位要素は<SSML>であり,
サービス名を定義した<service>要素をひとつ含みます.
SSMLファイル名は便宜的にこのサービス名と同一にします.

<service name='Sample' nsuri='http://services.opensoap.jp/samples/Sample/'>

<service>ノードにはひとつ以上の<connection>要素と,
任意の数の<operation>要素,ひとつの<fault>要素,
ひとつ以下の<MaxProccessNumber>要素を含みます.
サーバ内でオペレーション名が重複するなど,
必要な場合には<service>ノードに含まれるnsuri属性でサービスの名前空間を指定します.

<connection name='Sample1'>
	<Socket hostname='localhost' port='8765'/>
	<asynchronizedTTL count="second" >8000</asynchronizedTTL>
	<synchronizedTTL count="second" >20</synchronizedTTL>
	<MaxProccessNumber>5</MaxProccessNumber>
</connection>
<connection name='Sample2'>
        <StdIO>
                <exec prog='/usr/local/sbin/SampleService' option='-s -u'/>
	</StdIO>
	<asynchronizedTTL count="second" >8000</asynchronizedTTL>
	<synchronizedTTL count="second" >20</synchronizedTTL>
	<MaxProccessNumber>5</MaxProccessNumber>
</connection>

<connection>要素では,サービスとの接続方法を記述します.接続方法には

・socket:<Socket hostname='サービスプログラムのあるホスト名' port='ポート番号'/>
 (inetdもしくはxinetdへの登録が必要です.参照:RegistService.ujis)
・標準入出力:<StdIO>の子要素<exec prog='標準入出力で稼動するサービスプログラム本体のパス'
  option='プログラムに渡すコマンドライン引数'/>
・名前つきパイプ:<FIFO>(1.0版では未実装)
・IPC:<IPC>(1.0版では未実装)
・COM:<COM>(1.0版では未実装)
・その他接続モジュール:<Module>(1.0版では未実装)

を指定することができます.

さらに,非同期プロセスでのタイムアウト時間(秒)<asynchronizedTTL>,
同期プロセスでのタイムアウト処理<synchronizedTTL>
(count属性で秒'second',またはメッセージのホップ回数'hoptimes'を指定できます.)
を指定します.これらは同時に指定することができ,
リクエストメッセージによる同期・非同期の指定によって使い分けられます.

<MaxProccessNumber>で,この接続方法による最大接続数を指定できます.

<operation type ='Sample1'>add</operation>
<operation type ='Sample2'>sub</operation>

<operation>要素では,
<connection>のname属性で指定した接続方法を指定してオペレーション名を記述します.
ひとつのサービスに接続法の異なる複数のオペレーションがあってもかまいません.

<fault signature='1' />

<fault>要素ではサーバが返すFaultメッセージにサーバの署名を付加するかどうかを
signature属性('0' or '1')で指定します.

<MaxProccessNumber>15</MaxProccessNumber>

<MaxProccessNumber>でサービス全体のプロセス起動数を制限できます.

------
LastModified: July, 25. 2002 12:00:00



Copyright (C) 2001-2004 Webmasters of www.opensoap.jp. All Rights Reserved.
ご利用の際は 免責・著作権情報をご覧ください.