rmqp_connection.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_connection.h
#ifndef INCLUDED_RMQP_CONNECTION
#define INCLUDED_RMQP_CONNECTION
 
#include <rmqp_consumer.h>
#include <rmqp_producer.h>
#include <rmqt_consumerconfig.h>
 
#include <rmqt_future.h>
#include <rmqt_result.h>
 
#include <bsl_string.h>
#include <bsls_timeinterval.h>
 
//@PURPOSE: Provide a RabbitMQ Connection API
//
//@CLASSES:
//  rmqp::Connection: a RabbitMQ Connection API object
 
namespace BloombergLP {
namespace rmqp {
 
 
class Connection {
  public:
    // TYPES
    typedef enum { SUCCESS = 0, FAIL } ReturnCode;
 
    Connection();
    virtual ~Connection();
 
    // MANIPULATORS
    virtual rmqt::Result<Producer>
    createProducer(const rmqt::Topology& topology,
                   rmqt::ExchangeHandle exchange,
                   uint16_t maxOutstandingConfirms) = 0;
 
    virtual rmqt::Result<rmqp::Consumer>
    createConsumer(const rmqt::Topology& topology,
                   rmqt::QueueHandle queue,
                   const rmqp::Consumer::ConsumerFunc& onMessage,
                   const rmqt::ConsumerConfig& consumerConfig) = 0;
 
    virtual void close() = 0;
 
    virtual rmqt::Future<Producer>
    createProducerAsync(const rmqt::Topology& topology,
                        rmqt::ExchangeHandle exchange,
                        uint16_t maxOutstandingConfirms) = 0;
 
    virtual rmqt::Future<rmqp::Consumer>
    createConsumerAsync(const rmqt::Topology& topology,
                        rmqt::QueueHandle queue,
                        const rmqp::Consumer::ConsumerFunc& onMessage,
                        const rmqt::ConsumerConfig& consumerConfig) = 0;
 
    // DEPRECATED
    virtual rmqt::Result<rmqp::Consumer>
    createConsumer(const rmqt::Topology& topology,
                   rmqt::QueueHandle queue,
                   const rmqp::Consumer::ConsumerFunc& messageConsumer,
                   const bsl::string& consumerTag,
                   uint16_t prefetchCount);
 
    virtual rmqt::Future<rmqp::Consumer>
    createConsumerAsync(const rmqt::Topology& topology,
                        rmqt::QueueHandle queue,
                        const rmqp::Consumer::ConsumerFunc& messageConsumer,
                        const bsl::string& consumerTag,
                        uint16_t prefetchCount);
 
}; // class Connection
 
} // namespace rmqp
} // namespace BloombergLP
 
#endif // ! INCLUDED_RMQP_CONNECTION