summaryrefslogtreecommitdiff
path: root/src/app_thread.hpp
blob: 14cb8c57042675ec39aca7373eb4ea64d66e7747 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
/*
    Copyright (c) 2007-2009 FastMQ Inc.

    This file is part of 0MQ.

    0MQ is free software; you can redistribute it and/or modify it under
    the terms of the Lesser GNU General Public License as published by
    the Free Software Foundation; either version 3 of the License, or
    (at your option) any later version.

    0MQ 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
    Lesser GNU General Public License for more details.

    You should have received a copy of the Lesser GNU General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.
*/

#ifndef __ZMQ_APP_THREAD_HPP_INCLUDED__
#define __ZMQ_APP_THREAD_HPP_INCLUDED__

#include <vector>

#include "stdint.hpp"
#include "object.hpp"
#include "yarray.hpp"
#include "thread.hpp"

namespace zmq
{

    class app_thread_t : public object_t
    {
    public:

        app_thread_t (class dispatcher_t *dispatcher_, int thread_slot_,
            int flags_);

        ~app_thread_t ();

        //  Returns signaler associated with this application thread.
        struct i_signaler *get_signaler ();

        //  Nota bene: Following two functions are accessed from different
        //  threads. The caller (dispatcher) is responsible for synchronisation
        //  of accesses.

        //  Returns true is current thread is associated with the app thread.
        bool is_current ();

        //  Tries to associate current thread with the app thread object.
        //  Returns true is successfull, false otherwise.
        bool make_current ();

        //  Processes commands sent to this thread (if any). If 'block' is
        //  set to true, returns only after at least one command was processed.
        //  If throttle argument is true, commands are processed at most once
        //  in a predefined time period.
        void process_commands (bool block_, bool throttle_);

        //  Create a socket of a specified type.
        class socket_base_t *create_socket (int type_);

        //  Unregister the socket from the app_thread (called by socket itself).
        void remove_socket (class socket_base_t *socket_);

    private:

        //  All the sockets created from this application thread.
        typedef yarray_t <socket_base_t> sockets_t;
        sockets_t sockets;

        //  If false, app_thread_t object is not associated with any OS thread.
        //  In such case, 'tid' member contains a bogus value.
        bool associated;

        //  Thread ID associated with this slot.
        thread_t::id_t tid;

        //  App thread's signaler object.
        struct i_signaler *signaler;

        //  Timestamp of when commands were processed the last time.
        uint64_t last_processing_time;

        app_thread_t (const app_thread_t&);
        void operator = (const app_thread_t&);
    };

}

#endif