AMQPクライアントイベントハンドラーを実装する
AMQPイベントハンドラを実装するには、最初にインターフェイスIF_AMQP_CLIENT_EVENT_HANDLERを実装する必要があります。システムはAMQPクライアントイベントハンドラメソッドを呼び出して、アプリケーションがAMQPクライアントオブジェクトの着信確認応答とイベントを処理できるようにします。アプリケーションは、次のイベントハンドラーメソッドを実装できます。
インターフェイスメソッドON_ACCEPT_SESSIONは、AMQPクライアントフレームワークの将来の拡張用に予約されています。実装は空のままにしておく必要があります。
AMQPクライアントオブジェクトを作成して使用する
AMQPクライアントオブジェクトはタイプIF_AMQP_CLIENTであり、ファクトリクラスを使用して作成する必要がありますCL_AMQP_CLIENT_MANAGER。2つの異なるクライアントファクトリメソッドがあります。
-
CL_AMQP_CLIENT_MANAGER~CREATE_BY_DESTINATIONAMQPWebSocketベースの通信用。
- CL_MQTT_CLIENT_MANAGER~CREATE_BY_URLWebSocketとTCPソケットベースのAMQP通信の両方。次のURLプレフィックスを使用して、適切な基盤となるプロトコルを選択できます。
- ws://wss://WebSocketとSecureWebSocketの場合
- tcp://およびtcps://TCPソケットとセキュアTCPソケットの場合
の場合CREATE_BY_DESTINATION、トランザクションSM59でタイプ’G’（外部サーバへのHTTP接続）の宛先を更新する必要があります。宛先の[ログオンとセキュリティ]タブで、オプションでユーザーとパスワードを更新できます。ユーザーが指定されている場合、ユーザーとパスワードは、SASL PLAIN認証のAMQP接続フェーズで使用されます（IETF RFC 4616に準拠）。
これらの接続パラメーターに加えて、実装したAMQPクライアントイベントハンドラーをファクトリメソッドに指定する必要があります。
ファクトリメソッドが正常に実行されると、タイプがのAMQPクライアントオブジェクトが提供されますIF_AMQP_CLIENT。このオブジェクトは、次のメソッドを提供します。
このメソッドIF_AMQP_CLIENT~OPENはAMQP接続を確立します。このメソッドは、接続のAPCおよびAMQPステップに追加の接続オプションを指定するためのオプションのインポートパラメーターを提供します。パラメータI_APC_CONNECT_OPTIONSを使用すると、アプリケーションでAPC接続オプションを指定できます。たとえば、接続セットアップタイムアウトや、発信および着信AMQPメッセージのウイルススキャンプロファイルなどです。パラメータI_AMQP_CONNECT_OPTIONSを使用すると、アプリケーションでAMQP関連のオプションを指定できます。たとえば、オプションのSASLハンドシェイクのユーザー名とパスワード、AMQP接続の維持時間間隔、AMQPコンテナIDなどです。
このメソッドIF_AMQP_CLIENT~CLOSEは、AMQP接続とその下にあるAPC接続を終了します。確立されたAMQPセッションとリンクの場合、AMQPクライアントはフレームの前にフレームを送信ENDします。DETACHCLOSE
このメソッドIF_AMQP_CLIENT~GET_CONTEXTは、AMQPクライアントの接続に関する情報を提供します。コンテキストには、次の情報が含まれています。
- 接続の最初のHTTP要求（TCPソケットの場合、Internet Communication Manager（ICM）への内部HTTP要求があります）
- 接続ID（IDは拡張パスポート（EPP）にも記載されています）
- 接続状態
