Qpid Proton C++ API  0.37.0

Subscribes to the 'examples' node on an intermediary accessible on Simply prints out the body of received messages.

* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you 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
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
#include "options.hpp"
#include <proton/link.hpp>
#include <proton/value.hpp>
#include <iostream>
#include <map>
class simple_recv : public proton::messaging_handler {
std::string url;
std::string user;
std::string password;
proton::receiver receiver;
int expected;
int received;
simple_recv(const std::string &s, const std::string &u, const std::string &p, int c) :
url(s), user(u), password(p), expected(c), received(0) {}
if (!user.empty()) co.user(user);
if (!password.empty()) co.password(password);
receiver = c.open_receiver(url, co);
void on_message(proton::delivery &d, proton::message &msg) override {
if (!msg.id().empty() && proton::coerce<int>(msg.id()) < received) {
return; // Ignore if no id or duplicate
if (expected == 0 || received < expected) {
std::cout << msg.body() << std::endl;
if (received == expected) {
int main(int argc, char **argv) {
std::string address("");
std::string user;
std::string password;
int message_count = 100;
example::options opts(argc, argv);
opts.add_value(address, 'a', "address", "connect to and receive from URL", "URL");
opts.add_value(message_count, 'm', "messages", "receive COUNT messages", "COUNT");
opts.add_value(user, 'u', "user", "authenticate as USER", "USER");
opts.add_value(password, 'p', "password", "authenticate with PASSWORD", "PASSWORD");
try {
simple_recv recv(address, user, password, message_count);
return 0;
} catch (const example::bad_option& e) {
std::cout << opts << std::endl << e.what() << std::endl;
} catch (const std::exception& e) {
std::cerr << e.what() << std::endl;
return 1;
Options for creating a connection.
Definition: connection_options.hpp:67
connection_options & user(const std::string &)
Set the user name used to authenticate the connection.
connection_options & password(const std::string &)
Set the password used to authenticate the connection.
void close()
Close the connection.
A top-level container of connections, sessions, and links.
Definition: container.hpp:49
void run()
Run the container in the current thread.
returned< receiver > open_receiver(const std::string &addr_url)
Open a connection and receiver for addr_url.
A received message.
Definition: delivery.hpp:40
class receiver receiver() const
Return the receiver for this delivery.
An AMQP message.
Definition: message.hpp:48
void id(const message_id &)
Set the message ID.
void body(const value &x)
Set the body. Equivalent to body() = x.
Handler for Proton messaging events.
Definition: messaging_handler.hpp:69
virtual void on_message(delivery &, message &)
A message is received.
virtual void on_container_start(container &)
The container event loop is starting.
A channel for receiving messages.
Definition: receiver.hpp:41
class connection connection() const
Return the connection for this transfer.
A connection to a remote AMQP peer.
Options for creating a connection.
A top-level container of connections, sessions, and links.
A received message.
An AMQP message.
An AMQP message ID.
Handler for Proton messaging events.
A holder for any AMQP value, simple or complex.