summaryrefslogtreecommitdiff
path: root/slixmpp/plugins/xep_0332/stanza/response.py
blob: a0b8fe34dab704b9b4917c88c5c1d0e14aac84a1 (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
"""
    Slixmpp: The Slick XMPP Library
    Implementation of HTTP over XMPP transport
    http://xmpp.org/extensions/xep-0332.html
    Copyright (C) 2015 Riptide IO, sangeeth@riptideio.com
    This file is part of slixmpp.

    See the file LICENSE for copying permission.
"""

from slixmpp.xmlstream import ElementBase


class HTTPResponse(ElementBase):

    """
    When the HTTP Server responds, it does so by sending an `iq` stanza
    response (type=`result`) back to the client containing the `resp` element.
    Since response are asynchronous, and since multiple requests may be active
    at the same time, responses may be returned in a different order than the
    in which the original requests were made.

    Examples:
    <iq type='result'
        from='httpserver@clayster.com'
        to='httpclient@clayster.com/browser' id='2'>
        <resp xmlns='urn:xmpp:http'
              version='1.1'
              statusCode='200'
              statusMessage='OK'>
            <headers xmlns='http://jabber.org/protocol/shim'>
                <header name='Date'>Fri, 03 May 2013 16:39:54GMT-4</header>
                <header name='Server'>Clayster</header>
                <header name='Content-Type'>text/turtle</header>
                <header name='Content-Length'>...</header>
                <header name='Connection'>Close</header>
            </headers>
            <data>
                <text>
                    ...
                </text>
            </data>
        </resp>
    </iq>
    """

    name = 'response'
    namespace = 'urn:xmpp:http'
    interfaces = set(['code', 'message', 'version'])
    plugin_attrib = 'http-resp'

    def get_code(self):
        code = self._get_attr('statusCode', None)
        return int(code) if code is not None else code

    def set_code(self, code):
        self._set_attr('statusCode', str(code))

    def get_message(self):
        return self._get_attr('statusMessage', '')

    def set_message(self, message):
        self._set_attr('statusMessage', message)

    def set_version(self, version='1.1'):
        self._set_attr('version', version)