add myself
[mono.git] / doc / asp-net
1 * ASP.NET
2
3         ASP.NET support is divided in two pieces:
4         <ul>
5                 * Web Forms (Web Applications infrastructure).
6
7                 * Web Services (the SOAP-based rpc system).
8         </ul>
9
10         There is work underway for both systems.  The Web Forms
11         support is more advanced at this point, and various ".aspx"
12         programs can be run using the Mono runtime, including IBuySpy.
13
14         ASP.NET works either embedded into
15         our XSP server test server or the mod_mono Apache module.
16
17         We are now working bug fixing and adding missing features
18         after making the whole pipeline compatible with MS.
19
20         Tim started work on the Web Services.  Although we have a
21         SoapFormatter as part of the remoting infrastructure already
22         (contributed by Jesus), most people will be using the ASP.NET
23         Web Services support.  Work for the supporting class libraries
24         just started recently.  
25
26         The major missing element is a complete XmlSerializer.
27
28 ** HttpRuntime
29
30         Patrik has authored most of the HttpRuntime support (both on
31         the System.Web and on the foundation).
32
33 ** XSP
34
35         This is where initial development of the .aspx/.ascx/.asax compiler 
36         to C# took place. That compiler is now integrated in System.Web classes
37         mostly under System.Web.Compilation namespace.
38
39         We added a new web server that works with mono and MS runtime and is
40         being used to debug our classes.  It resides in xsp/server. A couple of
41         classes of this new server can be reused/extended to make an apache
42         module/cgi using mono (MonoWorkerRequest and MonoApplicationHost).
43
44         There is also a set of .aspx pages to test the server along with
45         a few user controls under xsp/test.
46
47         You can check it out from CVS and run 'make install' to test it.
48
49 ** Controls
50
51         A lot of work has been put in the various classes that
52         implement the controls (UI.HtmlControls and UI.WebControls),
53         but they have been coded mostly in the dark, and without being
54         able to test them in real life: Gaurav and Leen worked very
55         hard on this namespace.
56
57         We can now render all HtmlControls and almost all WebControls.
58         DataGrid and DataList controls are being finished by Gaurav.
59         Xml control needs some work on System.Xml related to XSL.
60
61         Help in making the controls better is appreciated.
62
63 ** ASP.NET and free controls.
64
65         We want to encourage developers to create open source controls
66         that can be used both on Mono's ASP.NET and Microsoft's ASP.NET.  
67
68 * Web Forms: The pieces (historical)
69
70         There are a couple of components to the puzzle:
71
72         <ul>
73                 * .aspx page parser (converts .aspx to C# code).
74         
75                 * System.Web.HttpRuntime support.
76         
77                 * Web controls (System.Web.UI.HtmlControls and
78                   System.Web.UI.WebControls).
79         
80                 * Underlying infrastructure for the controls (System.Web.UI).
81         
82                 * HttpRuntime.ProcessRequest is the core of the ASP.NET
83                   implementation.
84         </ul>
85
86
87         Gonzalo has been working on an ASP.NET parser that takes .aspx
88         files and generated the code required to run them (the code lives in
89         module `xsp' along with a little web server for testing).
90
91         Most of the runtime support was written by Patrik Torstensson
92         (now at Intel).  This was interesting, because in order to implement
93         some of its features, Patrik had to go into the runtime/JIT engine and
94         he spent a few weeks doing work there.
95
96         The classes for running ASP.NET are being actively written.
97         Gaurav, Leen and Patrik worked in the core of the classes
98         required to run ASP.NET web application as well as a small
99         embeddable web server.
100
101         Duncan got our System.Web assembly to compile.
102
103 ** How to Help
104
105         Testing and fixing HtmlControls, WebControls and validators is an
106         easy way to help.
107
108         In the CVS module XSP you can find a small web server used for
109         testing and a directory containing sample aspx pages.
110
111         You have some documentation under doc directory and in the README
112         file of each directory. They explain how to test our System.Web.
113         Testing is really easy!
114
115         As the server also works with MS runtime, you can use it to check
116         what the expected results are.
117