summaryrefslogtreecommitdiffstats
blob: eda7cfb87e009c5548471204f9a84fb77987681f (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
/*
 * Copyright (c) 2010-2016 Isode Limited.
 * All rights reserved.
 * See the COPYING file for more information.
 */

#pragma once

#include <memory>
#include <string>
#include <vector>

#include <Swiften/Base/API.h>
#include <Swiften/Elements/IQ.h>

namespace Swift {
    class IQChannel;
    class IQHandler;

    class SWIFTEN_API IQRouter {
        public:
            IQRouter(IQChannel* channel);
            ~IQRouter();

            /**
             * Sets the JID of this IQ router.
             *
             * This JID is used by requests to check whether incoming
             * results are addressed correctly.
             */
            void setJID(const JID& jid) {
                jid_ = jid;
            }

            const JID& getJID() const {
                return jid_;
            }

            /**
             * Sets the 'from' JID for all outgoing IQ stanzas.
             *
             * By default, IQRouter does not add a from to IQ stanzas, since
             * this is automatically added by the server. This overrides this
             * default behavior, which is necessary for e.g. components.
             */
            void setFrom(const JID& from) {
                from_ = from;
            }

            void addHandler(IQHandler* handler);
            void removeHandler(IQHandler* handler);
            void addHandler(std::shared_ptr<IQHandler> handler);
            void removeHandler(std::shared_ptr<IQHandler> handler);

            /**
             * Sends an IQ stanza.
             *
             * If a JID was specified using setFrom, the JID will
             * be set as the 'from' address on iq before sending
             * it.
             */
            void sendIQ(std::shared_ptr<IQ> iq);
            std::string getNewIQID();

            bool isAvailable();

            /**
             * Checks whether the given jid is the account JID (i.e. it is either
             * the bare JID, or it is the empty JID).
             * Can be used to check whether a stanza is sent by the server on behalf
             * of the user's account.
             */
            bool isAccountJID(const JID& jid) {
                return jid.isValid() ? jid_.toBare().equals(jid, JID::WithResource) : true;
            }

        private:
            void handleIQ(std::shared_ptr<IQ> iq);
            void processPendingRemoves();

        private:
            IQChannel* channel_;
            JID jid_;
            JID from_;
            std::vector< std::shared_ptr<IQHandler> > handlers_;
            std::vector< std::shared_ptr<IQHandler> > queuedRemoves_;
            bool queueRemoves_;
    };
}