SIP サーブレット API のサービスの呼び出し

以下の節では、SIP Servlet API (JSR 116) のサービスの呼び出し方法について説明します。

概要

SIP Servlet API は、アプリケーション構造および対話の Service Interaction のモデルを提供します。これは 3GPP で示す Service Capability Interaction Manager (SCIM) の簡単な実施に似ています。受信リクエストの処理はすべて、SIP サーブレット API 仕様に従って、Oracle Communications Converged Application Server SIP サーブレットコンテナで制御されます。

Oracle Communications Converged Application Server SIP サーブレットコンテナは、最初に受信した SIP リクエストをフィルタし、定義済みのルール (サーブレットマッピングルール) を適用して、特定のリクエストに対応するためにデプロイされたアプリケーション内のどの SIP サーブレットを呼び出すかを判断します。この順番は常にシーケンシャルであり、SIP アプリケーションの連続したデプロイメントで構築されたコンフィグレーションファイルに定義されています。

デプロイされた各 SIP アプリケーションのデプロイメント記述子には、サーブレットマッピングルールと呼ばれる一連の条件が定義されています。これらのルールで、どのサーブレットが最初に受信したリクエストを処理するか決定します。リクエストオブジェクトはサーブレット間で「ルーティング」されているので、サーブレットからサーブレットへのパスは「レコードルート」および SIP リクエスト内の「via」ヘッダと同様の方法で記録されます。このルートは、SIP アプリケーションセッションの一部として格納され、リクエストの「From」および「To」タグの向きにより、「forward」または「reverse」の順序で同じダイアログの後続リクエストとして追加されます。この内部的な「ルート」は、SIP リクエストが Oracle Communications Converged Application Server から送信される前にリクエストオブジェクトから削除され、外部 SIP サーバから表示することはできません。この内部的な「ルート」は、既存のダイアログにある新しいリクエストが受信されると、再度追加されます。

この方法で呼び出された SIP サーブレット (SIP/HTTP アプリケーション) は、その他の SIP/HTTP アプリケーションが存在するかどうかは無視します。これは、SIP サーブレットプログラミングモデルの特徴の 1 つです。このモデルを最大限に使用するには、開発者はサーブレットコンテナを中間プロキシとして効果的に動作するコンテナを持つ、論理的なサブネットワークのように処理する必要があります。SIP サーブレットコンテナは、IMS アーキテクチャの S-CSCF 機能と比較される場合が数多くあります。

サーブレットマッピングルール : オブジェクト、プロパティ、条件

サブレットマッピングルールはサービス開発者が定義し、詳細情報はアプリケーションのデプロイメント記述子で説明されます。デプロイメント記述子とは、Oracle Communications Converged Application Server でデプロイされた SAR アーカイブファイルにあるドキュメントです。アプリケーション (SIP/HTTP アプリケーション) のデプロイメント記述子に 1 つ以上のサーブレットマッピングルールを定義することができます。この場合、これらのルールをデプロイメント記述子に定義された順番で適用する必要があります。

以下の図は、一般的なデプロイメント記述子にある単純なサーブレットマッピングルールのサンプルを示します。

コードリスト A-1 に示すサーブレットマッピングルールは、以下のブール式を説明します。

サポート対象のサービストリガポイント

サービストリガポイントは、SIP リクエストの属性であり、サブレットマッピングルールで評価することができます。詳細については、JSR 116 仕様の「節 11.1: トリガのルール」を参照してください。

リクエストオブジェクト

リクエストオブジェクトは、Java で表した SIP リクエストです。

method: リクエストメソッドであり、文字列で示します。
uri: リクエストの URI。たとえば SipURI、TelURL などです。
from: From ヘッダの値を表すアドレスです。
to: To ヘッダの値を表すアドレスです。

URI:

scheme: URI scheme を示します。

SipURI (URI を拡張):

scheme: 「sip」または「sips」などのリテラル文字列
user: SIP/SIPS URI の「user」部分を示します。
host: SIP/SIPS URI の「host」部分を示します。ドメイン名またはドット付き 10 進法 IP アドレスを入力できます。
port: 10 進法の形式で表したポート番号です。存在しない場合、デフォルト値を使用します。(UDP か TCP には 5060、TLS には 5061 を入力します。)
tel:「user」パラメータが「phone」でない場合、この変数は定義されません。それ以外の場合、この値は SIP/SIPS URI の「user」部分に含まれる電話番号となり、表示される区切り文字は削除されます。この変数は、大文字と小文字を区別しません (電話番号には、「A」、「B」、「C」および「D」を入力することができます)。
param.name: SIP/SIPS URI に入力したパラメータ名の値を示します。名前は有効な SIP/SIPS URI パラメータ名である必要があります。

TelURL (URI を拡張):

scheme: 常にリテラル文字列「tel」を示します。
tel: 表示される区切り文字が削除された tel URL サブスクライバ名を示します。
param.name: tel URL 内の名前を持つパラメータの値を示します。名前は有効な tel URL パラメータ名である必要があります。

アドレス:

uri: URI オブジェクトです。上記の URI、SipURI および TelURL のタイプを参照してください。
display-name: From または To ヘッダの display-name の部分を示します。

条件と論理的なコネクタ

equal: 変数の値をリテラル値と比較します。変数が定義されていて、その値がリテラル値と等しい場合、「true」を示します。それ以外の場合、「false」を示します。
exists: 変数名を入力します。変数名が定義されていれば「true」を示し、それ以外の場合は「false」を示します。
contains: 1 つ目の引数として指定された変数の値が、2 つ目の引数として指定されたリテラル文字列を含む場合、「true」を示します。
subdomain-of: ドメイン名 (SIP/SIPS URI ホスト)または電話サブスクライバ (SIP または Tel URL の tel プロパティ)、およびリテラル値を表す変数であり、このオペレータはリテラル値で取得したドメインのサブドメインを示す変数の場合、「true」を返します。ドメイン名はサブドメインの構成要素の DNS 定義と一致します。例えば、ドメイン名「example.com」および「research.example.com」は、両方とも「example.com」のサブドメインです。このオペレータの引数として IP アドレスを入力することができます。ただし、両方がマッチする必要があります。tel 変数の場合、最初の引数で区切られた電話番号の接頭文字が 2 つ目の引数として与えられたリテラル値と一致する場合、オペレータのサブドメインは「true」を示します。たとえば、電話番号「1 212 555 1212」は「1212555」のサブドメインと見なされます。
and: 多くの条件が含まれます。含まれるすべての条件が true の場合のみ、true を示します。
or: 多くの条件が含まれます。含まれる条件のうち、少なくとも 1 つの条件が true の場合のみ、true を示します。
not: 含まれている条件の値を否定します。

equal および contains のオペレータは、比較処理を行う場合、オプションとして大文字と小文字の区別をしない設定ができます。デフォルトでは、大文字と小文字は区別されます。

製品の技術的な説明