diff --git a/0.11.2/_sources/examples/http/hello_world_server.txt b/0.11.2/_sources/examples/http/hello_world_server.txt index 6d5c029..3dace4e 100644 --- a/0.11.2/_sources/examples/http/hello_world_server.txt +++ b/0.11.2/_sources/examples/http/hello_world_server.txt @@ -19,7 +19,6 @@ simple response to any HTTP request. .. code-block:: c++ #include - #include #include namespace http = boost::network::http; @@ -28,16 +27,19 @@ simple response to any HTTP request. typedef http::server server; struct hello_world { - void operator() (server::request const &request, - server::response &response) { - std::string ip = source(request); - response = server::response::stock_reply( - server::response::ok, std::string("Hello, ") + ip + "!"); + void operator()(server::request const &request, server::response &response) { + server::string_type ip = source(request); + unsigned int port = request.source_port; + std::ostringstream data; + data << "Hello, " << ip << ':' << port << '!'; + response = server::response::stock_reply(server::response::ok, data.str()); + } + void log(const server::string_type& message) { + std::cerr << "ERROR: " << message << std::endl; } }; - int - main(int argc, char * argv[]) { + int main(int argc, char *argv[]) { if (argc != 3) { std::cerr << "Usage: " << argv[0] << " address port" << std::endl; @@ -46,7 +48,8 @@ simple response to any HTTP request. try { hello_world handler; - server server_(argv[1], argv[2], handler); + server::options options(handler); + server server_(options.address(argv[1]).port(argv[2])); server_.run(); } catch (std::exception &e) { @@ -100,34 +103,39 @@ This header contains all the code needed to develop an HTTP server with typedef http::server server; struct hello_world { - void operator () (server::request const &request, - server::response &response) { - std::string ip = source(request); - response = server::response::stock_reply( - server::response::ok, std::string("Hello, ") + ip + "!"); + void operator()(server::request const &request, server::response &response) { + server::string_type ip = source(request); + unsigned int port = request.source_port; + std::ostringstream data; + data << "Hello, " << ip << ':' << port << '!'; + response = server::response::stock_reply(server::response::ok, data.str()); + } + void log(const server::string_type& message) { + std::cerr << "ERROR: " << message << std::endl; } }; -``hello_world`` is a functor class which handles HTTP requests. All -the operator does here is return an HTTP response with HTTP code 200 -and the body ``"Hello, !"``. The ```` in this case would be -the IP address of the client that made the request. +``hello_world`` is a functor class which handles HTTP requests. +All the operator does here is return an HTTP response with HTTP code 200 +and the body ``"Hello, :!"``. The ```` in this case would be +the IP address of the client that made the request and ```` the clients port. There are a number of pre-defined stock replies differentiated by status code with configurable bodies. - All the supported enumeration values for the response status codes can be found in ``boost/network/protocol/http/impl/response.ipp``. .. code-block:: c++ hello_world handler; - server server_(argv[1], argv[2], handler); + server::options options(handler); + server server_(options.address(argv[1]).port(argv[2])); server_.run(); -The first two arguments to the ``server`` constructor are the host and -the port on which the server will listen. The third argument is the -the handler object defined previously. +The ``server`` constructor requires an object of the ``options`` class, +this object stores all needed options, especially the host and +the port on which the server will listen. +The ``options`` constructor's single argument is the handler object defined previously. .. note:: In this example, the server is specifically made to be single-threaded. In a multi-threaded server, you would invoke the ``hello_world::run`` member diff --git a/0.11.2/_sources/examples/http/twitter_search.txt b/0.11.2/_sources/examples/http/twitter_search.txt index 6c0f2b6..4b1945d 100644 --- a/0.11.2/_sources/examples/http/twitter_search.txt +++ b/0.11.2/_sources/examples/http/twitter_search.txt @@ -64,7 +64,7 @@ The code `rapidjson`_, a header-only library that is released under the `MIT License`_. -.. _`rapidjson`: http://code.google.com/p/rapidjson/ +.. _`rapidjson`: https://github.com/miloyip/rapidjson .. _`MIT License`: http://www.opensource.org/licenses/mit-license.php Building and running ``twitter_search`` diff --git a/0.11.2/examples/http/hello_world_server.html b/0.11.2/examples/http/hello_world_server.html index 5f9c5d8..30a1ac9 100644 --- a/0.11.2/examples/http/hello_world_server.html +++ b/0.11.2/examples/http/hello_world_server.html @@ -23,10 +23,7 @@ - - - - + - + -
+
-
+

“Hello world” HTTP server

Now that we’ve seen how we can deal with request and response objects from the client side, we’ll see how we can then use the same abstractions on the server side. In this example we’re going to create a simple HTTP Server in C++ using -cpp-netlib.

+cpp-netlib.

The code

-

The cpp-netlib provides the framework to develop embedded HTTP +

The cpp-netlib provides the framework to develop embedded HTTP servers. For this example, the server is configured to return a simple response to any HTTP request.

#include <boost/network/protocol/http/server.hpp>
-#include <string>
 #include <iostream>
 
 namespace http = boost::network::http;
@@ -76,16 +65,19 @@ 
The codetypedef http::server<hello_world> server;
 
 struct hello_world {
-    void operator() (server::request const &request,
-                     server::response &response) {
-        std::string ip = source(request);
-        response = server::response::stock_reply(
-            server::response::ok, std::string("Hello, ") + ip + "!");
+    void operator()(server::request const &request, server::response &response) {
+        server::string_type ip = source(request);
+        unsigned int port = request.source_port;
+        std::ostringstream data;
+        data << "Hello, " << ip << ':' << port << '!';
+        response = server::response::stock_reply(server::response::ok, data.str());
+    }
+    void log(const server::string_type& message) {
+        std::cerr << "ERROR: " << message << std::endl;
     }
 };
 
-int
-main(int argc, char * argv[]) {
+int main(int argc, char *argv[]) {
 
     if (argc != 3) {
         std::cerr << "Usage: " << argv[0] << " address port" << std::endl;
@@ -94,7 +86,8 @@ 
The codetry {
         hello_world handler;
-        server server_(argv[1], argv[2], handler);
+        server::options options(handler);
+        server server_(options.address(argv[1]).port(argv[2]));
         server_.run();
     }
     catch (std::exception &e) {
@@ -116,7 +109,7 @@ 
Building and running the server$ make hello_world_server
-

The first two arguments to the server constructor are the host and +

The first two arguments to the server constructor are the host and the port on which the server will listen. The third argument is the the handler object defined previously. This example can be run from a command line as follows:

@@ -136,44 +129,50 @@

Diving into the code

This header contains all the code needed to develop an HTTP server with -cpp-netlib.

+cpp-netlib.

struct hello_world;
 typedef http::server<hello_world> server;
 
 struct hello_world {
-    void operator () (server::request const &request,
-                      server::response &response) {
-        std::string ip = source(request);
-        response = server::response::stock_reply(
-            server::response::ok, std::string("Hello, ") + ip + "!");
+    void operator()(server::request const &request, server::response &response) {
+        server::string_type ip = source(request);
+        unsigned int port = request.source_port;
+        std::ostringstream data;
+        data << "Hello, " << ip << ':' << port << '!';
+        response = server::response::stock_reply(server::response::ok, data.str());
+    }
+    void log(const server::string_type& message) {
+        std::cerr << "ERROR: " << message << std::endl;
     }
 };
-

hello_world is a functor class which handles HTTP requests. All -the operator does here is return an HTTP response with HTTP code 200 -and the body "Hello, <ip>!". The <ip> in this case would be -the IP address of the client that made the request.

+

hello_world is a functor class which handles HTTP requests. +All the operator does here is return an HTTP response with HTTP code 200 +and the body "Hello, <ip>:<port>!". The <ip> in this case would be +the IP address of the client that made the request and <port> the clients port.

There are a number of pre-defined stock replies differentiated by -status code with configurable bodies.

-

All the supported enumeration values for the response status codes can be found -in boost/network/protocol/http/impl/response.ipp.

+status code with configurable bodies. +All the supported enumeration values for the response status codes can be found +in boost/network/protocol/http/impl/response.ipp.

hello_world handler;
-server server_(argv[1], argv[2], handler);
+server::options options(handler);
+server server_(options.address(argv[1]).port(argv[2]));
 server_.run();
-

The first two arguments to the server constructor are the host and -the port on which the server will listen. The third argument is the -the handler object defined previously.

+

The server constructor requires an object of the options class, +this object stores all needed options, especially the host and +the port on which the server will listen. +The options constructor’s single argument is the handler object defined previously.

Note

In this example, the server is specifically made to be single-threaded. -In a multi-threaded server, you would invoke the hello_world::run member +In a multi-threaded server, you would invoke the hello_world::run member method in a set of threads. In a multi-threaded environment you would also make sure that the handler does all the necessary synchronization for shared resources across threads. The handler is passed by reference to the server -constructor and you should ensure that any calls to the operator() overload +constructor and you should ensure that any calls to the operator() overload are thread-safe.

@@ -183,7 +182,7 @@

Diving into the code

-
+