Top / 開発 / サブプロジェクト / MultiPacketer

/MultiPacketer

開発/サブプロジェクト

MultiPacketer?とは †

簡単に言えば、汎用的なパケット送受信ツールです。
JavaScript?でシーケンスとパケットを定義することにより、どんなパケット(テキストベース)でも、送受信可能です。(SIPでもHTTPでもなんでもOKです。)
この特性を利用して、簡単なシミュレーションやテストに使用することが出来ます。

使用法 †

1. 取得先から、MultiPacketer?を取得します。
2. 必要なライブラリを取得します。
3. 上記を、適当なディレクトリに展開します。
4. JavaScriptファイルの作り方を参考にして、実行したいシーケンスのJavaScript?ファイルを作成します。
5. 実行法に従って実行します。

必要なライブラリ †

• J2SE5.0以上
• rhino1_6R2
• junit-3.8
• log4j-1.2.8

ビルドに必要なツール †

• Maven2

取得先 †

ソースファイル †

• ファイル：MultiPacketer1.0.src.zip

バイナリファイル †

• MultiPacketer1.0.zip

実行法 †

コマンドライン †

1. 下記のライブラリに対して、classpathを通します。
   1. 必要なライブラリのライブラリ
   2. ./lib/内のライブラリ
   3. ./target/multiPacketer.jar
2. ./js/init.js のパラメータを環境に合わせて変更します。
   1. このファイルの代わりにコマンドの引数として渡すことも出来ます。状況に応じて使い分けてください。
3. コマンドラインから、下記のコマンドを実行します。
   1. java org.siprop.simulator.multiPacketer.ConsoleMain? -Dmultipacket.config=./conf/multipacket.properties {実行したいJavaScript?ファイル}

Maven2 †

1. Maven2をインストールします。
2. ./install-path.xxx を参考に、必要なライブラリをMaven2にインストールします。
3. ./build.properties を作成して、必要なパラメータを設定します。
   1. localIP="ローカルIP(待ち受けIP)"
   2. localPort="ローカルポート(待ち受けポート)"
   3. remoteIP="リモートIP(送信先IP)"
   4. remotePort="リモートポート(送信先ポート)"
   5. transportType="トランスポートタイプ：[TCP|UDP]"
   6. ipType="IP種別：[IP4|IP6]"
   7. js="実行したいJavaScript?ファイル"
4. コマンドラインから、下記のコマンドを実行します。
   1. mvn install

ディレクトリ構造 †

-conf
 -multipacket.properties     ・・・log4jなどのシステム用設定ファイル
-js                          ・・・サンプルJavaScriptファイル
 -init.js                    ・・・初期パラメータ設定用
 -func_lib_call.js           ・・・SIPメッセージ生成用関数ライブラリ
 -basic_var.js               ・・・基本的なSIPヘッダー変数用ライブラリ
 -basic_message.js           ・・・基本的なSIPメッセージ変数用ライブラリ
 -standard_reg_uac_auth.js   ・・・一般的なREGISTERシーケンス・認証あり
 -standard_call_uac.js       ・・・一般的なUAC通話シーケンス
 -standard_call_uac_auth.js  ・・・一般的なUAC通話シーケンス・認証あり
 -standard_call_uas.js       ・・・一般的なUAS通話シーケンス
-lib
 -JainSipApi1.1.jar          ・・・Jain-SIPライブラリ
 -nist-sdp-1.0.jar           ・・・Jain-SIPライブラリ
 -nist-sip-1.2.jar           ・・・Jain-SIPライブラリ
-log                         ・・・log4j用のログファイル出力先ディレクトリ
-src
 -main                       ・・・本体のソースファイル
 -test                       ・・・test用ソースファイル
-pom.xml                     ・・・Maven2用設定ファイル
-build.xml                   ・・・実行用設定ファイル(ant用ファイル)
-install-path.bat            ・・・Maven2用の外部ライブラリインストール用バッチ
-install-path.sh             ・・・Maven2用の外部ライブラリインストール用バッチ

JavaScript?ファイルの作り方 †

1. 必要となるメッセージやヘッダーを作成し、変数にセットします。
   1. ヘッダーやパラメータ(変数)の定義：RequestURIの例
      下記のように定義します。jsEngine.setVar(String,String)で、設定した変数は、{変数名}とすることにより展開されます。
      下記例では、requestLine は、「INVITE sip:req@siprop.org SIP/2.0\r\n」と展開されます。
      また、システムが最初から保持している、システム変数もあります。

var requestUri = "sip:req@siprop.org";
jsEngine.setVar("REQUEST_URI", requestUri);

var requestLine = "INVITE {REQUEST_URI} SIP/2.0\r\n";
jsEngine.setVar("REQUEST_LINE", requestLine);

1. メッセージの定義：INVITEリクエストの例
   上記のヘッダーやパラメータを設定し、下記のような形で定義します。
   下記のすべての変数は、事前に定義しておく必要がありますが、本プログラムにおいては「basic_var.js」にて定義済みとなっています。

var INVITE_REQUEST = "INVITE {REQUEST_URI} SIP/2.0\r\n" +
                      "Call-ID:{CALL_ID}\r\n" +
                      "CSeq:{CSEQ_NUM} {METHOD}\r\n" +
                      "VIA:SIP/2.0/{TRANSPORT_TYPE} {LOCAL_IP}:{LOCAL_PORT};branch={BRANCH}\r\n" +
                      "From:\"{FROM_DISPLAYNAME}\" <{FROM_URI}>;tag={FROM_TAG}\r\n" +
                      "To:\"{TO_DISPLAYNAME}\" <{TO_URI}>\r\n" +
                      "Contact:<sip:{LOCAL_IP}:{LOCAL_PORT}>\r\n" +
                      "Allow: INVITE,ACK,CANCEL,BYE,NOTIFY,REFER,OPTIONS,MESSAGE\r\n" +
                      "Max-Forwards:70\r\n" +
                      "Content-Type: application/sdp\r\n" +
                      "Content-Length:{CONTENT_LENGTH}\r\n\r\n" +
                      "{STANDARD_SDP}";

1. 続いて、シーケンスを定義します。
   下記例は、「INVITE送信-200OK受信-ACK送信」という一般的なSIPシーケンスとなります。
   ※jsEngine.importScript()で、外部で定義したJavaScript?を呼びだし可能です。
   このほかにも、JavaScript内で使用可能なシステム関数があります。

// createACK()関数が定義されたライブラリの呼び出し
jsEngine.importScript("./js/func_lib_call.js"); 

// INVITEを送信
jsEngine.send(INVITE_REQUEST);
// 200OKを受信して、OK_RESPONSEにその内容をセットする。
var OK_RESPONSE = jsEngine.receive();
// 200OKから、ACKリクエストを生成する。
var ACK_REQUEST = createACK(OK_RESPONSE);
// 上記で、生成したACKを送信する。
jsEngine.send(ACK_REQUEST);

1. 以上で、終了です。あとは、実行してください。
   

1. Tips
   
   1. 上記例では、ほとんど、JavaScript?の関数などを利用していませんが、例えば、下記のようにすることにより、1xx応答が複数回来ることに対応可能となります。
      このように、JavaScript?の関数や機能を使うことにより、さまざまな状況に対応できます。

// 200OKパケットであるかをチェック。
var OK_RESPONSE = new String();
while(OK_RESPONSE.indexOf("SIP/2.0 200") != 1) {
  OK_RESPONSE = jsEngine.receive();
}

JavaScript?内で使用可能なシステム関数 †

JavaScript?内で使用できるシステム関数です。最新情報は、こちらを参照してください。jsFunction_XXXとなっているものが、上記の関数に相当します。

システム変数 †

システムが最初から用意している変数一覧です。最新情報は、こちらを参照してください。

拡張するには †

JSControllerクラスが外部とのインタフェースを担っています。

〜〜〜〜〜いろいろな処理〜〜〜〜〜
String result = "いろいろな処理の結果";
String jsCode = "jsEngine.setVar(\"RESULT\","\" + result  + "\");" +
               "jsEngine.importScript(\"./mainFunc.js\");";

JSController jsCon = new JSController();
jsCon.execByText(jsCode);

とすることにより、アプリ上からJavaScript?を実行することが出来ます。
mainFunc.jsには、変数RESULTを処理する内容が書かれているものとします。

各種資料 †

ドキュメント †

• Javadoc

Maven2コマンド †

PukiWiki 1.5.1 © 2001-2016 PukiWiki Development Team.
Skin "GS2" is designed by yiza.
Powered by PHP 7.2.24-0ubuntu0.18.04.17. HTML convert time: 0.029 sec.