
Description
This article presents a mini Web server with ASP support.
When writing these classes I was inspired by an article from MSDN Magazine 'A Client-side Environment for ASP Pages ' by Dino Esposito.
Although I didn't use any of the code from this MSDN article (mainly because it was written in VB) it was very helpful to get me started. One problem of Dino's solution is, that it is using the
msscript.ocx (Microsoft Script Control), which is not available on all Windows system (you must download and install it separately from Internet Explorer). So in this article I present you a MFC solution that uses the Microsoft Scripting Engine COM interface.
Features
- Multi threaded.
- Real time server log.
- Configure directory for web pages (same for all connections).
- Configure default HTML page.
- Support for GET, POST and HEAD methods.
- Sends directory listing if default HTML is not found in directory.
- Basic error handling (no custom messages yet).
- ASP support (Request, Response, Server and Form collections)
- Cookie support (including 'arrays' and enumeration!)
- SSI (Server Side Includes) support
Known limitations
- Most collections are case sensitive unlike real ASP collections!!!
- Form and QueryString collections do not support arrays at this moment -> no list/combobox support
- Application object not implemented
- Session collection is not included. (but is available from my website).
Major classes used
CScriptEngine
This is a wrapper class around the COM interface of Microsoft's Scripting Engine. It simply converts all calls to the COM interface to easy to use MFC functions.
CAspParser
This class implements the ASP parser. It attaches the interfaces to the script engine and prepares the ASP page for execution.
First all HTML code is converted to ASP code (
Response.Write lines), so the resulting page contains only ASP code (= vbscript code).
The Script Engine then executes this code and all output is written to the Response buffer.
Any calls to
Response or
Request objects will be routed to my
CResponseObject and
CRequestObject classes.
In the case of a web server this response buffer will be send back to the web browser.
CResponseObject
This class provides the
IResponse interface to the scripting engine.
The
IReponse is used by ASP to write data from a script to the output HTML page. Only the most common used properties and methods are implemented.
CRequestObject
This class provides the
IRequest interface to the scripting engine.
The
IRequest is used by ASP to read data from various collections into the script.
The following collections are (partly) implemented:
- QueryString Collection: used to get URL parameters.
- Form Collection : used to get Form variables.
- Server Variables Collection: used to get server information (local or remote ip address, server name and much more).
- Cookies Collection: used to get data from cookies.
CCookie and CCookieEnum
Implementation of the
ICookie interface to support cookies.
This code is partly based the ATL class
CCookie from Microsoft VC++ 7.0.
CCookieCollection and CCookieCollectionEnum
This is an attempt to duplicate the behaviour of the ASP
IRequestDictionary interface to support cookies.
CListenSocket
This socket accepts all incoming connections.
When a client connects to the server, CListenSocket accepts the connection and creates a new thread (CClientThread) that will take care of all further communication between the client and the server. After the thread has been created,
CListenSocket will return to its waiting state.
CClientThread
This thread will handle all communication between the client and the server using
CControlSocket.
CClientSocket
This socket class will process all incoming request and send back the response (files) to the client. All the other classes are just UI related.
Contacting the Author
Please send any comments or bug reports to me via
email. For updates to this article (and many other articles), check my site:
http://www.pablovandermeer.nl.
Revision history
- July 4, 2004 - Initial revision.