http://www.boost.org/LICENSE_1_0.txt).

]

[section:appendix_1 Appendix 1: Message Concepts]

[section:appendices Appendices]

[section:message_concept Message]

[include message_concept.qbk]

[include uri_concept.qbk]

[include http_uri_concept.qbk]

__message__ is

[@http://www.boost.org/doc/html/DefaultConstructible.html

DefaultConstructible],

[@http://www.boost.org/doc/html/CopyConstructible.html

CopyConstructible] and [@http://www.boost.org/doc/html/Assignable.html

Assignable].

[heading Description]

A type models the URI Concept if the type adheres to the following

usage semantics, and is DefaultConstructible and EqualityComparable.

[variablelist Notation

[[`M`] [A Message Type.]]

[[`m`, `m_`] [A Message Type instance.]]

[[`S`] [A String Type.]]

[[`s`] [A String Type instance.]]

[[`O`] [An Ostringstream Type.]]

[[`o`] [An Ostringstream Type instance.]]

[[`C`] [A Header Container Type.]]

[[`c`] [A Header Container Type instance.]]

]

[heading Valid Expressions]

[table

[[Expression] [Return Type] [Description]]

[[`M m_(m);`] [] [M must be Copy constructible.]]

[[`M m_; m_ = m;`] [] [M must be Assignable.]]

[[`swap(m, m_);`] [void] [Swap should be availabe via ADL.]]

[[`M::string_type`] [S] [M should have a nested type `string_type` of type `S`.]]

[[`M::headers_container_type`] [C] [M should have a nested type `headers_container_type` of type `C`.]]

]

[endsect] [/message_concept]

[endsect] [/appendix_1]

[section:appendix_2 Appendix 2: URI Concepts]

This page describes the URI Concepts implemented within cpp-netlib.

The following concepts are also implemented as Boost.Concept_check

types enforced by the URI library.

URI Concepts are organized into a hierarchy of conepts.

[section:uri_concept URI]

[heading Description]

A type models the URI Concept if the type adheres to the following

usage semantics, and is DefaultConstructible and EqualityComparable.

[variablelist Notation

[[`U`] [A URI Type.]]

[[`u`, `u_`] [A URI Type instance.]]

[[`S`] [A String Type.]]

[[`s`] [A String Type instance.]]

]

[heading Valid Expressions]

For any URI, the following expressions must be valid:

[table

[[Expression] [Return Type] [Description]]

[[`U u_(u)`;] [] [U must be Copy constructible.]]

[[`U u_; u_ = u;`] [] [U must be Assignable.]]

[[`U u_(s)`;] [] [U can be constructed from a string `s`.]]

[[`swap(u, u_);`] [void] [Swap should be availabe via ADL.]]

[[`protocol(u);`] [S] [Return the protocol part of the URI.]]

[[`rest(u);`] [S] [Return the rest of the URI, excluding the protocol part.]]

[[`valid(u);`] [bool] [Return true whether the URI is a valid URI.]]

[[`U::string_type`] [S] [U should have a nested type `string_type` of type `S`.]]

]

[endsect] [/uri_concept]

[section:http_uri HTTP URI]

A type models the HTTP URI Concept if the type adheres to the following

usage semantics, and if the type also models the URI Concept.

[variablelist Notation

[[`H`] [An HTTP URI Type.]]

[[`h`,`h_`] [An HTTP URI Type instance.]]

[[`S`] [A String Type.]]

[[`s`] [A String Type instance.]]

]

[heading Valid Expressions]

For any HTTP URI, the following expressions must be valid:

[table

[[Expression] [Return Type] [Description]]

[[`user_info(h)`] [S] [Retrieve the user-info part of the HTTP URI.]]

[[`host(h)`] [S] [Retrieve the host part of the HTTP URI.]]

[[`port(h)`] [uint16_t] [Retrieve the port part of the HTTP URI.]]

[[`path(h)`] [S] [Retrieve the path part of the HTTP URI.]]

[[`query(h)`] [S] [Retrieve the query part of the HTTP URI.]]

[[`fragment(h)`][S] [Retrieve the fragment part of the HTTP URI.]]

]

[endsect] [/http_uri]

[endsect] [/appendix_2]

[endsect] [/ appendices]

http://www.boost.org/LICENSE_1_0.txt).

]

[section:contributors Contributors]

[endsect] [/ contributors]

[/

(C) Copyright 2008, 2009 Glyn Matthews.

(C) Copyright 2008, 2009, 2010 Glyn Matthews.

Distributed under the Boost Software License, Version 1.0.

(See accompanying file LICENSE_1_0.txt or copy at

http://www.boost.org/LICENSE_1_0.txt).

]

[section:examples Examples]

[include examples/hello_world.qbk]

[include examples/http_client.qbk]

[include examples/simple_wget.qbk]

[endsect]

[/

(C) Copyright 2010 Glyn Matthews.

Distributed under the Boost Software License, Version 1.0.

(See accompanying file LICENSE_1_0.txt or copy at

http://www.boost.org/LICENSE_1_0.txt).

]

[section:hello_world Hello World]

[import ../../example/hello_world_server.cpp]

[hello_world_server_main]

[import ../../example/hello_world_client.cpp]

[hello_world_client_main]

[endsect] [/hello_world]

[section:http_client HTTP Client]

[import ../../example/http_client.cpp]

[http_client_main]

[endsect]

[endsect] [/http_client]

[section:simple_wget Simple 'wget' Clone]

[import ../../example/simple_wget.cpp]

[simple_wget_main]

[endsect]

[endsect] [/simple_wget]

[/

(C) Copyright 2010 Glyn Matthews.

Distributed under the Boost Software License, Version 1.0.

(See accompanying file LICENSE_1_0.txt or copy at

http://www.boost.org/LICENSE_1_0.txt).

]

[section:http_uri HTTP URI Concept]

A type models the HTTP URI Concept if the type adheres to the following

usage semantics, and if the type also models the URI Concept.

[variablelist Notation

[[`H`] [An HTTP URI Type.]]

[[`h`,`h_`] [An HTTP URI Type instance.]]

[[`S`] [A String Type.]]

[[`s`] [A String Type instance.]]

]

[heading Valid Expressions]

For any HTTP URI, the following expressions must be valid:

[table

[[Expression] [Return Type] [Description]]

[[`user_info(h)`] [S] [Retrieve the user-info part of the HTTP URI.]]

[[`host(h)`] [S] [Retrieve the host part of the HTTP URI.]]

[[`port(h)`] [uint16_t] [Retrieve the port part of the HTTP URI.]]

[[`path(h)`] [S] [Retrieve the path part of the HTTP URI.]]

[[`query(h)`] [S] [Retrieve the query part of the HTTP URI.]]

[[`fragment(h)`][S] [Retrieve the fragment part of the HTTP URI.]]

]

[endsect] [/ http_uri]

[section:motivation Motivation]

Modern applications that communicate over the internet have never been

more prevalent, ranging through diverse areas such as high performance

servers to embedded systems for smart phonesor navigation systems.

servers to embedded systems for smart phonesand navigation systems.

Currently, there are no open source network libraries available that

use modern object-oriented techniques in C++. With the introduction

of __boost_asio__, developing portable network C++ applications has

become a very much easier task. What is still lacking is a set of

libraries that utilise __boost_asio__ in order to provide application

level support so that C++ developers are able to develop internet and

distributed applications more effectively.

use modern object-oriented techniques in C++. Any developer will

understand the familiar problem of searching for a protocol library

for their project, failing to find anything suitable and too often

having to hand-roll their own.

By leveraging __boost__, and in particular __boost_asio__, developers

can create portable network C++ applications much more easily. What

is still lacking is a set of libraries that utilise __boost_asio__ in

order to provide application level support so that C++ developers are

able to develop internet and distributed applications more

effectively. This is the niche that the developers of the __cnl__ see

their project filling.

[endsect] [/motivation]

* develop a high quality, portable, easy to use C++ networking library

* enable developers to easily extend the library

* lower the barrier to entry for cross-platform network-aware C++

* lower the barrier to entry for cross-platform, network-aware C++

applications

The goal of __cnl__ has never been to build a fully-featured web

server - there are plenty of excellent options already available. The

niche that this library targets is for light-weight networking

functionality for C++ applications that have demanding performance

requirements or memory constraints, but that also need to be portable.

This type of application is becoming increasingly common as software

becomes more distributed, and applications need to communicate with

services.

The goal of the __cnl__ has never been to build a fully-featured web

server - there are plenty of excellent options already available.

This project targets light-weight networking functionality for C++

applications that have demanding performance requirements or memory

constraints, but that also need to be portable. This type of

application is becoming increasingly common as software becomes more

distributed, and applications need to run on a wide range of devices.

While many languages provide direct library support for high level

network programming, this feature is missing in C++. Therefore, this

library has been developed with the intention of eventually being

submitted to __boost__, a collection of general, high quality

libraries for C++ developers.

network programming, this feature is missing in standard C++.

Therefore, this library has been developed with the intention of

eventually being submitted to __boost__.

Eventually, __cnl__ will be extended to support many of the

Eventually,the__cnl__ will be extended to support many of the

application layer protocols such as SMTP, FTP, SOAP, XMPP etc.

[endsect] [/objectives]

classbasic_message {

typedeftypename string<Tag>::type string_type;

typedeftypename headers_container<Tag>::type headers_container_type;

basic_message(const basic_message &);

basic_message &operator = (const basic_message &);

voidswap(basic_message &);

headers_container_type &headers()const;

string_type &body()const;

string_type &source()const;

string_type &destination()const;

};

[/

(C) Copyright 2010 Glyn Matthews.

Distributed under the Boost Software License, Version 1.0.

(See accompanying file LICENSE_1_0.txt or copy at

http://www.boost.org/LICENSE_1_0.txt).

]

[section:message_concept Message Concept]

__message__ is

[@http://www.boost.org/doc/html/DefaultConstructible.html

DefaultConstructible],

[@http://www.boost.org/doc/html/CopyConstructible.html

CopyConstructible] and [@http://www.boost.org/doc/html/Assignable.html

Assignable].

[heading Description]

A type models the Message Concept if the type adheres to the following

usage semantics, and is DefaultConstructible and EqualityComparable.

[variablelist Notation

[[`M`] [A Message Type.]]

[[`m`, `m_`] [A Message Type instance.]]

[[`S`] [A String Type.]]

[[`s`] [A String Type instance.]]

[[`O`] [An Ostringstream Type.]]

[[`o`] [An Ostringstream Type instance.]]

[[`C`] [A Header Container Type.]]

[[`c`] [A Header Container Type instance.]]

]

[heading Valid Expressions]

[table

[[Expression] [Return Type] [Description]]

[[`M m_(m);`] [] [M must be Copy constructible.]]

[[`M m_; m_ = m;`] [] [M must be Assignable.]]

[[`swap(m, m_);`] [void] [Swap should be availabe via ADL.]]

[[`M::string_type`] [S] [M should have a nested type `string_type` of type `S`.]]

[[`M::headers_container_type`] [C] [M should have a nested type `headers_container_type` of type `C`.]]

]

[endsect] [/ message_concept]