APIkit for AsyncAPI でサポートされているバインドとパラメーター化されたチャネル

APIkit for AsyncAPI は、メッセージ駆動型アーキテクチャを可能にするさまざまなバインドをサポートしています。

コネクタ パブリッシュ メッセージリスナー 説明 参照

MQ (Anypoint MQ Connector) 用 Anypoint コネクタ

destination

destination

デフォルトでは、AnypointMQ Connector は ​destination​ としてチャネル名を使用します。チャネル名が実際の ​destination​ 名と異なる場合、またはチャネル名が有効な ​destination​ 名でない場合は、​destination​ (キューまたはエクスチェンジ) 名を指定する必要があります。

「Anypoint MQ Bindings (Anypoint MQ バインド)」Leaving the Site​を参照してください。

Solace PubSub+ Connector

deliveryMode

deliveryMode

Solace PubSub+ Connector は、​direct​ モードまたは ​persistent​ モードで動作します。デフォルトモードは ​persistent​ です。​deliveryMode​ パラメーターは、メッセージのパブリッシュのサービス品質を決定します。​Direct​ モードは、レイテンシーは低くなりますが、メッセージ配信が保証されません。「persistent」モードでは、ブローカーに障害が発生した場合でも、メッセージが確実に配信されます。

「Solace Bindings (Solace バインド)」Leaving the Site​を参照してください。

destinationType

destinationType

Solace PubSub+ Connector は、APIkit for AsyncAPI の ​queue​ をサポートしています。

「Solace Bindings (Solace バインド)」Leaving the Site​を参照してください。

なし

topicSubscriptions

Solace PubSub+ Connector は、​destinationType​ が ​queue​ の場合にキューがサブスクライブするトピックのリストを指定します。トピックを指定しない場合、​queue​ はチャネル名が表すトピックに自動的にサブスクライブします。

「Solace Bindings (Solace バインド)」Leaving the Site​を参照してください。

Apache Kafka 用 Anypoint Connector (Apache Kafka Connector) および Solace PubSub+ Connector は、バインドをサポートしていません。

パラメーター化されたチャネル

APIkit for AsyncAPI はパラメーター化されたチャネルをサポートしているため、動的で再利用可能な設定を定義し、インテグレーションをより効果的に拡張し、インテグレーションのさまざまな部分で一貫した設定を作成できます。

APIkit for AsyncAPI は、バインドで定義されたパラメーターをサポートしていません。たとえば、AnypointMQ の ​destination​ など。

次のコードは、パラメーター化された ​destination​ を含む部分的な API 仕様の例を示しています。

channels:
  orderAcknowledgement:
    description: new Order Acknowledgment
    servers:
      - anypointMQ
    bindings:
      anypointmq:
        destination: '{env}.amq-asyncapi-poc.orderAcknowledgement'
        destinationType: queue
    parameters:
      env:
        $ref: '#/components/parameters/env'
    publish:
      operationId: listen-order-ack
      description: publish a new Order Acknowledgment event to this channel and we will process it
      message:
        $ref: '#/components/messages/orderAckMessage'
yaml

パラメーター化されたチャネルは、設計時に設定する必要があります。実行時にパラメーター化されたチャネルを設定することはできません。

パラメーター化されたチャネルを使用した完全な API の例を示します。

APIkit for AsyncAPI は、​listeners​ でのみパラメーター化されたチャネルを使用します。