This is a status report for the week of June 4 – June 8. This week is best categorized as a research and planning week.
THIS WEEK’S ACCOMPLISHMENTS
On the coding front, there hasn’t been too much progress. The main things that changed were a general tidying of the API, addition of more FastCGI features, and general stabilization. The complete list is in the ChangeLog <http://mono-soc-2007.googlecode.com/svn/trunk/brian/FastCgi/ChangeLog>.
Outside of coding, I spent most of my time rummaging through the XSP source code trying to make heads and tales of what everything does. It has been a pretty slow process but I’ve been storing my results in MonoDoc format <http://mono-soc-2007.googlecode.com/svn/trunk/brian/docs>, so it should be helpful to other developers down the line.
Another thing that occupied my time was deciding what to do to bridge my FastCGI implementation with the current ApplicationServer. Below is my plan.
PLANS FOR THE COMING WEEK
This week, my #1 goal is to get an actual working ASP.NET implementation on top of my FastCGI library. To do this, I plan to separate the FastCGI implementation into its own library and implement three classes on top of it: FastCgiApplicationHost, FastCgiWorkerRequest, and FastCgiWebSource. ApplicationServer may or may not be used as the server, depending on whether my AbstractSocket (below) works out. If ApplicationServer is not used as the server, it will still be used to manage application paths. After all that, a driver class similar to XSP’s server.cs should be all that I need.
As for the socket issue I faced last week, I intend to create a base class AbstractSocket with two subclasses, ManagedSocket which will wrap around System.Net.Sockets.Socket, and UnmanagedSocket which will work with the existing socket by P/Invoking libc. All operations will then be done via AbstractSocket. This will require research on how to accomplish a similar effect on other operating systems.
CHALLENGES I’M FACING
The biggest challenge this week has been sorting through everything. There currently isn’t any documentation on the library and there are very few source code comments.
RESOURCES USED THIS WEEK
- MSDN – Looking up information on various classes and methods.
- FastCGI Specification – Obvious reasons.
- XSP Source Code – To see what everything does.
- Running XSP with tracing enabled – This was extremely helpful because it not only described the path of operation but showed what arguments were passed. This was very helpful for cryptic identifiers. (For example, seeing that ‘verb’ == “GET” really clarified things.)