rmqp_producer.h

// Copyright 2020-2023 Bloomberg Finance L.P.
// SPDX-License-Identifier: Apache-2.0
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
 
// rmqp_producer.h
#ifndef INCLUDED_RMQP_PRODUCER
#define INCLUDED_RMQP_PRODUCER
 
#include <rmqt_queue.h>
 
#include <rmqp_messagetransformer.h>
#include <rmqp_topologyupdate.h>
#include <rmqt_confirmresponse.h>
#include <rmqt_exchange.h>
#include <rmqt_message.h>
#include <rmqt_result.h>
#include <rmqt_topology.h>
 
#include <bsls_timeinterval.h>
 
#include <bsl_functional.h>
#include <bsl_memory.h>
#include <bsl_string.h>
#include <rmqt_future.h>
 
namespace BloombergLP {
namespace rmqp {
 
class Producer {
  public:
    // TYPES
    enum SendStatus {
        SENDING,
        DUPLICATE,
        TIMEOUT,
        INFLIGHT_LIMIT,
        TRANSFORM_ERROR
    };
 
    typedef bsl::function<void(const rmqt::Message&,
                               const bsl::string& routingKey,
                               const rmqt::ConfirmResponse&)>
        ConfirmationCallback;
 
    // CREATORS
    virtual ~Producer();
 
    // MANIPULATORS
 
    virtual void addTransformer(
        const bsl::shared_ptr<rmqp::MessageTransformer>& transformer) = 0;
 
    virtual SendStatus
    send(const rmqt::Message& message,
         const bsl::string& routingKey,
         const rmqp::Producer::ConfirmationCallback& confirmCallback,
         const bsls::TimeInterval& timeout) = 0;
 
    virtual SendStatus
    send(const rmqt::Message& message,
         const bsl::string& routingKey,
         rmqt::Mandatory::Value mandatoryFlag,
         const rmqp::Producer::ConfirmationCallback& confirmCallback,
         const bsls::TimeInterval& timeout) = 0;
 
    virtual SendStatus
    trySend(const rmqt::Message& message,
            const bsl::string& routingKey,
            const rmqp::Producer::ConfirmationCallback& confirmCallback) = 0;
 
    virtual rmqt::Result<>
    waitForConfirms(const bsls::TimeInterval& timeout) = 0;
 
    virtual rmqt::Future<>
    updateTopologyAsync(const rmqt::TopologyUpdate& topologyUpdate) = 0;
 
  protected:
    Producer();
 
  private:
    Producer(const Producer&) BSLS_KEYWORD_DELETED;
    Producer& operator=(const Producer&) BSLS_KEYWORD_DELETED;
 
}; // class Producer
 
} // namespace rmqp
} // namespace BloombergLP
 
#endif // ! INCLUDED_RMQP_PRODUCER