Skip to content

Commit d8000d3

Browse files
committed
Added short description of HTTP server.
1 parent f18a057 commit d8000d3

File tree

9 files changed

+62
-24
lines changed

9 files changed

+62
-24
lines changed

html/c___network_library/appendices/http_uri.html

+1-1
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@
5252
</dl>
5353
</div>
5454
<a name="c___network_library.appendices.http_uri.valid_expressions"></a><h5>
55-
<a name="id2731178"></a>
55+
<a name="id3117518"></a>
5656
<a class="link" href="http_uri.html#c___network_library.appendices.http_uri.valid_expressions">Valid
5757
Expressions</a>
5858
</h5>

html/c___network_library/appendices/message_concept.html

+2-2
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@
3333
and <a href="http://www.boost.org/doc/html/Assignable.html" target="_top">Assignable</a>.
3434
</p>
3535
<a name="c___network_library.appendices.message_concept.description"></a><h5>
36-
<a name="id2729861"></a>
36+
<a name="id3116179"></a>
3737
<a class="link" href="message_concept.html#c___network_library.appendices.message_concept.description">Description</a>
3838
</h5>
3939
<p>
@@ -79,7 +79,7 @@
7979
</dl>
8080
</div>
8181
<a name="c___network_library.appendices.message_concept.valid_expressions"></a><h5>
82-
<a name="id2730058"></a>
82+
<a name="id3116377"></a>
8383
<a class="link" href="message_concept.html#c___network_library.appendices.message_concept.valid_expressions">Valid
8484
Expressions</a>
8585
</h5>

html/c___network_library/appendices/uri_concept.html

+2-2
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@
3535
URI Concepts are organized into a hierarchy of conepts.
3636
</p>
3737
<a name="c___network_library.appendices.uri_concept.description"></a><h5>
38-
<a name="id2730418"></a>
38+
<a name="id3116752"></a>
3939
<a class="link" href="uri_concept.html#c___network_library.appendices.uri_concept.description">Description</a>
4040
</h5>
4141
<p>
@@ -66,7 +66,7 @@
6666
</dl>
6767
</div>
6868
<a name="c___network_library.appendices.uri_concept.valid_expressions"></a><h5>
69-
<a name="id2730556"></a>
69+
<a name="id3116896"></a>
7070
<a class="link" href="uri_concept.html#c___network_library.appendices.uri_concept.valid_expressions">Valid
7171
Expressions</a>
7272
</h5>

html/c___network_library/examples/simple_wget.html

+3-2
Original file line numberDiff line numberDiff line change
@@ -36,14 +36,15 @@
3636
<p>
3737
</p>
3838
<p>
39-
It demonstrates the use the http::uri and the http::client.
39+
It demonstrates the use the <code class="computeroutput"><span class="identifier">http</span><span class="special">::</span><span class="identifier">uri</span></code>
40+
and the <code class="computeroutput"><span class="identifier">http</span><span class="special">::</span><span class="identifier">client</span></code>.
4041
</p>
4142
<p>
4243
</p>
4344
<p>
4445

4546
</p>
46-
<pre class="programlisting"><span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">network</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
47+
<pre class="programlisting"><span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">network</span><span class="special">/</span><span class="identifier">protocol</span><span class="special">/</span><span class="identifier">http</span><span class="special">/</span><span class="identifier">client</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
4748
<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">network</span><span class="special">/</span><span class="identifier">uri</span><span class="special">/</span><span class="identifier">http</span><span class="special">/</span><span class="identifier">uri</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
4849
<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">string</span><span class="special">&gt;</span>
4950
<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">fstream</span><span class="special">&gt;</span>

html/c___network_library/protocol/http/http_client_example.html

+11-7
Original file line numberDiff line numberDiff line change
@@ -68,7 +68,7 @@
6868
components are described below:
6969
</p>
7070
<a name="c___network_library.protocol.http.http_client_example.http_request"></a><h6>
71-
<a name="id2727026"></a>
71+
<a name="id3113264"></a>
7272
<a class="link" href="http_client_example.html#c___network_library.protocol.http.http_client_example.http_request">HTTP
7373
Request</a>
7474
</h6>
@@ -82,7 +82,7 @@
8282
information about the request and the resource. It models the Message concept.
8383
</p>
8484
<a name="c___network_library.protocol.http.http_client_example.http_client"></a><h6>
85-
<a name="id2727195"></a>
85+
<a name="id3113433"></a>
8686
<a class="link" href="http_client_example.html#c___network_library.protocol.http.http_client_example.http_client">HTTP
8787
Client</a>
8888
</h6>
@@ -98,7 +98,7 @@
9898
object.
9999
</p>
100100
<a name="c___network_library.protocol.http.http_client_example.http_response"></a><h6>
101-
<a name="id2727373"></a>
101+
<a name="id3113611"></a>
102102
<a class="link" href="http_client_example.html#c___network_library.protocol.http.http_client_example.http_response">HTTP
103103
Response</a>
104104
</h6>
@@ -112,7 +112,7 @@
112112
the data received from the server. It also models the Message concept.
113113
</p>
114114
<a name="c___network_library.protocol.http.http_client_example.http_client_walkthrough"></a><h6>
115-
<a name="id2727543"></a>
115+
<a name="id3113781"></a>
116116
<a class="link" href="http_client_example.html#c___network_library.protocol.http.http_client_example.http_client_walkthrough">HTTP
117117
Client Walkthrough</a>
118118
</h6>
@@ -161,7 +161,7 @@
161161
the rest is simple. This example outputs the response body.
162162
</p>
163163
<a name="c___network_library.protocol.http.http_client_example.using__code__phrase_role__identifier__http__phrase__phrase_role__special______phrase__phrase_role__identifier__client__phrase___code_"></a><h6>
164-
<a name="id2727868"></a>
164+
<a name="id3114106"></a>
165165
<a class="link" href="http_client_example.html#c___network_library.protocol.http.http_client_example.using__code__phrase_role__identifier__http__phrase__phrase_role__special______phrase__phrase_role__identifier__client__phrase___code_">Using
166166
<code class="computeroutput"><span class="identifier">http</span><span class="special">::</span><span class="identifier">client</span></code></a>
167167
</h6>
@@ -183,15 +183,15 @@
183183
<li class="listitem"><code class="computeroutput"><span class="identifier">http</span><span class="special">::</span><span class="identifier">client</span><span class="special">(</span><span class="identifier">http</span><span class="special">::</span><span class="identifier">client</span><span class="special">::</span><span class="identifier">follow_redirect</span><span class="special">)</span></code></li>
184184
</ul></div>
185185
<a name="c___network_library.protocol.http.http_client_example._code__phrase_role__identifier__http__phrase__phrase_role__special______phrase__phrase_role__identifier__client__phrase__phrase_role__special______phrase__phrase_role__identifier__cache_resolved__phrase___code_"></a><h6>
186-
<a name="id2728189"></a>
186+
<a name="id3114427"></a>
187187
<a class="link" href="http_client_example.html#c___network_library.protocol.http.http_client_example._code__phrase_role__identifier__http__phrase__phrase_role__special______phrase__phrase_role__identifier__client__phrase__phrase_role__special______phrase__phrase_role__identifier__cache_resolved__phrase___code_"><code class="computeroutput"><span class="identifier">http</span><span class="special">::</span><span class="identifier">client</span><span class="special">::</span><span class="identifier">cache_resolved</span></code></a>
188188
</h6>
189189
<p>
190190
This argument enables the caching of resolved endpoints and prevents the
191191
client from resolving IP addresses of previously resolved hostnames.
192192
</p>
193193
<a name="c___network_library.protocol.http.http_client_example._code__phrase_role__identifier__http__phrase__phrase_role__special______phrase__phrase_role__identifier__client__phrase__phrase_role__special______phrase__phrase_role__identifier__follow_redirect__phrase__phrase_role__special_____phrase__phrase_role__identifier__s__phrase__phrase_role__special_____phrase___code_"></a><h6>
194-
<a name="id2728254"></a>
194+
<a name="id3114492"></a>
195195
<a class="link" href="http_client_example.html#c___network_library.protocol.http.http_client_example._code__phrase_role__identifier__http__phrase__phrase_role__special______phrase__phrase_role__identifier__client__phrase__phrase_role__special______phrase__phrase_role__identifier__follow_redirect__phrase__phrase_role__special_____phrase__phrase_role__identifier__s__phrase__phrase_role__special_____phrase___code_"><code class="computeroutput"><span class="identifier">http</span><span class="special">::</span><span class="identifier">client</span><span class="special">::</span><span class="identifier">follow_redirect</span><span class="special">(</span><span class="identifier">s</span><span class="special">)</span></code></a>
196196
</h6>
197197
<p>
@@ -200,6 +200,10 @@
200200
header provided by the response(s); headers present in the original request
201201
are preserved in the subsequent request(s).
202202
</p>
203+
<p>
204+
As with the <code class="computeroutput"><span class="identifier">http</span><span class="special">::</span><span class="identifier">server</span></code>, the client can be extended to
205+
support different characteristics.
206+
</p>
203207
</div>
204208
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
205209
<td align="left"></td>

html/c___network_library/protocol/http/http_server_example.html

+36-3
Original file line numberDiff line numberDiff line change
@@ -78,7 +78,7 @@
7878
<p>
7979
</p>
8080
<a name="c___network_library.protocol.http.http_server_example.http_server"></a><h6>
81-
<a name="id2725751"></a>
81+
<a name="id3111862"></a>
8282
<a class="link" href="http_server_example.html#c___network_library.protocol.http.http_server_example.http_server">HTTP
8383
Server</a>
8484
</h6>
@@ -92,7 +92,7 @@
9292
to handle incoming requests.
9393
</p>
9494
<a name="c___network_library.protocol.http.http_server_example.http_request_handler"></a><h6>
95-
<a name="id2725895"></a>
95+
<a name="id3112007"></a>
9696
<a class="link" href="http_server_example.html#c___network_library.protocol.http.http_server_example.http_request_handler">HTTP
9797
Request Handler</a>
9898
</h6>
@@ -113,7 +113,7 @@
113113
member function is also required to be defined.
114114
</p>
115115
<a name="c___network_library.protocol.http.http_server_example.running_the_server"></a><h6>
116-
<a name="id2726146"></a>
116+
<a name="id3112258"></a>
117117
<a class="link" href="http_server_example.html#c___network_library.protocol.http.http_server_example.running_the_server">Running
118118
the Server</a>
119119
</h6>
@@ -128,6 +128,39 @@
128128
<code class="computeroutput"><span class="identifier">hello_world</span></code> handler object
129129
is passed as the third argument.
130130
</p>
131+
<a name="c___network_library.protocol.http.http_server_example.using__code__phrase_role__identifier__http__phrase__phrase_role__special______phrase__phrase_role__identifier__server__phrase___code_"></a><h6>
132+
<a name="id3112437"></a>
133+
<a class="link" href="http_server_example.html#c___network_library.protocol.http.http_server_example.using__code__phrase_role__identifier__http__phrase__phrase_role__special______phrase__phrase_role__identifier__server__phrase___code_">Using
134+
<code class="computeroutput"><span class="identifier">http</span><span class="special">::</span><span class="identifier">server</span></code></a>
135+
</h6>
136+
<p>
137+
While this example shows how easy it is to create and use a single server
138+
instance, typically we want to do a lot more. An embedder might store several
139+
<code class="computeroutput"><span class="identifier">http</span><span class="special">::</span><span class="identifier">server</span></code> instances and call their <code class="computeroutput"><span class="identifier">run</span></code> functions in a thread pool.
140+
</p>
141+
<p>
142+
<code class="computeroutput"><span class="identifier">http</span><span class="special">::</span><span class="identifier">basic_server</span></code> can be further extended
143+
according to the supplied tag, so that it may implement specific functionality
144+
including, but not limited to:
145+
</p>
146+
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
147+
<li class="listitem">
148+
HTTP 1.0 only or HTTP 1.1 only
149+
</li>
150+
<li class="listitem">
151+
WebDAV support
152+
</li>
153+
<li class="listitem">
154+
Static files
155+
</li>
156+
<li class="listitem">
157+
Request pipelining
158+
</li>
159+
</ul></div>
160+
<p>
161+
As the project continues to develop, more of this functionality will be
162+
implemented.
163+
</p>
131164
</div>
132165
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
133166
<td align="left"></td>

html/c___network_library/quick_start.html

+3-3
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@
2727
<a name="c___network_library.quick_start"></a><a class="link" href="quick_start.html" title="Quick Start"> Quick Start</a>
2828
</h2></div></div></div>
2929
<a name="c___network_library.quick_start.hello_world_server"></a><h4>
30-
<a name="id2671772"></a>
30+
<a name="id3057889"></a>
3131
<a class="link" href="quick_start.html#c___network_library.quick_start.hello_world_server">Hello World
3232
Server</a>
3333
</h4>
@@ -45,7 +45,7 @@
4545
</p>
4646
<pre class="programlisting"><span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">network</span><span class="special">/</span><span class="identifier">protocol</span><span class="special">/</span><span class="identifier">http</span><span class="special">/</span><span class="identifier">server</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
4747
<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">iostream</span><span class="special">&gt;</span>
48-
<span class="identifier">f</span>
48+
4949

5050
<span class="keyword">namespace</span> <span class="identifier">http</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">network</span><span class="special">::</span><span class="identifier">http</span><span class="special">;</span>
5151

@@ -131,7 +131,7 @@
131131
<p>
132132
</p>
133133
<a name="c___network_library.quick_start.hello_world_client"></a><h4>
134-
<a name="id2721688"></a>
134+
<a name="id3107800"></a>
135135
<a class="link" href="quick_start.html#c___network_library.quick_start.hello_world_client">Hello World
136136
Client</a>
137137
</h4>

html/c___network_library/using.html

+2-2
Original file line numberDiff line numberDiff line change
@@ -27,15 +27,15 @@
2727
<a name="c___network_library.using"></a><a class="link" href="using.html" title="Using The C++ Network Library"> Using The C++ Network Library</a>
2828
</h2></div></div></div>
2929
<a name="c___network_library.using.supported_platforms"></a><h4>
30-
<a name="id2722652"></a>
30+
<a name="id3108764"></a>
3131
<a class="link" href="using.html#c___network_library.using.supported_platforms">Supported Platforms</a>
3232
</h4>
3333
<p>
3434
The C++ Network Library is tested on GCC 4.3 on Linux; MSVC 9.0 on Windows
3535
Vista.
3636
</p>
3737
<a name="c___network_library.using.dependencies"></a><h4>
38-
<a name="id2722675"></a>
38+
<a name="id3108787"></a>
3939
<a class="link" href="using.html#c___network_library.using.dependencies">Dependencies</a>
4040
</h4>
4141
<p>

html/index.html

+2-2
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@
3333
</div></div>
3434
<div><p class="copyright">Copyright &#169; 2008 , 2009, 2010 Glyn Matthews, Dean Michael Berris</p></div>
3535
<div><div class="legalnotice" title="Legal Notice">
36-
<a name="id2711848"></a><p>
36+
<a name="id3097964"></a><p>
3737
Distributed under the Boost Software License, Version 1.0. (See accompanying
3838
file LICENSE_1_0.txt or copy at <a href="http://www.boost.org/LICENSE_1_0.txt" target="_top">http://www.boost.org/LICENSE_1_0.txt</a>)
3939
</p>
@@ -88,7 +88,7 @@
8888
</div>
8989
</div>
9090
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
91-
<td align="left"><p><small>Last revised: January 25, 2010 at 19:02:34 GMT</small></p></td>
91+
<td align="left"><p><small>Last revised: January 27, 2010 at 20:23:26 GMT</small></p></td>
9292
<td align="right"><div class="copyright-footer"></div></td>
9393
</tr></table>
9494
<hr>

0 commit comments

Comments
 (0)