このセクションの内容:

概要

MQTT Extensions は、Parasoft SOAtest および Parasoft Virtualize のカスタム拡張です。MQTT Extensions をクライアント側（SOAtest）で使用して様々なタスクを実行できます。

トピックをパブリッシュする
指定された数のメッセージを受信するまで、または指定された時間が経過するまでトピックフィルターをサブスクライブする
テスト時にトピックフィルターをモニターし、発生したイベントに対して検証を実行する

サーバー側（Virtualize）では、リスナー拡張を使って Topic フィルターをサブスクライブし、受信するサブスクリプションメッセージに基づいて Topic にパブリッシュすることができます。
MQTT Extensionsは以下のカスタム拡張を提供します。

MQTT Transport: MQTT メッセージをパブリッシュするためのトランスポートプロトコルです。
MQTT Subscriber: 指定の持続時間を過ぎるまで Topic フィルターをサブスクライブするために使用します。
MQTT Message Listener: Topic フィルターをサブスクライブし、仮想化したメッセージをパブリッシュするために使用されるメッセージリスナーです。
MQTT Event Monitor: イベントモニタリングインターフェイスへのエントリポイントです。テスト中に受け取ったメッセージイベントをレポートするために Topic をサブスクライブします。
MQTT Configure Tool: テスト内の MQTT 拡張ごとに MQTT プロパティを設定しなくても良いように、異なるMQTT プロパティを設定する単純なツールです。

変数の使用

Load Test で MQTT 拡張を実行する場合、入力フィールドで使用できる変数は test_suite_loc だけであることに注意してください。Load Test は、Parasoft Marketplace 拡張用に .tst プロジェクトで使用される project_loc および workspace_loc 変数をサポートしていません。test_suite_loc 変数を使用すると、.tst プロジェクトファイルからの相対パスとして外部ファイルパスを指定できます。

インストール

MQTT Extensions は UI またはコマンドラインからインストールできます。インストールを開始する前に、圧縮ファイルをダウンロードして適切な場所に解凍してください。

UI からのインストール

[Parasoft ] > [設定] を選択し、[システムプロパティ] をクリックします。
[JAR の追加] をクリックし、mqtt.jar ファイルを選択します。
[適用] をクリックします。
SOAtest/Virtualize を再起動します。

コマンドラインからのインストール

設定プロパティファイルの system.properties.classpath プロパティに mqtt.jar ファイルを追加します。例:

system.properties.classpath=<PATH_TO_JAR>/mqtt.jar

MQTT Transport

テストに Messaging Client を追加し、[トランスポート] に [カスタム拡張] を選択します。
[実装] メニューから [MQTT] を選択します。

設定

以下の設定を行うことができます。

Connection 設定

[Connection] タブでは接続の設定を行います。

Broker URL	MQTT ブローカーの URL を定義します。URL の書式は `protocol://host:port です。` protocol は接続プロトコルです。トランスポートは MQTT ブローカーを使って TCP または WebSocket プロトコル経由でやり取りします。protocol に指定できる値は `tcp`、`ssl`、`ws`、または `wss` です。 host はブローカーのホストです。 port はブローカーのポートです。このフィールドは必須です。定義したプロトコルが `ssl` または `wss` の場合、[Transport Layer Security (TLS)] ページの設定も行う必要があります。
Client ID	ブローカーに接続するときに使用するクライアント ID を定義します。空白にした場合、MQTT ブローカーがクライアント ID を生成します。
Username	ブローカーに接続するときに使用するユーザー名を定義します。
Password	ブローカーに接続するときに使用するパスワードを定義します。
Connection Timeout	MQTT ブローカーへの接続の確立を待機するタイムアウト時間を指定します。単位は秒です。デフォルト値は `30` です。
Keep Alive Interval	アイドル状態の MQTT クライアントを切断する間隔の最大時間を定義します。デフォルト値は `60` です。
Clean Session	クリーンセッションを有効化/無効化します。 `True`: クリーンセッションを確立します。ブローカーが保持したメッセージは、クライアントに渡されません。 `False`: クリーンセッションを確立しません。ブローカーが保持したメッセージがクライアントに渡されます。デフォルトは `true` です。
Client Persistence Directory	クライアントパーシスタンスファイルを格納するディレクトリを定義します。[Clean Session] を `false` に設定している場合、クライアントパーシスタンスが役立ちます。なぜなら、クライアントパーシスタンスを利用することで、ブローカーとの接続が失われた場合に、クライアントが失ったメッセージをブローカーが特定するのを助けるためです。デフォルト: `Memory Persistence`SOAtest または Virtualize を再起動した場合、メッセージは持続しません。再起動後も持続させるには、データ用のディレクトリを定義してください。

Publish 設定

[Publish] タブではパブリッシュの設定を行います。

Topic

メッセージをパブリッシュするトピックを定義します。

Quality of Service

パブリッシュしたメッセージに紐付けるサービスメトリクスの品質を定義します。

設定できる値は、0、1、2 です。デフォルト値は 1 です。

Retain Message on Server

サーバー上にメッセージを保持するかどうかを指定します。メッセージを保持するには true に設定します。

保持したメッセージは、[Clean Session] の設定に関係なく、サブスクリプション時にクライアントに渡されます。デフォルトは false です。

Last Will and Testament (LWT) 設定

Last Will and Testament (LWT) は、クライアントがブローカーに接続するときに定義されます。クリーンな切断以外に何らかの理由でクライアントとブローカーの接続が失われた場合、ブローカーはクライアントの LWT を自動的にパブリッシュします。

Topic	LWT をパブリッシュするトピックを定義します。
Will Payload	LWT のペイロードを定義します。デフォルトは `none` です。このフィールドを設定しない場合、クライアントはブローカーと LWT を確立しません。
Quality of Service	LWT に紐付けるサービスメトリクスの品質を定義します。設定できる値は、`0`、`1`、`2` です。デフォルト値は `1` です。
Retain Message on Server	サーバー上に LWT を保持するかどうかを指定します。LWT を保持するには true に設定します。保持したメッセージは、[Clean Session] の設定に関係なく、サブスクリプション時にクライアントに渡されます。デフォルトは `false` です。

Transport Layer Security (TLS) 設定

[Broker URL] フィールドでプロトコルを ssl または wss に設定した場合、セキュアな接続を適切に確立できるよう、TLS を設定する必要があります。

TLS Protocol	セキュアな接続を確立するために使用するトランスポート層プロトコルを定義します。デフォルトは TLSv1.2 です。
Key Manager Factory	キーマネージャファクトリを定義します。キーマネージャファクトリを使って、[キーストアファイル] が提供する鍵を管理します。JVM にロードされるセキュリティプロバイダーに合わせて、異なるキーマネージャーを処理できます。JVM にセキュリティプロバイダーを追加した場合は、そのセキュリティプロバイダーのドキュメントを参照し、利用できるファクトリ名を確認してください。デフォルトは SunX509 です。
Key Store File Location	アセット (.tst、.pva、.pvn) の [キーストアファイル] への絶対パスまたは相対パスを定義します。
Key Store Type	[キーストアファイル] の種類を定義します。JVM にロードされるセキュリティプロバイダーに合わせて、異なるキーストアタイプを処理できます。JVM にセキュリティプロバイダーを追加した場合は、そのセキュリティプロバイダーのドキュメントを参照し、利用できるキーストアタイプ名を確認してください。
Key Store Password	[キーストアファイル] からキー/証明書を抽出するために使用するパスワードを定義します。空白にした場合、パスワードなしでキーの抽出を試みます。
Trust Manager Factory	トラストマネージャーファクトリを定義します。トラストマネージャーファクトリを使用して、[トラストストアファイル] が提供するキーを管理します。JVM にロードされるセキュリティプロバイダーに合わせて、異なるトラストマネージャーを利用できます。JVM にセキュリティプロバイダーを追加した場合は、そのセキュリティプロバイダーのドキュメントを参照し、利用できるファクトリ名を確認してください。デフォルトは SunX509 です。
Trust Store File Location	アセット (.tst、.pva、.pvn) の [トラストストアファイル]への絶対パスまたは相対パスを定義します。デフォルトは `Trust All Certificates` です。
Trust Store Type	[トラストストアファイル] の種類を定義します。JVM にロードされるセキュリティプロバイダーに合わせて、異なるトラストストアタイプを処理できます。JVM にセキュリティプロバイダーを追加した場合は、そのセキュリティプロバイダーのドキュメントを参照し、利用できるトラストストアタイプ名を確認してください。
Trust Store Password	[トラストストアファイル] からキー/証明書を抽出するために使用するパスワードを定義します。空白にした場合、パスワードなしでキーの抽出を試みます。

接続の管理設定

[接続の管理] タブでは、接続管理の設定を行います。

接続をキープアライブ	クライアント接続を持続して今後のパブリッシュで再利用するには、このオプションを有効化します。
テスト実行後に接続をクローズする	パブリッシュの直後にクライアント接続を切断するには、このオプションを有効化します。

MQTT Subscriber

MQTT Subscriber は、指定の持続時間に達するまで、メッセージの最大数に達するまで、または接続が終了するまで、トピックをリッスンします。メッセージの最大数がゼロ (無制限) の場合、MQTT Subscriber はサブスクリプションの最大持続時間までリッスンを試みます。