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
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
|
# -*- coding: UTF-8 -*-
# Abstract web classes for HTTP clients and servers or simulators
# By: Frederic Peters <fpeters@entrouvert.com>
# Emmanuel Raviart <eraviart@entrouvert.com>
#
# Copyright (C) 2004 Entr'ouvert
# http://www.entrouvert.org
#
# This program is free software; you can redistribute it and/or
# modify it under the terms of the GNU General Public License
# as published by the Free Software Foundation; either version 2
# of the License, or (at your option) any later version.
#
# This program 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 General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
"""Abstract web classes for HTTP clients and servers or simulators"""
class HttpRequestMixin:
headers = None
method = None # 'GET' or 'POST' or 'PUT' or...
url = None
path = None
pathAndQuery = None
query = None
scheme = None # 'http' or 'https'
def getFormField(self, name, default = None):
raise NotImplementedError
def getQueryBoolean(self, name, default = None):
fieldValue = self.getQueryField(name, 'none')
if fieldValue == 'none':
return default
else:
return fieldValue.lower not in ('', '0', 'false')
def getQueryField(self, name, default = None):
if self.query:
for field in self.query.split('&'):
fieldName, fieldValue = field.split('=')
if name == fieldName:
return fieldValue
return default
def hasFormField(self, name):
raise NotImplementedError
def hasQueryField(self, name):
if self.query:
for field in self.query.split('&'):
fieldName, fieldValue = field.split('=')
if name == fieldName:
return True
return False
class HttpResponseMixin:
body = None
defaultStatusMessages = {
'100': 'Continue',
'101': 'Switching Protocols',
'200': 'OK',
'201': 'Created',
'202': 'Accepted',
'203': 'Non-Authoritative Information',
'204': 'No Content',
'205': 'Reset Content',
'206': 'Partial Content',
'300': 'Multiple Choices',
'301': 'Moved Permanently',
'302': 'Found',
'303': 'See Other',
'304': 'Not Modified',
'305': 'Use Proxy',
'307': 'Temporary Redirect',
'400': 'Bad Request',
'401': 'Unauthorized',
'402': 'Payment Required',
'403': 'Forbidden',
'404': 'Not Found',
'405': 'Method Not Allowed',
'406': 'Not Acceptable',
'407': 'Proxy Authentication Required',
'408': 'Request Time-out',
'409': 'Conflict',
'410': 'Gone',
'411': 'Length Required',
'412': 'Precondition Failed',
'413': 'Request Entity Too Large',
'414': 'Request-URI Too Large',
'415': 'Unsupported Media Type',
'416': 'Requested range not satisfiable',
'417': 'Expectation Failed',
'500': 'Internal Server Error',
'501': 'Not Implemented',
'502': 'Bad Gateway',
'503': 'Service Unavailable',
'504': 'Gateway Time-out',
'505': 'HTTP Version not supported',
}
headers = None
statusCode = None # 200 or...
statusMessage = None
def __init__(self, httpRequestHandler, statusCode, statusMessage = None, headers = None,
body = None):
self.statusCode = statusCode
if statusMessage:
self.statusMessage = statusMessage
else:
self.statusMessage = self.defaultStatusMessages.get(statusCode)
httpResponseHeaders = httpRequestHandler.site.httpResponseHeaders
if headers:
httpResponseHeaders = httpResponseHeaders.copy()
for name, value in headers.iteritems():
httpResponseHeaders[name] = value
if httpResponseHeaders:
self.headers = httpResponseHeaders
if body:
self.body = body
def send(self, httpRequestHandler):
raise NotImplementedError
class HttpRequestHandlerMixin:
httpRequest = None
HttpResponse = None # Class
httpResponse = None
session = None
user = None
site = None # The virtual host
def respond(self, statusCode = 200, statusMessage = None, headers = None, body = None):
self.httpResponse = self.HttpResponse(
self, statusCode, statusMessage = statusMessage, headers = headers, body = body)
# Session and user must be saved before responding. Otherwise, when the server is
# multitasked or multithreaded, it may receive a new HTTP request before the session is
# saved.
if self.session is not None and self.session.isDirty:
self.session.save()
if self.user is not None and self.user.isDirty:
self.user.save()
return self.httpResponse.send(self)
def respondRedirectTemporarily(self, url):
raise NotImplementedError
class WebSessionMixin:
publishToken = False
token = None
class WebSiteMixin:
def authenticateX509User(self, clientCertificate):
# We should check certificate (for example clientCertificate.get_serial_number()
# and return the user if one matches, or None otherwise.
return None
def authenticateLoginPasswordUser(self, login, password):
# We should check login & password and return the user if one matches or None otherwise.
return None
class WebUserMixin:
sessionToken = None
|
