"Survey" pattern implemented

Survey pattern is "multicast with reply". There are two roles:
surveyor and respondent. Surveyor publishes a survey which gets
delivered to all connected respondents. Each repondent can send
a response to the survey. All the responses are delivered to
the original surveyor. Once the surveyor decides that the survey
is over (e.g. deadline was reached) it can send initiate survey.
Late responses from old surveys are automatically discarded by
the surveyor socket.

Socket types: SURVEYOR, XSURVEYOR, RESPONDENT, XRESPONDENT

Patch also includes a test program with surveoyr, two respondents
and an intermediary device.

Signed-off-by: Martin Sustrik <sustrik@250bpm.com>

1 files changed, 77 insertions, 0 deletions

diff --git a/src/surveyor.hpp b/src/surveyor.hpp
new file mode 100644
index 0000000..83fdbb0
--- /dev/null
+++ b/src/surveyor.hpp
@@ -0,0 +1,77 @@
+/*
+    Copyright (c) 2012 250bpm s.r.o.
+    Copyright (c) 2012 Other contributors as noted in the AUTHORS file
+
+    This file is part of Crossroads I/O project.
+
+    Crossroads I/O is free software; you can redistribute it and/or modify it
+    under the terms of the GNU Lesser General Public License as published by
+    the Free Software Foundation; either version 3 of the License, or
+    (at your option) any later version.
+
+    Crossroads is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU Lesser General Public License for more details.
+
+    You should have received a copy of the GNU Lesser General Public License
+    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+*/
+
+#ifndef __XS_SURVEYOR_HPP_INCLUDED__
+#define __XS_SURVEYOR_HPP_INCLUDED__
+
+#include "xsurveyor.hpp"
+#include "stdint.hpp"
+
+namespace xs
+{
+
+    class ctx_t;
+    class msg_t;
+    class io_thread_t;
+    class socket_base_t;
+
+    class surveyor_t : public xsurveyor_t
+    {
+    public:
+
+        surveyor_t (xs::ctx_t *parent_, uint32_t tid_, int sid_);
+        ~surveyor_t ();
+
+        //  Overloads of functions from socket_base_t.
+        int xsend (xs::msg_t *msg_, int flags_);
+        int xrecv (xs::msg_t *msg_, int flags_);
+        bool xhas_in ();
+        bool xhas_out ();
+
+    private:
+
+        //  If true, survey was already lauched and have no expriered yet.
+        bool receiving_responses;
+
+        //  The ID of the ongoing survey.
+        uint32_t survey_id;
+
+        surveyor_t (const surveyor_t&);
+        const surveyor_t &operator = (const surveyor_t&);
+    };
+
+    class surveyor_session_t : public xsurveyor_session_t
+    {
+    public:
+
+        surveyor_session_t (xs::io_thread_t *io_thread_, bool connect_,
+            xs::socket_base_t *socket_, const options_t &options_,
+            const char *protocol_, const char *address_);
+        ~surveyor_session_t ();
+
+    private:
+
+        surveyor_session_t (const surveyor_session_t&);
+        const surveyor_session_t &operator = (const surveyor_session_t&);
+    };
+
+}
+
+#endif