7.3. 共有サブスクリプションの作成

共有サブスクリプションとは、1 つ以上のメッセージレシーバーを表すリモートサーバーの状態のことです。このサブスクリプションは共有されているため、複数のクライアントが同じメッセージのストリームから消費できます。

クライアントは、受信者のソースにshared 機能を設定して、共有サブスクリプションを設定します。

共有サブスクリプションは、クライアントコンテナー ID とレシーバー名を組み合わせてサブスクリプション ID を形成することで一意に識別されます。複数のクライアントプロセスで同じサブスクリプションを特定できるように、これらに安定した値を指定する必要があります。shared に加えて global 機能が設定されている場合、サブスクリプション識別に受信者名だけが使用されます。

共有サブスクリプションを作成するには、以下の手順に従います。

  1. 接続コンテナー ID を client-1 などの安定した値に設定します。 

    Connection conn = new Connection(new Address(connUrl),
                                 SaslProfile.Anonymous,
                                 new Open() { ContainerId = "client-1" },
                                 null);

  2. shared 機能を設定して、共有用の受信側ソースを設定します。 

    Source source = new Source()
{
    Address = "notifications",
    Capabilities = new Symbol[] {"shared"},
};

  3. sub-1 などの安定した名前で受信側を作成し、ソースプロパティーを適用します。 

    ReceiverLink receiver = new ReceiverLink(session, "sub-1", source, null);

詳細は、SharedSubscribe.cs の例 を参照してください。