Author: andrews
Date: 2006-11-27 08:49:52 -0500 (Mon, 27 Nov 2006)
New Revision: 68512

Modified:
   trunk/mcs/class/System.Web/Test/mainsoft/NunitWeb/NunitWeb/BaseRequest.cs
   trunk/mcs/class/System.Web/Test/mainsoft/NunitWeb/NunitWeb/IForeignData.cs
   trunk/mcs/class/System.Web/Test/mainsoft/NunitWeb/NunitWeb/PostableRequest.cs
Log:
XML document additions

Modified: 
trunk/mcs/class/System.Web/Test/mainsoft/NunitWeb/NunitWeb/BaseRequest.cs
===================================================================
--- trunk/mcs/class/System.Web/Test/mainsoft/NunitWeb/NunitWeb/BaseRequest.cs   
2006-11-27 13:49:15 UTC (rev 68511)
+++ trunk/mcs/class/System.Web/Test/mainsoft/NunitWeb/NunitWeb/BaseRequest.cs   
2006-11-27 13:49:52 UTC (rev 68512)
@@ -79,11 +79,28 @@
                        return br;
                }
 
+               /// <summary>
+               /// Create a new <see cref="WebRequest"/>.
+               /// </summary>
+               /// <remarks>
+               /// This method is used when the test web application is not 
hosted, but deployed. Possible
+               /// uses: test web application is remoted, Grasshopper setup 
with web application running
+               /// on Tomcat.
+               /// </remarks>
+               /// <param name="baseUri">URI to send request to.</param>
+               /// <param name="headers">Collection of headers to add to 
request</param>
+               /// <returns>A new <see cref="HttpWebRequest"/>.</returns>
                public virtual WebRequest CreateWebRequest (Uri baseUri, 
NameValueCollection headers)
                {
                        return CreateHttpWebRequest (baseUri, headers);
                }
 
+               /// <summary>
+               /// Create a new <see cref="HttpWorkerRequest"/> by using <see 
cref="WebRequest.Create"/>.
+               /// </summary>
+               /// <param name="baseUri">URI to pass to <see 
cref="WebRequest.Create"/></param>
+               /// <param name="headers">Headers to add to the created <see 
cref="HttpWorkerRequest"/></param>
+               /// <returns>A new <see cref="HttpWorkerRequest"/></returns>
                protected virtual HttpWebRequest CreateHttpWebRequest (Uri 
baseUri, NameValueCollection headers)
                {
                        string reqUrl = Url;
@@ -122,7 +139,8 @@
 
                /// <summary>
                /// Extracts the response from the completed <see 
cref="System.Web.HttpWorkerRequest"/>
-               /// and returns a new <see cref="Response"/> instance.
+               /// and returns a new <see cref="Response"/> instance. This 
method works with HttpWorkerRequest
+               /// created with <see cref="CreateWorkerRequest"/>.
                /// </summary>
                /// <param name="request">this must be the same request that 
was returned by
                /// CreateWorkerRequest</param>
@@ -142,6 +160,13 @@
                        return r;
                }
 
+               /// <summary>
+               /// This method is used to extract response of the request 
created by <see cref="CreateWebRequest"/>.
+               /// </summary>
+               /// <remarks>
+               /// </remarks>
+               /// <param name="response"></param>
+               /// <returns></returns>
                public virtual Response ExtractResponse (WebResponse response)
                {
                        Response r = new Response ();

Modified: 
trunk/mcs/class/System.Web/Test/mainsoft/NunitWeb/NunitWeb/IForeignData.cs
===================================================================
--- trunk/mcs/class/System.Web/Test/mainsoft/NunitWeb/NunitWeb/IForeignData.cs  
2006-11-27 13:49:15 UTC (rev 68511)
+++ trunk/mcs/class/System.Web/Test/mainsoft/NunitWeb/NunitWeb/IForeignData.cs  
2006-11-27 13:49:52 UTC (rev 68512)
@@ -5,9 +5,11 @@
        /// <summary>
        /// This interface is used to add foreign data to the implementing class
        /// instances (similar to Python common practice) or AOP field 
injection.
+       /// </summary>
+       /// <remarks>
        /// This is achieved by convention that every class <b>using</b> this 
interface
        /// passes it's own type to the indexer property.
-       /// </summary>
+       /// </remarks>
        /// <example>
        /// class IForeignDataUsingClass
        /// {

Modified: 
trunk/mcs/class/System.Web/Test/mainsoft/NunitWeb/NunitWeb/PostableRequest.cs
===================================================================
--- 
trunk/mcs/class/System.Web/Test/mainsoft/NunitWeb/NunitWeb/PostableRequest.cs   
    2006-11-27 13:49:15 UTC (rev 68511)
+++ 
trunk/mcs/class/System.Web/Test/mainsoft/NunitWeb/NunitWeb/PostableRequest.cs   
    2006-11-27 13:49:52 UTC (rev 68512)
@@ -83,7 +83,16 @@
                                wr, UserAgent, EntityBody, ContentType);
                }
 
-               public override WebRequest CreateWebRequest(Uri baseUri, 
NameValueCollection headers) {
+               /// <summary>
+               /// Override the base <see cref="CreateWebRequest"/> and add 
POST method functionality
+               /// when necessary.
+               /// </summary>
+               /// <param name="baseUri">URI to send request to.</param>
+               /// <param name="headers">Headers added to the request.</param>
+               /// <returns>A new <see cref="WebRequest"/></returns>
+               public override WebRequest CreateWebRequest(Uri baseUri, 
NameValueCollection headers)
+               {
+                       //FIXME: may be it's better to override 
CreateHttpWebRequest?
                        HttpWebRequest hwr = base.CreateHttpWebRequest 
(baseUri, headers);
                        if (EntityBody == null || !IsPost)
                                return hwr;

_______________________________________________
Mono-patches maillist  -  [email protected]
http://lists.ximian.com/mailman/listinfo/mono-patches

Reply via email to