このセクションの内容:

概要

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

Topic にパブリッシュする
目的の数のメッセージを受け取るまで、あるいは指定の持続時間を過ぎるまで、Topic フィルターをサブスクライブする
テスト実行中に Topic フィルターをモニタリングし、発生したイベントを検証する

サーバー側（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 プロパティを設定する単純なツールです。

インストール

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

UI からのインストール

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

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

localsettings プロパティファイルの 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 はサブスクリプションの最大持続時間までリッスンを試みます。