serverside 0.2.5 → 0.2.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- data/CHANGELOG +10 -0
- data/README +3 -3
- data/Rakefile +4 -4
- data/bin/serverside +4 -4
- data/doc/rdoc/classes/Daemon.html +4 -4
- data/doc/rdoc/classes/ServerSide.html +14 -74
- data/doc/rdoc/classes/ServerSide/Application.html +13 -13
- data/doc/rdoc/classes/ServerSide/{Connection.html → HTTP.html} +12 -18
- data/doc/rdoc/classes/ServerSide/HTTP/Connection.html +200 -0
- data/doc/rdoc/classes/ServerSide/{Connection → HTTP}/Const.html +6 -6
- data/doc/rdoc/classes/ServerSide/{Connection/Base.html → HTTP/Request.html} +213 -164
- data/doc/rdoc/classes/ServerSide/{Server.html → HTTP/Server.html} +22 -22
- data/doc/rdoc/classes/ServerSide/Router.html +496 -0
- data/doc/rdoc/classes/ServerSide/StaticFiles.html +31 -30
- data/doc/rdoc/classes/ServerSide/Template.html +12 -12
- data/doc/rdoc/created.rid +1 -1
- data/doc/rdoc/files/CHANGELOG.html +22 -4
- data/doc/rdoc/files/COPYING.html +1 -1
- data/doc/rdoc/files/README.html +4 -4
- data/doc/rdoc/files/lib/serverside/application_rb.html +1 -1
- data/doc/rdoc/files/lib/serverside/cluster_rb.html +1 -1
- data/doc/rdoc/files/lib/serverside/connection_rb.html +1 -1
- data/doc/rdoc/files/lib/serverside/core_ext_rb.html +1 -1
- data/doc/rdoc/files/lib/serverside/daemon_rb.html +1 -1
- data/doc/rdoc/files/lib/serverside/request_rb.html +101 -0
- data/doc/rdoc/files/lib/serverside/routing_rb.html +1 -1
- data/doc/rdoc/files/lib/serverside/server_rb.html +1 -1
- data/doc/rdoc/files/lib/serverside/static_rb.html +1 -1
- data/doc/rdoc/files/lib/serverside/template_rb.html +1 -1
- data/doc/rdoc/files/lib/serverside_rb.html +1 -1
- data/doc/rdoc/fr_class_index.html +6 -5
- data/doc/rdoc/fr_file_index.html +1 -0
- data/doc/rdoc/fr_method_index.html +31 -31
- data/lib/serverside/application.rb +1 -1
- data/lib/serverside/connection.rb +12 -141
- data/lib/serverside/request.rb +150 -0
- data/lib/serverside/routing.rb +117 -126
- data/lib/serverside/server.rb +13 -12
- data/lib/serverside/static.rb +1 -1
- data/test/functional/primitive_static_server_test.rb +3 -3
- data/test/functional/routing_server.rb +1 -1
- data/test/functional/routing_server_test.rb +1 -1
- data/test/functional/static_profile.rb +1 -1
- data/test/functional/static_server_test.rb +2 -2
- data/test/unit/connection_test.rb +30 -224
- data/test/unit/request_test.rb +248 -0
- data/test/unit/routing_test.rb +4 -4
- data/test/unit/server_test.rb +10 -8
- data/test/unit/static_test.rb +1 -1
- metadata +61 -56
- data/doc/rdoc/classes/ServerSide/Connection/Router.html +0 -493
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
|
|
6
6
|
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
|
|
7
7
|
<head>
|
|
8
|
-
<title>Module: ServerSide::
|
|
8
|
+
<title>Module: ServerSide::HTTP::Const</title>
|
|
9
9
|
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
|
|
10
10
|
<meta http-equiv="Content-Script-Type" content="text/javascript" />
|
|
11
11
|
<link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
|
|
@@ -50,13 +50,13 @@
|
|
|
50
50
|
<table class="header-table">
|
|
51
51
|
<tr class="top-aligned-row">
|
|
52
52
|
<td><strong>Module</strong></td>
|
|
53
|
-
<td class="class-name-in-header">ServerSide::
|
|
53
|
+
<td class="class-name-in-header">ServerSide::HTTP::Const</td>
|
|
54
54
|
</tr>
|
|
55
55
|
<tr class="top-aligned-row">
|
|
56
56
|
<td><strong>In:</strong></td>
|
|
57
57
|
<td>
|
|
58
|
-
<a href="../../../files/lib/serverside/
|
|
59
|
-
lib/serverside/
|
|
58
|
+
<a href="../../../files/lib/serverside/request_rb.html">
|
|
59
|
+
lib/serverside/request.rb
|
|
60
60
|
</a>
|
|
61
61
|
<br />
|
|
62
62
|
</td>
|
|
@@ -109,8 +109,8 @@ of responses faster than otherwise.
|
|
|
109
109
|
<td width="3em"> </td>
|
|
110
110
|
<td class="context-item-desc">
|
|
111
111
|
Here’s a nice one - parses the first line of a request. The expected
|
|
112
|
-
format is as follows: <method> </path>[/][?<query>]
|
|
113
|
-
HTTP
|
|
112
|
+
format is as follows: <method> </path>[/][?<query>] <a
|
|
113
|
+
href="../HTTP.html">HTTP</a>/<version>
|
|
114
114
|
|
|
115
115
|
</td>
|
|
116
116
|
</tr>
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
|
|
6
6
|
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
|
|
7
7
|
<head>
|
|
8
|
-
<title>Class: ServerSide::
|
|
8
|
+
<title>Class: ServerSide::HTTP::Request</title>
|
|
9
9
|
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
|
|
10
10
|
<meta http-equiv="Content-Script-Type" content="text/javascript" />
|
|
11
11
|
<link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
|
|
@@ -50,13 +50,13 @@
|
|
|
50
50
|
<table class="header-table">
|
|
51
51
|
<tr class="top-aligned-row">
|
|
52
52
|
<td><strong>Class</strong></td>
|
|
53
|
-
<td class="class-name-in-header">ServerSide::
|
|
53
|
+
<td class="class-name-in-header">ServerSide::HTTP::Request</td>
|
|
54
54
|
</tr>
|
|
55
55
|
<tr class="top-aligned-row">
|
|
56
56
|
<td><strong>In:</strong></td>
|
|
57
57
|
<td>
|
|
58
|
-
<a href="../../../files/lib/serverside/
|
|
59
|
-
lib/serverside/
|
|
58
|
+
<a href="../../../files/lib/serverside/request_rb.html">
|
|
59
|
+
lib/serverside/request.rb
|
|
60
60
|
</a>
|
|
61
61
|
<br />
|
|
62
62
|
</td>
|
|
@@ -82,12 +82,12 @@
|
|
|
82
82
|
|
|
83
83
|
<div id="description">
|
|
84
84
|
<p>
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
</
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
85
|
+
The HTTPRequest class encapsulates <a href="../HTTP.html">HTTP</a>
|
|
86
|
+
requests. The request class contains methods for parsing the request and
|
|
87
|
+
rendering a response. <a href="../HTTP.html">HTTP</a> requests are created
|
|
88
|
+
by the connection. Descendants of HTTPRequest can be created When a
|
|
89
|
+
connection is created, it creates new requests in a loop until the
|
|
90
|
+
connection is closed.
|
|
91
91
|
</p>
|
|
92
92
|
|
|
93
93
|
</div>
|
|
@@ -99,16 +99,16 @@ create application-specific behavior.
|
|
|
99
99
|
<h3 class="section-bar">Methods</h3>
|
|
100
100
|
|
|
101
101
|
<div class="name-list">
|
|
102
|
-
<a href="#
|
|
103
|
-
<a href="#
|
|
104
|
-
<a href="#
|
|
105
|
-
<a href="#M000033">
|
|
106
|
-
<a href="#M000032">
|
|
107
|
-
<a href="#
|
|
108
|
-
<a href="#
|
|
109
|
-
<a href="#
|
|
110
|
-
<a href="#
|
|
111
|
-
<a href="#
|
|
102
|
+
<a href="#M000038">delete_cookie</a>
|
|
103
|
+
<a href="#M000029">new</a>
|
|
104
|
+
<a href="#M000031">parse</a>
|
|
105
|
+
<a href="#M000033">parse_cookies</a>
|
|
106
|
+
<a href="#M000032">parse_parameters</a>
|
|
107
|
+
<a href="#M000030">process</a>
|
|
108
|
+
<a href="#M000035">redirect</a>
|
|
109
|
+
<a href="#M000034">send_response</a>
|
|
110
|
+
<a href="#M000037">set_cookie</a>
|
|
111
|
+
<a href="#M000036">stream</a>
|
|
112
112
|
</div>
|
|
113
113
|
</div>
|
|
114
114
|
|
|
@@ -130,6 +130,64 @@ create application-specific behavior.
|
|
|
130
130
|
|
|
131
131
|
|
|
132
132
|
|
|
133
|
+
<div id="attribute-list">
|
|
134
|
+
<h3 class="section-bar">Attributes</h3>
|
|
135
|
+
|
|
136
|
+
<div class="name-list">
|
|
137
|
+
<table>
|
|
138
|
+
<tr class="top-aligned-row context-row">
|
|
139
|
+
<td class="context-item-name">conn</td>
|
|
140
|
+
<td class="context-item-value"> [R] </td>
|
|
141
|
+
<td class="context-item-desc"></td>
|
|
142
|
+
</tr>
|
|
143
|
+
<tr class="top-aligned-row context-row">
|
|
144
|
+
<td class="context-item-name">cookies</td>
|
|
145
|
+
<td class="context-item-value"> [R] </td>
|
|
146
|
+
<td class="context-item-desc"></td>
|
|
147
|
+
</tr>
|
|
148
|
+
<tr class="top-aligned-row context-row">
|
|
149
|
+
<td class="context-item-name">headers</td>
|
|
150
|
+
<td class="context-item-value"> [R] </td>
|
|
151
|
+
<td class="context-item-desc"></td>
|
|
152
|
+
</tr>
|
|
153
|
+
<tr class="top-aligned-row context-row">
|
|
154
|
+
<td class="context-item-name">method</td>
|
|
155
|
+
<td class="context-item-value"> [R] </td>
|
|
156
|
+
<td class="context-item-desc"></td>
|
|
157
|
+
</tr>
|
|
158
|
+
<tr class="top-aligned-row context-row">
|
|
159
|
+
<td class="context-item-name">parameters</td>
|
|
160
|
+
<td class="context-item-value"> [R] </td>
|
|
161
|
+
<td class="context-item-desc"></td>
|
|
162
|
+
</tr>
|
|
163
|
+
<tr class="top-aligned-row context-row">
|
|
164
|
+
<td class="context-item-name">path</td>
|
|
165
|
+
<td class="context-item-value"> [R] </td>
|
|
166
|
+
<td class="context-item-desc"></td>
|
|
167
|
+
</tr>
|
|
168
|
+
<tr class="top-aligned-row context-row">
|
|
169
|
+
<td class="context-item-name">persistent</td>
|
|
170
|
+
<td class="context-item-value"> [R] </td>
|
|
171
|
+
<td class="context-item-desc"></td>
|
|
172
|
+
</tr>
|
|
173
|
+
<tr class="top-aligned-row context-row">
|
|
174
|
+
<td class="context-item-name">query</td>
|
|
175
|
+
<td class="context-item-value"> [R] </td>
|
|
176
|
+
<td class="context-item-desc"></td>
|
|
177
|
+
</tr>
|
|
178
|
+
<tr class="top-aligned-row context-row">
|
|
179
|
+
<td class="context-item-name">response_cookies</td>
|
|
180
|
+
<td class="context-item-value"> [R] </td>
|
|
181
|
+
<td class="context-item-desc"></td>
|
|
182
|
+
</tr>
|
|
183
|
+
<tr class="top-aligned-row context-row">
|
|
184
|
+
<td class="context-item-name">version</td>
|
|
185
|
+
<td class="context-item-value"> [R] </td>
|
|
186
|
+
<td class="context-item-desc"></td>
|
|
187
|
+
</tr>
|
|
188
|
+
</table>
|
|
189
|
+
</div>
|
|
190
|
+
</div>
|
|
133
191
|
|
|
134
192
|
|
|
135
193
|
|
|
@@ -137,29 +195,29 @@ create application-specific behavior.
|
|
|
137
195
|
<div id="methods">
|
|
138
196
|
<h3 class="section-bar">Public Class methods</h3>
|
|
139
197
|
|
|
140
|
-
<div id="method-
|
|
141
|
-
<a name="
|
|
198
|
+
<div id="method-M000029" class="method-detail">
|
|
199
|
+
<a name="M000029"></a>
|
|
142
200
|
|
|
143
201
|
<div class="method-heading">
|
|
144
|
-
<a href="#
|
|
202
|
+
<a href="#M000029" class="method-signature">
|
|
145
203
|
<span class="method-name">new</span><span class="method-args">(conn)</span>
|
|
146
204
|
</a>
|
|
147
205
|
</div>
|
|
148
206
|
|
|
149
207
|
<div class="method-description">
|
|
150
208
|
<p>
|
|
151
|
-
Initializes the request instance.
|
|
152
|
-
|
|
209
|
+
Initializes the request instance. Any descendants of <a
|
|
210
|
+
href="Request.html">HTTP::Request</a> which override the initialize method
|
|
211
|
+
must receive conn as the single argument, and copy it to @conn.
|
|
153
212
|
</p>
|
|
154
213
|
<p><a class="source-toggle" href="#"
|
|
155
|
-
onclick="toggleCode('
|
|
156
|
-
<div class="method-source-code" id="
|
|
214
|
+
onclick="toggleCode('M000029-source');return false;">[Source]</a></p>
|
|
215
|
+
<div class="method-source-code" id="M000029-source">
|
|
157
216
|
<pre>
|
|
158
|
-
<span class="ruby-comment cmt"># File lib/serverside/
|
|
217
|
+
<span class="ruby-comment cmt"># File lib/serverside/request.rb, line 54</span>
|
|
159
218
|
54: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">conn</span>)
|
|
160
219
|
55: <span class="ruby-ivar">@conn</span> = <span class="ruby-identifier">conn</span>
|
|
161
|
-
56:
|
|
162
|
-
57: <span class="ruby-keyword kw">end</span>
|
|
220
|
+
56: <span class="ruby-keyword kw">end</span>
|
|
163
221
|
</pre>
|
|
164
222
|
</div>
|
|
165
223
|
</div>
|
|
@@ -167,11 +225,11 @@ requests.
|
|
|
167
225
|
|
|
168
226
|
<h3 class="section-bar">Public Instance methods</h3>
|
|
169
227
|
|
|
170
|
-
<div id="method-
|
|
171
|
-
<a name="
|
|
228
|
+
<div id="method-M000038" class="method-detail">
|
|
229
|
+
<a name="M000038"></a>
|
|
172
230
|
|
|
173
231
|
<div class="method-heading">
|
|
174
|
-
<a href="#
|
|
232
|
+
<a href="#M000038" class="method-signature">
|
|
175
233
|
<span class="method-name">delete_cookie</span><span class="method-args">(name)</span>
|
|
176
234
|
</a>
|
|
177
235
|
</div>
|
|
@@ -182,44 +240,58 @@ Marks a cookie as deleted. The cookie is given an expires stamp in the
|
|
|
182
240
|
past.
|
|
183
241
|
</p>
|
|
184
242
|
<p><a class="source-toggle" href="#"
|
|
185
|
-
onclick="toggleCode('
|
|
186
|
-
<div class="method-source-code" id="
|
|
243
|
+
onclick="toggleCode('M000038-source');return false;">[Source]</a></p>
|
|
244
|
+
<div class="method-source-code" id="M000038-source">
|
|
187
245
|
<pre>
|
|
188
|
-
<span class="ruby-comment cmt"># File lib/serverside/
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
246
|
+
<span class="ruby-comment cmt"># File lib/serverside/request.rb, line 145</span>
|
|
247
|
+
145: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">delete_cookie</span>(<span class="ruby-identifier">name</span>)
|
|
248
|
+
146: <span class="ruby-identifier">set_cookie</span>(<span class="ruby-identifier">name</span>, <span class="ruby-keyword kw">nil</span>, <span class="ruby-constant">Const</span><span class="ruby-operator">::</span><span class="ruby-constant">CookieExpiredTime</span>)
|
|
249
|
+
147: <span class="ruby-keyword kw">end</span>
|
|
192
250
|
</pre>
|
|
193
251
|
</div>
|
|
194
252
|
</div>
|
|
195
253
|
</div>
|
|
196
254
|
|
|
197
|
-
<div id="method-
|
|
198
|
-
<a name="
|
|
255
|
+
<div id="method-M000031" class="method-detail">
|
|
256
|
+
<a name="M000031"></a>
|
|
199
257
|
|
|
200
258
|
<div class="method-heading">
|
|
201
|
-
<a href="#
|
|
202
|
-
<span class="method-name">
|
|
259
|
+
<a href="#M000031" class="method-signature">
|
|
260
|
+
<span class="method-name">parse</span><span class="method-args">()</span>
|
|
203
261
|
</a>
|
|
204
262
|
</div>
|
|
205
263
|
|
|
206
264
|
<div class="method-description">
|
|
207
265
|
<p>
|
|
208
|
-
Parses
|
|
266
|
+
Parses an <a href="../HTTP.html">HTTP</a> request. If the request is not
|
|
267
|
+
valid, nil is returned. Otherwise, the <a href="../HTTP.html">HTTP</a>
|
|
268
|
+
headers are returned. Also determines whether the connection is persistent
|
|
269
|
+
(by checking the <a href="../HTTP.html">HTTP</a> version and the ‘<a
|
|
270
|
+
href="Connection.html">Connection</a>’ header).
|
|
209
271
|
</p>
|
|
210
272
|
<p><a class="source-toggle" href="#"
|
|
211
|
-
onclick="toggleCode('
|
|
212
|
-
<div class="method-source-code" id="
|
|
273
|
+
onclick="toggleCode('M000031-source');return false;">[Source]</a></p>
|
|
274
|
+
<div class="method-source-code" id="M000031-source">
|
|
213
275
|
<pre>
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
276
|
+
<span class="ruby-comment cmt"># File lib/serverside/request.rb, line 67</span>
|
|
277
|
+
67: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">parse</span>
|
|
278
|
+
68: <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">nil</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-ivar">@conn</span>.<span class="ruby-identifier">gets</span> <span class="ruby-operator">=~</span> <span class="ruby-constant">Const</span><span class="ruby-operator">::</span><span class="ruby-constant">RequestRegexp</span>
|
|
279
|
+
69: <span class="ruby-ivar">@method</span>, <span class="ruby-ivar">@path</span>, <span class="ruby-ivar">@query</span>, <span class="ruby-ivar">@version</span> = <span class="ruby-identifier">$1</span>.<span class="ruby-identifier">downcase</span>.<span class="ruby-identifier">to_sym</span>, <span class="ruby-identifier">$2</span>, <span class="ruby-identifier">$3</span>, <span class="ruby-identifier">$4</span>
|
|
280
|
+
70: <span class="ruby-ivar">@parameters</span> = <span class="ruby-ivar">@query</span> <span class="ruby-operator">?</span> <span class="ruby-identifier">parse_parameters</span>(<span class="ruby-ivar">@query</span>) <span class="ruby-operator">:</span> {}
|
|
281
|
+
71: <span class="ruby-ivar">@headers</span> = {}
|
|
282
|
+
72: <span class="ruby-keyword kw">while</span> (<span class="ruby-identifier">line</span> = <span class="ruby-ivar">@conn</span>.<span class="ruby-identifier">gets</span>)
|
|
283
|
+
73: <span class="ruby-keyword kw">break</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">line</span>.<span class="ruby-identifier">nil?</span> <span class="ruby-operator">||</span> (<span class="ruby-identifier">line</span> <span class="ruby-operator">==</span> <span class="ruby-constant">Const</span><span class="ruby-operator">::</span><span class="ruby-constant">LineBreak</span>)
|
|
284
|
+
74: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">line</span> <span class="ruby-operator">=~</span> <span class="ruby-constant">Const</span><span class="ruby-operator">::</span><span class="ruby-constant">HeaderRegexp</span>
|
|
285
|
+
75: <span class="ruby-ivar">@headers</span>[<span class="ruby-identifier">$1</span>.<span class="ruby-identifier">freeze</span>] = <span class="ruby-identifier">$2</span>.<span class="ruby-identifier">freeze</span>
|
|
286
|
+
76: <span class="ruby-keyword kw">end</span>
|
|
287
|
+
77: <span class="ruby-keyword kw">end</span>
|
|
288
|
+
78: <span class="ruby-ivar">@persistent</span> = (<span class="ruby-ivar">@version</span> <span class="ruby-operator">==</span> <span class="ruby-constant">Const</span><span class="ruby-operator">::</span><span class="ruby-constant">Version_1_1</span>) <span class="ruby-operator">&&</span>
|
|
289
|
+
79: (<span class="ruby-ivar">@headers</span>[<span class="ruby-constant">Const</span><span class="ruby-operator">::</span><span class="ruby-constant">Connection</span>] <span class="ruby-operator">!=</span> <span class="ruby-constant">Const</span><span class="ruby-operator">::</span><span class="ruby-constant">Close</span>)
|
|
290
|
+
80: <span class="ruby-ivar">@cookies</span> = <span class="ruby-ivar">@headers</span>[<span class="ruby-constant">Const</span><span class="ruby-operator">::</span><span class="ruby-constant">Cookie</span>] <span class="ruby-operator">?</span> <span class="ruby-identifier">parse_cookies</span> <span class="ruby-operator">:</span> <span class="ruby-constant">Const</span><span class="ruby-operator">::</span><span class="ruby-constant">EmptyHash</span>
|
|
291
|
+
81: <span class="ruby-ivar">@response_cookies</span> = <span class="ruby-keyword kw">nil</span>
|
|
292
|
+
82:
|
|
293
|
+
83: <span class="ruby-ivar">@headers</span>
|
|
294
|
+
84: <span class="ruby-keyword kw">end</span>
|
|
223
295
|
</pre>
|
|
224
296
|
</div>
|
|
225
297
|
</div>
|
|
@@ -230,28 +302,27 @@ Parses cookie values passed in the request
|
|
|
230
302
|
|
|
231
303
|
<div class="method-heading">
|
|
232
304
|
<a href="#M000033" class="method-signature">
|
|
233
|
-
<span class="method-name">
|
|
305
|
+
<span class="method-name">parse_cookies</span><span class="method-args">()</span>
|
|
234
306
|
</a>
|
|
235
307
|
</div>
|
|
236
308
|
|
|
237
309
|
<div class="method-description">
|
|
238
310
|
<p>
|
|
239
|
-
Parses
|
|
240
|
-
parameter values.
|
|
311
|
+
Parses cookie values passed in the request
|
|
241
312
|
</p>
|
|
242
313
|
<p><a class="source-toggle" href="#"
|
|
243
314
|
onclick="toggleCode('M000033-source');return false;">[Source]</a></p>
|
|
244
315
|
<div class="method-source-code" id="M000033-source">
|
|
245
316
|
<pre>
|
|
246
|
-
<span class="ruby-comment cmt"># File lib/serverside/
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
317
|
+
<span class="ruby-comment cmt"># File lib/serverside/request.rb, line 98</span>
|
|
318
|
+
98: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">parse_cookies</span>
|
|
319
|
+
99: <span class="ruby-ivar">@headers</span>[<span class="ruby-constant">Const</span><span class="ruby-operator">::</span><span class="ruby-constant">Cookie</span>].<span class="ruby-identifier">split</span>(<span class="ruby-constant">Const</span><span class="ruby-operator">::</span><span class="ruby-constant">CookieSplit</span>).<span class="ruby-identifier">inject</span>({}) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">m</span>, <span class="ruby-identifier">i</span><span class="ruby-operator">|</span>
|
|
320
|
+
100: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">i</span> <span class="ruby-operator">=~</span> <span class="ruby-constant">Const</span><span class="ruby-operator">::</span><span class="ruby-constant">CookieRegexp</span>
|
|
321
|
+
101: <span class="ruby-identifier">m</span>[<span class="ruby-identifier">$1</span>.<span class="ruby-identifier">to_sym</span>] = <span class="ruby-identifier">$2</span>.<span class="ruby-identifier">uri_unescape</span>
|
|
322
|
+
102: <span class="ruby-keyword kw">end</span>
|
|
323
|
+
103: <span class="ruby-identifier">m</span>
|
|
324
|
+
104: <span class="ruby-keyword kw">end</span>
|
|
325
|
+
105: <span class="ruby-keyword kw">end</span>
|
|
255
326
|
</pre>
|
|
256
327
|
</div>
|
|
257
328
|
</div>
|
|
@@ -262,86 +333,64 @@ parameter values.
|
|
|
262
333
|
|
|
263
334
|
<div class="method-heading">
|
|
264
335
|
<a href="#M000032" class="method-signature">
|
|
265
|
-
<span class="method-name">
|
|
336
|
+
<span class="method-name">parse_parameters</span><span class="method-args">(query)</span>
|
|
266
337
|
</a>
|
|
267
338
|
</div>
|
|
268
339
|
|
|
269
340
|
<div class="method-description">
|
|
270
341
|
<p>
|
|
271
|
-
Parses
|
|
272
|
-
|
|
273
|
-
connection is persistent (by checking the HTTP version and the ‘<a
|
|
274
|
-
href="../Connection.html">Connection</a>’ header).
|
|
342
|
+
Parses query parameters by splitting the query string and unescaping
|
|
343
|
+
parameter values.
|
|
275
344
|
</p>
|
|
276
345
|
<p><a class="source-toggle" href="#"
|
|
277
346
|
onclick="toggleCode('M000032-source');return false;">[Source]</a></p>
|
|
278
347
|
<div class="method-source-code" id="M000032-source">
|
|
279
348
|
<pre>
|
|
280
|
-
<span class="ruby-comment cmt"># File lib/serverside/
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
85: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">line</span> <span class="ruby-operator">=~</span> <span class="ruby-constant">Const</span><span class="ruby-operator">::</span><span class="ruby-constant">HeaderRegexp</span>
|
|
289
|
-
86: <span class="ruby-ivar">@headers</span>[<span class="ruby-identifier">$1</span>.<span class="ruby-identifier">freeze</span>] = <span class="ruby-identifier">$2</span>.<span class="ruby-identifier">freeze</span>
|
|
290
|
-
87: <span class="ruby-keyword kw">end</span>
|
|
291
|
-
88: <span class="ruby-keyword kw">end</span>
|
|
292
|
-
89: <span class="ruby-ivar">@persistent</span> = (<span class="ruby-ivar">@version</span> <span class="ruby-operator">==</span> <span class="ruby-constant">Const</span><span class="ruby-operator">::</span><span class="ruby-constant">Version_1_1</span>) <span class="ruby-operator">&&</span>
|
|
293
|
-
90: (<span class="ruby-ivar">@headers</span>[<span class="ruby-constant">Const</span><span class="ruby-operator">::</span><span class="ruby-constant">Connection</span>] <span class="ruby-operator">!=</span> <span class="ruby-constant">Const</span><span class="ruby-operator">::</span><span class="ruby-constant">Close</span>)
|
|
294
|
-
91: <span class="ruby-ivar">@cookies</span> = <span class="ruby-ivar">@headers</span>[<span class="ruby-constant">Const</span><span class="ruby-operator">::</span><span class="ruby-constant">Cookie</span>] <span class="ruby-operator">?</span> <span class="ruby-identifier">parse_cookies</span> <span class="ruby-operator">:</span> <span class="ruby-constant">Const</span><span class="ruby-operator">::</span><span class="ruby-constant">EmptyHash</span>
|
|
295
|
-
92: <span class="ruby-ivar">@response_cookies</span> = <span class="ruby-keyword kw">nil</span>
|
|
296
|
-
93:
|
|
297
|
-
94: <span class="ruby-ivar">@headers</span>
|
|
349
|
+
<span class="ruby-comment cmt"># File lib/serverside/request.rb, line 88</span>
|
|
350
|
+
88: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">parse_parameters</span>(<span class="ruby-identifier">query</span>)
|
|
351
|
+
89: <span class="ruby-identifier">query</span>.<span class="ruby-identifier">split</span>(<span class="ruby-constant">Const</span><span class="ruby-operator">::</span><span class="ruby-constant">Ampersand</span>).<span class="ruby-identifier">inject</span>({}) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">m</span>, <span class="ruby-identifier">i</span><span class="ruby-operator">|</span>
|
|
352
|
+
90: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">i</span> <span class="ruby-operator">=~</span> <span class="ruby-constant">Const</span><span class="ruby-operator">::</span><span class="ruby-constant">ParameterRegexp</span>
|
|
353
|
+
91: <span class="ruby-identifier">m</span>[<span class="ruby-identifier">$1</span>.<span class="ruby-identifier">to_sym</span>] = <span class="ruby-identifier">$2</span>.<span class="ruby-identifier">uri_unescape</span>
|
|
354
|
+
92: <span class="ruby-keyword kw">end</span>
|
|
355
|
+
93: <span class="ruby-identifier">m</span>
|
|
356
|
+
94: <span class="ruby-keyword kw">end</span>
|
|
298
357
|
95: <span class="ruby-keyword kw">end</span>
|
|
299
358
|
</pre>
|
|
300
359
|
</div>
|
|
301
360
|
</div>
|
|
302
361
|
</div>
|
|
303
362
|
|
|
304
|
-
<div id="method-
|
|
305
|
-
<a name="
|
|
363
|
+
<div id="method-M000030" class="method-detail">
|
|
364
|
+
<a name="M000030"></a>
|
|
306
365
|
|
|
307
366
|
<div class="method-heading">
|
|
308
|
-
<a href="#
|
|
367
|
+
<a href="#M000030" class="method-signature">
|
|
309
368
|
<span class="method-name">process</span><span class="method-args">()</span>
|
|
310
369
|
</a>
|
|
311
370
|
</div>
|
|
312
371
|
|
|
313
372
|
<div class="method-description">
|
|
314
373
|
<p>
|
|
315
|
-
Processes
|
|
316
|
-
error occurs, or the connection is not persistent, the connection is
|
|
317
|
-
closed.
|
|
374
|
+
Processes the request by parsing it and then responding.
|
|
318
375
|
</p>
|
|
319
376
|
<p><a class="source-toggle" href="#"
|
|
320
|
-
onclick="toggleCode('
|
|
321
|
-
<div class="method-source-code" id="
|
|
377
|
+
onclick="toggleCode('M000030-source');return false;">[Source]</a></p>
|
|
378
|
+
<div class="method-source-code" id="M000030-source">
|
|
322
379
|
<pre>
|
|
323
|
-
<span class="ruby-comment cmt"># File lib/serverside/
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
|
|
327
|
-
65: <span class="ruby-identifier">respond</span>
|
|
328
|
-
66: <span class="ruby-keyword kw">break</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-ivar">@persistent</span>
|
|
329
|
-
67: <span class="ruby-keyword kw">end</span>
|
|
330
|
-
68: <span class="ruby-keyword kw">rescue</span> =<span class="ruby-operator">></span> <span class="ruby-identifier">e</span>
|
|
331
|
-
69: <span class="ruby-comment cmt"># We don't care. Just close the connection.</span>
|
|
332
|
-
70: <span class="ruby-keyword kw">ensure</span>
|
|
333
|
-
71: <span class="ruby-ivar">@conn</span>.<span class="ruby-identifier">close</span>
|
|
334
|
-
72: <span class="ruby-keyword kw">end</span>
|
|
380
|
+
<span class="ruby-comment cmt"># File lib/serverside/request.rb, line 59</span>
|
|
381
|
+
59: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">process</span>
|
|
382
|
+
60: <span class="ruby-identifier">parse</span> <span class="ruby-operator">&&</span> ((<span class="ruby-identifier">respond</span> <span class="ruby-operator">||</span> <span class="ruby-keyword kw">true</span>) <span class="ruby-operator">&&</span> <span class="ruby-ivar">@persistent</span>)
|
|
383
|
+
61: <span class="ruby-keyword kw">end</span>
|
|
335
384
|
</pre>
|
|
336
385
|
</div>
|
|
337
386
|
</div>
|
|
338
387
|
</div>
|
|
339
388
|
|
|
340
|
-
<div id="method-
|
|
341
|
-
<a name="
|
|
389
|
+
<div id="method-M000035" class="method-detail">
|
|
390
|
+
<a name="M000035"></a>
|
|
342
391
|
|
|
343
392
|
<div class="method-heading">
|
|
344
|
-
<a href="#
|
|
393
|
+
<a href="#M000035" class="method-signature">
|
|
345
394
|
<span class="method-name">redirect</span><span class="method-args">(location, permanent = false)</span>
|
|
346
395
|
</a>
|
|
347
396
|
</div>
|
|
@@ -351,65 +400,65 @@ closed.
|
|
|
351
400
|
Send a redirect response.
|
|
352
401
|
</p>
|
|
353
402
|
<p><a class="source-toggle" href="#"
|
|
354
|
-
onclick="toggleCode('
|
|
355
|
-
<div class="method-source-code" id="
|
|
403
|
+
onclick="toggleCode('M000035-source');return false;">[Source]</a></p>
|
|
404
|
+
<div class="method-source-code" id="M000035-source">
|
|
356
405
|
<pre>
|
|
357
|
-
<span class="ruby-comment cmt"># File lib/serverside/
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
|
|
406
|
+
<span class="ruby-comment cmt"># File lib/serverside/request.rb, line 126</span>
|
|
407
|
+
126: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">redirect</span>(<span class="ruby-identifier">location</span>, <span class="ruby-identifier">permanent</span> = <span class="ruby-keyword kw">false</span>)
|
|
408
|
+
127: <span class="ruby-ivar">@conn</span> <span class="ruby-operator"><<</span> (<span class="ruby-constant">Const</span><span class="ruby-operator">::</span><span class="ruby-constant">StatusRedirect</span> <span class="ruby-operator">%</span> [<span class="ruby-identifier">permanent</span> <span class="ruby-value">? </span><span class="ruby-value">301</span> <span class="ruby-operator">:</span> <span class="ruby-value">302</span>, <span class="ruby-identifier">location</span>])
|
|
409
|
+
128: <span class="ruby-keyword kw">rescue</span>
|
|
410
|
+
129: <span class="ruby-keyword kw">ensure</span>
|
|
411
|
+
130: <span class="ruby-ivar">@persistent</span> = <span class="ruby-keyword kw">false</span>
|
|
412
|
+
131: <span class="ruby-keyword kw">end</span>
|
|
364
413
|
</pre>
|
|
365
414
|
</div>
|
|
366
415
|
</div>
|
|
367
416
|
</div>
|
|
368
417
|
|
|
369
|
-
<div id="method-
|
|
370
|
-
<a name="
|
|
418
|
+
<div id="method-M000034" class="method-detail">
|
|
419
|
+
<a name="M000034"></a>
|
|
371
420
|
|
|
372
421
|
<div class="method-heading">
|
|
373
|
-
<a href="#
|
|
422
|
+
<a href="#M000034" class="method-signature">
|
|
374
423
|
<span class="method-name">send_response</span><span class="method-args">(status, content_type, body = nil, content_length = nil, headers = nil)</span>
|
|
375
424
|
</a>
|
|
376
425
|
</div>
|
|
377
426
|
|
|
378
427
|
<div class="method-description">
|
|
379
428
|
<p>
|
|
380
|
-
Sends an HTTP response.
|
|
429
|
+
Sends an <a href="../HTTP.html">HTTP</a> response.
|
|
381
430
|
</p>
|
|
382
431
|
<p><a class="source-toggle" href="#"
|
|
383
|
-
onclick="toggleCode('
|
|
384
|
-
<div class="method-source-code" id="
|
|
432
|
+
onclick="toggleCode('M000034-source');return false;">[Source]</a></p>
|
|
433
|
+
<div class="method-source-code" id="M000034-source">
|
|
385
434
|
<pre>
|
|
386
|
-
<span class="ruby-comment cmt"># File lib/serverside/
|
|
387
|
-
|
|
388
|
-
|
|
389
|
-
|
|
390
|
-
|
|
391
|
-
|
|
392
|
-
|
|
393
|
-
|
|
394
|
-
|
|
395
|
-
|
|
396
|
-
|
|
397
|
-
|
|
398
|
-
|
|
399
|
-
|
|
400
|
-
|
|
401
|
-
|
|
402
|
-
|
|
435
|
+
<span class="ruby-comment cmt"># File lib/serverside/request.rb, line 108</span>
|
|
436
|
+
108: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">send_response</span>(<span class="ruby-identifier">status</span>, <span class="ruby-identifier">content_type</span>, <span class="ruby-identifier">body</span> = <span class="ruby-keyword kw">nil</span>, <span class="ruby-identifier">content_length</span> = <span class="ruby-keyword kw">nil</span>,
|
|
437
|
+
109: <span class="ruby-identifier">headers</span> = <span class="ruby-keyword kw">nil</span>)
|
|
438
|
+
110: <span class="ruby-identifier">h</span> = <span class="ruby-identifier">headers</span> <span class="ruby-value">? </span>
|
|
439
|
+
111: <span class="ruby-identifier">headers</span>.<span class="ruby-identifier">inject</span>(<span class="ruby-value str">''</span>) {<span class="ruby-operator">|</span><span class="ruby-identifier">m</span>, <span class="ruby-identifier">kv</span><span class="ruby-operator">|</span> <span class="ruby-identifier">m</span> <span class="ruby-operator"><<</span> (<span class="ruby-constant">Const</span><span class="ruby-operator">::</span><span class="ruby-constant">Header</span> <span class="ruby-operator">%</span> <span class="ruby-identifier">kv</span>)} <span class="ruby-operator">:</span> <span class="ruby-value str">''</span>
|
|
440
|
+
112:
|
|
441
|
+
113: <span class="ruby-identifier">content_length</span> = <span class="ruby-identifier">body</span>.<span class="ruby-identifier">length</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">content_length</span>.<span class="ruby-identifier">nil?</span> <span class="ruby-operator">&&</span> <span class="ruby-identifier">body</span>
|
|
442
|
+
114: <span class="ruby-ivar">@persistent</span> = <span class="ruby-keyword kw">false</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">content_length</span>.<span class="ruby-identifier">nil?</span>
|
|
443
|
+
115:
|
|
444
|
+
116: <span class="ruby-comment cmt"># Select the right format to use according to circumstances.</span>
|
|
445
|
+
117: <span class="ruby-ivar">@conn</span> <span class="ruby-operator"><<</span> ((<span class="ruby-ivar">@persistent</span> <span class="ruby-operator">?</span> <span class="ruby-constant">Const</span><span class="ruby-operator">::</span><span class="ruby-constant">StatusPersist</span> <span class="ruby-operator">:</span>
|
|
446
|
+
118: (<span class="ruby-identifier">body</span> <span class="ruby-value">? </span><span class="ruby-constant">Const</span><span class="ruby-operator">::</span><span class="ruby-constant">StatusClose</span> <span class="ruby-operator">:</span> <span class="ruby-constant">Const</span><span class="ruby-operator">::</span><span class="ruby-constant">StatusStream</span>)) <span class="ruby-operator">%</span>
|
|
447
|
+
119: [<span class="ruby-identifier">status</span>, <span class="ruby-identifier">content_type</span>, <span class="ruby-identifier">h</span>, <span class="ruby-ivar">@response_cookies</span>, <span class="ruby-identifier">content_length</span>])
|
|
448
|
+
120: <span class="ruby-ivar">@conn</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">body</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">body</span>
|
|
449
|
+
121: <span class="ruby-keyword kw">rescue</span>
|
|
450
|
+
122: <span class="ruby-ivar">@persistent</span> = <span class="ruby-keyword kw">false</span>
|
|
451
|
+
123: <span class="ruby-keyword kw">end</span>
|
|
403
452
|
</pre>
|
|
404
453
|
</div>
|
|
405
454
|
</div>
|
|
406
455
|
</div>
|
|
407
456
|
|
|
408
|
-
<div id="method-
|
|
409
|
-
<a name="
|
|
457
|
+
<div id="method-M000037" class="method-detail">
|
|
458
|
+
<a name="M000037"></a>
|
|
410
459
|
|
|
411
460
|
<div class="method-heading">
|
|
412
|
-
<a href="#
|
|
461
|
+
<a href="#M000037" class="method-signature">
|
|
413
462
|
<span class="method-name">set_cookie</span><span class="method-args">(name, value, expires)</span>
|
|
414
463
|
</a>
|
|
415
464
|
</div>
|
|
@@ -419,24 +468,24 @@ Sends an HTTP response.
|
|
|
419
468
|
Sets a cookie to be included in the response.
|
|
420
469
|
</p>
|
|
421
470
|
<p><a class="source-toggle" href="#"
|
|
422
|
-
onclick="toggleCode('
|
|
423
|
-
<div class="method-source-code" id="
|
|
471
|
+
onclick="toggleCode('M000037-source');return false;">[Source]</a></p>
|
|
472
|
+
<div class="method-source-code" id="M000037-source">
|
|
424
473
|
<pre>
|
|
425
|
-
<span class="ruby-comment cmt"># File lib/serverside/
|
|
426
|
-
|
|
427
|
-
|
|
428
|
-
|
|
429
|
-
|
|
474
|
+
<span class="ruby-comment cmt"># File lib/serverside/request.rb, line 139</span>
|
|
475
|
+
139: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">set_cookie</span>(<span class="ruby-identifier">name</span>, <span class="ruby-identifier">value</span>, <span class="ruby-identifier">expires</span>)
|
|
476
|
+
140: <span class="ruby-ivar">@response_cookies</span> <span class="ruby-operator">||=</span> <span class="ruby-value str">""</span>
|
|
477
|
+
141: <span class="ruby-ivar">@response_cookies</span> <span class="ruby-operator"><<</span> (<span class="ruby-constant">Const</span><span class="ruby-operator">::</span><span class="ruby-constant">SetCookie</span> <span class="ruby-operator">%</span> [<span class="ruby-identifier">name</span>, <span class="ruby-identifier">value</span>.<span class="ruby-identifier">to_s</span>.<span class="ruby-identifier">uri_escape</span>, <span class="ruby-identifier">expires</span>.<span class="ruby-identifier">rfc2822</span>])
|
|
478
|
+
142: <span class="ruby-keyword kw">end</span>
|
|
430
479
|
</pre>
|
|
431
480
|
</div>
|
|
432
481
|
</div>
|
|
433
482
|
</div>
|
|
434
483
|
|
|
435
|
-
<div id="method-
|
|
436
|
-
<a name="
|
|
484
|
+
<div id="method-M000036" class="method-detail">
|
|
485
|
+
<a name="M000036"></a>
|
|
437
486
|
|
|
438
487
|
<div class="method-heading">
|
|
439
|
-
<a href="#
|
|
488
|
+
<a href="#M000036" class="method-signature">
|
|
440
489
|
<span class="method-name">stream</span><span class="method-args">(body)</span>
|
|
441
490
|
</a>
|
|
442
491
|
</div>
|
|
@@ -446,13 +495,13 @@ Sets a cookie to be included in the response.
|
|
|
446
495
|
Streams additional data to the client.
|
|
447
496
|
</p>
|
|
448
497
|
<p><a class="source-toggle" href="#"
|
|
449
|
-
onclick="toggleCode('
|
|
450
|
-
<div class="method-source-code" id="
|
|
498
|
+
onclick="toggleCode('M000036-source');return false;">[Source]</a></p>
|
|
499
|
+
<div class="method-source-code" id="M000036-source">
|
|
451
500
|
<pre>
|
|
452
|
-
<span class="ruby-comment cmt"># File lib/serverside/
|
|
453
|
-
|
|
454
|
-
|
|
455
|
-
|
|
501
|
+
<span class="ruby-comment cmt"># File lib/serverside/request.rb, line 134</span>
|
|
502
|
+
134: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">stream</span>(<span class="ruby-identifier">body</span>)
|
|
503
|
+
135: (<span class="ruby-ivar">@conn</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">body</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">body</span>) <span class="ruby-keyword kw">rescue</span> (<span class="ruby-ivar">@persistent</span> = <span class="ruby-keyword kw">false</span>)
|
|
504
|
+
136: <span class="ruby-keyword kw">end</span>
|
|
456
505
|
</pre>
|
|
457
506
|
</div>
|
|
458
507
|
</div>
|