<aname="c___network_library.appendices.http_uri.valid_expressions"></a><h5>

<aname="id2731178"></a>

<aname="id3117518"></a>

<aclass="link"href="http_uri.html#c___network_library.appendices.http_uri.valid_expressions">Valid

Expressions</a>

and<ahref="http://www.boost.org/doc/html/Assignable.html"target="_top">Assignable</a>.

<aname="c___network_library.appendices.message_concept.description"></a><h5>

<aname="id2729861"></a>

<aname="id3116179"></a>

<aclass="link"href="message_concept.html#c___network_library.appendices.message_concept.description">Description</a>

<aname="c___network_library.appendices.message_concept.valid_expressions"></a><h5>

<aname="id2730058"></a>

<aname="id3116377"></a>

<aclass="link"href="message_concept.html#c___network_library.appendices.message_concept.valid_expressions">Valid

Expressions</a>

URI Concepts are organized into a hierarchy of conepts.

<aname="c___network_library.appendices.uri_concept.description"></a><h5>

<aname="id2730418"></a>

<aname="id3116752"></a>

<aclass="link"href="uri_concept.html#c___network_library.appendices.uri_concept.description">Description</a>

<aname="c___network_library.appendices.uri_concept.valid_expressions"></a><h5>

<aname="id2730556"></a>

<aname="id3116896"></a>

<aclass="link"href="uri_concept.html#c___network_library.appendices.uri_concept.valid_expressions">Valid

Expressions</a>

It demonstrates the use the http::uri and the http::client.

It demonstrates the use the<codeclass="computeroutput"><spanclass="identifier">http</span><spanclass="special">::</span><spanclass="identifier">uri</span></code>

and the<codeclass="computeroutput"><spanclass="identifier">http</span><spanclass="special">::</span><spanclass="identifier">client</span></code>.

<preclass="programlisting"><spanclass="preprocessor">#include</span><spanclass="special">&lt;</span><spanclass="identifier">boost</span><spanclass="special">/</span><spanclass="identifier">network</span><spanclass="special">.</span><spanclass="identifier">hpp</span><spanclass="special">&gt;</span>

<preclass="programlisting"><spanclass="preprocessor">#include</span><spanclass="special">&lt;</span><spanclass="identifier">boost</span><spanclass="special">/</span><spanclass="identifier">network</span><spanclass="special">/</span><spanclass="identifier">protocol</span><spanclass="special">/</span><spanclass="identifier">http</span><spanclass="special">/</span><spanclass="identifier">client</span><spanclass="special">.</span><spanclass="identifier">hpp</span><spanclass="special">&gt;</span>

<spanclass="preprocessor">#include</span><spanclass="special">&lt;</span><spanclass="identifier">boost</span><spanclass="special">/</span><spanclass="identifier">network</span><spanclass="special">/</span><spanclass="identifier">uri</span><spanclass="special">/</span><spanclass="identifier">http</span><spanclass="special">/</span><spanclass="identifier">uri</span><spanclass="special">.</span><spanclass="identifier">hpp</span><spanclass="special">&gt;</span>

<spanclass="preprocessor">#include</span><spanclass="special">&lt;</span><spanclass="identifier">string</span><spanclass="special">&gt;</span>

<spanclass="preprocessor">#include</span><spanclass="special">&lt;</span><spanclass="identifier">fstream</span><spanclass="special">&gt;</span>

components are described below:

<aname="c___network_library.protocol.http.http_client_example.http_request"></a><h6>

<aname="id2727026"></a>

<aname="id3113264"></a>

<aclass="link"href="http_client_example.html#c___network_library.protocol.http.http_client_example.http_request">HTTP

Request</a>

information about the request and the resource. It models the Message concept.

<aname="c___network_library.protocol.http.http_client_example.http_client"></a><h6>

<aname="id2727195"></a>

<aname="id3113433"></a>

<aclass="link"href="http_client_example.html#c___network_library.protocol.http.http_client_example.http_client">HTTP

Client</a>

object.

<aname="c___network_library.protocol.http.http_client_example.http_response"></a><h6>

<aname="id2727373"></a>

<aname="id3113611"></a>

<aclass="link"href="http_client_example.html#c___network_library.protocol.http.http_client_example.http_response">HTTP

Response</a>

the data received from the server. It also models the Message concept.

<aname="c___network_library.protocol.http.http_client_example.http_client_walkthrough"></a><h6>

<aname="id2727543"></a>

<aname="id3113781"></a>

<aclass="link"href="http_client_example.html#c___network_library.protocol.http.http_client_example.http_client_walkthrough">HTTP

Client Walkthrough</a>

the rest is simple. This example outputs the response body.

<aname="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>

<aname="id2727868"></a>

<aname="id3114106"></a>

<aclass="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

<codeclass="computeroutput"><spanclass="identifier">http</span><spanclass="special">::</span><spanclass="identifier">client</span></code></a>

<liclass="listitem"><codeclass="computeroutput"><spanclass="identifier">http</span><spanclass="special">::</span><spanclass="identifier">client</span><spanclass="special">(</span><spanclass="identifier">http</span><spanclass="special">::</span><spanclass="identifier">client</span><spanclass="special">::</span><spanclass="identifier">follow_redirect</span><spanclass="special">)</span></code></li>

<aname="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>

<aname="id2728189"></a>

<aname="id3114427"></a>

<aclass="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_"><codeclass="computeroutput"><spanclass="identifier">http</span><spanclass="special">::</span><spanclass="identifier">client</span><spanclass="special">::</span><spanclass="identifier">cache_resolved</span></code></a>

This argument enables the caching of resolved endpoints and prevents the

client from resolving IP addresses of previously resolved hostnames.

<aname="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>

<aname="id2728254"></a>

<aname="id3114492"></a>

<aclass="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_"><codeclass="computeroutput"><spanclass="identifier">http</span><spanclass="special">::</span><spanclass="identifier">client</span><spanclass="special">::</span><spanclass="identifier">follow_redirect</span><spanclass="special">(</span><spanclass="identifier">s</span><spanclass="special">)</span></code></a>

header provided by the response(s); headers present in the original request

are preserved in the subsequent request(s).

As with the<codeclass="computeroutput"><spanclass="identifier">http</span><spanclass="special">::</span><spanclass="identifier">server</span></code>, the client can be extended to

support different characteristics.

<tablexmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision"width="100%"><tr>

<tdalign="left"></td>

<aname="c___network_library.protocol.http.http_server_example.http_server"></a><h6>

<aname="id2725751"></a>

<aname="id3111862"></a>

<aclass="link"href="http_server_example.html#c___network_library.protocol.http.http_server_example.http_server">HTTP

Server</a>

to handle incoming requests.

<aname="c___network_library.protocol.http.http_server_example.http_request_handler"></a><h6>

<aname="id2725895"></a>

<aname="id3112007"></a>

<aclass="link"href="http_server_example.html#c___network_library.protocol.http.http_server_example.http_request_handler">HTTP

Request Handler</a>

member function is also required to be defined.

<aname="c___network_library.protocol.http.http_server_example.running_the_server"></a><h6>

<aname="id2726146"></a>

<aname="id3112258"></a>

<aclass="link"href="http_server_example.html#c___network_library.protocol.http.http_server_example.running_the_server">Running

the Server</a>

<codeclass="computeroutput"><spanclass="identifier">hello_world</span></code> handler object

is passed as the third argument.

<aname="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>

<aname="id3112437"></a>

<aclass="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

<codeclass="computeroutput"><spanclass="identifier">http</span><spanclass="special">::</span><spanclass="identifier">server</span></code></a>

While this example shows how easy it is to create and use a single server

instance, typically we want to do a lot more. An embedder might store several

<codeclass="computeroutput"><spanclass="identifier">http</span><spanclass="special">::</span><spanclass="identifier">server</span></code> instances and call their<codeclass="computeroutput"><spanclass="identifier">run</span></code> functions in a thread pool.

<codeclass="computeroutput"><spanclass="identifier">http</span><spanclass="special">::</span><spanclass="identifier">basic_server</span></code> can be further extended

according to the supplied tag, so that it may implement specific functionality

including, but not limited to:

<divclass="itemizedlist"><ulclass="itemizedlist"type="disc">

<liclass="listitem">

HTTP 1.0 only or HTTP 1.1 only

<liclass="listitem">

WebDAV support

<liclass="listitem">

Static files

<liclass="listitem">

Request pipelining

As the project continues to develop, more of this functionality will be

implemented.

<tablexmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision"width="100%"><tr>

<tdalign="left"></td>

<aname="c___network_library.quick_start"></a><aclass="link"href="quick_start.html"title="Quick Start"> Quick Start</a>

<aname="c___network_library.quick_start.hello_world_server"></a><h4>

<aname="id2671772"></a>

<aname="id3057889"></a>

<aclass="link"href="quick_start.html#c___network_library.quick_start.hello_world_server">Hello World

Server</a>

<preclass="programlisting"><spanclass="preprocessor">#include</span><spanclass="special">&lt;</span><spanclass="identifier">boost</span><spanclass="special">/</span><spanclass="identifier">network</span><spanclass="special">/</span><spanclass="identifier">protocol</span><spanclass="special">/</span><spanclass="identifier">http</span><spanclass="special">/</span><spanclass="identifier">server</span><spanclass="special">.</span><spanclass="identifier">hpp</span><spanclass="special">&gt;</span>

<spanclass="preprocessor">#include</span><spanclass="special">&lt;</span><spanclass="identifier">iostream</span><spanclass="special">&gt;</span>

<spanclass="keyword">namespace</span><spanclass="identifier">http</span><spanclass="special">=</span><spanclass="identifier">boost</span><spanclass="special">::</span><spanclass="identifier">network</span><spanclass="special">::</span><spanclass="identifier">http</span><spanclass="special">;</span>

<aname="c___network_library.quick_start.hello_world_client"></a><h4>

<aname="id2721688"></a>

<aname="id3107800"></a>

<aclass="link"href="quick_start.html#c___network_library.quick_start.hello_world_client">Hello World

Client</a>

<aname="c___network_library.using"></a><aclass="link"href="using.html"title="Using The C++ Network Library"> Using The C++ Network Library</a>

<aname="c___network_library.using.supported_platforms"></a><h4>

<aname="id2722652"></a>

<aname="id3108764"></a>

<aclass="link"href="using.html#c___network_library.using.supported_platforms">Supported Platforms</a>

The C++ Network Library is tested on GCC 4.3 on Linux; MSVC 9.0 on Windows

Vista.

<aname="c___network_library.using.dependencies"></a><h4>

<aname="id2722675"></a>

<aname="id3108787"></a>

<aclass="link"href="using.html#c___network_library.using.dependencies">Dependencies</a>

<div><pclass="copyright">Copyright &#169; 2008 , 2009, 2010 Glyn Matthews, Dean Michael Berris</p></div>

<div><divclass="legalnotice"title="Legal Notice">

<aname="id2711848"></a><p>

<aname="id3097964"></a><p>

Distributed under the Boost Software License, Version 1.0. (See accompanying

file LICENSE_1_0.txt or copy at<ahref="http://www.boost.org/LICENSE_1_0.txt"target="_top">http://www.boost.org/LICENSE_1_0.txt</a>)

<tablexmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision"width="100%"><tr>

<tdalign="left"><p><small>Last revised: January25, 2010 at19:02:34 GMT</small></p></td>

<tdalign="left"><p><small>Last revised: January27, 2010 at20:23:26 GMT</small></p></td>

<tdalign="right"><divclass="copyright-footer"></div></td>