Henry Leinen / WiFlyHTTPServer

Single instance HTTP Server using WiFly Interface.

Dependents:   WiFlyHTTPServerSample MultiThreadingHTTPServer

This is my implementation for a HTTP Server using the WiFly Interface. Please note that this is still under development.

It may still contain several bugs. I have tested it using a 1768 on an application board plus RN-XV board.

Currently there is only a FileSystem implemented. Also it is limited to GET request.

I try to extend it further so it will be more useful.

Btw, it does NOT work with RTOS, which seems not to be the Problem of my library.

Do not Forget to Import the WiFly Interface into your Project when using this library.

Change History:

REV5: - added support for basic RPC GET request functionality.

REV4: - added argument parsing from the request uri. - documentation extended and updated.

HTTPConnection.h@14:7f9fbfc18623, 2013-06-26 (annotated)

Committer:
leihen
Date:
Wed Jun 26 22:41:05 2013 +0000
Revision:
14:7f9fbfc18623
Parent:
13:93ff322420b0 
Moved the HttpServer module inside this library.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
leihen 0:7a2421e63e74 1 /* HTTPConnection.h */
leihen 3:d6224049b3bf 2 /*
leihen 3:d6224049b3bf 3 Copyright (c) 2013 Henry Leinen (henry[dot]leinen [at] online [dot] de)
leihen 3:d6224049b3bf 4
leihen 3:d6224049b3bf 5 Permission is hereby granted, free of charge, to any person obtaining a copy
leihen 3:d6224049b3bf 6 of this software and associated documentation files (the "Software"), to deal
leihen 3:d6224049b3bf 7 in the Software without restriction, including without limitation the rights
leihen 3:d6224049b3bf 8 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
leihen 3:d6224049b3bf 9 copies of the Software, and to permit persons to whom the Software is
leihen 3:d6224049b3bf 10 furnished to do so, subject to the following conditions:
leihen 3:d6224049b3bf 11
leihen 3:d6224049b3bf 12 The above copyright notice and this permission notice shall be included in
leihen 3:d6224049b3bf 13 all copies or substantial portions of the Software.
leihen 3:d6224049b3bf 14
leihen 3:d6224049b3bf 15 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
leihen 3:d6224049b3bf 16 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
leihen 3:d6224049b3bf 17 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
leihen 3:d6224049b3bf 18 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
leihen 3:d6224049b3bf 19 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
leihen 3:d6224049b3bf 20 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
leihen 3:d6224049b3bf 21 THE SOFTWARE.
leihen 3:d6224049b3bf 22 */
leihen 0:7a2421e63e74 23 #ifndef __HTTPConnection_H__
leihen 0:7a2421e63e74 24 #define __HTTPConnection_H__
leihen 0:7a2421e63e74 25
leihen 0:7a2421e63e74 26 #include "mbed.h"
leihen 0:7a2421e63e74 27
leihen 0:7a2421e63e74 28 #include <string>
leihen 0:7a2421e63e74 29 #include <map>
leihen 0:7a2421e63e74 30
leihen 1:6b7472d5e9ee 31 class HTTPServer;
leihen 1:6b7472d5e9ee 32
leihen 3:d6224049b3bf 33 /** Type HTTPRequestType enumerates request types
leihen 3:d6224049b3bf 34 */
leihen 3:d6224049b3bf 35 typedef enum
leihen 0:7a2421e63e74 36 {
leihen 3:d6224049b3bf 37 HTTP_RT_GET, /*!< GET request */
leihen 3:d6224049b3bf 38 HTTP_RT_POST, /*!< POST request */
leihen 3:d6224049b3bf 39 HTTP_RT_PUT, /*!< PUT request */
leihen 3:d6224049b3bf 40 HTTP_RT_OPTIONS, /*!< OPTIONS request */
leihen 3:d6224049b3bf 41 HTTP_RT_HEAD, /*!< HEAD request */
leihen 3:d6224049b3bf 42 HTTP_RT_DELETE, /*!< DELETE request */
leihen 3:d6224049b3bf 43 HTTP_RT_TRACE, /*!< TRACE request */
leihen 3:d6224049b3bf 44 HTTP_RT_CONNECT /*!< CONNECT request */
leihen 3:d6224049b3bf 45 } HTTPRequestType;
leihen 0:7a2421e63e74 46
leihen 0:7a2421e63e74 47 /** class HTTPConnection, encapsulates one connection being made throught the HTTPServer
leihen 0:7a2421e63e74 48 *
leihen 0:7a2421e63e74 49 */
leihen 0:7a2421e63e74 50 class HTTPConnection {
leihen 0:7a2421e63e74 51 public:
leihen 3:d6224049b3bf 52
leihen 3:d6224049b3bf 53 /** HTTPMessage contains all the details of the request received by external HTTP client.
leihen 3:d6224049b3bf 54 */
leihen 3:d6224049b3bf 55 typedef struct
leihen 3:d6224049b3bf 56 {
leihen 3:d6224049b3bf 57 /** Specifies the request type received
leihen 3:d6224049b3bf 58 */
leihen 4:d065642c32cc 59 HTTPRequestType request;
leihen 3:d6224049b3bf 60 /** The uri associated with the request.
leihen 3:d6224049b3bf 61 */
leihen 4:d065642c32cc 62 std::string uri;
leihen 3:d6224049b3bf 63 /** Contains the HTTP/1.1 or HTTP/1.0 version requested by client.
leihen 3:d6224049b3bf 64 */
leihen 4:d065642c32cc 65 std::string version;
leihen 3:d6224049b3bf 66 /** Map of headers provided by the client in the form <HeaderName>:<HeaderValue>
leihen 3:d6224049b3bf 67 */
leihen 4:d065642c32cc 68 std::map<std::string, std::string> headers;
leihen 4:d065642c32cc 69 /** Map of arguments that came with the uri string
leihen 4:d065642c32cc 70 */
leihen 4:d065642c32cc 71 std::map<std::string, std::string> args;
leihen 3:d6224049b3bf 72 } HTTPMessage;
leihen 4:d065642c32cc 73
leihen 3:d6224049b3bf 74 /** Public constructor for HTTPConnection objects.
leihen 3:d6224049b3bf 75 *
leihen 3:d6224049b3bf 76 */
leihen 3:d6224049b3bf 77 HTTPConnection ();
leihen 3:d6224049b3bf 78
leihen 3:d6224049b3bf 79 /** Destructor for HTTPConnection objects.
leihen 3:d6224049b3bf 80 *
leihen 3:d6224049b3bf 81 */
leihen 3:d6224049b3bf 82 ~HTTPConnection();
leihen 3:d6224049b3bf 83
leihen 3:d6224049b3bf 84 /** Query if this connection is already closed and can be deleted.
leihen 3:d6224049b3bf 85 @returns true, if connection is closed.
leihen 3:d6224049b3bf 86 */
leihen 3:d6224049b3bf 87 bool is_closed();
leihen 3:d6224049b3bf 88
leihen 0:7a2421e63e74 89 protected:
leihen 3:d6224049b3bf 90
leihen 3:d6224049b3bf 91 /** Function to close this connection. To be called from internally.
leihen 3:d6224049b3bf 92 */
leihen 3:d6224049b3bf 93 void close();
leihen 1:6b7472d5e9ee 94
leihen 1:6b7472d5e9ee 95 HTTPMessage m_Msg;
leihen 4:d065642c32cc 96
leihen 4:d065642c32cc 97 /** parse a HTTP request line from the content of the buffer.
leihen 4:d065642c32cc 98 * @param buffer : the request received from the client in the form <RequestType> <uri> <Http Version>
leihen 4:d065642c32cc 99 * @returns -1 if the request is invalid or 0 if the request is valid
leihen 4:d065642c32cc 100 */
leihen 2:8653bbcf7e58 101 int parse(char *buffer);
leihen 0:7a2421e63e74 102 int receiveHeaders(const char* buffer, int nBuffSize);
leihen 0:7a2421e63e74 103
leihen 4:d065642c32cc 104
leihen 4:d065642c32cc 105 /** parse the receoved \c uri_string for arguments which will be stored in the \c args map.
leihen 4:d065642c32cc 106 * @parse uri_string : the uri string which was received from the client.
leihen 4:d065642c32cc 107 * @parse args : the args map which will receive the argument:value touples from the \c uri_string.
leihen 4:d065642c32cc 108 * @returns -1 if an error occured, otherwise returns 0.
leihen 4:d065642c32cc 109 */
leihen 4:d065642c32cc 110 int parseUriArgs(char *uri_string, map<string,string>& args);
leihen 4:d065642c32cc 111
leihen 0:7a2421e63e74 112 };
leihen 0:7a2421e63e74 113
leihen 0:7a2421e63e74 114 #endif // __HTTPConnection_H__