Michael Spencer / Mbed 2 deprecated LaOS

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Dependencies:   mbed

NetServices/services/http/server/HTTPServer.h@1:f5ac63519541, 2014-03-05 (annotated)

Committer:
Michael J. Spencer
Date:
Wed Mar 05 06:14:02 2014 -0800
Revision:
1:f5ac63519541
Initial commit.

Who changed what in which revision?

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