LRSD stephane
/
WEBserverv4
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.
lwip/HTTPServer/HTTPServer.h@0:3c32eeb9292a, 2011-09-22 (annotated)
- Committer:
- geiineuville
- Date:
- Thu Sep 22 15:59:17 2011 +0000
- Revision:
- 0:3c32eeb9292a
V4
Who changed what in which revision?
| User | Revision | Line number | New contents of line |
|---|---|---|---|
| geiineuville | 0:3c32eeb9292a | 1 | #ifndef HTTPSERVER_H |
| geiineuville | 0:3c32eeb9292a | 2 | #define HTTPSERVER_H |
| geiineuville | 0:3c32eeb9292a | 3 | |
| geiineuville | 0:3c32eeb9292a | 4 | #include "TCPConnection.h" |
| geiineuville | 0:3c32eeb9292a | 5 | #include "TCPListener.h" |
| geiineuville | 0:3c32eeb9292a | 6 | #include "NetServer.h" |
| geiineuville | 0:3c32eeb9292a | 7 | |
| geiineuville | 0:3c32eeb9292a | 8 | #include <map> |
| geiineuville | 0:3c32eeb9292a | 9 | #include <set> |
| geiineuville | 0:3c32eeb9292a | 10 | #include <list> |
| geiineuville | 0:3c32eeb9292a | 11 | |
| geiineuville | 0:3c32eeb9292a | 12 | #define HTTP_MAX_EMPTYPOLLS 100 |
| geiineuville | 0:3c32eeb9292a | 13 | #define GET 4 |
| geiineuville | 0:3c32eeb9292a | 14 | #define POST 5 |
| geiineuville | 0:3c32eeb9292a | 15 | |
| geiineuville | 0:3c32eeb9292a | 16 | //extern unsigned int gconnections; |
| geiineuville | 0:3c32eeb9292a | 17 | |
| geiineuville | 0:3c32eeb9292a | 18 | using namespace std; |
| geiineuville | 0:3c32eeb9292a | 19 | |
| geiineuville | 0:3c32eeb9292a | 20 | namespace mbed { |
| geiineuville | 0:3c32eeb9292a | 21 | |
| geiineuville | 0:3c32eeb9292a | 22 | class HTTPServer; |
| geiineuville | 0:3c32eeb9292a | 23 | class HTTPHandler; |
| geiineuville | 0:3c32eeb9292a | 24 | class HTTPConnection; |
| geiineuville | 0:3c32eeb9292a | 25 | |
| geiineuville | 0:3c32eeb9292a | 26 | /** |
| geiineuville | 0:3c32eeb9292a | 27 | * A simple HASH function to reduce the size of stored Header Fields |
| geiineuville | 0:3c32eeb9292a | 28 | * TODO: Make the Hash case insensetive. |
| geiineuville | 0:3c32eeb9292a | 29 | */ |
| geiineuville | 0:3c32eeb9292a | 30 | unsigned int hash(unsigned char *str); |
| geiineuville | 0:3c32eeb9292a | 31 | |
| geiineuville | 0:3c32eeb9292a | 32 | /** |
| geiineuville | 0:3c32eeb9292a | 33 | * The Status of an HTTP Request |
| geiineuville | 0:3c32eeb9292a | 34 | * Nedded for HTTPHandler subclasses to define there reults in the HTTPHandler:init Method. |
| geiineuville | 0:3c32eeb9292a | 35 | */ |
| geiineuville | 0:3c32eeb9292a | 36 | enum HTTPStatus { |
| geiineuville | 0:3c32eeb9292a | 37 | HTTP_OK = 200, |
| geiineuville | 0:3c32eeb9292a | 38 | HTTP_BadRequest = 400, |
| geiineuville | 0:3c32eeb9292a | 39 | HTTP_Unauthorized = 401, |
| geiineuville | 0:3c32eeb9292a | 40 | HTTP_Forbidden = 403, |
| geiineuville | 0:3c32eeb9292a | 41 | HTTP_NotFound = 404, |
| geiineuville | 0:3c32eeb9292a | 42 | HTTP_MethodNotAllowed = 405, |
| geiineuville | 0:3c32eeb9292a | 43 | HTTP_InternalServerError = 500, |
| geiineuville | 0:3c32eeb9292a | 44 | HTTP_NotImplemented = 501, |
| geiineuville | 0:3c32eeb9292a | 45 | }; |
| geiineuville | 0:3c32eeb9292a | 46 | |
| geiineuville | 0:3c32eeb9292a | 47 | /** |
| geiineuville | 0:3c32eeb9292a | 48 | * The result of a chunk of data used for the HTTPHandler Methodes data and send |
| geiineuville | 0:3c32eeb9292a | 49 | */ |
| geiineuville | 0:3c32eeb9292a | 50 | enum HTTPHandle { |
| geiineuville | 0:3c32eeb9292a | 51 | /** Execution Succeeded but more data expected. */ |
| geiineuville | 0:3c32eeb9292a | 52 | HTTP_Success = 600, |
| geiineuville | 0:3c32eeb9292a | 53 | |
| geiineuville | 0:3c32eeb9292a | 54 | /** Running out of memory waiting for memory */ |
| geiineuville | 0:3c32eeb9292a | 55 | HTTP_SenderMemory = 601, |
| geiineuville | 0:3c32eeb9292a | 56 | |
| geiineuville | 0:3c32eeb9292a | 57 | |
| geiineuville | 0:3c32eeb9292a | 58 | /** Execution Succeeded and no more data expected. */ |
| geiineuville | 0:3c32eeb9292a | 59 | HTTP_SuccessEnded = 700, |
| geiineuville | 0:3c32eeb9292a | 60 | |
| geiineuville | 0:3c32eeb9292a | 61 | /** Execution failed. Close conection*/ |
| geiineuville | 0:3c32eeb9292a | 62 | HTTP_Failed = 701, |
| geiineuville | 0:3c32eeb9292a | 63 | |
| geiineuville | 0:3c32eeb9292a | 64 | /** This module will deliver the data. */ |
| geiineuville | 0:3c32eeb9292a | 65 | HTTP_Deliver = 800, |
| geiineuville | 0:3c32eeb9292a | 66 | |
| geiineuville | 0:3c32eeb9292a | 67 | /** This module has add header fields to the request. */ |
| geiineuville | 0:3c32eeb9292a | 68 | HTTP_AddFields = 801, |
| geiineuville | 0:3c32eeb9292a | 69 | }; |
| geiineuville | 0:3c32eeb9292a | 70 | |
| geiineuville | 0:3c32eeb9292a | 71 | /** |
| geiineuville | 0:3c32eeb9292a | 72 | * A parent object for a data storage container for all HTTPHandler objects. |
| geiineuville | 0:3c32eeb9292a | 73 | */ |
| geiineuville | 0:3c32eeb9292a | 74 | class HTTPData { |
| geiineuville | 0:3c32eeb9292a | 75 | public: |
| geiineuville | 0:3c32eeb9292a | 76 | HTTPData() {} |
| geiineuville | 0:3c32eeb9292a | 77 | virtual ~HTTPData() {} |
| geiineuville | 0:3c32eeb9292a | 78 | }; |
| geiineuville | 0:3c32eeb9292a | 79 | |
| geiineuville | 0:3c32eeb9292a | 80 | /** |
| geiineuville | 0:3c32eeb9292a | 81 | * A HTTPHandler will serve the requested data if there is an object of a |
| geiineuville | 0:3c32eeb9292a | 82 | * child class from HTTPHandler which is registert to an matching prefix. |
| geiineuville | 0:3c32eeb9292a | 83 | * To see how to implement your own HTTPHandler classes have a look at |
| geiineuville | 0:3c32eeb9292a | 84 | * HTTPRPC HTTPStaticPage and HTTPFileSystemHandler. |
| geiineuville | 0:3c32eeb9292a | 85 | */ |
| geiineuville | 0:3c32eeb9292a | 86 | class HTTPHandler { |
| geiineuville | 0:3c32eeb9292a | 87 | public: |
| geiineuville | 0:3c32eeb9292a | 88 | HTTPHandler(const char *prefix) : _prefix(prefix) {}; |
| geiineuville | 0:3c32eeb9292a | 89 | virtual ~HTTPHandler() { |
| geiineuville | 0:3c32eeb9292a | 90 | delete _prefix; |
| geiineuville | 0:3c32eeb9292a | 91 | }; |
| geiineuville | 0:3c32eeb9292a | 92 | |
| geiineuville | 0:3c32eeb9292a | 93 | protected: |
| geiineuville | 0:3c32eeb9292a | 94 | /** |
| geiineuville | 0:3c32eeb9292a | 95 | * Register needed header fields by the HTTPServer. |
| geiineuville | 0:3c32eeb9292a | 96 | * Because of memory size the server will throw away all request header fields which are not registert. |
| geiineuville | 0:3c32eeb9292a | 97 | * Register the fields you need in your implementation of this method. |
| geiineuville | 0:3c32eeb9292a | 98 | */ |
| geiineuville | 0:3c32eeb9292a | 99 | virtual void reg(HTTPServer *) {}; |
| geiineuville | 0:3c32eeb9292a | 100 | |
| geiineuville | 0:3c32eeb9292a | 101 | /** |
| geiineuville | 0:3c32eeb9292a | 102 | * This Method returns if you will deliver the requested page or not. |
| geiineuville | 0:3c32eeb9292a | 103 | * It will only executed if the prefix is matched by the URL. |
| geiineuville | 0:3c32eeb9292a | 104 | * If you want to add something to the headerfiles use this method and return HTTP_AddFields. See HTTPFields |
| geiineuville | 0:3c32eeb9292a | 105 | * This would be the right method to implement an Auth Handler. |
| geiineuville | 0:3c32eeb9292a | 106 | */ |
| geiineuville | 0:3c32eeb9292a | 107 | virtual HTTPHandle action(HTTPConnection *) const {return HTTP_Deliver;} |
| geiineuville | 0:3c32eeb9292a | 108 | |
| geiineuville | 0:3c32eeb9292a | 109 | /** |
| geiineuville | 0:3c32eeb9292a | 110 | * If action returned HTTP_Deliver. |
| geiineuville | 0:3c32eeb9292a | 111 | * This function will be executed and it means your handler will be deliver the requested data. |
| geiineuville | 0:3c32eeb9292a | 112 | * In this method is the right place to allocate the needed space for your request data and to prepare the sended Header. |
| geiineuville | 0:3c32eeb9292a | 113 | */ |
| geiineuville | 0:3c32eeb9292a | 114 | virtual HTTPStatus init(HTTPConnection *) const {return HTTP_NotFound;} |
| geiineuville | 0:3c32eeb9292a | 115 | |
| geiineuville | 0:3c32eeb9292a | 116 | /** |
| geiineuville | 0:3c32eeb9292a | 117 | * If data from a post request is arrived for an request you accepted this function will be executed with the data. |
| geiineuville | 0:3c32eeb9292a | 118 | * @param data A pointer to the received data. |
| geiineuville | 0:3c32eeb9292a | 119 | * @param len The length of the received data. |
| geiineuville | 0:3c32eeb9292a | 120 | * @return Return an HTTPHandle. For example HTTP_SuccessEnded if you received all your needed data and want to close the conection (normally not the case). |
| geiineuville | 0:3c32eeb9292a | 121 | */ |
| geiineuville | 0:3c32eeb9292a | 122 | virtual HTTPHandle data(HTTPConnection *, void *data, int len) const {return HTTP_SuccessEnded;} |
| geiineuville | 0:3c32eeb9292a | 123 | |
| geiineuville | 0:3c32eeb9292a | 124 | /** |
| geiineuville | 0:3c32eeb9292a | 125 | * If tere is new space in the sendbuffer this function is executed. You can send maximal Bytes of data. |
| geiineuville | 0:3c32eeb9292a | 126 | * @return Return an HTTPHandle. For example HTTP_SuccessEnded if you send out all your data and you want to close the connection. |
| geiineuville | 0:3c32eeb9292a | 127 | */ |
| geiineuville | 0:3c32eeb9292a | 128 | virtual HTTPHandle send(HTTPConnection *, int) const {return HTTP_SuccessEnded;} |
| geiineuville | 0:3c32eeb9292a | 129 | |
| geiineuville | 0:3c32eeb9292a | 130 | /** |
| geiineuville | 0:3c32eeb9292a | 131 | * returns the Prefix from the HTTPHandler |
| geiineuville | 0:3c32eeb9292a | 132 | */ |
| geiineuville | 0:3c32eeb9292a | 133 | const char *getPrefix() const {return _prefix;} |
| geiineuville | 0:3c32eeb9292a | 134 | |
| geiineuville | 0:3c32eeb9292a | 135 | const char *_prefix; |
| geiineuville | 0:3c32eeb9292a | 136 | |
| geiineuville | 0:3c32eeb9292a | 137 | friend HTTPServer; |
| geiineuville | 0:3c32eeb9292a | 138 | friend HTTPConnection; |
| geiineuville | 0:3c32eeb9292a | 139 | }; |
| geiineuville | 0:3c32eeb9292a | 140 | |
| geiineuville | 0:3c32eeb9292a | 141 | /** |
| geiineuville | 0:3c32eeb9292a | 142 | * For every incomming connection we have a HTTPConnection object which will handle the requests of this connection. |
| geiineuville | 0:3c32eeb9292a | 143 | */ |
| geiineuville | 0:3c32eeb9292a | 144 | class HTTPConnection : public TCPConnection { |
| geiineuville | 0:3c32eeb9292a | 145 | public: |
| geiineuville | 0:3c32eeb9292a | 146 | /** |
| geiineuville | 0:3c32eeb9292a | 147 | * Constructs a new connection object from a server. |
| geiineuville | 0:3c32eeb9292a | 148 | * It just need the server object to contact the handlers |
| geiineuville | 0:3c32eeb9292a | 149 | * and the tcp connection pcb. |
| geiineuville | 0:3c32eeb9292a | 150 | * @param parent The server which created the connection. |
| geiineuville | 0:3c32eeb9292a | 151 | * @param pcb The pcb object NetServers internal representation of an TCP Connection |
| geiineuville | 0:3c32eeb9292a | 152 | */ |
| geiineuville | 0:3c32eeb9292a | 153 | HTTPConnection(HTTPServer *parent, struct tcp_pcb *pcb); |
| geiineuville | 0:3c32eeb9292a | 154 | /** |
| geiineuville | 0:3c32eeb9292a | 155 | * Default destructor. Simple cleanup. |
| geiineuville | 0:3c32eeb9292a | 156 | */ |
| geiineuville | 0:3c32eeb9292a | 157 | virtual ~HTTPConnection(); |
| geiineuville | 0:3c32eeb9292a | 158 | |
| geiineuville | 0:3c32eeb9292a | 159 | /** |
| geiineuville | 0:3c32eeb9292a | 160 | * Get the requested url. |
| geiineuville | 0:3c32eeb9292a | 161 | * Only set if a request ist received. |
| geiineuville | 0:3c32eeb9292a | 162 | */ |
| geiineuville | 0:3c32eeb9292a | 163 | char *getURL() const { return _request_url; } |
| geiineuville | 0:3c32eeb9292a | 164 | |
| geiineuville | 0:3c32eeb9292a | 165 | /** |
| geiineuville | 0:3c32eeb9292a | 166 | * Gets a string of set fields to send with the answere header. |
| geiineuville | 0:3c32eeb9292a | 167 | */ |
| geiineuville | 0:3c32eeb9292a | 168 | const char *getHeaderFields() const { return (_request_headerfields)?_request_headerfields:""; } |
| geiineuville | 0:3c32eeb9292a | 169 | |
| geiineuville | 0:3c32eeb9292a | 170 | /** |
| geiineuville | 0:3c32eeb9292a | 171 | * Gets the length of the anwere in bytes. This is requiered for the HTTP Header. |
| geiineuville | 0:3c32eeb9292a | 172 | * It should be set over setLength by an HTTPHandler in the init() method. |
| geiineuville | 0:3c32eeb9292a | 173 | */ |
| geiineuville | 0:3c32eeb9292a | 174 | const int &getLength() const { return _request_length; } |
| geiineuville | 0:3c32eeb9292a | 175 | |
| geiineuville | 0:3c32eeb9292a | 176 | /** |
| geiineuville | 0:3c32eeb9292a | 177 | * Gets POST or GET or 0 depends on wether ther is a request and what type is requested. |
| geiineuville | 0:3c32eeb9292a | 178 | */ |
| geiineuville | 0:3c32eeb9292a | 179 | const char &getType() const { return _request_type; } |
| geiineuville | 0:3c32eeb9292a | 180 | |
| geiineuville | 0:3c32eeb9292a | 181 | /** |
| geiineuville | 0:3c32eeb9292a | 182 | * Gets a value from a header field of the request header. |
| geiineuville | 0:3c32eeb9292a | 183 | * But you must have registerd this headerfield by the HTTPServer before. |
| geiineuville | 0:3c32eeb9292a | 184 | * Use the HTTPHandler::reg() method for the registration of important header fields for your Handler. |
| geiineuville | 0:3c32eeb9292a | 185 | */ |
| geiineuville | 0:3c32eeb9292a | 186 | const char *getField(char *key) const; |
| geiineuville | 0:3c32eeb9292a | 187 | |
| geiineuville | 0:3c32eeb9292a | 188 | /** |
| geiineuville | 0:3c32eeb9292a | 189 | * For internal usage. Adds an header field value to its hash. |
| geiineuville | 0:3c32eeb9292a | 190 | * If it was registered You can see the Value with the getField method |
| geiineuville | 0:3c32eeb9292a | 191 | */ |
| geiineuville | 0:3c32eeb9292a | 192 | void addField(char *key, char *value); |
| geiineuville | 0:3c32eeb9292a | 193 | |
| geiineuville | 0:3c32eeb9292a | 194 | /** |
| geiineuville | 0:3c32eeb9292a | 195 | * Sets the result length for an request shoud be set in an HTTPHandler.init() call. |
| geiineuville | 0:3c32eeb9292a | 196 | * This Value will be send with the response header before the first chunk of data is send. |
| geiineuville | 0:3c32eeb9292a | 197 | */ |
| geiineuville | 0:3c32eeb9292a | 198 | void setLength(const int &value) { _request_length = value; } |
| geiineuville | 0:3c32eeb9292a | 199 | |
| geiineuville | 0:3c32eeb9292a | 200 | /** |
| geiineuville | 0:3c32eeb9292a | 201 | * Set the response header field to a value. |
| geiineuville | 0:3c32eeb9292a | 202 | * Should be used in the HTTPHandler::init() method. |
| geiineuville | 0:3c32eeb9292a | 203 | * For example if you want to set caching methods. |
| geiineuville | 0:3c32eeb9292a | 204 | */ |
| geiineuville | 0:3c32eeb9292a | 205 | void setHeaderFields(char *value) { _request_headerfields = value; } |
| geiineuville | 0:3c32eeb9292a | 206 | |
| geiineuville | 0:3c32eeb9292a | 207 | /** Indicates that if a request is received the header is incomplete until now. */ |
| geiineuville | 0:3c32eeb9292a | 208 | bool request_incomplete; |
| geiineuville | 0:3c32eeb9292a | 209 | |
| geiineuville | 0:3c32eeb9292a | 210 | /** If an request is complete HTTPHandler:init will be called and can store here its connection data. */ |
| geiineuville | 0:3c32eeb9292a | 211 | HTTPData *data; |
| geiineuville | 0:3c32eeb9292a | 212 | |
| geiineuville | 0:3c32eeb9292a | 213 | /** The handler which handles the current request. Depends on the prefix of the URL. */ |
| geiineuville | 0:3c32eeb9292a | 214 | HTTPHandler *request_handler; |
| geiineuville | 0:3c32eeb9292a | 215 | |
| geiineuville | 0:3c32eeb9292a | 216 | /** The status of the request. Will be set as result of HTTPHandler::init. */ |
| geiineuville | 0:3c32eeb9292a | 217 | HTTPStatus request_status; |
| geiineuville | 0:3c32eeb9292a | 218 | |
| geiineuville | 0:3c32eeb9292a | 219 | /** The HTTTPServer which created this connection. */ |
| geiineuville | 0:3c32eeb9292a | 220 | HTTPServer *parent; |
| geiineuville | 0:3c32eeb9292a | 221 | private: |
| geiineuville | 0:3c32eeb9292a | 222 | virtual void err(err_t err); |
| geiineuville | 0:3c32eeb9292a | 223 | virtual err_t poll(); |
| geiineuville | 0:3c32eeb9292a | 224 | virtual err_t sent(u16_t len); |
| geiineuville | 0:3c32eeb9292a | 225 | virtual err_t recv(struct pbuf *q, err_t err); |
| geiineuville | 0:3c32eeb9292a | 226 | |
| geiineuville | 0:3c32eeb9292a | 227 | /** We will not make any DNS requests. */ |
| geiineuville | 0:3c32eeb9292a | 228 | virtual void dnsreply(const char *, struct ip_addr *) {} |
| geiineuville | 0:3c32eeb9292a | 229 | |
| geiineuville | 0:3c32eeb9292a | 230 | /** If a request is finished it will be deleted with this method. Simple cleanup. */ |
| geiineuville | 0:3c32eeb9292a | 231 | void deleteRequest(); |
| geiineuville | 0:3c32eeb9292a | 232 | |
| geiineuville | 0:3c32eeb9292a | 233 | /** Call the handler to send the next chunk of data. */ |
| geiineuville | 0:3c32eeb9292a | 234 | void send(); |
| geiineuville | 0:3c32eeb9292a | 235 | |
| geiineuville | 0:3c32eeb9292a | 236 | /** Call the handler if we received new data. */ |
| geiineuville | 0:3c32eeb9292a | 237 | void store(void *d, struct pbuf *p); |
| geiineuville | 0:3c32eeb9292a | 238 | |
| geiineuville | 0:3c32eeb9292a | 239 | /** |
| geiineuville | 0:3c32eeb9292a | 240 | * If a request header is not complete we can colect needed header fields. |
| geiineuville | 0:3c32eeb9292a | 241 | * This happens in here. |
| geiineuville | 0:3c32eeb9292a | 242 | */ |
| geiineuville | 0:3c32eeb9292a | 243 | void getFields(struct pbuf **q, char **d); |
| geiineuville | 0:3c32eeb9292a | 244 | |
| geiineuville | 0:3c32eeb9292a | 245 | char *_request_url; |
| geiineuville | 0:3c32eeb9292a | 246 | char _request_type; |
| geiineuville | 0:3c32eeb9292a | 247 | char *_request_headerfields; |
| geiineuville | 0:3c32eeb9292a | 248 | map<unsigned int, char *> _request_fields; |
| geiineuville | 0:3c32eeb9292a | 249 | int _request_length; |
| geiineuville | 0:3c32eeb9292a | 250 | char *_request_arg_key; |
| geiineuville | 0:3c32eeb9292a | 251 | char *_request_arg_value; |
| geiineuville | 0:3c32eeb9292a | 252 | char _request_arg_state; |
| geiineuville | 0:3c32eeb9292a | 253 | |
| geiineuville | 0:3c32eeb9292a | 254 | unsigned int emptypolls; // Last time for timeout |
| geiineuville | 0:3c32eeb9292a | 255 | unsigned int _timeout_max; |
| geiineuville | 0:3c32eeb9292a | 256 | }; |
| geiineuville | 0:3c32eeb9292a | 257 | |
| geiineuville | 0:3c32eeb9292a | 258 | /* Class HTTPServer |
| geiineuville | 0:3c32eeb9292a | 259 | * An object of this class is an HTTPServer instance and will anwere requests on a given port. |
| geiineuville | 0:3c32eeb9292a | 260 | * It will deliver HTTP pages |
| geiineuville | 0:3c32eeb9292a | 261 | */ |
| geiineuville | 0:3c32eeb9292a | 262 | class HTTPServer : public TCPListener { |
| geiineuville | 0:3c32eeb9292a | 263 | public: |
| geiineuville | 0:3c32eeb9292a | 264 | |
| geiineuville | 0:3c32eeb9292a | 265 | /* Constructor: HTTPServer |
| geiineuville | 0:3c32eeb9292a | 266 | * Creates an HTTPServer object. You might want to initialise the network server befor. |
| geiineuville | 0:3c32eeb9292a | 267 | * If you dont do it it will be happen by the first post or get request you make. |
| geiineuville | 0:3c32eeb9292a | 268 | * |
| geiineuville | 0:3c32eeb9292a | 269 | * To initialize the network server on creation of the HTTPServer object it's possible to parse some arguments: |
| geiineuville | 0:3c32eeb9292a | 270 | * Variables: |
| geiineuville | 0:3c32eeb9292a | 271 | * hostname - A host name for the device. Might take a while to appear in the network, |
| geiineuville | 0:3c32eeb9292a | 272 | * depends on the network infrastructure. Furthermore in most cases you have |
| geiineuville | 0:3c32eeb9292a | 273 | * to add your domainname after the host name to address the device. |
| geiineuville | 0:3c32eeb9292a | 274 | * Default is NULL. |
| geiineuville | 0:3c32eeb9292a | 275 | * ip - The device ipaddress or ip_addr_any for dhcp. Default is ip_addr_any |
| geiineuville | 0:3c32eeb9292a | 276 | * nm - The device netmask or ip_addr_any for dhcp. Default is ip_addr_any. |
| geiineuville | 0:3c32eeb9292a | 277 | * gw - The device gateway or ip_addr_any for dhcp. Default is ip_addr_any. |
| geiineuville | 0:3c32eeb9292a | 278 | * dns - The device first dns server ip or ip_addr_any for dhcp. Default is ip_addr_any. |
| geiineuville | 0:3c32eeb9292a | 279 | * |
| geiineuville | 0:3c32eeb9292a | 280 | * Example: |
| geiineuville | 0:3c32eeb9292a | 281 | * > HTTPServer http; // Simple DHCP, brings up the TCP/IP stack on bind(). Default prot is port 80. |
| geiineuville | 0:3c32eeb9292a | 282 | * > HTTPServer http(8080); // Port is here 8080. |
| geiineuville | 0:3c32eeb9292a | 283 | * |
| geiineuville | 0:3c32eeb9292a | 284 | * > HTTPServer http("worf"); // Brings up the device with DHCP and sets the host name "worf" |
| geiineuville | 0:3c32eeb9292a | 285 | * > // The device will be available under worf.<your local domain> |
| geiineuville | 0:3c32eeb9292a | 286 | * > // for example worf.1-2-3-4.dynamic.sky.com |
| geiineuville | 0:3c32eeb9292a | 287 | * |
| geiineuville | 0:3c32eeb9292a | 288 | * > HTTPServer http("wolf", // Brings up the device with static IP address and domain name. |
| geiineuville | 0:3c32eeb9292a | 289 | * > IPv4(192,168,0,44), // IPv4 is a helper function which allows to rtype ipaddresses direct |
| geiineuville | 0:3c32eeb9292a | 290 | * > IPv4(255,255,255,0), // as numbers in C++. |
| geiineuville | 0:3c32eeb9292a | 291 | * > IPv4(192,168,0,1), // the device address is set to 192.168.0.44, netmask 255.255.255.0 |
| geiineuville | 0:3c32eeb9292a | 292 | * > IPv4(192,168,0,1) // default gateway is 192.168.0.1 and dns to 192.168.0.1 as well. |
| geiineuville | 0:3c32eeb9292a | 293 | * > 8080); // And port is on 8080. Default port is 80. |
| geiineuville | 0:3c32eeb9292a | 294 | */ |
| geiineuville | 0:3c32eeb9292a | 295 | |
| geiineuville | 0:3c32eeb9292a | 296 | HTTPServer(const char *hostname, struct ip_addr ip = ip_addr_any, struct ip_addr nm = ip_addr_any, struct ip_addr gw = ip_addr_any, struct ip_addr dns = ip_addr_any, unsigned short port = 80); |
| geiineuville | 0:3c32eeb9292a | 297 | HTTPServer(unsigned short port = 80); |
| geiineuville | 0:3c32eeb9292a | 298 | |
| geiineuville | 0:3c32eeb9292a | 299 | /* Destructor: ~HTTPServer |
| geiineuville | 0:3c32eeb9292a | 300 | * Destroys the HTTPServer and all open connections. |
| geiineuville | 0:3c32eeb9292a | 301 | */ |
| geiineuville | 0:3c32eeb9292a | 302 | virtual ~HTTPServer() { |
| geiineuville | 0:3c32eeb9292a | 303 | fields.clear(); |
| geiineuville | 0:3c32eeb9292a | 304 | _handler.clear(); |
| geiineuville | 0:3c32eeb9292a | 305 | } |
| geiineuville | 0:3c32eeb9292a | 306 | |
| geiineuville | 0:3c32eeb9292a | 307 | /* Function: addHandler |
| geiineuville | 0:3c32eeb9292a | 308 | * Add a new content handler to handle requests. |
| geiineuville | 0:3c32eeb9292a | 309 | * Content handler are URL prefix specific. |
| geiineuville | 0:3c32eeb9292a | 310 | * Have a look at HTTPRPC and HTTPFileSystemHandler for examples. |
| geiineuville | 0:3c32eeb9292a | 311 | */ |
| geiineuville | 0:3c32eeb9292a | 312 | virtual void addHandler(HTTPHandler *handler) { |
| geiineuville | 0:3c32eeb9292a | 313 | _handler.push_back(handler); |
| geiineuville | 0:3c32eeb9292a | 314 | handler->reg(this); |
| geiineuville | 0:3c32eeb9292a | 315 | } |
| geiineuville | 0:3c32eeb9292a | 316 | |
| geiineuville | 0:3c32eeb9292a | 317 | /* Function registerField |
| geiineuville | 0:3c32eeb9292a | 318 | * Register needed header fields to filter from a request header. |
| geiineuville | 0:3c32eeb9292a | 319 | * Should be called from HTTPHandler::reg() |
| geiineuville | 0:3c32eeb9292a | 320 | */ |
| geiineuville | 0:3c32eeb9292a | 321 | virtual void registerField(char *name) { |
| geiineuville | 0:3c32eeb9292a | 322 | fields.insert(hash((unsigned char *)name)); |
| geiineuville | 0:3c32eeb9292a | 323 | } |
| geiineuville | 0:3c32eeb9292a | 324 | |
| geiineuville | 0:3c32eeb9292a | 325 | /* Function isField |
| geiineuville | 0:3c32eeb9292a | 326 | * A short lookup if the headerfield is registerd. |
| geiineuville | 0:3c32eeb9292a | 327 | */ |
| geiineuville | 0:3c32eeb9292a | 328 | virtual bool isField(unsigned long h) const { |
| geiineuville | 0:3c32eeb9292a | 329 | return fields.find(h) != fields.end(); |
| geiineuville | 0:3c32eeb9292a | 330 | } |
| geiineuville | 0:3c32eeb9292a | 331 | |
| geiineuville | 0:3c32eeb9292a | 332 | /* Function: poll |
| geiineuville | 0:3c32eeb9292a | 333 | * You have to call this method at least every 250ms to let the http server run. |
| geiineuville | 0:3c32eeb9292a | 334 | * But I would recomend to call this function as fast as possible. |
| geiineuville | 0:3c32eeb9292a | 335 | * This function is directly coupled to the answere time of your HTTPServer instance. |
| geiineuville | 0:3c32eeb9292a | 336 | */ |
| geiineuville | 0:3c32eeb9292a | 337 | inline static void poll() { |
| geiineuville | 0:3c32eeb9292a | 338 | NetServer::poll(); |
| geiineuville | 0:3c32eeb9292a | 339 | } |
| geiineuville | 0:3c32eeb9292a | 340 | |
| geiineuville | 0:3c32eeb9292a | 341 | /* Function: timeout |
| geiineuville | 0:3c32eeb9292a | 342 | * Sets the timout for a HTTP request. |
| geiineuville | 0:3c32eeb9292a | 343 | * The timout is the time wich is allowed to spent between two incomming TCP packets. |
| geiineuville | 0:3c32eeb9292a | 344 | * If the time is passed the connection will be closed. |
| geiineuville | 0:3c32eeb9292a | 345 | */ |
| geiineuville | 0:3c32eeb9292a | 346 | void timeout(int value) { |
| geiineuville | 0:3c32eeb9292a | 347 | _timeout_max = value; |
| geiineuville | 0:3c32eeb9292a | 348 | } |
| geiineuville | 0:3c32eeb9292a | 349 | |
| geiineuville | 0:3c32eeb9292a | 350 | /* Function timeout |
| geiineuville | 0:3c32eeb9292a | 351 | * Returns the timout to use it in HTTPHandlers and HTTPConnections |
| geiineuville | 0:3c32eeb9292a | 352 | */ |
| geiineuville | 0:3c32eeb9292a | 353 | int timeout() { |
| geiineuville | 0:3c32eeb9292a | 354 | return _timeout_max; |
| geiineuville | 0:3c32eeb9292a | 355 | } |
| geiineuville | 0:3c32eeb9292a | 356 | private: |
| geiineuville | 0:3c32eeb9292a | 357 | /** |
| geiineuville | 0:3c32eeb9292a | 358 | * Pick up the right handler to deliver the response. |
| geiineuville | 0:3c32eeb9292a | 359 | */ |
| geiineuville | 0:3c32eeb9292a | 360 | virtual HTTPHandler *handle(HTTPConnection *con) const { |
| geiineuville | 0:3c32eeb9292a | 361 | for(list<HTTPHandler *>::const_iterator iter = _handler.begin(); |
| geiineuville | 0:3c32eeb9292a | 362 | iter != _handler.end(); iter++) { |
| geiineuville | 0:3c32eeb9292a | 363 | if(strncmp((*iter)->getPrefix(), con->getURL(), strlen((*iter)->getPrefix()))==0) { |
| geiineuville | 0:3c32eeb9292a | 364 | HTTPHandler *handler = *iter; |
| geiineuville | 0:3c32eeb9292a | 365 | if(handler->action(con)==HTTP_Deliver) { |
| geiineuville | 0:3c32eeb9292a | 366 | return *iter; |
| geiineuville | 0:3c32eeb9292a | 367 | } |
| geiineuville | 0:3c32eeb9292a | 368 | } |
| geiineuville | 0:3c32eeb9292a | 369 | } |
| geiineuville | 0:3c32eeb9292a | 370 | return NULL; |
| geiineuville | 0:3c32eeb9292a | 371 | } |
| geiineuville | 0:3c32eeb9292a | 372 | |
| geiineuville | 0:3c32eeb9292a | 373 | /** |
| geiineuville | 0:3c32eeb9292a | 374 | * Accept an incomming connection and fork a HTTPConnection if we have enought memory. |
| geiineuville | 0:3c32eeb9292a | 375 | */ |
| geiineuville | 0:3c32eeb9292a | 376 | virtual err_t accept(struct tcp_pcb *pcb, err_t err) { |
| geiineuville | 0:3c32eeb9292a | 377 | LWIP_UNUSED_ARG(err); |
| geiineuville | 0:3c32eeb9292a | 378 | HTTPConnection *con = new HTTPConnection(this, pcb); |
| geiineuville | 0:3c32eeb9292a | 379 | // printf("New Connection opend. Now are %u connections open\n", ++gconnections); |
| geiineuville | 0:3c32eeb9292a | 380 | if(con == NULL) { |
| geiineuville | 0:3c32eeb9292a | 381 | printf("http_accept: Out of memory\n"); |
| geiineuville | 0:3c32eeb9292a | 382 | return ERR_MEM; |
| geiineuville | 0:3c32eeb9292a | 383 | } |
| geiineuville | 0:3c32eeb9292a | 384 | con->set_poll_interval(1); |
| geiineuville | 0:3c32eeb9292a | 385 | tcp_setprio(pcb, TCP_PRIO_MIN); |
| geiineuville | 0:3c32eeb9292a | 386 | return ERR_OK; |
| geiineuville | 0:3c32eeb9292a | 387 | } |
| geiineuville | 0:3c32eeb9292a | 388 | |
| geiineuville | 0:3c32eeb9292a | 389 | /** The registerd request header fields */ |
| geiineuville | 0:3c32eeb9292a | 390 | set<unsigned int> fields; |
| geiineuville | 0:3c32eeb9292a | 391 | |
| geiineuville | 0:3c32eeb9292a | 392 | /** A List of all registered handler. */ |
| geiineuville | 0:3c32eeb9292a | 393 | list<HTTPHandler *> _handler; |
| geiineuville | 0:3c32eeb9292a | 394 | |
| geiineuville | 0:3c32eeb9292a | 395 | int _timeout_max; |
| geiineuville | 0:3c32eeb9292a | 396 | |
| geiineuville | 0:3c32eeb9292a | 397 | friend HTTPConnection; |
| geiineuville | 0:3c32eeb9292a | 398 | }; |
| geiineuville | 0:3c32eeb9292a | 399 | |
| geiineuville | 0:3c32eeb9292a | 400 | }; |
| geiineuville | 0:3c32eeb9292a | 401 | |
| geiineuville | 0:3c32eeb9292a | 402 | #include "HTTPRPC.h" |
| geiineuville | 0:3c32eeb9292a | 403 | #include "HTTPFS.h" |
| geiineuville | 0:3c32eeb9292a | 404 | #include "HTTPFields.h" |
| geiineuville | 0:3c32eeb9292a | 405 | |
| geiineuville | 0:3c32eeb9292a | 406 | #endif /* HTTP_H */ |