| <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
| <html xmlns="http://www.w3.org/1999/xhtml"> |
| <head> |
| <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/> |
| <meta http-equiv="X-UA-Compatible" content="IE=9"/> |
| <meta name="generator" content="Doxygen 1.8.13"/> |
| <meta name="viewport" content="width=device-width, initial-scale=1"/> |
| <title>Qpid Proton C++ API: multithreaded_client.cpp</title> |
| <link href="tabs.css" rel="stylesheet" type="text/css"/> |
| <script type="text/javascript" src="jquery.js"></script> |
| <script type="text/javascript" src="dynsections.js"></script> |
| <link href="navtree.css" rel="stylesheet" type="text/css"/> |
| <script type="text/javascript" src="resize.js"></script> |
| <script type="text/javascript" src="navtreedata.js"></script> |
| <script type="text/javascript" src="navtree.js"></script> |
| <script type="text/javascript"> |
| $(document).ready(initResizable); |
| </script> |
| <link href="search/search.css" rel="stylesheet" type="text/css"/> |
| <script type="text/javascript" src="search/searchdata.js"></script> |
| <script type="text/javascript" src="search/search.js"></script> |
| <script type="text/javascript"> |
| $(document).ready(function() { init_search(); }); |
| </script> |
| <link href="doxygen.css" rel="stylesheet" type="text/css" /> |
| </head> |
| <body> |
| <div id="top"><!-- do not remove this div, it is closed by doxygen! --> |
| <div id="titlearea"> |
| <table cellspacing="0" cellpadding="0"> |
| <tbody> |
| <tr style="height: 56px;"> |
| <td id="projectalign" style="padding-left: 0.5em;"> |
| <div id="projectname">Qpid Proton C++ API |
|  <span id="projectnumber">0.21.0</span> |
| </div> |
| </td> |
| <td> <div id="MSearchBox" class="MSearchBoxInactive"> |
| <span class="left"> |
| <img id="MSearchSelect" src="search/mag_sel.png" |
| onmouseover="return searchBox.OnSearchSelectShow()" |
| onmouseout="return searchBox.OnSearchSelectHide()" |
| alt=""/> |
| <input type="text" id="MSearchField" value="Search" accesskey="S" |
| onfocus="searchBox.OnSearchFieldFocus(true)" |
| onblur="searchBox.OnSearchFieldFocus(false)" |
| onkeyup="searchBox.OnSearchFieldChange(event)"/> |
| </span><span class="right"> |
| <a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a> |
| </span> |
| </div> |
| </td> |
| </tr> |
| </tbody> |
| </table> |
| </div> |
| <!-- end header part --> |
| <!-- Generated by Doxygen 1.8.13 --> |
| <script type="text/javascript"> |
| var searchBox = new SearchBox("searchBox", "search",false,'Search'); |
| </script> |
| </div><!-- top --> |
| <div id="side-nav" class="ui-resizable side-nav-resizable"> |
| <div id="nav-tree"> |
| <div id="nav-tree-contents"> |
| <div id="nav-sync" class="sync"></div> |
| </div> |
| </div> |
| <div id="splitbar" style="-moz-user-select:none;" |
| class="ui-resizable-handle"> |
| </div> |
| </div> |
| <script type="text/javascript"> |
| $(document).ready(function(){initNavTree('multithreaded_client_8cpp-example.html','');}); |
| </script> |
| <div id="doc-content"> |
| <!-- window showing the filter options --> |
| <div id="MSearchSelectWindow" |
| onmouseover="return searchBox.OnSearchSelectShow()" |
| onmouseout="return searchBox.OnSearchSelectHide()" |
| onkeydown="return searchBox.OnSearchSelectKey(event)"> |
| </div> |
| |
| <!-- iframe showing the search results (closed by default) --> |
| <div id="MSearchResultsWindow"> |
| <iframe src="javascript:void(0)" frameborder="0" |
| name="MSearchResults" id="MSearchResults"> |
| </iframe> |
| </div> |
| |
| <div class="header"> |
| <div class="headertitle"> |
| <div class="title">multithreaded_client.cpp</div> </div> |
| </div><!--header--> |
| <div class="contents"> |
| <p>A multithreaded sender and receiver.<b>Requires C++11</b></p> |
| <div class="fragment"><div class="line"><span class="comment">/*</span></div><div class="line"><span class="comment"> * Licensed to the Apache Software Foundation (ASF) under one</span></div><div class="line"><span class="comment"> * or more contributor license agreements. See the NOTICE file</span></div><div class="line"><span class="comment"> * distributed with this work for additional information</span></div><div class="line"><span class="comment"> * regarding copyright ownership. The ASF licenses this file</span></div><div class="line"><span class="comment"> * to you under the Apache License, Version 2.0 (the</span></div><div class="line"><span class="comment"> * "License"); you may not use this file except in compliance</span></div><div class="line"><span class="comment"> * with the License. You may obtain a copy of the License at</span></div><div class="line"><span class="comment"> *</span></div><div class="line"><span class="comment"> * http://www.apache.org/licenses/LICENSE-2.0</span></div><div class="line"><span class="comment"> *</span></div><div class="line"><span class="comment"> * Unless required by applicable law or agreed to in writing,</span></div><div class="line"><span class="comment"> * software distributed under the License is distributed on an</span></div><div class="line"><span class="comment"> * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY</span></div><div class="line"><span class="comment"> * KIND, either express or implied. See the License for the</span></div><div class="line"><span class="comment"> * specific language governing permissions and limitations</span></div><div class="line"><span class="comment"> * under the License.</span></div><div class="line"><span class="comment"> */</span></div><div class="line"></div><div class="line"><span class="comment">//</span></div><div class="line"><span class="comment">// C++11 or greater</span></div><div class="line"><span class="comment">//</span></div><div class="line"><span class="comment">// A multi-threaded client that calls proton::container::run() in one thread, sends</span></div><div class="line"><span class="comment">// messages in another and receives messages in a third.</span></div><div class="line"><span class="comment">//</span></div><div class="line"><span class="comment">// Note this client does not deal with flow-control. If the sender is faster</span></div><div class="line"><span class="comment">// than the receiver, messages will build up in memory on the sending side.</span></div><div class="line"><span class="comment">// See @ref multithreaded_client_flow_control.cpp for a more complex example with</span></div><div class="line"><span class="comment">// flow control.</span></div><div class="line"><span class="comment">//</span></div><div class="line"><span class="comment">// NOTE: no proper error handling</span></div><div class="line"></div><div class="line"><span class="preprocessor">#include <<a class="code" href="connection_8hpp.html">proton/connection.hpp</a>></span></div><div class="line"><span class="preprocessor">#include <<a class="code" href="connection__options_8hpp.html">proton/connection_options.hpp</a>></span></div><div class="line"><span class="preprocessor">#include <<a class="code" href="container_8hpp.html">proton/container.hpp</a>></span></div><div class="line"><span class="preprocessor">#include <<a class="code" href="message_8hpp.html">proton/message.hpp</a>></span></div><div class="line"><span class="preprocessor">#include <<a class="code" href="messaging__handler_8hpp.html">proton/messaging_handler.hpp</a>></span></div><div class="line"><span class="preprocessor">#include <<a class="code" href="receiver_8hpp.html">proton/receiver.hpp</a>></span></div><div class="line"><span class="preprocessor">#include <<a class="code" href="sender_8hpp.html">proton/sender.hpp</a>></span></div><div class="line"><span class="preprocessor">#include <<a class="code" href="work__queue_8hpp.html">proton/work_queue.hpp</a>></span></div><div class="line"></div><div class="line"><span class="preprocessor">#include <condition_variable></span></div><div class="line"><span class="preprocessor">#include <iostream></span></div><div class="line"><span class="preprocessor">#include <mutex></span></div><div class="line"><span class="preprocessor">#include <queue></span></div><div class="line"><span class="preprocessor">#include <sstream></span></div><div class="line"><span class="preprocessor">#include <string></span></div><div class="line"><span class="preprocessor">#include <thread></span></div><div class="line"></div><div class="line"><span class="comment">// Lock output from threads to avoid scrambling</span></div><div class="line">std::mutex out_lock;</div><div class="line"><span class="preprocessor">#define OUT(x) do { std::lock_guard<std::mutex> l(out_lock); x; } while (false)</span></div><div class="line"></div><div class="line"><span class="comment">// Handler for a single thread-safe sending and receiving connection.</span></div><div class="line"><span class="keyword">class </span>client : <span class="keyword">public</span> <a name="_a0"></a><a class="code" href="classproton_1_1messaging__handler.html">proton::messaging_handler</a> {</div><div class="line"> <span class="comment">// Invariant</span></div><div class="line"> <span class="keyword">const</span> std::string url_;</div><div class="line"> <span class="keyword">const</span> std::string address_;</div><div class="line"></div><div class="line"> <span class="comment">// Only used in proton handler thread</span></div><div class="line"> <a name="_a1"></a><a class="code" href="classproton_1_1sender.html">proton::sender</a> sender_;</div><div class="line"></div><div class="line"> <span class="comment">// Shared by proton and user threads, protected by lock_</span></div><div class="line"> std::mutex lock_;</div><div class="line"> <a name="_a2"></a><a class="code" href="classproton_1_1work__queue.html">proton::work_queue</a> *work_queue_;</div><div class="line"> std::condition_variable sender_ready_;</div><div class="line"> std::queue<proton::message> messages_;</div><div class="line"> std::condition_variable messages_ready_;</div><div class="line"></div><div class="line"> <span class="keyword">public</span>:</div><div class="line"> client(<span class="keyword">const</span> std::string& url, <span class="keyword">const</span> std::string& address) : url_(url), address_(address), work_queue_(0) {}</div><div class="line"></div><div class="line"> <span class="comment">// Thread safe</span></div><div class="line"> <span class="keywordtype">void</span> send(<span class="keyword">const</span> <a name="_a3"></a><a class="code" href="classproton_1_1message.html">proton::message</a>& msg) {</div><div class="line"> <span class="comment">// Use [=] to copy the message, we cannot pass it by reference since it</span></div><div class="line"> <span class="comment">// will be used in another thread.</span></div><div class="line"> work_queue()-><a name="a4"></a><a class="code" href="classproton_1_1work__queue.html#a59dae2153455bc095477a3b66a0b681e">add</a>([=]() { sender_.<a name="a5"></a><a class="code" href="classproton_1_1sender.html#a214eb30b24e6831d016a47b9dddda830">send</a>(msg); });</div><div class="line"> }</div><div class="line"></div><div class="line"> <span class="comment">// Thread safe</span></div><div class="line"> <a class="code" href="classproton_1_1message.html">proton::message</a> receive() {</div><div class="line"> std::unique_lock<std::mutex> l(lock_);</div><div class="line"> <span class="keywordflow">while</span> (messages_.empty()) messages_ready_.wait(l);</div><div class="line"> <span class="keyword">auto</span> msg = std::move(messages_.front());</div><div class="line"> messages_.pop();</div><div class="line"> <span class="keywordflow">return</span> msg;</div><div class="line"> }</div><div class="line"></div><div class="line"> <span class="comment">// Thread safe</span></div><div class="line"> <span class="keywordtype">void</span> close() {</div><div class="line"> work_queue()->add([=]() { sender_.<a name="a6"></a><a class="code" href="classproton_1_1link.html#aff302bb6016f2ae29f01bb4e07389a52">connection</a>().<a name="a7"></a><a class="code" href="classproton_1_1connection.html#a5ae591df94fc66ccb85cbb6565368bca">close</a>(); });</div><div class="line"> }</div><div class="line"></div><div class="line"> <span class="keyword">private</span>:</div><div class="line"></div><div class="line"> <a class="code" href="classproton_1_1work__queue.html">proton::work_queue</a>* work_queue() {</div><div class="line"> <span class="comment">// Wait till work_queue_ and sender_ are initialized.</span></div><div class="line"> std::unique_lock<std::mutex> l(lock_);</div><div class="line"> <span class="keywordflow">while</span> (!work_queue_) sender_ready_.wait(l);</div><div class="line"> <span class="keywordflow">return</span> work_queue_;</div><div class="line"> }</div><div class="line"></div><div class="line"> <span class="comment">// == messaging_handler overrides, only called in proton handler thread</span></div><div class="line"></div><div class="line"> <span class="comment">// Note: this example creates a connection when the container starts.</span></div><div class="line"> <span class="comment">// To create connections after the container has started, use</span></div><div class="line"> <span class="comment">// container::connect().</span></div><div class="line"> <span class="comment">// See @ref multithreaded_client_flow_control.cpp for an example.</span></div><div class="line"> <span class="keywordtype">void</span> <a name="a8"></a><a class="code" href="classproton_1_1messaging__handler.html#a9188622c33638e076d2214080129c824">on_container_start</a>(<a name="_a9"></a><a class="code" href="classproton_1_1container.html">proton::container</a>& cont)<span class="keyword"> override </span>{</div><div class="line"> cont.<a name="a10"></a><a class="code" href="classproton_1_1container.html#adbd9ed231804512a47cca3c81f00cdf1">connect</a>(url_);</div><div class="line"> }</div><div class="line"></div><div class="line"> <span class="keywordtype">void</span> <a name="a11"></a><a class="code" href="classproton_1_1messaging__handler.html#a41277abe0e33a3df2764b08dcc12d768">on_connection_open</a>(<a name="_a12"></a><a class="code" href="classproton_1_1connection.html">proton::connection</a>& conn)<span class="keyword"> override </span>{</div><div class="line"> conn.<a name="a13"></a><a class="code" href="classproton_1_1connection.html#ae8eece4fd4b9e1a2531ca12d2ab57a32">open_sender</a>(address_);</div><div class="line"> conn.<a name="a14"></a><a class="code" href="classproton_1_1connection.html#aad60d14592ee9d34caca4c61214ecd27">open_receiver</a>(address_);</div><div class="line"> }</div><div class="line"></div><div class="line"> <span class="keywordtype">void</span> <a name="a15"></a><a class="code" href="classproton_1_1messaging__handler.html#ac655d56c64574c9eb7b10e80d32764f4">on_sender_open</a>(<a class="code" href="classproton_1_1sender.html">proton::sender</a>& s)<span class="keyword"> override </span>{</div><div class="line"> <span class="comment">// sender_ and work_queue_ must be set atomically</span></div><div class="line"> std::lock_guard<std::mutex> l(lock_);</div><div class="line"> sender_ = s;</div><div class="line"> work_queue_ = &s.<a name="a16"></a><a class="code" href="classproton_1_1link.html#a7c755d6ac6385e007adb61966598ba63">work_queue</a>();</div><div class="line"> sender_ready_.notify_all();</div><div class="line"> }</div><div class="line"></div><div class="line"> <span class="keywordtype">void</span> <a name="a17"></a><a class="code" href="classproton_1_1messaging__handler.html#a584c9daeadf4322801f58e054017fecb">on_message</a>(<a name="_a18"></a><a class="code" href="classproton_1_1delivery.html">proton::delivery</a>& dlv, <a class="code" href="classproton_1_1message.html">proton::message</a>& msg)<span class="keyword"> override </span>{</div><div class="line"> std::lock_guard<std::mutex> l(lock_);</div><div class="line"> messages_.push(msg);</div><div class="line"> messages_ready_.notify_all();</div><div class="line"> }</div><div class="line"></div><div class="line"> <span class="keywordtype">void</span> <a name="a19"></a><a class="code" href="classproton_1_1messaging__handler.html#a042f595d1807eb1abe0195ab79357edd">on_error</a>(<span class="keyword">const</span> <a name="_a20"></a><a class="code" href="classproton_1_1error__condition.html">proton::error_condition</a>& e)<span class="keyword"> override </span>{</div><div class="line"> OUT(std::cerr << <span class="stringliteral">"unexpected error: "</span> << e << std::endl);</div><div class="line"> exit(1);</div><div class="line"> }</div><div class="line">};</div><div class="line"></div><div class="line"><span class="keywordtype">int</span> main(<span class="keywordtype">int</span> argc, <span class="keyword">const</span> <span class="keywordtype">char</span>** argv) {</div><div class="line"> <span class="keywordflow">try</span> {</div><div class="line"> <span class="keywordflow">if</span> (argc != 4) {</div><div class="line"> std ::cerr <<</div><div class="line"> <span class="stringliteral">"Usage: "</span> << argv[0] << <span class="stringliteral">" CONNECTION-URL AMQP-ADDRESS MESSAGE-COUNT\n"</span></div><div class="line"> <span class="stringliteral">"CONNECTION-URL: connection address, e.g.'amqp://127.0.0.1'\n"</span></div><div class="line"> <span class="stringliteral">"AMQP-ADDRESS: AMQP node address, e.g. 'examples'\n"</span></div><div class="line"> <span class="stringliteral">"MESSAGE-COUNT: number of messages to send\n"</span>;</div><div class="line"> <span class="keywordflow">return</span> 1;</div><div class="line"> }</div><div class="line"> <span class="keyword">const</span> <span class="keywordtype">char</span> *url = argv[1];</div><div class="line"> <span class="keyword">const</span> <span class="keywordtype">char</span> *address = argv[2];</div><div class="line"> <span class="keywordtype">int</span> n_messages = atoi(argv[3]);</div><div class="line"></div><div class="line"> client cl(url, address);</div><div class="line"> <a class="code" href="classproton_1_1container.html">proton::container</a> container(cl);</div><div class="line"> std::thread container_thread([&]() { container.<a name="a21"></a><a class="code" href="classproton_1_1container.html#a13a43e6d814de94978c515cb084873b1">run</a>(); });</div><div class="line"></div><div class="line"> std::thread sender([&]() {</div><div class="line"> <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i = 0; i < n_messages; ++i) {</div><div class="line"> <a class="code" href="classproton_1_1message.html">proton::message</a> msg(<a name="a22"></a><a class="code" href="namespaceproton.html#a1367d11b0ac6a99ea8e7d9a5b8f36b34">std::to_string</a>(i + 1));</div><div class="line"> cl.send(msg);</div><div class="line"> OUT(std::cout << <span class="stringliteral">"sent \""</span> << msg.<a name="a23"></a><a class="code" href="classproton_1_1message.html#ae9af642f154a68ec0eb8e715ecaf95ae">body</a>() << <span class="charliteral">'"'</span> << std::endl);</div><div class="line"> }</div><div class="line"> });</div><div class="line"></div><div class="line"> <span class="keywordtype">int</span> received = 0;</div><div class="line"> std::thread receiver([&]() {</div><div class="line"> <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i = 0; i < n_messages; ++i) {</div><div class="line"> <span class="keyword">auto</span> msg = cl.receive();</div><div class="line"> OUT(std::cout << <span class="stringliteral">"received \""</span> << msg.body() << <span class="charliteral">'"'</span> << std::endl);</div><div class="line"> ++received;</div><div class="line"> }</div><div class="line"> });</div><div class="line"></div><div class="line"> sender.join();</div><div class="line"> receiver.join();</div><div class="line"> cl.close();</div><div class="line"> container_thread.join();</div><div class="line"> std::cout << received << <span class="stringliteral">" messages sent and received"</span> << std::endl;</div><div class="line"></div><div class="line"> <span class="keywordflow">return</span> 0;</div><div class="line"> } <span class="keywordflow">catch</span> (<span class="keyword">const</span> std::exception& e) {</div><div class="line"> std::cerr << e.what() << std::endl;</div><div class="line"> }</div><div class="line"></div><div class="line"> <span class="keywordflow">return</span> 1;</div><div class="line">}</div></div><!-- fragment --> </div><!-- contents --> |
| </div><!-- doc-content --> |
| <!-- start footer part --> |
| <div id="nav-path" class="navpath"><!-- id is needed for treeview function! --> |
| <ul> |
| <li class="footer">Generated by |
| <a href="http://www.doxygen.org/index.html"> |
| <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.8.13 </li> |
| </ul> |
| </div> |
| </body> |
| </html> |