Interface TopicReferenceStore

    • Method Detail

      • acknowledgeReference

        boolean acknowledgeReference​(ConnectionContext context,
                                     String clientId,
                                     String subscriptionName,
                                     MessageId messageId)
                              throws IOException
        Removes the last acknowledged messgeID for the given subscription so that we can recover and commence dispatching messages from the last checkpoint N.B. - all messages previous to this one for a given subscriber should also be acknowledged
        Parameters:
        context -
        clientId -
        subscriptionName -
        messageId -
        Returns:
        true if there are no more references to the message - or the message is null
        Throws:
        IOException
      • recoverSubscription

        void recoverSubscription​(String clientId,
                                 String subscriptionName,
                                 MessageRecoveryListener listener)
                          throws Exception
        For the new subscription find the last acknowledged message ID and then find any new messages since then and dispatch them to the subscription.

        e.g. if we dispatched some messages to a new durable topic subscriber, then went down before acknowledging any messages, we need to know the correct point from which to recover from.

        Specified by:
        recoverSubscription in interface TopicMessageStore
        Parameters:
        clientId -
        subscriptionName -
        listener -
        Throws:
        Exception
      • resetBatching

        void resetBatching​(String clientId,
                           String subscriptionName)
        A hint to the Store to reset any batching state for a durable subsriber
        Specified by:
        resetBatching in interface TopicMessageStore
        Parameters:
        clientId -
        subscriptionName -
      • getMessageCount

        int getMessageCount​(String clientId,
                            String subscriberName)
                     throws IOException
        Get the number of messages ready to deliver from the store to a durable subscriber
        Specified by:
        getMessageCount in interface TopicMessageStore
        Parameters:
        clientId -
        subscriberName -
        Returns:
        the outstanding message count
        Throws:
        IOException
      • addSubsciption

        void addSubsciption​(SubscriptionInfo subscriptionInfo,
                            boolean retroactive)
                     throws IOException
        Inserts the subscriber info due to a subscription change

        If this is a new subscription and the retroactive is false, then the last message sent to the topic should be set as the last message acknowledged by they new subscription. Otherwise, if retroactive is true, then create the subscription without it having an acknowledged message so that on recovery, all message recorded for the topic get replayed.

        Parameters:
        subscriptionInfo -
        retroactive -
        Throws:
        IOException