Rik Van Dyck / Mbed 2 deprecated Project_Embedded_C

Project_Embedded_C

Dependencies:   mbed DS1307 Servo TextLCD

NetServices/services/http/server/HTTPServer.h@2:55b6fd49b738, 2014-12-18 (annotated)

Committer:
rikvandyck
Date:
Thu Dec 18 10:43:07 2014 +0000
Revision:
2:55b6fd49b738
Parent:
0:e1edd52b1ee2 
Project_Embedded_C

Who changed what in which revision?

UserRevisionLine numberNew contents of line
rikvandyck 0:e1edd52b1ee2 1
rikvandyck 0:e1edd52b1ee2 2 /*
rikvandyck 0:e1edd52b1ee2 3 Copyright (c) 2010 Donatien Garnier (donatiengar [at] gmail [dot] com)
rikvandyck 0:e1edd52b1ee2 4
rikvandyck 0:e1edd52b1ee2 5 Permission is hereby granted, free of charge, to any person obtaining a copy
rikvandyck 0:e1edd52b1ee2 6 of this software and associated documentation files (the "Software"), to deal
rikvandyck 0:e1edd52b1ee2 7 in the Software without restriction, including without limitation the rights
rikvandyck 0:e1edd52b1ee2 8 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
rikvandyck 0:e1edd52b1ee2 9 copies of the Software, and to permit persons to whom the Software is
rikvandyck 0:e1edd52b1ee2 10 furnished to do so, subject to the following conditions:
rikvandyck 0:e1edd52b1ee2 11
rikvandyck 0:e1edd52b1ee2 12 The above copyright notice and this permission notice shall be included in
rikvandyck 0:e1edd52b1ee2 13 all copies or substantial portions of the Software.
rikvandyck 0:e1edd52b1ee2 14
rikvandyck 0:e1edd52b1ee2 15 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
rikvandyck 0:e1edd52b1ee2 16 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
rikvandyck 0:e1edd52b1ee2 17 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
rikvandyck 0:e1edd52b1ee2 18 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
rikvandyck 0:e1edd52b1ee2 19 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
rikvandyck 0:e1edd52b1ee2 20 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
rikvandyck 0:e1edd52b1ee2 21 THE SOFTWARE.
rikvandyck 0:e1edd52b1ee2 22 */
rikvandyck 0:e1edd52b1ee2 23
rikvandyck 0:e1edd52b1ee2 24 /** \file
rikvandyck 0:e1edd52b1ee2 25 HTTP Server header file
rikvandyck 0:e1edd52b1ee2 26 */
rikvandyck 0:e1edd52b1ee2 27
rikvandyck 0:e1edd52b1ee2 28 #ifndef HTTP_SERVER_H
rikvandyck 0:e1edd52b1ee2 29 #define HTTP_SERVER_H
rikvandyck 0:e1edd52b1ee2 30
rikvandyck 0:e1edd52b1ee2 31 class HTTPRequestHandler;
rikvandyck 0:e1edd52b1ee2 32 class HTTPRequestDispatcher;
rikvandyck 0:e1edd52b1ee2 33
rikvandyck 0:e1edd52b1ee2 34 #include "core/net.h"
rikvandyck 0:e1edd52b1ee2 35 #include "HTTPRequestHandler.h"
rikvandyck 0:e1edd52b1ee2 36 #include "HTTPRequestDispatcher.h"
rikvandyck 0:e1edd52b1ee2 37
rikvandyck 0:e1edd52b1ee2 38 #include <string>
rikvandyck 0:e1edd52b1ee2 39 using std::string;
rikvandyck 0:e1edd52b1ee2 40
rikvandyck 0:e1edd52b1ee2 41 #include <map>
rikvandyck 0:e1edd52b1ee2 42 using std::map;
rikvandyck 0:e1edd52b1ee2 43
rikvandyck 0:e1edd52b1ee2 44 ///A simple HTTP server implementation
rikvandyck 0:e1edd52b1ee2 45 /**
rikvandyck 0:e1edd52b1ee2 46 The HTTPServer is composed of:
rikvandyck 0:e1edd52b1ee2 47 - The actual server (HTTPServer)
rikvandyck 0:e1edd52b1ee2 48 - A request dispatcher, instanciated on each request (HTTPRequestDispatcher)
rikvandyck 0:e1edd52b1ee2 49 - Request handlers instanciated by the dispatcher(deriving from HTTPRequestHandler)
rikvandyck 0:e1edd52b1ee2 50 */
rikvandyck 0:e1edd52b1ee2 51 class HTTPServer
rikvandyck 0:e1edd52b1ee2 52 {
rikvandyck 0:e1edd52b1ee2 53 public:
rikvandyck 0:e1edd52b1ee2 54 ///Instantiates the HTTP Server
rikvandyck 0:e1edd52b1ee2 55 HTTPServer();
rikvandyck 0:e1edd52b1ee2 56 ~HTTPServer();
rikvandyck 0:e1edd52b1ee2 57
rikvandyck 0:e1edd52b1ee2 58 struct handlersComp //Used to order handlers in the right way
rikvandyck 0:e1edd52b1ee2 59 {
rikvandyck 0:e1edd52b1ee2 60 bool operator() (const string& handler1, const string& handler2) const
rikvandyck 0:e1edd52b1ee2 61 {
rikvandyck 0:e1edd52b1ee2 62 //The first handler is longer than the second one
rikvandyck 0:e1edd52b1ee2 63 if (handler1.length() > handler2.length())
rikvandyck 0:e1edd52b1ee2 64 return true; //Returns true if handler1 is to appear before handler2
rikvandyck 0:e1edd52b1ee2 65 else if (handler1.length() < handler2.length())
rikvandyck 0:e1edd52b1ee2 66 return false;
rikvandyck 0:e1edd52b1ee2 67 else //To avoid the == case, sort now by address
rikvandyck 0:e1edd52b1ee2 68 return ((&handler1)>(&handler2));
rikvandyck 0:e1edd52b1ee2 69 }
rikvandyck 0:e1edd52b1ee2 70 };
rikvandyck 0:e1edd52b1ee2 71
rikvandyck 0:e1edd52b1ee2 72 ///Adds a handler
rikvandyck 0:e1edd52b1ee2 73 /**
rikvandyck 0:e1edd52b1ee2 74 Appends a handler to the handlers list
rikvandyck 0:e1edd52b1ee2 75 @param T : class which will be instanciated to serve these requests
rikvandyck 0:e1edd52b1ee2 76 @param path : requests starting with this path will be served using this handler
rikvandyck 0:e1edd52b1ee2 77 */
rikvandyck 0:e1edd52b1ee2 78 template<typename T>
rikvandyck 0:e1edd52b1ee2 79 void addHandler(const char* path) //Template decl in header
rikvandyck 0:e1edd52b1ee2 80 { m_lpHandlers[path] = &T::inst; }
rikvandyck 0:e1edd52b1ee2 81
rikvandyck 0:e1edd52b1ee2 82 ///Starts listening
rikvandyck 0:e1edd52b1ee2 83 /**
rikvandyck 0:e1edd52b1ee2 84 Binds server to a specific port and starts listening
rikvandyck 0:e1edd52b1ee2 85 @param port : port on which to listen for incoming connections
rikvandyck 0:e1edd52b1ee2 86 */
rikvandyck 0:e1edd52b1ee2 87 void bind(int port = 80);
rikvandyck 0:e1edd52b1ee2 88
rikvandyck 0:e1edd52b1ee2 89 private:
rikvandyck 0:e1edd52b1ee2 90 friend class HTTPRequestDispatcher;
rikvandyck 0:e1edd52b1ee2 91
rikvandyck 0:e1edd52b1ee2 92 void onTCPSocketEvent(TCPSocketEvent e);
rikvandyck 0:e1edd52b1ee2 93
rikvandyck 0:e1edd52b1ee2 94 TCPSocket* m_pTCPSocket;
rikvandyck 0:e1edd52b1ee2 95 map< string, HTTPRequestHandler*(*)(const char*, const char*, TCPSocket*), handlersComp > m_lpHandlers;
rikvandyck 0:e1edd52b1ee2 96
rikvandyck 0:e1edd52b1ee2 97 };
rikvandyck 0:e1edd52b1ee2 98
rikvandyck 0:e1edd52b1ee2 99 //Including handlers here for more convenience
rikvandyck 0:e1edd52b1ee2 100 #include "impl/RPCHandler.h"
rikvandyck 0:e1edd52b1ee2 101 #include "impl/FSHandler.h"
rikvandyck 0:e1edd52b1ee2 102 #include "impl/SimpleHandler.h"
rikvandyck 0:e1edd52b1ee2 103
rikvandyck 0:e1edd52b1ee2 104 #endif