client.hpp

Go to the documentation of this file.

#pragma once
 
/// @file userver/urabbitmq/client.hpp
/// @brief @copybrief urabbitmq::Client
 
#include <memory>
 
#include <userver/clients/dns/resolver_fwd.hpp>
#include <userver/utils/fast_pimpl.hpp>
#include <userver/utils/statistics/writer.hpp>
 
#include <userver/rabbitmq_fwd.hpp>
#include <userver/urabbitmq/broker_interface.hpp>
#include <userver/urabbitmq/client_settings.hpp>
 
USERVER_NAMESPACE_BEGIN
 
namespace urabbitmq {
 
class ConsumerBase;
class ClientImpl;
 
/// @ingroup userver_clients
///
/// @brief Interface for communicating with a RabbitMQ cluster.
///
/// Usually retrieved from components::RabbitMQ component.
class Client : public std::enable_shared_from_this<Client>,
               public IAdminInterface,
               public IChannelInterface,
               public IReliableChannelInterface {
public:
    /// Client factory function
    /// @param resolver asynchronous DNS resolver
    /// @param settings client settings
    static std::shared_ptr<Client> Create(clients::dns::Resolver& resolver, const ClientSettings& settings);
    /// Client destructor
    ~Client();
 
    void DeclareExchange(
        const Exchange& exchange,
        Exchange::Type type,
        utils::Flags<Exchange::Flags> flags,
        engine::Deadline deadline
    ) override;
 
    void DeclareExchange(const Exchange& exchange, Exchange::Type type, engine::Deadline deadline) override {
        DeclareExchange(exchange, type, {}, deadline);
    }
 
    void DeclareExchange(const Exchange& exchange, engine::Deadline deadline) override {
        DeclareExchange(exchange, Exchange::Type::kFanOut, {}, deadline);
    }
 
    void DeclareQueue(const Queue& queue, utils::Flags<Queue::Flags> flags, engine::Deadline deadline) override;
 
    void DeclareQueue(const Queue& queue, engine::Deadline deadline) override { DeclareQueue(queue, {}, deadline); }
 
    void BindQueue(
        const Exchange& exchange,
        const Queue& queue,
        const std::string& routing_key,
        engine::Deadline deadline
    ) override;
 
    void RemoveExchange(const Exchange& exchange, engine::Deadline deadline) override;
 
    void RemoveQueue(const Queue& queue, engine::Deadline deadline) override;
 
    /// @brief Get an administrative interface for the broker.
    ///
    /// @param deadline deadline for connection acquisition from the pool
    AdminChannel GetAdminChannel(engine::Deadline deadline);
 
    void Publish(
        const Exchange& exchange,
        const std::string& routing_key,
        const std::string& message,
        MessageType type,
        engine::Deadline deadline
    ) override {
        Publish(exchange, routing_key, Envelope{message, type, {}, {}, {}}, deadline);
    };
 
    void Publish(
        const Exchange& exchange,
        const std::string& routing_key,
        const std::string& message,
        engine::Deadline deadline
    ) override {
        Publish(exchange, routing_key, message, MessageType::kTransient, deadline);
    };
 
    void Publish(
        const Exchange& exchange,
        const std::string& routing_key,
        const Envelope& envelope,
        engine::Deadline deadline
    ) override;
 
    std::string Get(const Queue& queue, utils::Flags<Queue::Flags> flags, engine::Deadline deadline) override;
 
    /// @brief Get a publisher interface for the broker.
    ///
    /// @param deadline deadline for connection acquisition from the pool
    Channel GetChannel(engine::Deadline deadline);
 
    void PublishReliable(
        const Exchange& exchange,
        const std::string& routing_key,
        const std::string& message,
        MessageType type,
        engine::Deadline deadline
    ) override {
        PublishReliable(exchange, routing_key, Envelope{message, type, {}, {}, {}}, deadline);
    }
 
    void PublishReliable(
        const Exchange& exchange,
        const std::string& routing_key,
        const std::string& message,
        engine::Deadline deadline
    ) override {
        PublishReliable(exchange, routing_key, message, MessageType::kTransient, deadline);
    }
 
    void PublishReliable(
        const Exchange& exchange,
        const std::string& routing_key,
        const Envelope& envelope,
        engine::Deadline deadline
    ) override;
 
    /// @brief Get a reliable publisher interface for the broker
    /// (publisher-confirms)
    ///
    /// @param deadline deadline for connection acquisition from the pool
    ReliableChannel GetReliableChannel(engine::Deadline deadline);
 
    /// Write cluster statistics
    void WriteStatistics(utils::statistics::Writer& writer) const;
 
protected:
    Client(clients::dns::Resolver& resolver, const ClientSettings& settings);
 
private:
    friend class ConsumerBase;
    utils::FastPimpl<ClientImpl, 296, 8> impl_;
};
 
}  // namespace urabbitmq
 
USERVER_NAMESPACE_END