aboutsummaryrefslogtreecommitdiffstatshomepage
diff options
context:
space:
mode:
authorDiva Canto2010-12-18 18:23:51 -0800
committerDiva Canto2010-12-18 18:23:51 -0800
commitcf72fece6db782530086724cd704261ccfb8c986 (patch)
tree1b48ebc272ba2891c06cc990a67a0939103bd754
parentReplaced HttpServer_OpenSim.dll with a version that locks certain ops in Http... (diff)
downloadopensim-SC_OLD-cf72fece6db782530086724cd704261ccfb8c986.zip
opensim-SC_OLD-cf72fece6db782530086724cd704261ccfb8c986.tar.gz
opensim-SC_OLD-cf72fece6db782530086724cd704261ccfb8c986.tar.bz2
opensim-SC_OLD-cf72fece6db782530086724cd704261ccfb8c986.tar.xz
Replaced the HttpServer_OpenSim.dll with one compiled for .NET 3.5 (the last one was 4.0, and that doesn't work). Also added the corresponding .xml and .pdb, if that makes any difference.
Diffstat (limited to '')
-rw-r--r--bin/HttpServer_OpenSim.dllbin116224 -> 115712 bytes
-rw-r--r--bin/HttpServer_OpenSim.pdbbin382464 -> 409088 bytes
-rw-r--r--bin/HttpServer_OpenSim.xml5978
3 files changed, 2989 insertions, 2989 deletions
diff --git a/bin/HttpServer_OpenSim.dll b/bin/HttpServer_OpenSim.dll
index cdd4655..d7503a0 100644
--- a/bin/HttpServer_OpenSim.dll
+++ b/bin/HttpServer_OpenSim.dll
Binary files differ
diff --git a/bin/HttpServer_OpenSim.pdb b/bin/HttpServer_OpenSim.pdb
index 7c00e66..4151588 100644
--- a/bin/HttpServer_OpenSim.pdb
+++ b/bin/HttpServer_OpenSim.pdb
Binary files differ
diff --git a/bin/HttpServer_OpenSim.xml b/bin/HttpServer_OpenSim.xml
index 9c3df78..27386b7 100644
--- a/bin/HttpServer_OpenSim.xml
+++ b/bin/HttpServer_OpenSim.xml
@@ -4,492 +4,494 @@
4 <name>HttpServer_OpenSim</name> 4 <name>HttpServer_OpenSim</name>
5 </assembly> 5 </assembly>
6 <members> 6 <members>
7 <member name="T:HttpServer.IComponentProvider"> 7 <member name="T:HttpServer.Exceptions.BadRequestException">
8 <summary>
9 Inversion of control interface.
10 </summary>
11 </member>
12 <member name="M:HttpServer.IComponentProvider.AddInstance``1(System.Object)">
13 <summary> 8 <summary>
14 Add a component instance 9 The request could not be understood by the server due to malformed syntax.
10 The client SHOULD NOT repeat the request without modifications.
11
12 Text taken from: http://www.submissionchamber.com/help-guides/error-codes.php
15 </summary> 13 </summary>
16 <typeparam name="T">Interface type</typeparam>
17 <param name="instance">Instance to add</param>
18 </member> 14 </member>
19 <member name="M:HttpServer.IComponentProvider.Get``1"> 15 <member name="T:HttpServer.Exceptions.HttpException">
20 <summary> 16 <summary>
21 Get a component. 17 All HTTP based exceptions will derive this class.
22 </summary> 18 </summary>
23 <typeparam name="T">Interface type</typeparam>
24 <returns>Component if registered, otherwise null.</returns>
25 <remarks>
26 Component will get created if needed.
27 </remarks>
28 </member> 19 </member>
29 <member name="M:HttpServer.IComponentProvider.Contains(System.Type)"> 20 <member name="M:HttpServer.Exceptions.HttpException.#ctor(System.Net.HttpStatusCode,System.String)">
30 <summary> 21 <summary>
31 Checks if the specified component interface have been added. 22 Create a new HttpException
32 </summary> 23 </summary>
33 <param name="interfaceType"></param> 24 <param name="code">http status code (sent in the response)</param>
34 <returns>true if found; otherwise false.</returns> 25 <param name="message">error description</param>
35 </member> 26 </member>
36 <member name="M:HttpServer.IComponentProvider.Add``2"> 27 <member name="M:HttpServer.Exceptions.HttpException.#ctor(System.Net.HttpStatusCode,System.String,System.Exception)">
37 <summary> 28 <summary>
38 Add a component. 29 Create a new HttpException
39 </summary> 30 </summary>
40 <typeparam name="InterfaceType">Type being requested.</typeparam> 31 <param name="code">http status code (sent in the response)</param>
41 <typeparam name="InstanceType">Type being created.</typeparam> 32 <param name="message">error description</param>
33 <param name="inner">inner exception</param>
42 </member> 34 </member>
43 <member name="T:HttpServer.HttpModules.HttpModule"> 35 <member name="P:HttpServer.Exceptions.HttpException.HttpStatusCode">
44 <summary> 36 <summary>
45 A HttpModule can be used to serve Uri's. The module itself 37 status code to use in the response.
46 decides if it should serve a Uri or not. In this way, you can
47 get a very flexible http application since you can let multiple modules
48 serve almost similar urls.
49 </summary> 38 </summary>
50 <remarks>
51 Throw <see cref="T:HttpServer.Exceptions.UnauthorizedException"/> if you are using a <see cref="T:HttpServer.Authentication.AuthenticationModule"/> and want to prompt for user name/password.
52 </remarks>
53 </member> 39 </member>
54 <member name="M:HttpServer.HttpModules.HttpModule.Process(HttpServer.IHttpRequest,HttpServer.IHttpResponse,HttpServer.Sessions.IHttpSession)"> 40 <member name="M:HttpServer.Exceptions.BadRequestException.#ctor(System.String)">
55 <summary> 41 <summary>
56 Method that process the url 42 Create a new bad request exception.
57 </summary> 43 </summary>
58 <param name="request">Information sent by the browser about the request</param> 44 <param name="errMsg">reason to why the request was bad.</param>
59 <param name="response">Information that is being sent back to the client.</param>
60 <param name="session">Session used to </param>
61 <returns>true if this module handled the request.</returns>
62 </member> 45 </member>
63 <member name="M:HttpServer.HttpModules.HttpModule.SetLogWriter(HttpServer.ILogWriter)"> 46 <member name="M:HttpServer.Exceptions.BadRequestException.#ctor(System.String,System.Exception)">
64 <summary> 47 <summary>
65 Set the log writer to use. 48 Create a new bad request exception.
66 </summary> 49 </summary>
67 <param name="writer">logwriter to use.</param> 50 <param name="errMsg">reason to why the request was bad.</param>
51 <param name="inner">inner exception</param>
68 </member> 52 </member>
69 <member name="M:HttpServer.HttpModules.HttpModule.Write(HttpServer.LogPrio,System.String)"> 53 <member name="T:HttpServer.Authentication.DigestAuthentication">
70 <summary> 54 <summary>
71 Log something. 55 Implements HTTP Digest authentication. It's more secure than Basic auth since password is
56 encrypted with a "key" from the server.
72 </summary> 57 </summary>
73 <param name="prio">importance of log message</param> 58 <remarks>
74 <param name="message">message</param> 59 Keep in mind that the password is encrypted with MD5. Use a combination of SSL and digest auth to be secure.
60 </remarks>
75 </member> 61 </member>
76 <member name="P:HttpServer.HttpModules.HttpModule.AllowSecondaryProcessing"> 62 <member name="T:HttpServer.Authentication.AuthenticationModule">
77 <summary> 63 <summary>
78 If true specifies that the module doesn't consume the processing of a request so that subsequent modules 64 Authentication modules are used to implement different
79 can continue processing afterwards. Default is false. 65 kind of HTTP authentication.
80 </summary> 66 </summary>
81 </member> 67 </member>
82 <member name="T:HttpServer.Helpers.ResourceInfo"> 68 <member name="F:HttpServer.Authentication.AuthenticationModule.AuthenticationTag">
83 <summary> 69 <summary>
84 Container to bind resource names to assemblies 70 Tag used for authentication.
85 </summary> 71 </summary>
86 </member> 72 </member>
87 <member name="M:HttpServer.Helpers.ResourceInfo.#ctor(System.String,System.String,System.Reflection.Assembly)"> 73 <member name="M:HttpServer.Authentication.AuthenticationModule.#ctor(HttpServer.Authentication.AuthenticationHandler,HttpServer.Authentication.AuthenticationRequiredHandler)">
88 <summary> 74 <summary>
89 Instantiates an instance of <see cref="T:HttpServer.Helpers.ResourceInfo"/> 75 Initializes a new instance of the <see cref="T:HttpServer.Authentication.AuthenticationModule"/> class.
90 </summary> 76 </summary>
91 <param name="uri">The dot seperated uri the resource maps to</param> 77 <param name="authenticator">Delegate used to provide information used during authentication.</param>
92 <param name="resourceName">The full resource name</param> 78 <param name="authenticationRequiredHandler">Delegate used to determine if authentication is required (may be null).</param>
93 <param name="assembly">The assembly the resource exists in</param>
94 </member> 79 </member>
95 <member name="M:HttpServer.Helpers.ResourceInfo.GetStream"> 80 <member name="M:HttpServer.Authentication.AuthenticationModule.#ctor(HttpServer.Authentication.AuthenticationHandler)">
96 <summary> 81 <summary>
97 Retrieves a stream to the resource 82 Initializes a new instance of the <see cref="T:HttpServer.Authentication.AuthenticationModule"/> class.
98 </summary> 83 </summary>
99 <returns>Null if the resource couldn't be located somehow</returns> 84 <param name="authenticator">Delegate used to provide information used during authentication.</param>
100 </member> 85 </member>
101 <member name="P:HttpServer.Helpers.ResourceInfo.Assembly"> 86 <member name="M:HttpServer.Authentication.AuthenticationModule.CreateResponse(System.String,System.Object[])">
102 <summary> 87 <summary>
103 Retrieves the assembly the resource resides in 88 Create a response that can be sent in the WWW-Authenticate header.
104 </summary> 89 </summary>
90 <param name="realm">Realm that the user should authenticate in</param>
91 <param name="options">Array with optional options.</param>
92 <returns>A correct authentication request.</returns>
93 <exception cref="T:System.ArgumentNullException">If realm is empty or null.</exception>
105 </member> 94 </member>
106 <member name="P:HttpServer.Helpers.ResourceInfo.Uri"> 95 <member name="M:HttpServer.Authentication.AuthenticationModule.Authenticate(System.String,System.String,System.String,System.Object[])">
107 <summary> 96 <summary>
108 Retrieves the full name/path of the assembly 97 An authentication response have been received from the web browser.
98 Check if it's correct
109 </summary> 99 </summary>
100 <param name="authenticationHeader">Contents from the Authorization header</param>
101 <param name="realm">Realm that should be authenticated</param>
102 <param name="httpVerb">GET/POST/PUT/DELETE etc.</param>
103 <param name="options">options to specific implementations</param>
104 <returns>Authentication object that is stored for the request. A user class or something like that.</returns>
105 <exception cref="T:System.ArgumentException">if <paramref name="authenticationHeader"/> is invalid</exception>
106 <exception cref="T:System.ArgumentNullException">If any of the parameters is empty or null.</exception>
110 </member> 107 </member>
111 <member name="P:HttpServer.Helpers.ResourceInfo.Extension"> 108 <member name="M:HttpServer.Authentication.AuthenticationModule.CheckAuthentication(System.String,System.String,System.String@,System.Object@)">
112 <summary> 109 <summary>
113 Retrieves the extension of the resource 110 Used to invoke the authentication delegate that is used to lookup the user name/realm.
114 </summary> 111 </summary>
112 <param name="realm">Realm (domain) that user want to authenticate in</param>
113 <param name="userName">User name</param>
114 <param name="password">Password used for validation. Some implementations got password in clear text, they are then sent to client.</param>
115 <param name="login">object that will be stored in the request to help you identify the user if authentication was successful.</param>
116 <returns>true if authentication was successful</returns>
115 </member> 117 </member>
116 <member name="P:HttpServer.Helpers.ResourceInfo.ExtensionLessUri"> 118 <member name="M:HttpServer.Authentication.AuthenticationModule.AuthenticationRequired(HttpServer.IHttpRequest)">
117 <summary>Returns the Uri without extension</summary>
118 </member>
119 <member name="P:HttpServer.Helpers.ResourceInfo.ResourceName">
120 <summary>Retrieves the full path name to the resource file</summary>
121 </member>
122 <member name="T:HttpServer.Helpers.ObjectForm">
123 <summary> 119 <summary>
124 The object form class takes an object and creates form items for it. 120 Determines if authentication is required.
125 </summary> 121 </summary>
122 <param name="request">HTTP request from browser</param>
123 <returns>true if user should be authenticated.</returns>
124 <remarks>throw <see cref="T:HttpServer.Exceptions.ForbiddenException"/> from your delegate if no more attempts are allowed.</remarks>
125 <exception cref="T:HttpServer.Exceptions.ForbiddenException">If no more attempts are allowed</exception>
126 </member> 126 </member>
127 <member name="M:HttpServer.Helpers.ObjectForm.#ctor(System.String,System.String,System.Object,System.String)"> 127 <member name="P:HttpServer.Authentication.AuthenticationModule.Name">
128 <summary> 128 <summary>
129 Initializes a new instance of the <see cref="T:HttpServer.Helpers.ObjectForm"/> class. 129 name used in HTTP request.
130 </summary> 130 </summary>
131 <param name="method"></param>
132 <param name="name">form name *and* id.</param>
133 <param name="action">action to do when form is posted.</param>
134 <param name="obj"></param>
135 </member> 131 </member>
136 <member name="M:HttpServer.Helpers.ObjectForm.#ctor(System.String,System.String,System.Object)"> 132 <member name="M:HttpServer.Authentication.DigestAuthentication.#ctor(HttpServer.Authentication.AuthenticationHandler,HttpServer.Authentication.AuthenticationRequiredHandler)">
137 <summary> 133 <summary>
138 Initializes a new instance of the <see cref="T:HttpServer.Helpers.ObjectForm"/> class. 134 Initializes a new instance of the <see cref="T:HttpServer.Authentication.DigestAuthentication"/> class.
139 </summary> 135 </summary>
140 <param name="name">form name *and* id.</param> 136 <param name="authenticator">Delegate used to provide information used during authentication.</param>
141 <param name="action">action to do when form is posted.</param> 137 <param name="authenticationRequiredHandler">Delegate used to determine if authentication is required (may be null).</param>
142 <param name="obj">object to get values from</param>
143 </member> 138 </member>
144 <member name="M:HttpServer.Helpers.ObjectForm.#ctor(System.String,System.Object)"> 139 <member name="M:HttpServer.Authentication.DigestAuthentication.#ctor(HttpServer.Authentication.AuthenticationHandler)">
145 <summary> 140 <summary>
146 Initializes a new instance of the <see cref="T:HttpServer.Helpers.ObjectForm"/> class. 141 Initializes a new instance of the <see cref="T:HttpServer.Authentication.DigestAuthentication"/> class.
147 </summary> 142 </summary>
148 <param name="action">form action.</param> 143 <param name="authenticator">Delegate used to provide information used during authentication.</param>
149 <param name="obj">object to get values from.</param>
150 </member> 144 </member>
151 <member name="M:HttpServer.Helpers.ObjectForm.Begin"> 145 <member name="F:HttpServer.Authentication.DigestAuthentication.DisableNonceCheck">
152 <summary> 146 <summary>
153 write out the FORM-tag. 147 Used by test classes to be able to use hardcoded values
154 </summary> 148 </summary>
155 <returns>generated html code</returns>
156 </member> 149 </member>
157 <member name="M:HttpServer.Helpers.ObjectForm.Begin(System.Boolean)"> 150 <member name="M:HttpServer.Authentication.DigestAuthentication.Authenticate(System.String,System.String,System.String,System.Object[])">
158 <summary> 151 <summary>
159 Writeout the form tag 152 An authentication response have been received from the web browser.
153 Check if it's correct
160 </summary> 154 </summary>
161 <param name="isAjax">form should be posted through ajax.</param> 155 <param name="authenticationHeader">Contents from the Authorization header</param>
162 <returns>generated html code</returns> 156 <param name="realm">Realm that should be authenticated</param>
157 <param name="httpVerb">GET/POST/PUT/DELETE etc.</param>
158 <param name="options">First option: true if username/password is correct but not cnonce</param>
159 <returns>
160 Authentication object that is stored for the request. A user class or something like that.
161 </returns>
162 <exception cref="T:System.ArgumentException">if authenticationHeader is invalid</exception>
163 <exception cref="T:System.ArgumentNullException">If any of the paramters is empty or null.</exception>
163 </member> 164 </member>
164 <member name="M:HttpServer.Helpers.ObjectForm.Tb(System.String,System.Object[])"> 165 <member name="M:HttpServer.Authentication.DigestAuthentication.Encrypt(System.String,System.String,System.String,System.String,System.String,System.String,System.String,System.String,System.String)">
165 <summary> 166 <summary>
166 Generates a text box. 167 Encrypts parameters into a Digest string
167 </summary> 168 </summary>
168 <param name="propertyName"></param> 169 <param name="realm">Realm that the user want to log into.</param>
169 <param name="options"></param> 170 <param name="userName">User logging in</param>
170 <returns>generated html code</returns> 171 <param name="password">Users password.</param>
172 <param name="method">HTTP method.</param>
173 <param name="uri">Uri/domain that generated the login prompt.</param>
174 <param name="qop">Quality of Protection.</param>
175 <param name="nonce">"Number used ONCE"</param>
176 <param name="nc">Hexadecimal request counter.</param>
177 <param name="cnonce">"Client Number used ONCE"</param>
178 <returns>Digest encrypted string</returns>
171 </member> 179 </member>
172 <member name="M:HttpServer.Helpers.ObjectForm.Pb(System.String,System.Object[])"> 180 <member name="M:HttpServer.Authentication.DigestAuthentication.Encrypt(System.String,System.String,System.String,System.String,System.String,System.String)">
173 <summary> 181 <summary>
174 password box 182
175 </summary> 183 </summary>
176 <param name="propertyName"></param> 184 <param name="ha1">Md5 hex encoded "userName:realm:password", without the quotes.</param>
177 <param name="options"></param> 185 <param name="ha2">Md5 hex encoded "method:uri", without the quotes</param>
178 <returns>generated html code</returns> 186 <param name="qop">Quality of Protection</param>
187 <param name="nonce">"Number used ONCE"</param>
188 <param name="nc">Hexadecimal request counter.</param>
189 <param name="cnonce">Client number used once</param>
190 <returns></returns>
179 </member> 191 </member>
180 <member name="M:HttpServer.Helpers.ObjectForm.Hidden(System.String,System.Object[])"> 192 <member name="M:HttpServer.Authentication.DigestAuthentication.CreateResponse(System.String,System.Object[])">
181 <summary> 193 <summary>
182 Hiddens the specified property name. 194 Create a response that can be sent in the WWW-Authenticate header.
183 </summary> 195 </summary>
184 <param name="propertyName">Name of the property.</param> 196 <param name="realm">Realm that the user should authenticate in</param>
185 <param name="options">The options.</param> 197 <param name="options">First options specifies if true if username/password is correct but not cnonce.</param>
186 <returns>generated html code</returns> 198 <returns>A correct auth request.</returns>
199 <exception cref="T:System.ArgumentNullException">If realm is empty or null.</exception>
187 </member> 200 </member>
188 <member name="M:HttpServer.Helpers.ObjectForm.Label(System.String,System.String)"> 201 <member name="M:HttpServer.Authentication.DigestAuthentication.Decode(System.String,System.Text.Encoding)">
189 <summary> 202 <summary>
190 Labels the specified property name. 203 Decodes authorization header value
191 </summary> 204 </summary>
192 <param name="propertyName">property in object.</param> 205 <param name="buffer">header value</param>
193 <param name="label">caption</param> 206 <param name="encoding">Encoding that the buffer is in</param>
194 <returns>generated html code</returns> 207 <returns>All headers and their values if successful; otherwise null</returns>
208 <example>
209 NameValueCollection header = DigestAuthentication.Decode("response=\"6629fae49393a05397450978507c4ef1\",\r\nc=00001", Encoding.ASCII);
210 </example>
211 <remarks>Can handle lots of whitespaces and new lines without failing.</remarks>
195 </member> 212 </member>
196 <member name="M:HttpServer.Helpers.ObjectForm.Cb(System.String,System.String,System.Object[])"> 213 <member name="M:HttpServer.Authentication.DigestAuthentication.GetCurrentNonce">
197 <summary> 214 <summary>
198 Generate a checkbox 215 Gets the current nonce.
199 </summary> 216 </summary>
200 <param name="propertyName">property in object</param> 217 <returns></returns>
201 <param name="value">checkbox value</param>
202 <param name="options">additional html attributes.</param>
203 <returns>generated html code</returns>
204 </member> 218 </member>
205 <member name="M:HttpServer.Helpers.ObjectForm.Select(System.String,System.String,System.String,System.Object[])"> 219 <member name="M:HttpServer.Authentication.DigestAuthentication.GetMD5HashBinHex2(System.String)">
206 <summary> 220 <summary>
207 Write a html select tag 221 Gets the Md5 hash bin hex2.
208 </summary> 222 </summary>
209 <param name="propertyName">object property.</param> 223 <param name="toBeHashed">To be hashed.</param>
210 <param name="idColumn">id column</param>
211 <param name="titleColumn">The title column.</param>
212 <param name="options">The options.</param>
213 <returns></returns> 224 <returns></returns>
214 </member> 225 </member>
215 <member name="M:HttpServer.Helpers.ObjectForm.Select(System.String,System.Collections.IEnumerable,System.String,System.String,System.Object[])"> 226 <member name="M:HttpServer.Authentication.DigestAuthentication.IsValidNonce(System.String)">
216 <summary> 227 <summary>
217 Selects the specified property name. 228 determines if the nonce is valid or has expired.
218 </summary> 229 </summary>
219 <param name="propertyName">Name of the property.</param> 230 <param name="nonce">nonce value (check wikipedia for info)</param>
220 <param name="items">The items.</param> 231 <returns>true if the nonce has not expired.</returns>
221 <param name="idColumn">The id column.</param>
222 <param name="titleColumn">The title column.</param>
223 <param name="options">The options.</param>
224 <returns></returns>
225 </member> 232 </member>
226 <member name="M:HttpServer.Helpers.ObjectForm.Submit(System.String)"> 233 <member name="P:HttpServer.Authentication.DigestAuthentication.Name">
227 <summary> 234 <summary>
228 Write a submit tag. 235 name used in http request.
229 </summary> 236 </summary>
230 <param name="value">button caption</param>
231 <returns>html submit tag</returns>
232 </member> 237 </member>
233 <member name="M:HttpServer.Helpers.ObjectForm.End"> 238 <member name="P:HttpServer.Authentication.DigestAuthentication.TokenIsHA1">
234 <summary> 239 <summary>
235 html end form tag 240 Gets or sets whether the token supplied in <see cref="T:HttpServer.Authentication.AuthenticationHandler"/> is a
241 HA1 generated string.
236 </summary> 242 </summary>
237 <returns>html</returns>
238 </member> 243 </member>
239 <member name="T:HttpServer.FormDecoders.XmlDecoder"> 244 <member name="T:HttpServer.Rules.RegexRedirectRule">
240 <summary> 245 <summary>
241 This decoder converts XML documents to form items. 246 Class to make dynamic binding of redirects. Instead of having to specify a number of similar redirect rules
242 Each element becomes a subitem in the form, and each attribute becomes an item. 247 a regular expression can be used to identify redirect URLs and their targets.
243 </summary> 248 </summary>
244 <example> 249 <example>
245 // xml: <hello id="1">something<world id="2">data</world></hello> 250 <![CDATA[
246 // result: 251 new RegexRedirectRule("/(?<target>[a-z0-9]+)", "/users/${target}?find=true", RegexOptions.IgnoreCase)
247 // form["hello"].Value = "something" 252 ]]>
248 // form["hello"]["id"].Value = 1
249 // form["hello"]["world]["id"].Value = 1
250 // form["hello"]["world"].Value = "data"
251 </example> 253 </example>
252 <remarks>
253 The original xml document is stored in form["__xml__"].Value.
254 </remarks>
255 </member> 254 </member>
256 <member name="T:HttpServer.FormDecoders.IFormDecoder"> 255 <member name="T:HttpServer.Rules.RedirectRule">
257 <summary>
258 Interface for form content decoders.
259 </summary>
260 </member>
261 <member name="M:HttpServer.FormDecoders.IFormDecoder.Decode(System.IO.Stream,System.String,System.Text.Encoding)">
262 <summary>
263
264 </summary>
265 <param name="stream">Stream containing the content</param>
266 <param name="contentType">Content type (with any additional info like boundry). Content type is always supplied in lower case</param>
267 <param name="encoding">Stream enconding</param>
268 <returns>A http form, or null if content could not be parsed.</returns>
269 <exception cref="T:System.IO.InvalidDataException">If contents in the stream is not valid input data.</exception>
270 </member>
271 <member name="M:HttpServer.FormDecoders.IFormDecoder.CanParse(System.String)">
272 <summary>
273 Checks if the decoder can handle the mime type
274 </summary>
275 <param name="contentType">Content type (with any additional info like boundry). Content type is always supplied in lower case.</param>
276 <returns>True if the decoder can parse the specified content type</returns>
277 </member>
278 <member name="M:HttpServer.FormDecoders.XmlDecoder.Decode(System.IO.Stream,System.String,System.Text.Encoding)">
279 <summary>
280
281 </summary>
282 <param name="stream">Stream containing the content</param>
283 <param name="contentType">Content type (with any additional info like boundry). Content type is always supplied in lower case</param>
284 <param name="encoding">Stream encoding</param>
285 Note: contentType and encoding are not used?
286 <returns>A http form, or null if content could not be parsed.</returns>
287 <exception cref="T:System.IO.InvalidDataException"></exception>
288 </member>
289 <member name="M:HttpServer.FormDecoders.XmlDecoder.TraverseNode(HttpServer.IHttpInput,System.Xml.XmlNode)">
290 <summary>
291 Recursive function that will go through an xml element and store it's content
292 to the form item.
293 </summary>
294 <param name="item">(parent) Item in form that content should be added to.</param>
295 <param name="node">Node that should be parsed.</param>
296 </member>
297 <member name="M:HttpServer.FormDecoders.XmlDecoder.CanParse(System.String)">
298 <summary> 256 <summary>
299 Checks if the decoder can handle the mime type 257 redirects from one URL to another.
300 </summary> 258 </summary>
301 <param name="contentType">Content type (with any additional info like boundry). Content type is always supplied in lower case.</param>
302 <returns>True if the decoder can parse the specified content type</returns>
303 </member> 259 </member>
304 <member name="T:HttpServer.Exceptions.InternalServerException"> 260 <member name="T:HttpServer.Rules.IRule">
305 <summary> 261 <summary>
306 The server encountered an unexpected condition which prevented it from fulfilling the request. 262 Rules are used to perform operations before a request is being handled.
263 Rules can be used to create routing etc.
307 </summary> 264 </summary>
308 </member> 265 </member>
309 <member name="T:HttpServer.Exceptions.HttpException"> 266 <member name="M:HttpServer.Rules.IRule.Process(HttpServer.IHttpRequest,HttpServer.IHttpResponse)">
310 <summary> 267 <summary>
311 All HTTP based exceptions will derive this class. 268 Process the incoming request.
312 </summary> 269 </summary>
270 <param name="request">incoming HTTP request</param>
271 <param name="response">outgoing HTTP response</param>
272 <returns>true if response should be sent to the browser directly (no other rules or modules will be processed).</returns>
273 <remarks>
274 returning true means that no modules will get the request. Returning true is typically being done
275 for redirects.
276 </remarks>
277 <exception cref="T:System.ArgumentNullException">If request or response is null.</exception>
313 </member> 278 </member>
314 <member name="M:HttpServer.Exceptions.HttpException.#ctor(System.Net.HttpStatusCode,System.String)"> 279 <member name="M:HttpServer.Rules.RedirectRule.#ctor(System.String,System.String)">
315 <summary> 280 <summary>
316 Create a new HttpException 281 Initializes a new instance of the <see cref="T:HttpServer.Rules.RedirectRule"/> class.
317 </summary> 282 </summary>
318 <param name="code">http status code (sent in the response)</param> 283 <param name="fromUrl">Absolute path (no server name)</param>
319 <param name="message">error description</param> 284 <param name="toUrl">Absolute path (no server name)</param>
285 <example>
286 server.Add(new RedirectRule("/", "/user/index"));
287 </example>
320 </member> 288 </member>
321 <member name="M:HttpServer.Exceptions.HttpException.#ctor(System.Net.HttpStatusCode,System.String,System.Exception)"> 289 <member name="M:HttpServer.Rules.RedirectRule.#ctor(System.String,System.String,System.Boolean)">
322 <summary> 290 <summary>
323 Create a new HttpException 291 Initializes a new instance of the <see cref="T:HttpServer.Rules.RedirectRule"/> class.
324 </summary> 292 </summary>
325 <param name="code">http status code (sent in the response)</param> 293 <param name="fromUrl">Absolute path (no server name)</param>
326 <param name="message">error description</param> 294 <param name="toUrl">Absolute path (no server name)</param>
327 <param name="inner">inner exception</param> 295 <param name="shouldRedirect">true if request should be redirected, false if the request URI should be replaced.</param>
296 <example>
297 server.Add(new RedirectRule("/", "/user/index"));
298 </example>
328 </member> 299 </member>
329 <member name="P:HttpServer.Exceptions.HttpException.HttpStatusCode"> 300 <member name="M:HttpServer.Rules.RedirectRule.Process(HttpServer.IHttpRequest,HttpServer.IHttpResponse)">
330 <summary> 301 <summary>
331 status code to use in the response. 302 Process the incoming request.
332 </summary> 303 </summary>
304 <param name="request">incoming HTTP request</param>
305 <param name="response">outgoing HTTP response</param>
306 <returns>true if response should be sent to the browser directly (no other rules or modules will be processed).</returns>
307 <remarks>
308 returning true means that no modules will get the request. Returning true is typically being done
309 for redirects.
310 </remarks>
333 </member> 311 </member>
334 <member name="M:HttpServer.Exceptions.InternalServerException.#ctor"> 312 <member name="P:HttpServer.Rules.RedirectRule.FromUrl">
335 <summary> 313 <summary>
336 Initializes a new instance of the <see cref="T:HttpServer.Exceptions.InternalServerException"/> class. 314 Gets string to match request URI with.
337 </summary> 315 </summary>
316 <remarks>Is compared to request.Uri.AbsolutePath</remarks>
338 </member> 317 </member>
339 <member name="M:HttpServer.Exceptions.InternalServerException.#ctor(System.String)"> 318 <member name="P:HttpServer.Rules.RedirectRule.ToUrl">
340 <summary> 319 <summary>
341 Initializes a new instance of the <see cref="T:HttpServer.Exceptions.InternalServerException"/> class. 320 Gets where to redirect.
342 </summary> 321 </summary>
343 <param name="message">error message.</param>
344 </member> 322 </member>
345 <member name="M:HttpServer.Exceptions.InternalServerException.#ctor(System.String,System.Exception)"> 323 <member name="P:HttpServer.Rules.RedirectRule.ShouldRedirect">
346 <summary> 324 <summary>
347 Initializes a new instance of the <see cref="T:HttpServer.Exceptions.InternalServerException"/> class. 325 Gets whether server should redirect client.
348 </summary> 326 </summary>
349 <param name="message">error message.</param> 327 <remarks>
350 <param name="inner">inner exception.</param> 328 <c>false</c> means that the rule will replace
329 the current request URI with the new one from this class.
330 <c>true</c> means that a redirect response is sent to the client.
331 </remarks>
351 </member> 332 </member>
352 <member name="T:HttpServer.Sessions.MemorySessionStore"> 333 <member name="M:HttpServer.Rules.RegexRedirectRule.#ctor(System.String,System.String)">
353 <summary> 334 <summary>
354 Session store using memory for each session. 335 Initializes a new instance of the <see cref="T:HttpServer.Rules.RegexRedirectRule"/> class.
355 </summary> 336 </summary>
337 <param name="fromUrlExpression">Expression to match URL</param>
338 <param name="toUrlExpression">Expression to generate URL</param>
339 <example>
340 <![CDATA[
341 server.Add(new RegexRedirectRule("/(?<first>[a-zA-Z0-9]+)", "/user/${first}"));
342 Result of ie. /employee1 will then be /user/employee1
343 ]]>
344 </example>
356 </member> 345 </member>
357 <member name="T:HttpServer.Sessions.IHttpSessionStore"> 346 <member name="M:HttpServer.Rules.RegexRedirectRule.#ctor(System.String,System.String,System.Text.RegularExpressions.RegexOptions)">
358 <summary> 347 <summary>
359 A session store is used to store and load sessions on a media. 348 Initializes a new instance of the <see cref="T:HttpServer.Rules.RegexRedirectRule"/> class.
360 The default implementation (<see cref="T:HttpServer.Sessions.MemorySessionStore"/>) saves/retrieves sessions from memory.
361 </summary> 349 </summary>
350 <param name="fromUrlExpression">Expression to match URL</param>
351 <param name="toUrlExpression">Expression to generate URL</param>
352 <param name="options">Regular expression options to use, can be null</param>
353 <example>
354 <![CDATA[
355 server.Add(new RegexRedirectRule("/(?<first>[a-zA-Z0-9]+)", "/user/{first}", RegexOptions.IgnoreCase));
356 Result of ie. /employee1 will then be /user/employee1
357 ]]>
358 </example>
362 </member> 359 </member>
363 <member name="M:HttpServer.Sessions.IHttpSessionStore.Create"> 360 <member name="M:HttpServer.Rules.RegexRedirectRule.#ctor(System.String,System.String,System.Text.RegularExpressions.RegexOptions,System.Boolean)">
364 <summary> 361 <summary>
365 Creates a new http session with a generated id. 362 Initializes a new instance of the <see cref="T:HttpServer.Rules.RegexRedirectRule"/> class.
366 </summary> 363 </summary>
367 <returns>A <see cref="T:HttpServer.Sessions.IHttpSession"/> object</returns> 364 <param name="fromUrlExpression">Expression to match URL</param>
365 <param name="toUrlExpression">Expression to generate URL</param>
366 <param name="options">Regular expression options to apply</param>
367 <param name="shouldRedirect"><c>true</c> if request should be redirected, <c>false</c> if the request URI should be replaced.</param>
368 <example>
369 <![CDATA[
370 server.Add(new RegexRedirectRule("/(?<first>[a-zA-Z0-9]+)", "/user/${first}", RegexOptions.None));
371 Result of ie. /employee1 will then be /user/employee1
372 ]]>
373 </example>
374 <exception cref="T:System.ArgumentNullException">Argument is null.</exception>
375 <seealso cref="P:HttpServer.Rules.RedirectRule.ShouldRedirect"/>
368 </member> 376 </member>
369 <member name="M:HttpServer.Sessions.IHttpSessionStore.Create(System.String)"> 377 <member name="M:HttpServer.Rules.RegexRedirectRule.Process(HttpServer.IHttpRequest,HttpServer.IHttpResponse)">
370 <summary> 378 <summary>
371 Creates a new http session with a specific id 379 Process the incoming request.
372 </summary> 380 </summary>
373 <param name="id">Id used to identify the new cookie..</param> 381 <param name="request">incoming HTTP request</param>
374 <returns>A <see cref="T:HttpServer.Sessions.IHttpSession"/> object.</returns> 382 <param name="response">outgoing HTTP response</param>
383 <returns>true if response should be sent to the browser directly (no other rules or modules will be processed).</returns>
375 <remarks> 384 <remarks>
376 Id should be generated by the store implementation if it's null or <see cref="F:System.String.Empty"/>. 385 returning true means that no modules will get the request. Returning true is typically being done
386 for redirects.
377 </remarks> 387 </remarks>
388 <exception cref="T:System.ArgumentNullException">If request or response is null</exception>
378 </member> 389 </member>
379 <member name="M:HttpServer.Sessions.IHttpSessionStore.Load(System.String)"> 390 <member name="T:HttpServer.ExceptionHandler">
380 <summary>
381 Load an existing session.
382 </summary>
383 <param name="sessionId">Session id (usually retrieved from a client side cookie).</param>
384 <returns>A session if found; otherwise null.</returns>
385 </member>
386 <member name="M:HttpServer.Sessions.IHttpSessionStore.Save(HttpServer.Sessions.IHttpSession)">
387 <summary>
388 Save an updated session to the store.
389 </summary>
390 <param name="session">Session id (usually retrieved from a client side cookie).</param>
391 <exception cref="T:System.ArgumentException">If Id property have not been specified.</exception>
392 </member>
393 <member name="M:HttpServer.Sessions.IHttpSessionStore.AddUnused(HttpServer.Sessions.IHttpSession)">
394 <summary>
395 We use the flyweight pattern which reuses small objects
396 instead of creating new each time.
397 </summary>
398 <param name="session">Unused session that should be reused next time Create is called.</param>
399 </member>
400 <member name="M:HttpServer.Sessions.IHttpSessionStore.Cleanup">
401 <summary> 391 <summary>
402 Remove expired sessions 392 We dont want to let the server to die due to exceptions thrown in worker threads.
393 therefore we use this delegate to give you a change to handle uncaught exceptions.
403 </summary> 394 </summary>
395 <param name="source">Class that the exception was thrown in.</param>
396 <param name="exception">Exception</param>
397 <remarks>
398 Server will throw a InternalServerException in release version if you dont
399 handle this delegate.
400 </remarks>
404 </member> 401 </member>
405 <member name="M:HttpServer.Sessions.IHttpSessionStore.Remove(System.String)"> 402 <member name="T:HttpServer.Authentication.AuthenticationHandler">
406 <summary> 403 <summary>
407 Remove a session 404 Delegate used to let authentication modules authenticate the user name and password.
408 </summary> 405 </summary>
409 <param name="sessionId">id of the session.</param> 406 <param name="realm">Realm that the user want to authenticate in</param>
407 <param name="userName">User name specified by client</param>
408 <param name="token">Can either be user password or implementation specific token.</param>
409 <param name="login">object that will be stored in a session variable called <see cref="F:HttpServer.Authentication.AuthenticationModule.AuthenticationTag"/> if authentication was successful.</param>
410 <exception cref="T:HttpServer.Exceptions.ForbiddenException">throw forbidden exception if too many attempts have been made.</exception>
411 <remarks>
412 <para>
413 Use <see cref="P:HttpServer.Authentication.DigestAuthentication.TokenIsHA1"/> to specify that the token is a HA1 token. (MD5 generated
414 string from realm, user name and password); Md5String(userName + ":" + realm + ":" + password);
415 </para>
416 </remarks>
410 </member> 417 </member>
411 <member name="P:HttpServer.Sessions.IHttpSessionStore.Item(System.String)"> 418 <member name="T:HttpServer.Authentication.AuthenticationRequiredHandler">
412 <summary> 419 <summary>
413 Load a session from the store 420 Let's you decide on a system level if authentication is required.
414 </summary> 421 </summary>
415 <param name="sessionId"></param> 422 <param name="request">HTTP request from client</param>
416 <returns>null if session is not found.</returns> 423 <returns>true if user should be authenticated.</returns>
424 <remarks>throw <see cref="T:HttpServer.Exceptions.ForbiddenException"/> if no more attempts are allowed.</remarks>
425 <exception cref="T:HttpServer.Exceptions.ForbiddenException">If no more attempts are allowed</exception>
417 </member> 426 </member>
418 <member name="P:HttpServer.Sessions.IHttpSessionStore.ExpireTime"> 427 <member name="T:HttpServer.Sessions.IHttpSession">
419 <summary> 428 <summary>
420 Number of minutes before a session expires. 429 Interface for sessions
421 </summary> 430 </summary>
422 <value>Default time is 20 minutes.</value>
423 </member> 431 </member>
424 <member name="M:HttpServer.Sessions.MemorySessionStore.#ctor"> 432 <member name="M:HttpServer.Sessions.IHttpSession.Clear">
425 <summary> 433 <summary>
426 Initializes the class setting the expirationtimer to clean the session every minute 434 Remove everything from the session
427 </summary> 435 </summary>
428 </member> 436 </member>
429 <member name="M:HttpServer.Sessions.MemorySessionStore.Cleanup(System.Object)"> 437 <member name="M:HttpServer.Sessions.IHttpSession.Clear(System.Boolean)">
430 <summary> 438 <summary>
431 Delegate for the cleanup timer 439 Remove everything from the session
432 </summary> 440 </summary>
441 <param name="expires">True if the session is cleared due to expiration</param>
433 </member> 442 </member>
434 <member name="M:HttpServer.Sessions.MemorySessionStore.Create"> 443 <member name="P:HttpServer.Sessions.IHttpSession.Id">
435 <summary> 444 <summary>
436 Creates a new http session 445 Session id
437 </summary> 446 </summary>
438 <returns></returns>
439 </member> 447 </member>
440 <member name="M:HttpServer.Sessions.MemorySessionStore.Create(System.String)"> 448 <member name="P:HttpServer.Sessions.IHttpSession.Item(System.String)">
441 <summary> 449 <summary>
442 Creates a new http session with a specific id 450 Should
443 </summary> 451 </summary>
444 <param name="id">Id used to identify the new cookie..</param> 452 <param name="name">Name of the session variable</param>
445 <returns>A <see cref="T:HttpServer.Sessions.IHttpSession"/> object.</returns> 453 <returns>null if it's not set</returns>
446 <remarks> 454 <exception cref="T:System.Runtime.Serialization.SerializationException">If the object cant be serialized.</exception>
447 Id should be generated by the store implementation if it's null or <see cref="F:System.String.Empty"/>.
448 </remarks>
449 </member> 455 </member>
450 <member name="M:HttpServer.Sessions.MemorySessionStore.Load(System.String)"> 456 <member name="P:HttpServer.Sessions.IHttpSession.Accessed">
451 <summary> 457 <summary>
452 Load an existing session. 458 When the session was last accessed.
459 This property is touched by the http server each time the
460 session is requested.
453 </summary> 461 </summary>
454 <param name="sessionId"></param>
455 <returns></returns>
456 </member> 462 </member>
457 <member name="M:HttpServer.Sessions.MemorySessionStore.Save(HttpServer.Sessions.IHttpSession)"> 463 <member name="P:HttpServer.Sessions.IHttpSession.Count">
458 <summary> 464 <summary>
459 Save an updated session to the store. 465 Number of session variables.
460 </summary> 466 </summary>
461 <param name="session"></param>
462 </member> 467 </member>
463 <member name="M:HttpServer.Sessions.MemorySessionStore.AddUnused(HttpServer.Sessions.IHttpSession)"> 468 <member name="E:HttpServer.Sessions.IHttpSession.BeforeClear">
464 <summary> 469 <summary>
465 We use the flyweight pattern which reuses small objects 470 Event triggered upon clearing the session
466 instead of creating new each time.
467 </summary> 471 </summary>
468 <param name="session">EmptyLanguageNode (unused) session that should be reused next time Create is called.</param>
469 </member> 472 </member>
470 <member name="M:HttpServer.Sessions.MemorySessionStore.Cleanup"> 473 <member name="T:HttpServer.Sessions.HttpSessionClearedArgs">
471 <summary> 474 <summary>
472 Remove expired sessions 475 Arguments sent when a <see cref="T:HttpServer.Sessions.IHttpSession"/> is cleared
473 </summary> 476 </summary>
474 </member> 477 </member>
475 <member name="M:HttpServer.Sessions.MemorySessionStore.Remove(System.String)"> 478 <member name="M:HttpServer.Sessions.HttpSessionClearedArgs.#ctor(System.Boolean)">
476 <summary> 479 <summary>
477 Remove a session 480 Instantiates the arguments for the event
478 </summary> 481 </summary>
479 <param name="sessionId">id of the session.</param> 482 <param name="expired">True if the session is cleared due to expiration</param>
480 </member> 483 </member>
481 <member name="P:HttpServer.Sessions.MemorySessionStore.Item(System.String)"> 484 <member name="P:HttpServer.Sessions.HttpSessionClearedArgs.Expired">
482 <summary> 485 <summary>
483 Load a session from the store 486 Returns true if the session is cleared due to expiration
484 </summary> 487 </summary>
485 <param name="sessionId"></param>
486 <returns>null if session is not found.</returns>
487 </member> 488 </member>
488 <member name="P:HttpServer.Sessions.MemorySessionStore.ExpireTime"> 489 <member name="T:HttpServer.Sessions.HttpSessionClearedHandler">
489 <summary> 490 <summary>
490 Number of minutes before a session expires. 491 Delegate for when a IHttpSession is cleared
491 Default is 20 minutes.
492 </summary> 492 </summary>
493 <param name="session"><see cref="T:HttpServer.Sessions.IHttpSession"/> this is being cleared.</param>
494 <param name="args">Arguments for the clearing</param>
493 </member> 495 </member>
494 <member name="T:HttpServer.ResponseCookies"> 496 <member name="T:HttpServer.ResponseCookies">
495 <summary> 497 <summary>
@@ -541,35 +543,29 @@
541 Gets the cookie of a given identifier (null if not existing). 543 Gets the cookie of a given identifier (null if not existing).
542 </summary> 544 </summary>
543 </member> 545 </member>
544 <member name="T:HttpServer.Check"> 546 <member name="T:HttpServer.RequestParserFactory">
545 <summary> 547 <summary>
546 Small design by contract implementation. 548 Creates request parsers when needed.
547 </summary> 549 </summary>
548 </member> 550 </member>
549 <member name="M:HttpServer.Check.NotEmpty(System.String,System.String)"> 551 <member name="T:HttpServer.IRequestParserFactory">
550 <summary> 552 <summary>
551 Check whether a parameter is empty. 553 Creates request parsers when needed.
552 </summary> 554 </summary>
553 <param name="value">Parameter value</param>
554 <param name="parameterOrErrorMessage">Parameter name, or error description.</param>
555 <exception cref="T:System.ArgumentException">value is empty.</exception>
556 </member> 555 </member>
557 <member name="M:HttpServer.Check.Require(System.Object,System.String)"> 556 <member name="M:HttpServer.IRequestParserFactory.CreateParser(HttpServer.ILogWriter)">
558 <summary> 557 <summary>
559 Checks whether a parameter is null. 558 Create a new request parser.
560 </summary> 559 </summary>
561 <param name="value">Parameter value</param> 560 <param name="logWriter">Used when logging should be enabled.</param>
562 <param name="parameterOrErrorMessage">Parameter name, or error description.</param> 561 <returns>A new request parser.</returns>
563 <exception cref="T:System.ArgumentNullException">value is null.</exception>
564 </member> 562 </member>
565 <member name="M:HttpServer.Check.Min(System.Int32,System.Object,System.String)"> 563 <member name="M:HttpServer.RequestParserFactory.CreateParser(HttpServer.ILogWriter)">
566 <summary> 564 <summary>
567 Checks whether a parameter is null. 565 Create a new request parser.
568 </summary> 566 </summary>
569 <param name="minValue"></param> 567 <param name="logWriter">Used when logging should be enabled.</param>
570 <param name="value">Parameter value</param> 568 <returns>A new request parser.</returns>
571 <param name="parameterOrErrorMessage">Parameter name, or error description.</param>
572 <exception cref="T:System.ArgumentException">value is null.</exception>
573 </member> 569 </member>
574 <member name="T:HttpServer.Parser.HttpRequestParser"> 570 <member name="T:HttpServer.Parser.HttpRequestParser">
575 <summary> 571 <summary>
@@ -707,33 +703,20 @@
707 A header have been received. 703 A header have been received.
708 </summary> 704 </summary>
709 </member> 705 </member>
710 <member name="T:HttpServer.HttpModules.WebSiteModule"> 706 <member name="T:HttpServer.HttpModules.HttpModuleExceptionEventArgs">
711 <summary> 707 <summary>
712 The website module let's you handle multiple websites in the same server. 708 Used to inform http server that
713 It uses the "Host" header to check which site you want.
714 </summary> 709 </summary>
715 <remarks>It's recommended that you do not
716 add any other modules to HttpServer if you are using the website module. Instead,
717 add all wanted modules to each website.</remarks>
718 </member> 710 </member>
719 <member name="M:HttpServer.HttpModules.WebSiteModule.#ctor(System.String,System.String)"> 711 <member name="M:HttpServer.HttpModules.HttpModuleExceptionEventArgs.#ctor(System.Exception)">
720 <summary>
721
722 </summary>
723 <param name="host">domain name that should be handled.</param>
724 <param name="name"></param>
725 </member>
726 <member name="M:HttpServer.HttpModules.WebSiteModule.Process(HttpServer.IHttpRequest,HttpServer.IHttpResponse,HttpServer.Sessions.IHttpSession)">
727 <summary> 712 <summary>
728 Method that process the url 713 Eventarguments used when an exception is thrown by a module
729 </summary> 714 </summary>
730 <param name="request">Information sent by the browser about the request</param> 715 <param name="e">the exception</param>
731 <param name="response">Information that is being sent back to the client.</param>
732 <param name="session">Session used to </param>
733 </member> 716 </member>
734 <member name="P:HttpServer.HttpModules.WebSiteModule.SiteName"> 717 <member name="P:HttpServer.HttpModules.HttpModuleExceptionEventArgs.Exception">
735 <summary> 718 <summary>
736 Name of site. 719 Exception thrown in a module
737 </summary> 720 </summary>
738 </member> 721 </member>
739 <member name="T:HttpServer.HttpForm"> 722 <member name="T:HttpServer.HttpForm">
@@ -927,76 +910,489 @@
927 </summary> 910 </summary>
928 <returns>0 if no files are added</returns> 911 <returns>0 if no files are added</returns>
929 </member> 912 </member>
930 <member name="T:HttpServer.Exceptions.BadRequestException"> 913 <member name="T:HttpServer.FormDecoders.IFormDecoder">
914 <summary>
915 Interface for form content decoders.
916 </summary>
917 </member>
918 <member name="M:HttpServer.FormDecoders.IFormDecoder.Decode(System.IO.Stream,System.String,System.Text.Encoding)">
931 <summary> 919 <summary>
932 The request could not be understood by the server due to malformed syntax.
933 The client SHOULD NOT repeat the request without modifications.
934 920
935 Text taken from: http://www.submissionchamber.com/help-guides/error-codes.php
936 </summary> 921 </summary>
922 <param name="stream">Stream containing the content</param>
923 <param name="contentType">Content type (with any additional info like boundry). Content type is always supplied in lower case</param>
924 <param name="encoding">Stream enconding</param>
925 <returns>A http form, or null if content could not be parsed.</returns>
926 <exception cref="T:System.IO.InvalidDataException">If contents in the stream is not valid input data.</exception>
937 </member> 927 </member>
938 <member name="M:HttpServer.Exceptions.BadRequestException.#ctor(System.String)"> 928 <member name="M:HttpServer.FormDecoders.IFormDecoder.CanParse(System.String)">
939 <summary> 929 <summary>
940 Create a new bad request exception. 930 Checks if the decoder can handle the mime type
941 </summary> 931 </summary>
942 <param name="errMsg">reason to why the request was bad.</param> 932 <param name="contentType">Content type (with any additional info like boundry). Content type is always supplied in lower case.</param>
933 <returns>True if the decoder can parse the specified content type</returns>
943 </member> 934 </member>
944 <member name="M:HttpServer.Exceptions.BadRequestException.#ctor(System.String,System.Exception)"> 935 <member name="T:HttpServer.ContentType">
945 <summary> 936 <summary>
946 Create a new bad request exception. 937 Lists content type mime types.
947 </summary> 938 </summary>
948 <param name="errMsg">reason to why the request was bad.</param>
949 <param name="inner">inner exception</param>
950 </member> 939 </member>
951 <member name="T:HttpServer.Sessions.MemorySession"> 940 <member name="F:HttpServer.ContentType.Text">
952 <summary> 941 <summary>
953 A session stored in memory. 942 text/plain
954 </summary> 943 </summary>
955 </member> 944 </member>
956 <member name="T:HttpServer.Sessions.IHttpSession"> 945 <member name="F:HttpServer.ContentType.Html">
957 <summary> 946 <summary>
958 Interface for sessions 947 text/haml
959 </summary> 948 </summary>
960 </member> 949 </member>
961 <member name="M:HttpServer.Sessions.IHttpSession.Clear"> 950 <member name="F:HttpServer.ContentType.Javascript">
962 <summary> 951 <summary>
963 Remove everything from the session 952 content type for javascript documents = application/javascript
964 </summary> 953 </summary>
954 <remarks>
955 <para>
956 RFC 4329 states that text/javascript have been superseeded by
957 application/javascript. You might still want to check browser versions
958 since older ones do not support application/javascript.
959 </para>
960 <para>Browser support: http://krijnhoetmer.nl/stuff/javascript/mime-types/</para>
961 </remarks>
965 </member> 962 </member>
966 <member name="M:HttpServer.Sessions.IHttpSession.Clear(System.Boolean)"> 963 <member name="F:HttpServer.ContentType.Xml">
967 <summary> 964 <summary>
968 Remove everything from the session 965 text/xml
969 </summary> 966 </summary>
970 <param name="expires">True if the session is cleared due to expiration</param>
971 </member> 967 </member>
972 <member name="P:HttpServer.Sessions.IHttpSession.Id"> 968 <member name="T:HttpServer.ContentTypes">
973 <summary> 969 <summary>
974 Session id 970 A list of content types
975 </summary> 971 </summary>
976 </member> 972 </member>
977 <member name="P:HttpServer.Sessions.IHttpSession.Item(System.String)"> 973 <member name="M:HttpServer.ContentTypes.#ctor(System.String)">
978 <summary> 974 <summary>
979 Should 975
980 </summary> 976 </summary>
981 <param name="name">Name of the session variable</param> 977 <param name="types">Semicolon separated content types.</param>
982 <returns>null if it's not set</returns>
983 <exception cref="T:System.Runtime.Serialization.SerializationException">If the object cant be serialized.</exception>
984 </member> 978 </member>
985 <member name="P:HttpServer.Sessions.IHttpSession.Accessed"> 979 <member name="M:HttpServer.ContentTypes.GetEnumerator">
986 <summary> 980 <summary>
987 When the session was last accessed. 981 Returns an enumerator that iterates through a collection.
988 This property is touched by the http server each time the
989 session is requested.
990 </summary> 982 </summary>
983 <returns>
984 An <see cref="T:System.Collections.IEnumerator"/> object that can be used to iterate through the collection.
985 </returns>
991 </member> 986 </member>
992 <member name="P:HttpServer.Sessions.IHttpSession.Count"> 987 <member name="M:HttpServer.ContentTypes.Contains(System.String)">
993 <summary> 988 <summary>
994 Number of session variables. 989 Searches for the specified type
995 </summary> 990 </summary>
991 <param name="type">Can also be a part of a type (searching for "xml" would return true for "application/xml").</param>
992 <returns>true if type was found.</returns>
996 </member> 993 </member>
997 <member name="E:HttpServer.Sessions.IHttpSession.BeforeClear"> 994 <member name="P:HttpServer.ContentTypes.First">
998 <summary> 995 <summary>
999 Event triggered upon clearing the session 996 Get this first content type.
997 </summary>
998 </member>
999 <member name="P:HttpServer.ContentTypes.Item(System.String)">
1000 <summary>
1001 Fetch a content type
1002 </summary>
1003 <param name="type">Part of type ("xml" would return "application/xml")</param>
1004 <returns></returns>
1005 <remarks>All content types are in lower case.</remarks>
1006 </member>
1007 <member name="T:HttpServer.HttpModules.HttpModule">
1008 <summary>
1009 A HttpModule can be used to serve Uri's. The module itself
1010 decides if it should serve a Uri or not. In this way, you can
1011 get a very flexible http application since you can let multiple modules
1012 serve almost similar urls.
1013 </summary>
1014 <remarks>
1015 Throw <see cref="T:HttpServer.Exceptions.UnauthorizedException"/> if you are using a <see cref="T:HttpServer.Authentication.AuthenticationModule"/> and want to prompt for user name/password.
1016 </remarks>
1017 </member>
1018 <member name="M:HttpServer.HttpModules.HttpModule.Process(HttpServer.IHttpRequest,HttpServer.IHttpResponse,HttpServer.Sessions.IHttpSession)">
1019 <summary>
1020 Method that process the url
1021 </summary>
1022 <param name="request">Information sent by the browser about the request</param>
1023 <param name="response">Information that is being sent back to the client.</param>
1024 <param name="session">Session used to </param>
1025 <returns>true if this module handled the request.</returns>
1026 </member>
1027 <member name="M:HttpServer.HttpModules.HttpModule.SetLogWriter(HttpServer.ILogWriter)">
1028 <summary>
1029 Set the log writer to use.
1030 </summary>
1031 <param name="writer">logwriter to use.</param>
1032 </member>
1033 <member name="M:HttpServer.HttpModules.HttpModule.Write(HttpServer.LogPrio,System.String)">
1034 <summary>
1035 Log something.
1036 </summary>
1037 <param name="prio">importance of log message</param>
1038 <param name="message">message</param>
1039 </member>
1040 <member name="P:HttpServer.HttpModules.HttpModule.AllowSecondaryProcessing">
1041 <summary>
1042 If true specifies that the module doesn't consume the processing of a request so that subsequent modules
1043 can continue processing afterwards. Default is false.
1044 </summary>
1045 </member>
1046 <member name="T:HttpServer.Helpers.WebHelper">
1047 <summary>
1048 Webhelper provides helpers for common tasks in HTML.
1049 </summary>
1050 </member>
1051 <member name="F:HttpServer.Helpers.WebHelper.JSImplementation">
1052 <summary>
1053 Used to let the website use different javascript libraries.
1054 Default is <see cref="T:HttpServer.Helpers.Implementations.PrototypeImp"/>
1055 </summary>
1056 </member>
1057 <member name="M:HttpServer.Helpers.WebHelper.AjaxRequest(System.String,System.String,System.String[])">
1058 <summary>
1059 Creates a link that invokes through ajax.
1060 </summary>
1061 <param name="url">url to fetch</param>
1062 <param name="title">link title</param>
1063 <param name="options">
1064 optional options in format "key, value, key, value".
1065 Javascript options starts with ':'.
1066 </param>
1067 <returns>a link tag</returns>
1068 <example>
1069 WebHelper.AjaxRequest("/users/add/", "Add user", "method:", "post", "onclick", "validate('this');");
1070 </example>
1071 </member>
1072 <member name="M:HttpServer.Helpers.WebHelper.AjaxUpdater(System.String,System.String,System.String,System.String[])">
1073 <summary>
1074 Builds a link that updates an element with the fetched ajax content.
1075 </summary>
1076 <param name="url">Url to fetch content from</param>
1077 <param name="title">link title</param>
1078 <param name="targetId">html element to update with the results of the ajax request.</param>
1079 <param name="options">optional options in format "key, value, key, value"</param>
1080 <returns>A link tag.</returns>
1081 </member>
1082 <member name="M:HttpServer.Helpers.WebHelper.DialogLink(System.String,System.String,System.String[])">
1083 <summary>
1084 A link that pop ups a Dialog (overlay div)
1085 </summary>
1086 <param name="url">url to contents of dialog</param>
1087 <param name="title">link title</param>
1088 <param name="htmlAttributes">name/value of html attributes.</param>
1089 <returns>A "a"-tag that popups a dialog when clicked</returns>
1090 <example>
1091 WebHelper.DialogLink("/user/show/1", "show user", "onmouseover", "alert('booh!');");
1092 </example>
1093 </member>
1094 <member name="M:HttpServer.Helpers.WebHelper.CreateDialog(System.String,System.String,System.String[])">
1095 <summary>
1096 Create/Open a dialog box using ajax
1097 </summary>
1098 <param name="url"></param>
1099 <param name="title"></param>
1100 <param name="parameters"></param>
1101 <returns></returns>
1102 </member>
1103 <member name="M:HttpServer.Helpers.WebHelper.CloseDialog">
1104 <summary>
1105 Close a javascript dialog window/div.
1106 </summary>
1107 <returns>javascript for closing a dialog.</returns>
1108 <see cref="M:HttpServer.Helpers.WebHelper.DialogLink(System.String,System.String,System.String[])"/>
1109 </member>
1110 <member name="M:HttpServer.Helpers.WebHelper.FormStart(System.String,System.String,System.Boolean)">
1111 <summary>
1112 Create a &lt;form&gt; tag.
1113 </summary>
1114 <param name="name">name of form</param>
1115 <param name="action">action to invoke on submit</param>
1116 <param name="isAjax">form should be posted as ajax</param>
1117 <returns>html code</returns>
1118 <example>
1119 WebHelper.FormStart("frmLogin", "/user/login", Request.IsAjax);
1120 </example>
1121 </member>
1122 <member name="M:HttpServer.Helpers.WebHelper.Link(System.String,System.String,System.String[])">
1123 <summary>
1124 Create a link tag.
1125 </summary>
1126 <param name="url">url to go to</param>
1127 <param name="title">link title (text that is displayed)</param>
1128 <param name="htmlAttributes">html attributes, name, value, name, value</param>
1129 <returns>html code</returns>
1130 <example>
1131 WebHelper.Link("/user/show/1", "Show user", "id", "showUser", "onclick", "return confirm('Are you shure?');");
1132 </example>
1133 </member>
1134 <member name="M:HttpServer.Helpers.WebHelper.BuildLink(System.String,System.String,System.String[])">
1135 <summary>
1136 Build a link
1137 </summary>
1138 <param name="url">url to go to.</param>
1139 <param name="title">title of link (displayed text)</param>
1140 <param name="htmlAttributes">extra html attributes.</param>
1141 <returns>a complete link</returns>
1142 </member>
1143 <member name="M:HttpServer.Helpers.WebHelper.BuildLink(System.String,System.String,System.String[],System.String[])">
1144 <summary>
1145 Build a link
1146 </summary>
1147 <param name="url">url to go to.</param>
1148 <param name="title">title of link (displayed text)</param>
1149 <param name="htmlAttributes">extra html attributes.</param>
1150 <returns>a complete link</returns>
1151 <param name="options">more options</param>
1152 </member>
1153 <member name="M:HttpServer.Helpers.WebHelper.Select(System.String,System.Collections.ICollection,HttpServer.Helpers.GetIdTitle,System.Object,System.Boolean)">
1154 <summary>
1155 Obsolete
1156 </summary>
1157 <param name="name">Obsolete</param>
1158 <param name="collection">Obsolete</param>
1159 <param name="getIdTitle">Obsolete</param>
1160 <param name="selectedValue">Obsolete</param>
1161 <param name="firstEmpty">Obsolete</param>
1162 <returns>Obsolete</returns>
1163 </member>
1164 <member name="M:HttpServer.Helpers.WebHelper.Select(System.String,System.String,System.Collections.ICollection,HttpServer.Helpers.GetIdTitle,System.Object,System.Boolean)">
1165 <summary>
1166 Obsolete
1167 </summary>
1168 <param name="name">Obsolete</param>
1169 <param name="id">Obsolete</param>
1170 <param name="collection">Obsolete</param>
1171 <param name="getIdTitle">Obsolete</param>
1172 <param name="selectedValue">Obsolete</param>
1173 <param name="firstEmpty">Obsolete</param>
1174 <returns>Obsolete</returns>
1175 </member>
1176 <member name="M:HttpServer.Helpers.WebHelper.List(System.Collections.Generic.IEnumerable{System.Object},System.String)">
1177 <summary>
1178 Render errors into a UL with class "errors"
1179 </summary>
1180 <param name="className">class used by UL-tag.</param>
1181 <param name="theList">items to list</param>
1182 <returns>an unordered html list.</returns>
1183 </member>
1184 <member name="M:HttpServer.Helpers.WebHelper.List(System.Collections.Specialized.NameValueCollection,System.String)">
1185 <summary>
1186 Render errors into a UL with class "errors"
1187 </summary>
1188 <param name="className">class used by UL-tag.</param>
1189 <param name="theList">items to list</param>
1190 <returns>an unordered html list.</returns>
1191 </member>
1192 <member name="M:HttpServer.Helpers.WebHelper.Errors(System.Collections.Specialized.NameValueCollection)">
1193 <summary>
1194 Render errors into a UL with class "errors"
1195 </summary>
1196 <param name="errors"></param>
1197 <returns></returns>
1198 </member>
1199 <member name="M:HttpServer.Helpers.WebHelper.GenerateHtmlAttributes(System.Text.StringBuilder,System.String[],System.String[])">
1200 <summary>
1201 Generates a list with html attributes.
1202 </summary>
1203 <param name="sb">StringBuilder that the options should be added to.</param>
1204 <param name="firstOptions">attributes set by user.</param>
1205 <param name="secondOptions">attributes set by any of the helper classes.</param>
1206 </member>
1207 <member name="M:HttpServer.Helpers.WebHelper.GenerateHtmlAttributes(System.Text.StringBuilder,System.String[])">
1208 <summary>
1209 Generates a list with html attributes.
1210 </summary>
1211 <param name="sb">StringBuilder that the options should be added to.</param>
1212 <param name="options"></param>
1213 </member>
1214 <member name="T:HttpServer.Helpers.JavascriptHelperImplementation">
1215 <summary>
1216 Purpose of this class is to create a javascript toolkit independent javascript helper.
1217 </summary>
1218 </member>
1219 <member name="M:HttpServer.Helpers.JavascriptHelperImplementation.GenerateOptions(System.Text.StringBuilder,System.String[],System.Boolean)">
1220 <summary>
1221 Generates a list with JS options.
1222 </summary>
1223 <param name="sb">StringBuilder that the options should be added to.</param>
1224 <param name="options">the javascript options. name, value pairs. each string value should be escaped by YOU!</param>
1225 <param name="startWithComma">true if we should start with a comma.</param>
1226 </member>
1227 <member name="M:HttpServer.Helpers.JavascriptHelperImplementation.RemoveJavascriptOptions(System.String[])">
1228 <summary>
1229 Removes any javascript parameters from an array of parameters
1230 </summary>
1231 <param name="options">The array of parameters to remove javascript params from</param>
1232 <returns>An array of html parameters</returns>
1233 </member>
1234 <member name="M:HttpServer.Helpers.JavascriptHelperImplementation.AjaxFormOnSubmit(System.String[])">
1235 <summary>
1236 javascript action that should be added to the "onsubmit" event in the form tag.
1237 </summary>
1238 <returns></returns>
1239 <remarks>All javascript option names should end with colon.</remarks>
1240 <example>
1241 <code>
1242 JSHelper.AjaxRequest("/user/show/1", "onsuccess:", "$('userInfo').update(result);");
1243 </code>
1244 </example>
1245 </member>
1246 <member name="M:HttpServer.Helpers.JavascriptHelperImplementation.AjaxRequest(System.String,System.String[])">
1247 <summary>
1248 Requests a url through ajax
1249 </summary>
1250 <param name="url">url to fetch</param>
1251 <param name="options">optional options in format "key, value, key, value", used in JS request object.</param>
1252 <returns>a link tag</returns>
1253 <remarks>All javascript option names should end with colon.</remarks>
1254 <example>
1255 <code>
1256 JSHelper.AjaxRequest("/user/show/1", "onsuccess:", "$('userInfo').update(result);");
1257 </code>
1258 </example>
1259 </member>
1260 <member name="M:HttpServer.Helpers.JavascriptHelperImplementation.AjaxUpdater(System.String,System.String,System.String[])">
1261 <summary>
1262 Ajax requests that updates an element with
1263 the fetched content
1264 </summary>
1265 <param name="url">Url to fetch content from</param>
1266 <param name="targetId">element to update</param>
1267 <param name="options">optional options in format "key, value, key, value", used in JS updater object.</param>
1268 <returns>A link tag.</returns>
1269 <remarks>All javascript option names should end with colon.</remarks>
1270 <example>
1271 <code>
1272 JSHelper.AjaxUpdater("/user/show/1", "userInfo", "onsuccess:", "alert('Successful!');");
1273 </code>
1274 </example>
1275 </member>
1276 <member name="M:HttpServer.Helpers.JavascriptHelperImplementation.DialogLink(System.String,System.String,System.String[])">
1277 <summary>
1278 A link that pop ups a Dialog (overlay div)
1279 </summary>
1280 <param name="url">url to contents of dialog</param>
1281 <param name="title">link title</param>
1282 <returns>A "a"-tag that popups a dialog when clicked</returns>
1283 <param name="htmlAttributes">name/value of html attributes</param>
1284 <example>
1285 WebHelper.DialogLink("/user/show/1", "show user", "onmouseover", "alert('booh!');");
1286 </example>
1287 </member>
1288 <member name="M:HttpServer.Helpers.JavascriptHelperImplementation.CloseDialog">
1289 <summary>
1290 Close a javascript dialog window/div.
1291 </summary>
1292 <returns>javascript for closing a dialog.</returns>
1293 <see cref="M:HttpServer.Helpers.JavascriptHelperImplementation.DialogLink(System.String,System.String,System.String[])"/>
1294 </member>
1295 <member name="M:HttpServer.Helpers.JavascriptHelperImplementation.CreateDialog(System.String,System.String,System.String[])">
1296 <summary>
1297 Creates a new modal dialog window
1298 </summary>
1299 <param name="url">url to open in window.</param>
1300 <param name="title">window title (may not be supported by all js implementations)</param>
1301 <param name="options"></param>
1302 <returns></returns>
1303 </member>
1304 <member name="T:HttpServer.IHttpContextHandler">
1305 <summary>
1306 Class that receives Requests from a <see cref="T:HttpServer.IHttpClientContext"/>.
1307 </summary>
1308 </member>
1309 <member name="M:HttpServer.IHttpContextHandler.ClientDisconnected(HttpServer.IHttpClientContext,System.Net.Sockets.SocketError)">
1310 <summary>
1311 Client have been disconnected.
1312 </summary>
1313 <param name="client">Client that was disconnected.</param>
1314 <param name="error">Reason</param>
1315 <see cref="T:HttpServer.IHttpClientContext"/>
1316 </member>
1317 <member name="M:HttpServer.IHttpContextHandler.RequestReceived(HttpServer.IHttpClientContext,HttpServer.IHttpRequest)">
1318 <summary>
1319 Invoked when a client context have received a new HTTP request
1320 </summary>
1321 <param name="client">Client that received the request.</param>
1322 <param name="request">Request that was received.</param>
1323 <see cref="T:HttpServer.IHttpClientContext"/>
1324 </member>
1325 <member name="T:HttpServer.HttpHelper">
1326 <summary>
1327 Generic helper functions for HTTP
1328 </summary>
1329 </member>
1330 <member name="F:HttpServer.HttpHelper.HTTP10">
1331 <summary>
1332 Version string for HTTP v1.0
1333 </summary>
1334 </member>
1335 <member name="F:HttpServer.HttpHelper.HTTP11">
1336 <summary>
1337 Version string for HTTP v1.1
1338 </summary>
1339 </member>
1340 <member name="F:HttpServer.HttpHelper.EmptyUri">
1341 <summary>
1342 An empty URI
1343 </summary>
1344 </member>
1345 <member name="M:HttpServer.HttpHelper.ParseQueryString(System.String)">
1346 <summary>
1347 Parses a query string.
1348 </summary>
1349 <param name="queryString">Query string (URI encoded)</param>
1350 <returns>A <see cref="T:HttpServer.HttpInput"/> object if successful; otherwise <see cref="F:HttpServer.HttpInput.Empty"/></returns>
1351 <exception cref="T:System.ArgumentNullException"><c>queryString</c> is null.</exception>
1352 <exception cref="T:System.FormatException">If string cannot be parsed.</exception>
1353 </member>
1354 <member name="T:HttpServer.FormDecoders.FormDecoderProvider">
1355 <summary>
1356 This provider is used to let us implement any type of form decoding we want without
1357 having to rewrite anything else in the server.
1358 </summary>
1359 </member>
1360 <member name="M:HttpServer.FormDecoders.FormDecoderProvider.Decode(System.String,System.IO.Stream,System.Text.Encoding)">
1361 <summary>
1362
1363 </summary>
1364 <param name="contentType">Should contain boundary and type, as in: multipart/form-data; boundary=---------------------------230051238959</param>
1365 <param name="stream">Stream containing form data.</param>
1366 <param name="encoding">Encoding used when decoding the stream</param>
1367 <returns><see cref="F:HttpServer.HttpInput.Empty"/> if no parser was found.</returns>
1368 <exception cref="T:System.ArgumentException">If stream is null or not readable.</exception>
1369 <exception cref="T:System.IO.InvalidDataException">If stream contents cannot be decoded properly.</exception>
1370 </member>
1371 <member name="M:HttpServer.FormDecoders.FormDecoderProvider.Add(HttpServer.FormDecoders.IFormDecoder)">
1372 <summary>
1373 Add a decoder.
1374 </summary>
1375 <param name="decoder"></param>
1376 <exception cref="T:System.ArgumentNullException"></exception>
1377 </member>
1378 <member name="P:HttpServer.FormDecoders.FormDecoderProvider.Count">
1379 <summary>
1380 Number of added decoders.
1381 </summary>
1382 </member>
1383 <member name="P:HttpServer.FormDecoders.FormDecoderProvider.Decoders">
1384 <summary>
1385 Use with care.
1386 </summary>
1387 </member>
1388 <member name="P:HttpServer.FormDecoders.FormDecoderProvider.DefaultDecoder">
1389 <summary>
1390 Decoder used for unknown content types.
1391 </summary>
1392 </member>
1393 <member name="T:HttpServer.Sessions.MemorySession">
1394 <summary>
1395 A session stored in memory.
1000 </summary> 1396 </summary>
1001 </member> 1397 </member>
1002 <member name="M:HttpServer.Sessions.MemorySession.#ctor(System.String)"> 1398 <member name="M:HttpServer.Sessions.MemorySession.#ctor(System.String)">
@@ -1064,113 +1460,624 @@
1064 Event triggered upon clearing the session 1460 Event triggered upon clearing the session
1065 </summary> 1461 </summary>
1066 </member> 1462 </member>
1067 <member name="T:HttpServer.Rules.RedirectRule"> 1463 <member name="T:HttpServer.FormDecoders.XmlDecoder">
1068 <summary> 1464 <summary>
1069 redirects from one URL to another. 1465 This decoder converts XML documents to form items.
1466 Each element becomes a subitem in the form, and each attribute becomes an item.
1070 </summary> 1467 </summary>
1468 <example>
1469 // xml: <hello id="1">something<world id="2">data</world></hello>
1470 // result:
1471 // form["hello"].Value = "something"
1472 // form["hello"]["id"].Value = 1
1473 // form["hello"]["world]["id"].Value = 1
1474 // form["hello"]["world"].Value = "data"
1475 </example>
1476 <remarks>
1477 The original xml document is stored in form["__xml__"].Value.
1478 </remarks>
1071 </member> 1479 </member>
1072 <member name="T:HttpServer.Rules.IRule"> 1480 <member name="M:HttpServer.FormDecoders.XmlDecoder.Decode(System.IO.Stream,System.String,System.Text.Encoding)">
1073 <summary> 1481 <summary>
1074 Rules are used to perform operations before a request is being handled. 1482
1075 Rules can be used to create routing etc.
1076 </summary> 1483 </summary>
1484 <param name="stream">Stream containing the content</param>
1485 <param name="contentType">Content type (with any additional info like boundry). Content type is always supplied in lower case</param>
1486 <param name="encoding">Stream encoding</param>
1487 Note: contentType and encoding are not used?
1488 <returns>A http form, or null if content could not be parsed.</returns>
1489 <exception cref="T:System.IO.InvalidDataException"></exception>
1077 </member> 1490 </member>
1078 <member name="M:HttpServer.Rules.IRule.Process(HttpServer.IHttpRequest,HttpServer.IHttpResponse)"> 1491 <member name="M:HttpServer.FormDecoders.XmlDecoder.TraverseNode(HttpServer.IHttpInput,System.Xml.XmlNode)">
1079 <summary> 1492 <summary>
1080 Process the incoming request. 1493 Recursive function that will go through an xml element and store it's content
1494 to the form item.
1081 </summary> 1495 </summary>
1082 <param name="request">incoming HTTP request</param> 1496 <param name="item">(parent) Item in form that content should be added to.</param>
1083 <param name="response">outgoing HTTP response</param> 1497 <param name="node">Node that should be parsed.</param>
1084 <returns>true if response should be sent to the browser directly (no other rules or modules will be processed).</returns>
1085 <remarks>
1086 returning true means that no modules will get the request. Returning true is typically being done
1087 for redirects.
1088 </remarks>
1089 <exception cref="T:System.ArgumentNullException">If request or response is null.</exception>
1090 </member> 1498 </member>
1091 <member name="M:HttpServer.Rules.RedirectRule.#ctor(System.String,System.String)"> 1499 <member name="M:HttpServer.FormDecoders.XmlDecoder.CanParse(System.String)">
1092 <summary> 1500 <summary>
1093 Initializes a new instance of the <see cref="T:HttpServer.Rules.RedirectRule"/> class. 1501 Checks if the decoder can handle the mime type
1094 </summary> 1502 </summary>
1095 <param name="fromUrl">Absolute path (no server name)</param> 1503 <param name="contentType">Content type (with any additional info like boundry). Content type is always supplied in lower case.</param>
1096 <param name="toUrl">Absolute path (no server name)</param> 1504 <returns>True if the decoder can parse the specified content type</returns>
1097 <example>
1098 server.Add(new RedirectRule("/", "/user/index"));
1099 </example>
1100 </member> 1505 </member>
1101 <member name="M:HttpServer.Rules.RedirectRule.#ctor(System.String,System.String,System.Boolean)"> 1506 <member name="M:HttpServer.FormDecoders.HttpMultipart.ReadLine">
1102 <summary> 1507 <summary>
1103 Initializes a new instance of the <see cref="T:HttpServer.Rules.RedirectRule"/> class. 1508
1104 </summary> 1509 </summary>
1105 <param name="fromUrl">Absolute path (no server name)</param> 1510 <returns></returns>
1106 <param name="toUrl">Absolute path (no server name)</param> 1511 <exception cref="T:System.ArgumentOutOfRangeException"></exception>
1107 <param name="shouldRedirect">true if request should be redirected, false if the request URI should be replaced.</param> 1512 <exception cref="T:System.ObjectDisposedException"></exception>
1513 </member>
1514 <member name="T:HttpServer.FormDecoders.HttpMultipart.Element">
1515 <summary>Represents a field in a multipart form</summary>
1516 </member>
1517 <member name="T:HttpServer.Exceptions.InternalServerException">
1518 <summary>
1519 The server encountered an unexpected condition which prevented it from fulfilling the request.
1520 </summary>
1521 </member>
1522 <member name="M:HttpServer.Exceptions.InternalServerException.#ctor">
1523 <summary>
1524 Initializes a new instance of the <see cref="T:HttpServer.Exceptions.InternalServerException"/> class.
1525 </summary>
1526 </member>
1527 <member name="M:HttpServer.Exceptions.InternalServerException.#ctor(System.String)">
1528 <summary>
1529 Initializes a new instance of the <see cref="T:HttpServer.Exceptions.InternalServerException"/> class.
1530 </summary>
1531 <param name="message">error message.</param>
1532 </member>
1533 <member name="M:HttpServer.Exceptions.InternalServerException.#ctor(System.String,System.Exception)">
1534 <summary>
1535 Initializes a new instance of the <see cref="T:HttpServer.Exceptions.InternalServerException"/> class.
1536 </summary>
1537 <param name="message">error message.</param>
1538 <param name="inner">inner exception.</param>
1539 </member>
1540 <member name="T:HttpServer.RequestParserState">
1541 <summary>
1542 Current state in the parsing.
1543 </summary>
1544 </member>
1545 <member name="F:HttpServer.RequestParserState.FirstLine">
1546 <summary>
1547 Should parse the request line
1548 </summary>
1549 </member>
1550 <member name="F:HttpServer.RequestParserState.HeaderName">
1551 <summary>
1552 Searching for a complete header name
1553 </summary>
1554 </member>
1555 <member name="F:HttpServer.RequestParserState.AfterName">
1556 <summary>
1557 Searching for colon after header name (ignoring white spaces)
1558 </summary>
1559 </member>
1560 <member name="F:HttpServer.RequestParserState.Between">
1561 <summary>
1562 Searching for start of header value (ignoring white spaces)
1563 </summary>
1564 </member>
1565 <member name="F:HttpServer.RequestParserState.HeaderValue">
1566 <summary>
1567 Searching for a complete header value (can span over multiple lines, as long as they are prefixed with one/more whitespaces)
1568 </summary>
1569 </member>
1570 <member name="F:HttpServer.RequestParserState.Body">
1571 <summary>
1572 Adding bytes to body
1573 </summary>
1574 </member>
1575 <member name="T:HttpServer.HttpModules.ReverseProxyModule">
1576 <summary>
1577 A reverse proxy are used to act as a bridge between local (protected/hidden) websites
1578 and public clients.
1579
1580 A typical usage is to allow web servers on non standard ports to still be available
1581 to the public clients, or allow web servers on private ips to be available.
1582 </summary>
1583 </member>
1584 <member name="M:HttpServer.HttpModules.ReverseProxyModule.#ctor(System.String,System.String)">
1585 <summary>
1586
1587 </summary>
1588 <param name="source">Base url requested from browser</param>
1589 <param name="destination">Base url on private web server</param>
1108 <example> 1590 <example>
1109 server.Add(new RedirectRule("/", "/user/index")); 1591 // this will return contents from http://192.168.1.128/view/jonas when client requests http://www.gauffin.com/user/view/jonas
1592 _server.Add(new ReverseProxyModule("http://www.gauffin.com/user/", "http://192.168.1.128/");
1110 </example> 1593 </example>
1111 </member> 1594 </member>
1112 <member name="M:HttpServer.Rules.RedirectRule.Process(HttpServer.IHttpRequest,HttpServer.IHttpResponse)"> 1595 <member name="M:HttpServer.HttpModules.ReverseProxyModule.CanHandle(System.Uri)">
1113 <summary> 1596 <summary>
1114 Process the incoming request. 1597 Method that determines if an url should be handled or not by the module
1598 </summary>
1599 <param name="uri">Url requested by the client.</param>
1600 <returns>true if module should handle the url.</returns>
1601 </member>
1602 <member name="M:HttpServer.HttpModules.ReverseProxyModule.Process(HttpServer.IHttpRequest,HttpServer.IHttpResponse,HttpServer.Sessions.IHttpSession)">
1603 <summary>
1604 Method that process the url
1605 </summary>
1606 <param name="request">Information sent by the browser about the request</param>
1607 <param name="response">Information that is being sent back to the client.</param>
1608 <param name="session">Session used to </param>
1609 </member>
1610 <member name="T:HttpServer.Method">
1611 <summary>
1612 Contains all HTTP Methods (according to the HTTP 1.1 specification)
1613 <para>
1614 See: http://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html
1615 </para>
1616 </summary>
1617 </member>
1618 <member name="F:HttpServer.Method.Delete">
1619 <summary>
1620 The DELETE method requests that the origin server delete the resource identified by the Request-URI.
1115 </summary> 1621 </summary>
1116 <param name="request">incoming HTTP request</param>
1117 <param name="response">outgoing HTTP response</param>
1118 <returns>true if response should be sent to the browser directly (no other rules or modules will be processed).</returns>
1119 <remarks> 1622 <remarks>
1120 returning true means that no modules will get the request. Returning true is typically being done 1623 <para>
1121 for redirects. 1624 This method MAY be overridden by human intervention (or other means) on the origin server.
1625 The client cannot be guaranteed that the operation has been carried out, even if the status code
1626 returned from the origin server indicates that the action has been completed successfully.
1627 </para>
1628 <para>
1629 However, the server SHOULD NOT indicate success unless, at the time the response is given,
1630 it intends to delete the resource or move it to an inaccessible location.
1631 </para>
1632 <para>
1633 A successful response SHOULD be 200 (OK) if the response includes an entity describing the status,
1634 202 (Accepted) if the action has not yet been enacted,
1635 or 204 (No Content) if the action has been enacted but the response does not include an entity.
1636 </para>
1637 <para>
1638 If the request passes through a cache and the Request-URI identifies one or more currently cached entities,
1639 those entries SHOULD be treated as stale. Responses to this method are not cacheable.
1640 </para>
1122 </remarks> 1641 </remarks>
1123 </member> 1642 </member>
1124 <member name="P:HttpServer.Rules.RedirectRule.FromUrl"> 1643 <member name="F:HttpServer.Method.Get">
1125 <summary> 1644 <summary>
1126 Gets string to match request URI with. 1645 The GET method means retrieve whatever information (in the form of an entity) is identified by the Request-URI.
1127 </summary> 1646 </summary>
1128 <remarks>Is compared to request.Uri.AbsolutePath</remarks> 1647 <remarks>
1648 <para>
1649 If the Request-URI refers to a data-producing process, it is the produced data which shall be returned as the
1650 entity in the response and not the source text of the process, unless that text happens to be the output of the process.
1651 </para>
1652 <para>
1653 The semantics of the GET method change to a "conditional GET" if the request message includes an
1654 If-Modified-Since, If-Unmodified-Since, If-Match, If-None-Match, or If-Range header field.
1655 A conditional GET method requests that the entity be transferred only under the circumstances described
1656 by the conditional header field(s). The conditional GET method is intended to reduce unnecessary network
1657 usage by allowing cached entities to be refreshed without requiring multiple requests or transferring
1658 data already held by the client.
1659 </para>
1660 </remarks>
1129 </member> 1661 </member>
1130 <member name="P:HttpServer.Rules.RedirectRule.ToUrl"> 1662 <member name="F:HttpServer.Method.Header">
1131 <summary> 1663 <summary>
1132 Gets where to redirect. 1664 The HEAD method is identical to GET except that the server MUST NOT return a message-body in the response.
1133 </summary> 1665 </summary>
1666 <remarks>
1667 The meta information contained in the HTTP headers in response to a HEAD request SHOULD be identical to the
1668 information sent in response to a GET request. This method can be used for obtaining meta information about
1669 the entity implied by the request without transferring the entity-body itself.
1670
1671 This method is often used for testing hypertext links for validity, accessibility, and recent modification.
1672 </remarks>
1134 </member> 1673 </member>
1135 <member name="P:HttpServer.Rules.RedirectRule.ShouldRedirect"> 1674 <member name="F:HttpServer.Method.Options">
1136 <summary> 1675 <summary>
1137 Gets whether server should redirect client. 1676 <para>The OPTIONS method represents a request for information about the communication options available on the request/response chain identified by the Request-URI.</para>
1138 </summary> 1677 </summary>
1139 <remarks> 1678 <remarks>
1140 <c>false</c> means that the rule will replace 1679 <para>This method allows the client to determine the options and/or requirements associated with a resource, or the capabilities of a server, without implying a resource action or initiating a resource retrieval.</para>
1141 the current request URI with the new one from this class.
1142 <c>true</c> means that a redirect response is sent to the client.
1143 </remarks> 1680 </remarks>
1144 </member> 1681 </member>
1145 <member name="T:HttpServer.RequestCookie"> 1682 <member name="F:HttpServer.Method.Post">
1146 <summary> 1683 <summary>
1147 cookie sent by the client/browser 1684 The POST method is used to request that the origin server accept the entity enclosed
1685 in the request as a new subordinate of the resource identified by the Request-URI in the Request-Line.
1148 </summary> 1686 </summary>
1149 <seealso cref="T:HttpServer.ResponseCookie"/> 1687 <remarks>
1688 POST is designed to allow a uniform method to cover the following functions:
1689 <list type="bullet">
1690 <item>
1691 Annotation of existing resources;
1692 </item><item>
1693 Posting a message to a bulletin board, newsgroup, mailing list, or similar group of articles;
1694 </item><item>
1695 Providing a block of data, such as the result of submitting a form, to a data-handling process;
1696 </item><item>
1697 Extending a database through an append operation.
1698 </item>
1699 </list>
1700 <para>
1701 If a resource has been created on the origin server, the response SHOULD be 201 (Created) and
1702 contain an entity which describes the status of the request and refers to the new resource, and a
1703 Location header (see section 14.30).
1704 </para>
1705 <para>
1706 The action performed by the POST method might not result in a resource that can be identified by a URI.
1707 In this case, either 200 (OK) or 204 (No Content) is the appropriate response status, depending on
1708 whether or not the response includes an entity that describes the result.
1709 </para><para>
1710 Responses to this method are not cacheable, unless the response includes appropriate Cache-Control
1711 or Expires header fields. However, the 303 (See Other) response can be used to direct the user agent
1712 to retrieve a cacheable resource.
1713 </para>
1714 </remarks>
1150 </member> 1715 </member>
1151 <member name="M:HttpServer.RequestCookie.#ctor(System.String,System.String)"> 1716 <member name="F:HttpServer.Method.Put">
1152 <summary> 1717 <summary>
1153 Constructor. 1718 The PUT method requests that the enclosed entity be stored under the supplied Request-URI.
1154 </summary> 1719 </summary>
1155 <param name="id">cookie identifier</param> 1720 <remarks>
1156 <param name="content">cookie content</param> 1721 <list type="bullet">
1157 <exception cref="T:System.ArgumentNullException">id or content is null</exception> 1722 <item>
1158 <exception cref="T:System.ArgumentException">id is empty</exception> 1723 If the Request-URI refers to an already existing resource, the enclosed entity SHOULD be considered as a
1724 modified version of the one residing on the origin server.
1725 </item><item>
1726 If the Request-URI does not point to an existing resource, and that URI is capable of being defined as a new
1727 resource by the requesting user agent, the origin server can create the resource with that URI.
1728 </item><item>
1729 If a new resource is created, the origin server MUST inform the user agent via the 201 (Created) response.
1730 </item><item>
1731 If an existing resource is modified, either the 200 (OK) or 204 (No Content) response codes SHOULD be sent to
1732 indicate successful completion of the request.
1733 </item><item>
1734 If the resource could not be created or modified with the Request-URI, an appropriate error response SHOULD be
1735 given that reflects the nature of the problem.
1736 </item>
1737 </list>
1738 <para>
1739 The recipient of the entity MUST NOT ignore any Content-* (e.g. Content-Range) headers that it does not
1740 understand or implement and MUST return a 501 (Not Implemented) response in such cases.
1741 </para>
1742 </remarks>
1159 </member> 1743 </member>
1160 <member name="M:HttpServer.RequestCookie.ToString"> 1744 <member name="F:HttpServer.Method.Trace">
1161 <summary> 1745 <summary>
1162 Gets the cookie HTML representation. 1746 The TRACE method is used to invoke a remote, application-layer loop- back of the request message.
1163 </summary> 1747 </summary>
1164 <returns>cookie string</returns>
1165 </member> 1748 </member>
1166 <member name="P:HttpServer.RequestCookie.Name"> 1749 <member name="T:HttpServer.Methods">
1167 <summary> 1750 <summary>
1168 Gets the cookie identifier. 1751 Contains all HTTP Methods (according to the HTTP 1.1 specification)
1752 <para>
1753 See: http://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html
1754 </para>
1169 </summary> 1755 </summary>
1170 </member> 1756 </member>
1171 <member name="P:HttpServer.RequestCookie.Value"> 1757 <member name="F:HttpServer.Methods.Delete">
1172 <summary> 1758 <summary>
1173 Cookie value. Set to null to remove cookie. 1759 The DELETE method requests that the origin server delete the resource identified by the Request-URI.
1760 </summary>
1761 <remarks>
1762 <para>
1763 This method MAY be overridden by human intervention (or other means) on the origin server.
1764 The client cannot be guaranteed that the operation has been carried out, even if the status code
1765 returned from the origin server indicates that the action has been completed successfully.
1766 </para>
1767 <para>
1768 However, the server SHOULD NOT indicate success unless, at the time the response is given,
1769 it intends to delete the resource or move it to an inaccessible location.
1770 </para>
1771 <para>
1772 A successful response SHOULD be 200 (OK) if the response includes an entity describing the status,
1773 202 (Accepted) if the action has not yet been enacted,
1774 or 204 (No Content) if the action has been enacted but the response does not include an entity.
1775 </para>
1776 <para>
1777 If the request passes through a cache and the Request-URI identifies one or more currently cached entities,
1778 those entries SHOULD be treated as stale. Responses to this method are not cacheable.
1779 </para>
1780 </remarks>
1781 </member>
1782 <member name="F:HttpServer.Methods.Get">
1783 <summary>
1784 The GET method means retrieve whatever information (in the form of an entity) is identified by the Request-URI.
1785 </summary>
1786 <remarks>
1787 <para>
1788 If the Request-URI refers to a data-producing process, it is the produced data which shall be returned as the
1789 entity in the response and not the source text of the process, unless that text happens to be the output of the process.
1790 </para>
1791 <para>
1792 The semantics of the GET method change to a "conditional GET" if the request message includes an
1793 If-Modified-Since, If-Unmodified-Since, If-Match, If-None-Match, or If-Range header field.
1794 A conditional GET method requests that the entity be transferred only under the circumstances described
1795 by the conditional header field(s). The conditional GET method is intended to reduce unnecessary network
1796 usage by allowing cached entities to be refreshed without requiring multiple requests or transferring
1797 data already held by the client.
1798 </para>
1799 </remarks>
1800 </member>
1801 <member name="F:HttpServer.Methods.Header">
1802 <summary>
1803 The HEAD method is identical to GET except that the server MUST NOT return a message-body in the response.
1804 </summary>
1805 <remarks>
1806 The meta information contained in the HTTP headers in response to a HEAD request SHOULD be identical to the
1807 information sent in response to a GET request. This method can be used for obtaining meta information about
1808 the entity implied by the request without transferring the entity-body itself.
1809
1810 This method is often used for testing hypertext links for validity, accessibility, and recent modification.
1811 </remarks>
1812 </member>
1813 <member name="F:HttpServer.Methods.Options">
1814 <summary>
1815 <para>The OPTIONS method represents a request for information about the communication options available on the request/response chain identified by the Request-URI.</para>
1816 </summary>
1817 <remarks>
1818 <para>This method allows the client to determine the options and/or requirements associated with a resource, or the capabilities of a server, without implying a resource action or initiating a resource retrieval.</para>
1819 </remarks>
1820 </member>
1821 <member name="F:HttpServer.Methods.Post">
1822 <summary>
1823 The POST method is used to request that the origin server accept the entity enclosed
1824 in the request as a new subordinate of the resource identified by the Request-URI in the Request-Line.
1825 </summary>
1826 <remarks>
1827 POST is designed to allow a uniform method to cover the following functions:
1828 <list type="bullet">
1829 <item>
1830 Annotation of existing resources;
1831 </item><item>
1832 Posting a message to a bulletin board, newsgroup, mailing list, or similar group of articles;
1833 </item><item>
1834 Providing a block of data, such as the result of submitting a form, to a data-handling process;
1835 </item><item>
1836 Extending a database through an append operation.
1837 </item>
1838 </list>
1839 <para>
1840 If a resource has been created on the origin server, the response SHOULD be 201 (Created) and
1841 contain an entity which describes the status of the request and refers to the new resource, and a
1842 Location header (see section 14.30).
1843 </para>
1844 <para>
1845 The action performed by the POST method might not result in a resource that can be identified by a URI.
1846 In this case, either 200 (OK) or 204 (No Content) is the appropriate response status, depending on
1847 whether or not the response includes an entity that describes the result.
1848 </para><para>
1849 Responses to this method are not cacheable, unless the response includes appropriate Cache-Control
1850 or Expires header fields. However, the 303 (See Other) response can be used to direct the user agent
1851 to retrieve a cacheable resource.
1852 </para>
1853 </remarks>
1854 </member>
1855 <member name="F:HttpServer.Methods.Put">
1856 <summary>
1857 The PUT method requests that the enclosed entity be stored under the supplied Request-URI.
1858 </summary>
1859 <remarks>
1860 <list type="bullet">
1861 <item>
1862 If the Request-URI refers to an already existing resource, the enclosed entity SHOULD be considered as a
1863 modified version of the one residing on the origin server.
1864 </item><item>
1865 If the Request-URI does not point to an existing resource, and that URI is capable of being defined as a new
1866 resource by the requesting user agent, the origin server can create the resource with that URI.
1867 </item><item>
1868 If a new resource is created, the origin server MUST inform the user agent via the 201 (Created) response.
1869 </item><item>
1870 If an existing resource is modified, either the 200 (OK) or 204 (No Content) response codes SHOULD be sent to
1871 indicate successful completion of the request.
1872 </item><item>
1873 If the resource could not be created or modified with the Request-URI, an appropriate error response SHOULD be
1874 given that reflects the nature of the problem.
1875 </item>
1876 </list>
1877 <para>
1878 The recipient of the entity MUST NOT ignore any Content-* (e.g. Content-Range) headers that it does not
1879 understand or implement and MUST return a 501 (Not Implemented) response in such cases.
1880 </para>
1881 </remarks>
1882 </member>
1883 <member name="F:HttpServer.Methods.Trace">
1884 <summary>
1885 The TRACE method is used to invoke a remote, application-layer loop- back of the request message.
1886 </summary>
1887 </member>
1888 <member name="T:HttpServer.HttpListener">
1889 <summary>
1890 New implementation of the HTTP listener.
1891 </summary>
1892 <remarks>
1893 Use the <c>Create</c> methods to create a default listener.
1894 </remarks>
1895 </member>
1896 <member name="T:HttpServer.HttpListenerBase">
1897 <summary>
1898 Contains a listener that doesn't do anything with the connections.
1899 </summary>
1900 </member>
1901 <member name="M:HttpServer.HttpListenerBase.#ctor(System.Net.IPAddress,System.Int32,HttpServer.IHttpContextFactory)">
1902 <summary>
1903 Listen for regular HTTP connections
1904 </summary>
1905 <param name="address">IP Address to accept connections on</param>
1906 <param name="port">TCP Port to listen on, default HTTP port is 80.</param>
1907 <param name="factory">Factory used to create <see cref="T:HttpServer.IHttpClientContext"/>es.</param>
1908 <exception cref="T:System.ArgumentNullException"><c>address</c> is null.</exception>
1909 <exception cref="T:System.ArgumentException">Port must be a positive number.</exception>
1910 </member>
1911 <member name="M:HttpServer.HttpListenerBase.#ctor(System.Net.IPAddress,System.Int32,HttpServer.IHttpContextFactory,System.Security.Cryptography.X509Certificates.X509Certificate)">
1912 <summary>
1913 Initializes a new instance of the <see cref="T:HttpServer.HttpListenerBase"/> class.
1914 </summary>
1915 <param name="address">IP Address to accept connections on</param>
1916 <param name="port">TCP Port to listen on, default HTTPS port is 443</param>
1917 <param name="factory">Factory used to create <see cref="T:HttpServer.IHttpClientContext"/>es.</param>
1918 <param name="certificate">Certificate to use</param>
1919 </member>
1920 <member name="M:HttpServer.HttpListenerBase.#ctor(System.Net.IPAddress,System.Int32,HttpServer.IHttpContextFactory,System.Security.Cryptography.X509Certificates.X509Certificate,System.Security.Authentication.SslProtocols)">
1921 <summary>
1922 Initializes a new instance of the <see cref="T:HttpServer.HttpListenerBase"/> class.
1923 </summary>
1924 <param name="address">IP Address to accept connections on</param>
1925 <param name="port">TCP Port to listen on, default HTTPS port is 443</param>
1926 <param name="factory">Factory used to create <see cref="T:HttpServer.IHttpClientContext"/>es.</param>
1927 <param name="certificate">Certificate to use</param>
1928 <param name="protocol">which HTTPS protocol to use, default is TLS.</param>
1929 </member>
1930 <member name="M:HttpServer.HttpListenerBase.OnAccept(System.IAsyncResult)">
1931 <exception cref="T:System.Exception"><c>Exception</c>.</exception>
1932 </member>
1933 <member name="M:HttpServer.HttpListenerBase.RetryBeginAccept">
1934 <summary>
1935 Will try to accept connections one more time.
1936 </summary>
1937 <exception cref="T:System.Exception">If any exceptions is thrown.</exception>
1938 </member>
1939 <member name="M:HttpServer.HttpListenerBase.OnAcceptingSocket(System.Net.Sockets.Socket)">
1940 <summary>
1941 Can be used to create filtering of new connections.
1942 </summary>
1943 <param name="socket">Accepted socket</param>
1944 <returns>true if connection can be accepted; otherwise false.</returns>
1945 </member>
1946 <member name="M:HttpServer.HttpListenerBase.Start(System.Int32)">
1947 <summary>
1948 Start listen for new connections
1949 </summary>
1950 <param name="backlog">Number of connections that can stand in a queue to be accepted.</param>
1951 <exception cref="T:System.InvalidOperationException">Listener have already been started.</exception>
1952 </member>
1953 <member name="M:HttpServer.HttpListenerBase.Stop">
1954 <summary>
1955 Stop the listener
1956 </summary>
1957 <exception cref="T:System.Net.Sockets.SocketException"></exception>
1958 </member>
1959 <member name="P:HttpServer.HttpListenerBase.LogWriter">
1960 <summary>
1961 Gives you a change to receive log entries for all internals of the HTTP library.
1962 </summary>
1963 <remarks>
1964 You may not switch log writer after starting the listener.
1965 </remarks>
1966 </member>
1967 <member name="P:HttpServer.HttpListenerBase.UseTraceLogs">
1968 <summary>
1969 True if we should turn on trace logs.
1970 </summary>
1971 </member>
1972 <member name="E:HttpServer.HttpListenerBase.ExceptionThrown">
1973 <summary>
1974 Catch exceptions not handled by the listener.
1975 </summary>
1976 <remarks>
1977 Exceptions will be thrown during debug mode if this event is not used,
1978 exceptions will be printed to console and suppressed during release mode.
1979 </remarks>
1980 </member>
1981 <member name="E:HttpServer.HttpListenerBase.RequestReceived">
1982 <summary>
1983 A request have been received from a <see cref="T:HttpServer.IHttpClientContext"/>.
1984 </summary>
1985 </member>
1986 <member name="M:HttpServer.HttpListener.#ctor(System.Net.IPAddress,System.Int32,HttpServer.IHttpContextFactory)">
1987 <summary>
1988 Initializes a new instance of the <see cref="T:HttpServer.HttpListener"/> class.
1989 </summary>
1990 <param name="address">IP Address to accept connections on</param>
1991 <param name="port">TCP Port to listen on, default HTTP port is 80.</param>
1992 <param name="factory">Factory used to create <see cref="T:HttpServer.IHttpClientContext"/>es.</param>
1993 <exception cref="T:System.ArgumentNullException"><c>address</c> is null.</exception>
1994 <exception cref="T:System.ArgumentException">Port must be a positive number.</exception>
1995 </member>
1996 <member name="M:HttpServer.HttpListener.#ctor(System.Net.IPAddress,System.Int32,HttpServer.IHttpContextFactory,System.Security.Cryptography.X509Certificates.X509Certificate)">
1997 <summary>
1998 Initializes a new instance of the <see cref="T:HttpServer.HttpListener"/> class.
1999 </summary>
2000 <param name="address">The address.</param>
2001 <param name="port">The port.</param>
2002 <param name="factory">The factory.</param>
2003 <param name="certificate">The certificate.</param>
2004 </member>
2005 <member name="M:HttpServer.HttpListener.#ctor(System.Net.IPAddress,System.Int32,HttpServer.IHttpContextFactory,System.Security.Cryptography.X509Certificates.X509Certificate,System.Security.Authentication.SslProtocols)">
2006 <summary>
2007 Initializes a new instance of the <see cref="T:HttpServer.HttpListener"/> class.
2008 </summary>
2009 <param name="address">The address.</param>
2010 <param name="port">The port.</param>
2011 <param name="factory">The factory.</param>
2012 <param name="certificate">The certificate.</param>
2013 <param name="protocol">The protocol.</param>
2014 </member>
2015 <member name="M:HttpServer.HttpListener.Create(System.Net.IPAddress,System.Int32)">
2016 <summary>
2017 Creates a new <see cref="T:HttpServer.HttpListener"/> instance with default factories.
2018 </summary>
2019 <param name="address">Address that the listener should accept connections on.</param>
2020 <param name="port">Port that listener should accept connections on.</param>
2021 <returns>Created HTTP listener.</returns>
2022 </member>
2023 <member name="M:HttpServer.HttpListener.Create(System.Net.IPAddress,System.Int32,System.Security.Cryptography.X509Certificates.X509Certificate)">
2024 <summary>
2025 Creates a new <see cref="T:HttpServer.HttpListener"/> instance with default factories.
2026 </summary>
2027 <param name="address">Address that the listener should accept connections on.</param>
2028 <param name="port">Port that listener should accept connections on.</param>
2029 <param name="certificate">Certificate to use</param>
2030 <returns>Created HTTP listener.</returns>
2031 </member>
2032 <member name="M:HttpServer.HttpListener.Create(System.Net.IPAddress,System.Int32,System.Security.Cryptography.X509Certificates.X509Certificate,System.Security.Authentication.SslProtocols)">
2033 <summary>
2034 Creates a new <see cref="T:HttpServer.HttpListener"/> instance with default factories.
2035 </summary>
2036 <param name="address">Address that the listener should accept connections on.</param>
2037 <param name="port">Port that listener should accept connections on.</param>
2038 <param name="certificate">Certificate to use</param>
2039 <param name="protocol">which HTTPS protocol to use, default is TLS.</param>
2040 <returns>Created HTTP listener.</returns>
2041 </member>
2042 <member name="M:HttpServer.HttpListener.OnAcceptingSocket(System.Net.Sockets.Socket)">
2043 <summary>
2044 Can be used to create filtering of new connections.
2045 </summary>
2046 <param name="socket">Accepted socket</param>
2047 <returns>
2048 true if connection can be accepted; otherwise false.
2049 </returns>
2050 </member>
2051 <member name="E:HttpServer.HttpListener.Accepted">
2052 <summary>
2053 A client have been accepted, but not handled, by the listener.
2054 </summary>
2055 </member>
2056 <member name="T:HttpServer.Parser.HeaderEventArgs">
2057 <summary>
2058 Event arguments used when a new header have been parsed.
2059 </summary>
2060 </member>
2061 <member name="M:HttpServer.Parser.HeaderEventArgs.#ctor(System.String,System.String)">
2062 <summary>
2063 Initializes a new instance of the <see cref="T:HttpServer.Parser.HeaderEventArgs"/> class.
2064 </summary>
2065 <param name="name">Name of header.</param>
2066 <param name="value">Header value.</param>
2067 </member>
2068 <member name="M:HttpServer.Parser.HeaderEventArgs.#ctor">
2069 <summary>
2070 Initializes a new instance of the <see cref="T:HttpServer.Parser.HeaderEventArgs"/> class.
2071 </summary>
2072 </member>
2073 <member name="P:HttpServer.Parser.HeaderEventArgs.Name">
2074 <summary>
2075 Gets or sets header name.
2076 </summary>
2077 </member>
2078 <member name="P:HttpServer.Parser.HeaderEventArgs.Value">
2079 <summary>
2080 Gets or sets header value.
1174 </summary> 2081 </summary>
1175 </member> 2082 </member>
1176 <member name="T:HttpServer.LogPrio"> 2083 <member name="T:HttpServer.LogPrio">
@@ -1268,27 +2175,6 @@
1268 <param name="prio">Importance of the log message</param> 2175 <param name="prio">Importance of the log message</param>
1269 <param name="message">The message.</param> 2176 <param name="message">The message.</param>
1270 </member> 2177 </member>
1271 <member name="T:HttpServer.IHttpContextHandler">
1272 <summary>
1273 Class that receives Requests from a <see cref="T:HttpServer.IHttpClientContext"/>.
1274 </summary>
1275 </member>
1276 <member name="M:HttpServer.IHttpContextHandler.ClientDisconnected(HttpServer.IHttpClientContext,System.Net.Sockets.SocketError)">
1277 <summary>
1278 Client have been disconnected.
1279 </summary>
1280 <param name="client">Client that was disconnected.</param>
1281 <param name="error">Reason</param>
1282 <see cref="T:HttpServer.IHttpClientContext"/>
1283 </member>
1284 <member name="M:HttpServer.IHttpContextHandler.RequestReceived(HttpServer.IHttpClientContext,HttpServer.IHttpRequest)">
1285 <summary>
1286 Invoked when a client context have received a new HTTP request
1287 </summary>
1288 <param name="client">Client that received the request.</param>
1289 <param name="request">Request that was received.</param>
1290 <see cref="T:HttpServer.IHttpClientContext"/>
1291 </member>
1292 <member name="T:HttpServer.Helpers.JSHelper"> 2178 <member name="T:HttpServer.Helpers.JSHelper">
1293 <summary> 2179 <summary>
1294 Will contain helper functions for javascript. 2180 Will contain helper functions for javascript.
@@ -1342,65 +2228,14 @@
1342 <returns>javascript for closing a dialog.</returns> 2228 <returns>javascript for closing a dialog.</returns>
1343 <see cref="M:HttpServer.Helpers.JSHelper.CreateDialog(System.String,System.String,System.String[])"/> 2229 <see cref="M:HttpServer.Helpers.JSHelper.CreateDialog(System.String,System.String,System.String[])"/>
1344 </member> 2230 </member>
1345 <member name="T:HttpServer.Helpers.FormHelper"> 2231 <member name="T:HttpServer.Helpers.GetIdTitle">
1346 <summary>
1347 Helpers making it easier to work with forms.
1348 </summary>
1349 <seealso cref="T:HttpServer.Helpers.ObjectForm"/>
1350 </member>
1351 <member name="F:HttpServer.Helpers.FormHelper.JSImplementation">
1352 <summary>
1353 Used to let the website use different JavaScript libraries.
1354 Default is <see cref="T:HttpServer.Helpers.Implementations.PrototypeImp"/>
1355 </summary>
1356 </member>
1357 <member name="M:HttpServer.Helpers.FormHelper.Start(System.String,System.String,System.Boolean,System.String[])">
1358 <summary>
1359 Create a &lt;form&gt; tag.
1360 </summary>
1361 <param name="id">name of form</param>
1362 <param name="action">action to invoke on submit</param>
1363 <param name="isAjax">form should be posted as Ajax</param>
1364 <returns>HTML code</returns>
1365 <example>
1366 <code>
1367 // without options
1368 WebHelper.FormStart("frmLogin", "/user/login", Request.IsAjax);
1369
1370 // with options
1371 WebHelper.FormStart("frmLogin", "/user/login", Request.IsAjax, "style", "display:inline", "class", "greenForm");
1372 </code>
1373 </example>
1374 <param name="options">HTML attributes or JavaScript options.</param>
1375 <remarks>Method will ALWAYS be POST.</remarks>
1376 <exception cref="T:System.ArgumentException">options must consist of name, value, name, value</exception>
1377 </member>
1378 <member name="M:HttpServer.Helpers.FormHelper.Select(System.String,System.Collections.IEnumerable,HttpServer.Helpers.GetIdTitle,System.Object,System.Boolean)">
1379 <summary>
1380 Creates a select list with the values in a collection.
1381 </summary>
1382 <param name="name">Name of the SELECT-tag</param>
1383 <param name="collection">collection used to generate options.</param>
1384 <param name="getIdTitle">delegate used to return id and title from objects.</param>
1385 <param name="selectedValue">value that should be marked as selected.</param>
1386 <param name="firstEmpty">First row should contain an empty value.</param>
1387 <returns>string containing a SELECT-tag.</returns>
1388 <seealso cref="T:HttpServer.Helpers.GetIdTitle"/>
1389 </member>
1390 <member name="M:HttpServer.Helpers.FormHelper.Select(System.String,System.String,System.Collections.IEnumerable,HttpServer.Helpers.GetIdTitle,System.Object,System.Boolean)">
1391 <summary> 2232 <summary>
1392 Creates a select list with the values in a collection. 2233 Delegate used by <see cref="M:HttpServer.Helpers.FormHelper.Select(System.String,System.Collections.IEnumerable,HttpServer.Helpers.GetIdTitle,System.Object,System.Boolean)"/> to populate select options.
1393 </summary> 2234 </summary>
1394 <param name="name">Name of the SELECT-tag</param> 2235 <param name="obj">current object (for instance a User).</param>
1395 <param name="id">Id of the SELECT-tag</param> 2236 <param name="id">Text that should be displayed in the value part of a &lt;optiongt;-tag.</param>
1396 <param name="collection">collection used to generate options.</param> 2237 <param name="title">Text shown in the select list.</param>
1397 <param name="getIdTitle">delegate used to return id and title from objects.</param>
1398 <param name="selectedValue">value that should be marked as selected.</param>
1399 <param name="firstEmpty">First row should contain an empty value.</param>
1400 <returns>string containing a SELECT-tag.</returns>
1401 <seealso cref="T:HttpServer.Helpers.GetIdTitle"/>
1402 <example> 2238 <example>
1403 <code>
1404 // Class that is going to be used in a SELECT-tag. 2239 // Class that is going to be used in a SELECT-tag.
1405 public class User 2240 public class User
1406 { 2241 {
@@ -1453,239 +2288,40 @@
1453 User user = (User)o; 2288 User user = (User)o;
1454 id = user.Id; 2289 id = user.Id;
1455 value = user.RealName; 2290 value = user.RealName;
1456 } 2291 } /// </example>
1457 </code>
1458 </example>
1459 <exception cref="T:System.ArgumentNullException"><c>name</c>, <c>id</c>, <c>collection</c> or <c>getIdTitle</c> is null.</exception>
1460 </member>
1461 <member name="M:HttpServer.Helpers.FormHelper.Select(System.String,System.String,System.Collections.IEnumerable,HttpServer.Helpers.GetIdTitle,System.Object,System.Boolean,System.String[])">
1462 <summary>
1463 Creates a select list with the values in a collection.
1464 </summary>
1465 <param name="name">Name of the SELECT-tag</param>
1466 <param name="id">Id of the SELECT-tag</param>
1467 <param name="collection">collection used to generate options.</param>
1468 <param name="getIdTitle">delegate used to return id and title from objects.</param>
1469 <param name="selectedValue">value that should be marked as selected.</param>
1470 <param name="firstEmpty">First row should contain an empty value.</param>
1471 <param name="htmlAttributes">name, value collection of extra HTML attributes.</param>
1472 <returns>string containing a SELECT-tag.</returns>
1473 <seealso cref="T:HttpServer.Helpers.GetIdTitle"/>
1474 <exception cref="T:System.ArgumentNullException"><c>name</c>, <c>id</c>, <c>collection</c> or <c>getIdTitle</c> is null.</exception>
1475 <exception cref="T:System.ArgumentException">Invalid HTML attribute list.</exception>
1476 </member>
1477 <member name="M:HttpServer.Helpers.FormHelper.Options(System.Collections.IEnumerable,HttpServer.Helpers.GetIdTitle,System.Object,System.Boolean)">
1478 <summary>
1479 Generate a list of HTML options
1480 </summary>
1481 <param name="collection">collection used to generate options.</param>
1482 <param name="getIdTitle">delegate used to return id and title from objects.</param>
1483 <param name="selectedValue">value that should be marked as selected.</param>
1484 <param name="firstEmpty">First row should contain an empty value.</param>
1485 <returns></returns>
1486 <exception cref="T:System.ArgumentNullException"><c>collection</c> or <c>getIdTitle</c> is null.</exception>
1487 </member>
1488 <member name="M:HttpServer.Helpers.FormHelper.Options(System.Text.StringBuilder,System.Collections.IEnumerable,HttpServer.Helpers.GetIdTitle,System.Object,System.Boolean)">
1489 <exception cref="T:System.ArgumentNullException"><c>sb</c> is null.</exception>
1490 </member>
1491 <member name="M:HttpServer.Helpers.FormHelper.CheckBox(System.String,System.Object,System.Object,System.String[])">
1492 <summary>
1493 Creates a check box.
1494 </summary>
1495 <param name="name">element name</param>
1496 <param name="value">element value</param>
1497 <param name="isChecked">determines if the check box is selected or not. This is done differently depending on the
1498 type of variable. A boolean simply triggers checked or not, all other types are compared with "value" to determine if
1499 the box is checked or not. </param>
1500 <param name="htmlAttributes">a list with additional attributes (name, value, name, value).</param>
1501 <returns>a generated radio button</returns>
1502 </member>
1503 <member name="M:HttpServer.Helpers.FormHelper.CheckBox(System.String,System.String,System.Object,System.Object,System.String[])">
1504 <summary>
1505 Creates a check box.
1506 </summary>
1507 <param name="name">element name</param>
1508 <param name="id">element id</param>
1509 <param name="value">element value</param>
1510 <param name="isChecked">determines if the check box is selected or not. This is done differently depending on the
1511 type of variable. A boolean simply triggers checked or not, all other types are compared with "value" to determine if
1512 the box is checked or not. </param>
1513 <param name="htmlAttributes">a list with additional attributes (name, value, name, value).</param>
1514 <returns>a generated radio button</returns>
1515 <remarks>
1516 value in your business object. (check box will be selected if it matches the element value)
1517 </remarks>
1518 </member>
1519 <member name="M:HttpServer.Helpers.FormHelper.CheckBox(System.String,System.String,System.Object,System.String[])">
1520 <summary>
1521 Creates a check box.
1522 </summary>
1523 <param name="name">element name</param>
1524 <param name="id">element id</param>
1525 <param name="isChecked">determines if the check box is selected or not. This is done differently depending on the
1526 type of variable. A boolean simply triggers checked or not, all other types are compared with "value" to determine if
1527 the box is checked or not. </param>
1528 <param name="htmlAttributes">a list with additional attributes (name, value, name, value).</param>
1529 <returns>a generated radio button</returns>
1530 <remarks>will set value to "1".</remarks>
1531 </member>
1532 <member name="M:HttpServer.Helpers.FormHelper.RadioButton(System.String,System.Object,System.Object,System.String[])">
1533 <summary>
1534 Creates a RadioButton.
1535 </summary>
1536 <param name="name">element name</param>
1537 <param name="value">element value</param>
1538 <param name="isSelected">determines if the radio button is selected or not. This is done differently depending on the
1539 type of variable. A boolean simply triggers checked or not, all other types are compared with "value" to determine if
1540 the box is checked or not. </param>
1541 <param name="htmlAttributes">a list with additional attributes (name, value, name, value).</param>
1542 <returns>a generated radio button</returns>
1543 </member>
1544 <member name="M:HttpServer.Helpers.FormHelper.RadioButton(System.String,System.String,System.Object,System.Object,System.String[])">
1545 <summary>
1546 Creates a RadioButton.
1547 </summary>
1548 <param name="name">element name</param>
1549 <param name="id">element id</param>
1550 <param name="value">element value</param>
1551 <param name="isSelected">determines if the radio button is selected or not. This is done differently depending on the
1552 type of variable. A boolean simply triggers checked or not, all other types are compared with "value" to determine if
1553 the box is checked or not. </param>
1554 <param name="htmlAttributes">a list with additional attributes (name, value, name, value).</param>
1555 <returns>a generated radio button</returns>
1556 </member>
1557 <member name="M:HttpServer.Helpers.FormHelper.End">
1558 <summary>
1559 form close tag
1560 </summary>
1561 <returns></returns>
1562 </member>
1563 <member name="T:HttpServer.Sessions.HttpSessionClearedArgs">
1564 <summary>
1565 Arguments sent when a <see cref="T:HttpServer.Sessions.IHttpSession"/> is cleared
1566 </summary>
1567 </member>
1568 <member name="M:HttpServer.Sessions.HttpSessionClearedArgs.#ctor(System.Boolean)">
1569 <summary>
1570 Instantiates the arguments for the event
1571 </summary>
1572 <param name="expired">True if the session is cleared due to expiration</param>
1573 </member>
1574 <member name="P:HttpServer.Sessions.HttpSessionClearedArgs.Expired">
1575 <summary>
1576 Returns true if the session is cleared due to expiration
1577 </summary>
1578 </member>
1579 <member name="T:HttpServer.Sessions.HttpSessionClearedHandler">
1580 <summary>
1581 Delegate for when a IHttpSession is cleared
1582 </summary>
1583 <param name="session"><see cref="T:HttpServer.Sessions.IHttpSession"/> this is being cleared.</param>
1584 <param name="args">Arguments for the clearing</param>
1585 </member>
1586 <member name="T:HttpServer.RequestQueue">
1587 <summary>
1588 Used to queue incoming requests.
1589 </summary>
1590 </member>
1591 <member name="M:HttpServer.RequestQueue.#ctor(HttpServer.ProcessRequestHandler)">
1592 <summary>
1593 Initializes a new instance of the <see cref="T:HttpServer.RequestQueue"/> class.
1594 </summary>
1595 <param name="handler">Called when a request should be processed.</param>
1596 </member>
1597 <member name="M:HttpServer.RequestQueue.QueueThread">
1598 <summary>
1599 Used to process queued requests.
1600 </summary>
1601 </member>
1602 <member name="P:HttpServer.RequestQueue.MaxRequestCount">
1603 <summary>
1604 Gets or sets maximum number of allowed simultaneous requests.
1605 </summary>
1606 </member>
1607 <member name="P:HttpServer.RequestQueue.MaxQueueSize">
1608 <summary>
1609 Gets or sets maximum number of requests queuing to be handled.
1610 </summary>
1611 </member>
1612 <member name="P:HttpServer.RequestQueue.CurrentRequestCount">
1613 <summary>
1614 Specifies how many requests the HTTP server is currently processing.
1615 </summary>
1616 </member> 2292 </member>
1617 <member name="T:HttpServer.RequestQueue.QueueItem"> 2293 <member name="T:HttpServer.Parser.BodyEventArgs">
1618 <summary> 2294 <summary>
1619 Used two queue incoming requests to avoid 2295 Arguments used when more body bytes have come.
1620 thread starvation.
1621 </summary> 2296 </summary>
1622 </member> 2297 </member>
1623 <member name="T:HttpServer.ProcessRequestHandler"> 2298 <member name="M:HttpServer.Parser.BodyEventArgs.#ctor(System.Byte[],System.Int32,System.Int32)">
1624 <summary> 2299 <summary>
1625 Method used to process a queued request 2300 Initializes a new instance of the <see cref="T:HttpServer.Parser.BodyEventArgs"/> class.
1626 </summary> 2301 </summary>
1627 <param name="context">Context that the request was received from.</param> 2302 <param name="buffer">buffer that contains the received bytes.</param>
1628 <param name="request">Request to process.</param> 2303 <param name="offset">offset in buffer where to start processing.</param>
2304 <param name="count">number of bytes from <paramref name="offset"/> that should be parsed.</param>
1629 </member> 2305 </member>
1630 <member name="T:HttpServer.RequestParserFactory"> 2306 <member name="M:HttpServer.Parser.BodyEventArgs.#ctor">
1631 <summary> 2307 <summary>
1632 Creates request parsers when needed. 2308 Initializes a new instance of the <see cref="T:HttpServer.Parser.BodyEventArgs"/> class.
1633 </summary> 2309 </summary>
1634 </member> 2310 </member>
1635 <member name="T:HttpServer.IRequestParserFactory"> 2311 <member name="P:HttpServer.Parser.BodyEventArgs.Buffer">
1636 <summary> 2312 <summary>
1637 Creates request parsers when needed. 2313 Gets or sets buffer that contains the received bytes.
1638 </summary> 2314 </summary>
1639 </member> 2315 </member>
1640 <member name="M:HttpServer.IRequestParserFactory.CreateParser(HttpServer.ILogWriter)"> 2316 <member name="P:HttpServer.Parser.BodyEventArgs.Count">
1641 <summary>
1642 Create a new request parser.
1643 </summary>
1644 <param name="logWriter">Used when logging should be enabled.</param>
1645 <returns>A new request parser.</returns>
1646 </member>
1647 <member name="M:HttpServer.RequestParserFactory.CreateParser(HttpServer.ILogWriter)">
1648 <summary> 2317 <summary>
1649 Create a new request parser. 2318 Gets or sets number of bytes from <see cref="P:HttpServer.Parser.BodyEventArgs.Offset"/> that should be parsed.
1650 </summary> 2319 </summary>
1651 <param name="logWriter">Used when logging should be enabled.</param>
1652 <returns>A new request parser.</returns>
1653 </member> 2320 </member>
1654 <member name="T:HttpServer.HttpResponse"> 2321 <member name="P:HttpServer.Parser.BodyEventArgs.Offset">
1655 <summary> 2322 <summary>
1656 Response that is sent back to the web browser / client. 2323 Gets or sets offset in buffer where to start processing.
1657 </summary> 2324 </summary>
1658 <remarks>
1659 <para>
1660 A response can be sent if different ways. The easiest one is
1661 to just fill the Body stream with content, everything else
1662 will then be taken care of by the framework. The default content-type
1663 is text/html, you should change it if you send anything else.
1664 </para><para>
1665 The second and slightly more complex way is to send the response
1666 as parts. Start with sending the header using the SendHeaders method and
1667 then you can send the body using SendBody method, but do not forget
1668 to set <see cref="P:HttpServer.HttpResponse.ContentType"/> and <see cref="P:HttpServer.HttpResponse.ContentLength"/> before doing so.
1669 </para>
1670 </remarks>
1671 <example>
1672 <code>
1673 // Example using response body.
1674 class MyModule : HttpModule
1675 {
1676 public override bool Process(IHttpRequest request, IHttpResponse response, IHttpSession session)
1677 {
1678 StreamWriter writer = new StreamWriter(response.Body);
1679 writer.WriteLine("Hello dear World!");
1680 writer.Flush();
1681
1682 // return true to tell webserver that we've handled the url
1683 return true;
1684 }
1685 }
1686 </code>
1687 </example>
1688 todo: add two examples, using SendHeaders/SendBody and just the Body stream.
1689 </member> 2325 </member>
1690 <member name="T:HttpServer.IHttpResponse"> 2326 <member name="T:HttpServer.IHttpResponse">
1691 <summary> 2327 <summary>
@@ -1856,587 +2492,503 @@
1856 Cookies that should be created/changed. 2492 Cookies that should be created/changed.
1857 </summary> 2493 </summary>
1858 </member> 2494 </member>
1859 <member name="M:HttpServer.HttpResponse.#ctor(HttpServer.IHttpClientContext,HttpServer.IHttpRequest)"> 2495 <member name="T:HttpServer.ConnectionType">
1860 <summary> 2496 <summary>
1861 Initializes a new instance of the <see cref="T:HttpServer.IHttpResponse"/> class. 2497 Type of HTTP connection
1862 </summary> 2498 </summary>
1863 <param name="context">Client that send the <see cref="T:HttpServer.IHttpRequest"/>.</param>
1864 <param name="request">Contains information of what the client want to receive.</param>
1865 <exception cref="T:System.ArgumentException"><see cref="P:HttpServer.IHttpRequest.HttpVersion"/> cannot be empty.</exception>
1866 </member> 2499 </member>
1867 <member name="M:HttpServer.HttpResponse.#ctor(HttpServer.IHttpClientContext,System.String,HttpServer.ConnectionType)"> 2500 <member name="F:HttpServer.ConnectionType.Close">
1868 <summary> 2501 <summary>
1869 Initializes a new instance of the <see cref="T:HttpServer.IHttpResponse"/> class. 2502 Connection is closed after each request-response
1870 </summary> 2503 </summary>
1871 <param name="context">Client that send the <see cref="T:HttpServer.IHttpRequest"/>.</param>
1872 <param name="httpVersion">Version of HTTP protocol that the client uses.</param>
1873 <param name="connectionType">Type of HTTP connection used.</param>
1874 </member> 2504 </member>
1875 <member name="M:HttpServer.HttpResponse.AddHeader(System.String,System.String)"> 2505 <member name="F:HttpServer.ConnectionType.KeepAlive">
1876 <summary> 2506 <summary>
1877 Add another header to the document. 2507 Connection is kept alive for X seconds (unless another request have been made)
1878 </summary> 2508 </summary>
1879 <param name="name">Name of the header, case sensitive, use lower cases.</param>
1880 <param name="value">Header values can span over multiple lines as long as each line starts with a white space. New line chars should be \r\n</param>
1881 <exception cref="T:System.InvalidOperationException">If headers already been sent.</exception>
1882 <exception cref="T:System.ArgumentException">If value conditions have not been met.</exception>
1883 <remarks>Adding any header will override the default ones and those specified by properties.</remarks>
1884 </member> 2509 </member>
1885 <member name="M:HttpServer.HttpResponse.Send"> 2510 <member name="T:HttpServer.IHttpRequest">
1886 <summary> 2511 <summary>
1887 Send headers and body to the browser. 2512 Contains server side HTTP request information.
1888 </summary> 2513 </summary>
1889 <exception cref="T:System.InvalidOperationException">If content have already been sent.</exception>
1890 </member> 2514 </member>
1891 <member name="M:HttpServer.HttpResponse.SendBody(System.Byte[],System.Int32,System.Int32)"> 2515 <member name="M:HttpServer.IHttpRequest.AddHeader(System.String,System.String)">
1892 <summary> 2516 <summary>
1893 Make sure that you have specified <see cref="P:HttpServer.HttpResponse.ContentLength"/> and sent the headers first. 2517 Called during parsing of a <see cref="T:HttpServer.IHttpRequest"/>.
1894 </summary> 2518 </summary>
1895 <param name="buffer"></param> 2519 <param name="name">Name of the header, should not be URL encoded</param>
1896 <exception cref="T:System.InvalidOperationException">If headers have not been sent.</exception> 2520 <param name="value">Value of the header, should not be URL encoded</param>
1897 <see cref="M:HttpServer.HttpResponse.SendHeaders"/> 2521 <exception cref="T:HttpServer.Exceptions.BadRequestException">If a header is incorrect.</exception>
1898 <param name="offset">offset of first byte to send</param>
1899 <param name="count">number of bytes to send.</param>
1900 <seealso cref="M:HttpServer.HttpResponse.Send"/>
1901 <seealso cref="M:HttpServer.HttpResponse.SendHeaders"/>
1902 <remarks>This method can be used if you want to send body contents without caching them first. This
1903 is recommended for larger files to keep the memory usage low.</remarks>
1904 </member> 2522 </member>
1905 <member name="M:HttpServer.HttpResponse.SendBody(System.Byte[])"> 2523 <member name="M:HttpServer.IHttpRequest.AddToBody(System.Byte[],System.Int32,System.Int32)">
1906 <summary> 2524 <summary>
1907 Make sure that you have specified <see cref="P:HttpServer.HttpResponse.ContentLength"/> and sent the headers first. 2525 Add bytes to the body
1908 </summary> 2526 </summary>
1909 <param name="buffer"></param> 2527 <param name="bytes">buffer to read bytes from</param>
1910 <exception cref="T:System.InvalidOperationException">If headers have not been sent.</exception> 2528 <param name="offset">where to start read</param>
1911 <see cref="M:HttpServer.HttpResponse.SendHeaders"/> 2529 <param name="length">number of bytes to read</param>
1912 <seealso cref="M:HttpServer.HttpResponse.Send"/> 2530 <returns>Number of bytes actually read (same as length unless we got all body bytes).</returns>
1913 <seealso cref="M:HttpServer.HttpResponse.SendHeaders"/> 2531 <exception cref="T:System.InvalidOperationException">If body is not writable</exception>
1914 <remarks>This method can be used if you want to send body contents without caching them first. This 2532 <exception cref="T:System.ArgumentNullException"><c>bytes</c> is null.</exception>
1915 is recommended for larger files to keep the memory usage low.</remarks> 2533 <exception cref="T:System.ArgumentOutOfRangeException"><c>offset</c> is out of range.</exception>
1916 </member> 2534 </member>
1917 <member name="M:HttpServer.HttpResponse.SendHeaders"> 2535 <member name="M:HttpServer.IHttpRequest.Clear">
1918 <summary> 2536 <summary>
1919 Send headers to the client. 2537 Clear everything in the request
1920 </summary> 2538 </summary>
1921 <exception cref="T:System.InvalidOperationException">If headers already been sent.</exception>
1922 <seealso cref="M:HttpServer.HttpResponse.AddHeader(System.String,System.String)"/>
1923 <seealso cref="M:HttpServer.HttpResponse.Send"/>
1924 <seealso cref="M:HttpServer.HttpResponse.SendBody(System.Byte[])"/>
1925 </member> 2539 </member>
1926 <member name="M:HttpServer.HttpResponse.Redirect(System.Uri)"> 2540 <member name="M:HttpServer.IHttpRequest.DecodeBody(HttpServer.FormDecoders.FormDecoderProvider)">
1927 <summary> 2541 <summary>
1928 Redirect client to somewhere else using the 302 status code. 2542 Decode body into a form.
1929 </summary> 2543 </summary>
1930 <param name="uri">Destination of the redirect</param> 2544 <param name="providers">A list with form decoders.</param>
1931 <exception cref="T:System.InvalidOperationException">If headers already been sent.</exception> 2545 <exception cref="T:System.IO.InvalidDataException">If body contents is not valid for the chosen decoder.</exception>
1932 <remarks>You can not do anything more with the request when a redirect have been done. This should be your last 2546 <exception cref="T:System.InvalidOperationException">If body is still being transferred.</exception>
1933 action.</remarks>
1934 </member> 2547 </member>
1935 <member name="M:HttpServer.HttpResponse.Redirect(System.String)"> 2548 <member name="M:HttpServer.IHttpRequest.SetCookies(HttpServer.RequestCookies)">
1936 <summary> 2549 <summary>
1937 redirect to somewhere 2550 Sets the cookies.
1938 </summary> 2551 </summary>
1939 <param name="url">where the redirect should go</param> 2552 <param name="cookies">The cookies.</param>
1940 <remarks>
1941 No body are allowed when doing redirects.
1942 </remarks>
1943 </member> 2553 </member>
1944 <member name="P:HttpServer.HttpResponse.Body"> 2554 <member name="M:HttpServer.IHttpRequest.CreateResponse(HttpServer.IHttpClientContext)">
1945 <summary> 2555 <summary>
1946 The body stream is used to cache the body contents 2556 Create a response object.
1947 before sending everything to the client. It's the simplest
1948 way to serve documents.
1949 </summary> 2557 </summary>
2558 <param name="context">Context for the connected client.</param>
2559 <returns>A new <see cref="T:HttpServer.IHttpResponse"/>.</returns>
1950 </member> 2560 </member>
1951 <member name="P:HttpServer.HttpResponse.Chunked"> 2561 <member name="P:HttpServer.IHttpRequest.AcceptTypes">
1952 <summary> 2562 <summary>
1953 The chunked encoding modifies the body of a message in order to 2563 Gets kind of types accepted by the client.
1954 transfer it as a series of chunks, each with its own size indicator,
1955 followed by an OPTIONAL trailer containing entity-header fields. This
1956 allows dynamically produced content to be transferred along with the
1957 information necessary for the recipient to verify that it has
1958 received the full message.
1959 </summary> 2564 </summary>
1960 </member> 2565 </member>
1961 <member name="P:HttpServer.HttpResponse.ProtocolVersion"> 2566 <member name="P:HttpServer.IHttpRequest.Body">
1962 <summary> 2567 <summary>
1963 Defines the version of the HTTP Response for applications where it's required 2568 Gets or sets body stream.
1964 for this to be forced.
1965 </summary> 2569 </summary>
1966 </member> 2570 </member>
1967 <member name="P:HttpServer.HttpResponse.Connection"> 2571 <member name="P:HttpServer.IHttpRequest.BodyIsComplete">
1968 <summary> 2572 <summary>
1969 Kind of connection 2573 Gets whether the body is complete.
1970 </summary> 2574 </summary>
1971 </member> 2575 </member>
1972 <member name="P:HttpServer.HttpResponse.Encoding"> 2576 <member name="P:HttpServer.IHttpRequest.Connection">
1973 <summary> 2577 <summary>
1974 Encoding to use when sending stuff to the client. 2578 Gets or sets kind of connection used for the session.
1975 </summary> 2579 </summary>
1976 <remarks>Default is UTF8</remarks>
1977 </member> 2580 </member>
1978 <member name="P:HttpServer.HttpResponse.KeepAlive"> 2581 <member name="P:HttpServer.IHttpRequest.ContentLength">
1979 <summary> 2582 <summary>
1980 Number of seconds to keep connection alive 2583 Gets or sets number of bytes in the body.
1981 </summary> 2584 </summary>
1982 <remarks>Only used if Connection property is set to <see cref="F:HttpServer.ConnectionType.KeepAlive"/>.</remarks>
1983 </member> 2585 </member>
1984 <member name="P:HttpServer.HttpResponse.Status"> 2586 <member name="P:HttpServer.IHttpRequest.Cookies">
1985 <summary> 2587 <summary>
1986 Status code that is sent to the client. 2588 Gets cookies that was sent with the request.
1987 </summary> 2589 </summary>
1988 <remarks>Default is <see cref="F:System.Net.HttpStatusCode.OK"/></remarks>
1989 </member> 2590 </member>
1990 <member name="P:HttpServer.HttpResponse.Reason"> 2591 <member name="P:HttpServer.IHttpRequest.Form">
1991 <summary> 2592 <summary>
1992 Information about why a specific status code was used. 2593 Gets form parameters.
1993 </summary> 2594 </summary>
1994 </member> 2595 </member>
1995 <member name="P:HttpServer.HttpResponse.ContentLength"> 2596 <member name="P:HttpServer.IHttpRequest.Headers">
1996 <summary> 2597 <summary>
1997 Size of the body. MUST be specified before sending the header, 2598 Gets headers sent by the client.
1998 unless property Chunked is set to true.
1999 </summary> 2599 </summary>
2000 </member> 2600 </member>
2001 <member name="P:HttpServer.HttpResponse.ContentType"> 2601 <member name="P:HttpServer.IHttpRequest.HttpVersion">
2002 <summary> 2602 <summary>
2003 Kind of content in the body 2603 Gets or sets version of HTTP protocol that's used.
2004 </summary> 2604 </summary>
2005 <remarks>Default type is "text/html"</remarks> 2605 <remarks>
2606 Probably <see cref="F:HttpServer.HttpHelper.HTTP10"/> or <see cref="F:HttpServer.HttpHelper.HTTP11"/>.
2607 </remarks>
2608 <seealso cref="T:HttpServer.HttpHelper"/>
2006 </member> 2609 </member>
2007 <member name="P:HttpServer.HttpResponse.HeadersSent"> 2610 <member name="P:HttpServer.IHttpRequest.IsAjax">
2008 <summary> 2611 <summary>
2009 Headers have been sent to the client- 2612 Gets whether the request was made by Ajax (Asynchronous JavaScript)
2010 </summary> 2613 </summary>
2011 <remarks>You can not send any additional headers if they have already been sent.</remarks>
2012 </member> 2614 </member>
2013 <member name="P:HttpServer.HttpResponse.Sent"> 2615 <member name="P:HttpServer.IHttpRequest.Method">
2014 <summary> 2616 <summary>
2015 The whole response have been sent. 2617 Gets or sets requested method.
2016 </summary> 2618 </summary>
2619 <remarks>
2620 Will always be in upper case.
2621 </remarks>
2622 <see cref="P:HttpServer.IHttpRequest.Method"/>
2017 </member> 2623 </member>
2018 <member name="P:HttpServer.HttpResponse.Cookies"> 2624 <member name="P:HttpServer.IHttpRequest.Param">
2019 <summary> 2625 <summary>
2020 Cookies that should be created/changed. 2626 Gets parameter from <see cref="P:HttpServer.IHttpRequest.QueryString"/> or <see cref="P:HttpServer.IHttpRequest.Form"/>.
2021 </summary> 2627 </summary>
2022 </member> 2628 </member>
2023 <member name="T:HttpServer.HttpContextFactory"> 2629 <member name="P:HttpServer.IHttpRequest.QueryString">
2024 <summary> 2630 <summary>
2025 Used to create and reuse contexts. 2631 Gets variables sent in the query string
2026 </summary> 2632 </summary>
2027 </member> 2633 </member>
2028 <member name="T:HttpServer.IHttpContextFactory"> 2634 <member name="P:HttpServer.IHttpRequest.Uri">
2029 <summary> 2635 <summary>
2030 Used to create <see cref="T:HttpServer.IHttpClientContext"/>es. 2636 Gets or sets requested URI.
2031 </summary> 2637 </summary>
2032 </member> 2638 </member>
2033 <member name="M:HttpServer.IHttpContextFactory.CreateContext(System.Net.Sockets.Socket)"> 2639 <member name="P:HttpServer.IHttpRequest.UriParts">
2034 <summary> 2640 <summary>
2035 Creates a <see cref="T:HttpServer.IHttpClientContext"/> that handles a connected client. 2641 Gets URI absolute path divided into parts.
2036 </summary> 2642 </summary>
2037 <param name="socket">Client socket (accepted by the <see cref="T:HttpServer.HttpListener"/>).</param> 2643 <example>
2038 <returns>A creates <see cref="T:HttpServer.IHttpClientContext"/>.</returns> 2644 // URI is: http://gauffin.com/code/tiny/
2645 Console.WriteLine(request.UriParts[0]); // result: code
2646 Console.WriteLine(request.UriParts[1]); // result: tiny
2647 </example>
2648 <remarks>
2649 If you're using controllers than the first part is controller name,
2650 the second part is method name and the third part is Id property.
2651 </remarks>
2652 <seealso cref="P:HttpServer.IHttpRequest.Uri"/>
2039 </member> 2653 </member>
2040 <member name="M:HttpServer.IHttpContextFactory.CreateSecureContext(System.Net.Sockets.Socket,System.Security.Cryptography.X509Certificates.X509Certificate,System.Security.Authentication.SslProtocols)"> 2654 <member name="P:HttpServer.IHttpRequest.UriPath">
2041 <summary> 2655 <summary>
2042 Create a secure <see cref="T:HttpServer.IHttpClientContext"/>. 2656 Gets or sets path and query.
2043 </summary> 2657 </summary>
2044 <param name="socket">Client socket (accepted by the <see cref="T:HttpServer.HttpListener"/>).</param> 2658 <see cref="P:HttpServer.IHttpRequest.Uri"/>
2045 <param name="certificate">HTTPS certificate to use.</param> 2659 <remarks>
2046 <param name="protocol">Kind of HTTPS protocol. Usually TLS or SSL.</param> 2660 Are only used during request parsing. Cannot be set after "Host" header have been
2047 <returns>A created <see cref="T:HttpServer.IHttpClientContext"/>.</returns> 2661 added.
2662 </remarks>
2048 </member> 2663 </member>
2049 <member name="E:HttpServer.IHttpContextFactory.RequestReceived"> 2664 <member name="T:HttpServer.IHttpClientContext">
2050 <summary> 2665 <summary>
2051 A request have been received from one of the contexts. 2666 Contains a connection to a browser/client.
2052 </summary> 2667 </summary>
2053 </member> 2668 </member>
2054 <member name="M:HttpServer.HttpContextFactory.#ctor(HttpServer.ILogWriter,System.Int32,HttpServer.IRequestParserFactory)"> 2669 <member name="M:HttpServer.IHttpClientContext.Disconnect(System.Net.Sockets.SocketError)">
2055 <summary> 2670 <summary>
2056 Initializes a new instance of the <see cref="T:HttpServer.HttpContextFactory"/> class. 2671 Disconnect from client
2057 </summary> 2672 </summary>
2058 <param name="writer">The writer.</param> 2673 <param name="error">error to report in the <see cref="E:HttpServer.IHttpClientContext.Disconnected"/> event.</param>
2059 <param name="bufferSize">Amount of bytes to read from the incoming socket stream.</param>
2060 <param name="factory">Used to create a request parser.</param>
2061 </member> 2674 </member>
2062 <member name="M:HttpServer.HttpContextFactory.CreateContext(System.Boolean,System.Net.IPEndPoint,System.IO.Stream,System.Net.Sockets.Socket)"> 2675 <member name="M:HttpServer.IHttpClientContext.Respond(System.String,System.Net.HttpStatusCode,System.String,System.String,System.String)">
2063 <summary> 2676 <summary>
2064 Create a new context. 2677 Send a response.
2065 </summary> 2678 </summary>
2066 <param name="isSecured">true if socket is running HTTPS.</param> 2679 <param name="httpVersion">Either <see cref="F:HttpServer.HttpHelper.HTTP10"/> or <see cref="F:HttpServer.HttpHelper.HTTP11"/></param>
2067 <param name="endPoint">Client that connected</param> 2680 <param name="statusCode">HTTP status code</param>
2068 <param name="stream">Network/SSL stream.</param> 2681 <param name="reason">reason for the status code.</param>
2069 <returns>A context.</returns> 2682 <param name="body">HTML body contents, can be null or empty.</param>
2683 <param name="contentType">A content type to return the body as, i.e. 'text/html' or 'text/plain', defaults to 'text/html' if null or empty</param>
2684 <exception cref="T:System.ArgumentException">If <paramref name="httpVersion"/> is invalid.</exception>
2070 </member> 2685 </member>
2071 <member name="M:HttpServer.HttpContextFactory.CreateNewContext(System.Boolean,System.Net.IPEndPoint,System.IO.Stream,System.Net.Sockets.Socket)"> 2686 <member name="M:HttpServer.IHttpClientContext.Respond(System.String,System.Net.HttpStatusCode,System.String)">
2072 <summary> 2687 <summary>
2073 Create a new context. 2688 Send a response.
2074 </summary> 2689 </summary>
2075 <param name="isSecured">true if HTTPS is used.</param> 2690 <param name="httpVersion">Either <see cref="F:HttpServer.HttpHelper.HTTP10"/> or <see cref="F:HttpServer.HttpHelper.HTTP11"/></param>
2076 <param name="endPoint">Remote client</param> 2691 <param name="statusCode">HTTP status code</param>
2077 <param name="stream">Network stream, <see cref="T:HttpServer.HttpClientContext"/> uses <see cref="T:HttpServer.ReusableSocketNetworkStream"/>.</param> 2692 <param name="reason">reason for the status code.</param>
2078 <returns>A new context (always).</returns>
2079 </member> 2693 </member>
2080 <member name="M:HttpServer.HttpContextFactory.CreateSecureContext(System.Net.Sockets.Socket,System.Security.Cryptography.X509Certificates.X509Certificate,System.Security.Authentication.SslProtocols)"> 2694 <member name="M:HttpServer.IHttpClientContext.Respond(System.String)">
2081 <summary> 2695 <summary>
2082 Create a secure <see cref="T:HttpServer.IHttpClientContext"/>. 2696 Send a response.
2083 </summary> 2697 </summary>
2084 <param name="socket">Client socket (accepted by the <see cref="T:HttpServer.HttpListener"/>).</param> 2698 <exception cref="T:System.ArgumentNullException"></exception>
2085 <param name="certificate">HTTPS certificate to use.</param>
2086 <param name="protocol">Kind of HTTPS protocol. Usually TLS or SSL.</param>
2087 <returns>
2088 A created <see cref="T:HttpServer.IHttpClientContext"/>.
2089 </returns>
2090 </member> 2699 </member>
2091 <member name="M:HttpServer.HttpContextFactory.CreateContext(System.Net.Sockets.Socket)"> 2700 <member name="M:HttpServer.IHttpClientContext.Send(System.Byte[])">
2092 <summary> 2701 <summary>
2093 Creates a <see cref="T:HttpServer.IHttpClientContext"/> that handles a connected client. 2702 send a whole buffer
2094 </summary> 2703 </summary>
2095 <param name="socket">Client socket (accepted by the <see cref="T:HttpServer.HttpListener"/>).</param> 2704 <param name="buffer">buffer to send</param>
2096 <returns> 2705 <exception cref="T:System.ArgumentNullException"></exception>
2097 A creates <see cref="T:HttpServer.IHttpClientContext"/>.
2098 </returns>
2099 </member> 2706 </member>
2100 <member name="P:HttpServer.HttpContextFactory.UseTraceLogs"> 2707 <member name="M:HttpServer.IHttpClientContext.Send(System.Byte[],System.Int32,System.Int32)">
2101 <summary> 2708 <summary>
2102 True if detailed trace logs should be written. 2709 Send data using the stream
2103 </summary> 2710 </summary>
2711 <param name="buffer">Contains data to send</param>
2712 <param name="offset">Start position in buffer</param>
2713 <param name="size">number of bytes to send</param>
2714 <exception cref="T:System.ArgumentNullException"></exception>
2715 <exception cref="T:System.ArgumentOutOfRangeException"></exception>
2104 </member> 2716 </member>
2105 <member name="E:HttpServer.HttpContextFactory.RequestReceived"> 2717 <member name="M:HttpServer.IHttpClientContext.Close">
2106 <summary> 2718 <summary>
2107 A request have been received from one of the contexts. 2719 Closes the streams and disposes of the unmanaged resources
2108 </summary> 2720 </summary>
2109 </member> 2721 </member>
2110 <member name="T:HttpServer.ReusableSocketNetworkStream"> 2722 <member name="P:HttpServer.IHttpClientContext.Secured">
2111 <summary> 2723 <summary>
2112 Custom network stream to mark sockets as reusable when disposing the stream. 2724 Using SSL or other encryption method.
2113 </summary> 2725 </summary>
2114 </member> 2726 </member>
2115 <member name="M:HttpServer.ReusableSocketNetworkStream.#ctor(System.Net.Sockets.Socket)"> 2727 <member name="P:HttpServer.IHttpClientContext.IsSecured">
2116 <summary> 2728 <summary>
2117 Creates a new instance of the <see cref="T:System.Net.Sockets.NetworkStream" /> class for the specified <see cref="T:System.Net.Sockets.Socket" />. 2729 Using SSL or other encryption method.
2118 </summary> 2730 </summary>
2119 <param name="socket">
2120 The <see cref="T:System.Net.Sockets.Socket" /> that the <see cref="T:System.Net.Sockets.NetworkStream" /> will use to send and receive data.
2121 </param>
2122 <exception cref="T:System.ArgumentNullException">
2123 The <paramref name="socket" /> parameter is null.
2124 </exception>
2125 <exception cref="T:System.IO.IOException">
2126 The <paramref name="socket" /> parameter is not connected.
2127 -or-
2128 The <see cref="P:System.Net.Sockets.Socket.SocketType" /> property of the <paramref name="socket" /> parameter is not <see cref="F:System.Net.Sockets.SocketType.Stream" />.
2129 -or-
2130 The <paramref name="socket" /> parameter is in a nonblocking state.
2131 </exception>
2132 </member> 2731 </member>
2133 <member name="M:HttpServer.ReusableSocketNetworkStream.#ctor(System.Net.Sockets.Socket,System.Boolean)"> 2732 <member name="E:HttpServer.IHttpClientContext.Disconnected">
2134 <summary> 2733 <summary>
2135 Initializes a new instance of the <see cref="T:System.Net.Sockets.NetworkStream" /> class for the specified <see cref="T:System.Net.Sockets.Socket" /> with the specified <see cref="T:System.Net.Sockets.Socket" /> ownership. 2734 The context have been disconnected.
2136 </summary> 2735 </summary>
2137 <param name="socket"> 2736 <remarks>
2138 The <see cref="T:System.Net.Sockets.Socket" /> that the <see cref="T:System.Net.Sockets.NetworkStream" /> will use to send and receive data. 2737 Event can be used to clean up a context, or to reuse it.
2139 </param> 2738 </remarks>
2140 <param name="ownsSocket">
2141 Set to true to indicate that the <see cref="T:System.Net.Sockets.NetworkStream" /> will take ownership of the <see cref="T:System.Net.Sockets.Socket" />; otherwise, false.
2142 </param>
2143 <exception cref="T:System.ArgumentNullException">
2144 The <paramref name="socket" /> parameter is null.
2145 </exception>
2146 <exception cref="T:System.IO.IOException">
2147 The <paramref name="socket" /> parameter is not connected.
2148 -or-
2149 the value of the <see cref="P:System.Net.Sockets.Socket.SocketType" /> property of the <paramref name="socket" /> parameter is not <see cref="F:System.Net.Sockets.SocketType.Stream" />.
2150 -or-
2151 the <paramref name="socket" /> parameter is in a nonblocking state.
2152 </exception>
2153 </member> 2739 </member>
2154 <member name="M:HttpServer.ReusableSocketNetworkStream.#ctor(System.Net.Sockets.Socket,System.IO.FileAccess)"> 2740 <member name="E:HttpServer.IHttpClientContext.RequestReceived">
2155 <summary> 2741 <summary>
2156 Creates a new instance of the <see cref="T:System.Net.Sockets.NetworkStream" /> class for the specified <see cref="T:System.Net.Sockets.Socket" /> with the specified access rights. 2742 A request have been received in the context.
2157 </summary> 2743 </summary>
2158 <param name="socket">
2159 The <see cref="T:System.Net.Sockets.Socket" /> that the <see cref="T:System.Net.Sockets.NetworkStream" /> will use to send and receive data.
2160 </param>
2161 <param name="access">
2162 A bitwise combination of the <see cref="T:System.IO.FileAccess" /> values that specify the type of access given to the <see cref="T:System.Net.Sockets.NetworkStream" /> over the provided <see cref="T:System.Net.Sockets.Socket" />.
2163 </param>
2164 <exception cref="T:System.ArgumentNullException">
2165 The <paramref name="socket" /> parameter is null.
2166 </exception>
2167 <exception cref="T:System.IO.IOException">
2168 The <paramref name="socket" /> parameter is not connected.
2169 -or-
2170 the <see cref="P:System.Net.Sockets.Socket.SocketType" /> property of the <paramref name="socket" /> parameter is not <see cref="F:System.Net.Sockets.SocketType.Stream" />.
2171 -or-
2172 the <paramref name="socket" /> parameter is in a nonblocking state.
2173 </exception>
2174 </member> 2744 </member>
2175 <member name="M:HttpServer.ReusableSocketNetworkStream.#ctor(System.Net.Sockets.Socket,System.IO.FileAccess,System.Boolean)"> 2745 <member name="T:HttpServer.DisconnectedEventArgs">
2176 <summary> 2746 <summary>
2177 Creates a new instance of the <see cref="T:System.Net.Sockets.NetworkStream" /> class for the specified <see cref="T:System.Net.Sockets.Socket" /> with the specified access rights and the specified <see cref="T:System.Net.Sockets.Socket" /> ownership. 2747 A <see cref="T:HttpServer.IHttpClientContext"/> have been disconnected.
2178 </summary> 2748 </summary>
2179 <param name="socket">
2180 The <see cref="T:System.Net.Sockets.Socket" /> that the <see cref="T:System.Net.Sockets.NetworkStream" /> will use to send and receive data.
2181 </param>
2182 <param name="access">
2183 A bitwise combination of the <see cref="T:System.IO.FileAccess" /> values that specifies the type of access given to the <see cref="T:System.Net.Sockets.NetworkStream" /> over the provided <see cref="T:System.Net.Sockets.Socket" />.
2184 </param>
2185 <param name="ownsSocket">
2186 Set to true to indicate that the <see cref="T:System.Net.Sockets.NetworkStream" /> will take ownership of the <see cref="T:System.Net.Sockets.Socket" />; otherwise, false.
2187 </param>
2188 <exception cref="T:System.ArgumentNullException">
2189 The <paramref name="socket" /> parameter is null.
2190 </exception>
2191 <exception cref="T:System.IO.IOException">
2192 The <paramref name="socket" /> parameter is not connected.
2193 -or-
2194 The <see cref="P:System.Net.Sockets.Socket.SocketType" /> property of the <paramref name="socket" /> parameter is not <see cref="F:System.Net.Sockets.SocketType.Stream" />.
2195 -or-
2196 The <paramref name="socket" /> parameter is in a nonblocking state.
2197 </exception>
2198 </member> 2749 </member>
2199 <member name="M:HttpServer.ReusableSocketNetworkStream.Close"> 2750 <member name="M:HttpServer.DisconnectedEventArgs.#ctor(System.Net.Sockets.SocketError)">
2200 <summary> 2751 <summary>
2201 Closes the current stream and releases any resources (such as sockets and file handles) associated with the current stream. 2752 Initializes a new instance of the <see cref="T:HttpServer.DisconnectedEventArgs"/> class.
2202 </summary> 2753 </summary>
2754 <param name="error">Reason to disconnection.</param>
2203 </member> 2755 </member>
2204 <member name="M:HttpServer.ReusableSocketNetworkStream.Dispose(System.Boolean)"> 2756 <member name="P:HttpServer.DisconnectedEventArgs.Error">
2205 <summary> 2757 <summary>
2206 Releases the unmanaged resources used by the <see cref="T:System.Net.Sockets.NetworkStream"/> and optionally releases the managed resources. 2758 Gets reason to why client disconnected.
2207 </summary> 2759 </summary>
2208 <param name="disposing">true to release both managed and unmanaged resources; false to release only unmanaged resources.</param>
2209 </member> 2760 </member>
2210 <member name="T:HttpServer.Authentication.BasicAuthentication"> 2761 <member name="T:HttpServer.RequestEventArgs">
2211 <summary> 2762 <summary>
2212 The "basic" authentication scheme is based on the model that the 2763
2213 client must authenticate itself with a user-ID and a password for
2214 each realm. The realm value should be considered an opaque string
2215 which can only be compared for equality with other realms on that
2216 server. The server will service the request only if it can validate
2217 the user-ID and password for the protection space of the Request-URI.
2218 There are no optional authentication parameters.
2219 </summary> 2764 </summary>
2220 </member> 2765 </member>
2221 <member name="T:HttpServer.Authentication.AuthenticationModule"> 2766 <member name="M:HttpServer.RequestEventArgs.#ctor(HttpServer.IHttpRequest)">
2222 <summary> 2767 <summary>
2223 Authentication modules are used to implement different 2768 Initializes a new instance of the <see cref="T:HttpServer.RequestEventArgs"/> class.
2224 kind of HTTP authentication.
2225 </summary> 2769 </summary>
2770 <param name="request">The request.</param>
2226 </member> 2771 </member>
2227 <member name="F:HttpServer.Authentication.AuthenticationModule.AuthenticationTag"> 2772 <member name="P:HttpServer.RequestEventArgs.Request">
2228 <summary> 2773 <summary>
2229 Tag used for authentication. 2774 Gets received request.
2230 </summary> 2775 </summary>
2231 </member> 2776 </member>
2232 <member name="M:HttpServer.Authentication.AuthenticationModule.#ctor(HttpServer.Authentication.AuthenticationHandler,HttpServer.Authentication.AuthenticationRequiredHandler)"> 2777 <member name="T:HttpServer.HttpModules.WebSiteModule">
2233 <summary> 2778 <summary>
2234 Initializes a new instance of the <see cref="T:HttpServer.Authentication.AuthenticationModule"/> class. 2779 The website module let's you handle multiple websites in the same server.
2780 It uses the "Host" header to check which site you want.
2235 </summary> 2781 </summary>
2236 <param name="authenticator">Delegate used to provide information used during authentication.</param> 2782 <remarks>It's recommended that you do not
2237 <param name="authenticationRequiredHandler">Delegate used to determine if authentication is required (may be null).</param> 2783 add any other modules to HttpServer if you are using the website module. Instead,
2784 add all wanted modules to each website.</remarks>
2238 </member> 2785 </member>
2239 <member name="M:HttpServer.Authentication.AuthenticationModule.#ctor(HttpServer.Authentication.AuthenticationHandler)"> 2786 <member name="M:HttpServer.HttpModules.WebSiteModule.#ctor(System.String,System.String)">
2240 <summary> 2787 <summary>
2241 Initializes a new instance of the <see cref="T:HttpServer.Authentication.AuthenticationModule"/> class. 2788
2242 </summary> 2789 </summary>
2243 <param name="authenticator">Delegate used to provide information used during authentication.</param> 2790 <param name="host">domain name that should be handled.</param>
2791 <param name="name"></param>
2244 </member> 2792 </member>
2245 <member name="M:HttpServer.Authentication.AuthenticationModule.CreateResponse(System.String,System.Object[])"> 2793 <member name="M:HttpServer.HttpModules.WebSiteModule.Process(HttpServer.IHttpRequest,HttpServer.IHttpResponse,HttpServer.Sessions.IHttpSession)">
2246 <summary> 2794 <summary>
2247 Create a response that can be sent in the WWW-Authenticate header. 2795 Method that process the url
2248 </summary> 2796 </summary>
2249 <param name="realm">Realm that the user should authenticate in</param> 2797 <param name="request">Information sent by the browser about the request</param>
2250 <param name="options">Array with optional options.</param> 2798 <param name="response">Information that is being sent back to the client.</param>
2251 <returns>A correct authentication request.</returns> 2799 <param name="session">Session used to </param>
2252 <exception cref="T:System.ArgumentNullException">If realm is empty or null.</exception>
2253 </member> 2800 </member>
2254 <member name="M:HttpServer.Authentication.AuthenticationModule.Authenticate(System.String,System.String,System.String,System.Object[])"> 2801 <member name="P:HttpServer.HttpModules.WebSiteModule.SiteName">
2255 <summary> 2802 <summary>
2256 An authentication response have been received from the web browser. 2803 Name of site.
2257 Check if it's correct
2258 </summary> 2804 </summary>
2259 <param name="authenticationHeader">Contents from the Authorization header</param>
2260 <param name="realm">Realm that should be authenticated</param>
2261 <param name="httpVerb">GET/POST/PUT/DELETE etc.</param>
2262 <param name="options">options to specific implementations</param>
2263 <returns>Authentication object that is stored for the request. A user class or something like that.</returns>
2264 <exception cref="T:System.ArgumentException">if <paramref name="authenticationHeader"/> is invalid</exception>
2265 <exception cref="T:System.ArgumentNullException">If any of the parameters is empty or null.</exception>
2266 </member> 2805 </member>
2267 <member name="M:HttpServer.Authentication.AuthenticationModule.CheckAuthentication(System.String,System.String,System.String@,System.Object@)"> 2806 <member name="T:HttpServer.HttpInputItem">
2268 <summary> 2807 <summary>
2269 Used to invoke the authentication delegate that is used to lookup the user name/realm. 2808 represents a HTTP input item. Each item can have multiple sub items, a sub item
2809 is made in a HTML form by using square brackets
2270 </summary> 2810 </summary>
2271 <param name="realm">Realm (domain) that user want to authenticate in</param> 2811 <example>
2272 <param name="userName">User name</param> 2812 // <input type="text" name="user[FirstName]" value="jonas" /> becomes:
2273 <param name="password">Password used for validation. Some implementations got password in clear text, they are then sent to client.</param> 2813 Console.WriteLine("Value: {0}", form["user"]["FirstName"].Value);
2274 <param name="login">object that will be stored in the request to help you identify the user if authentication was successful.</param> 2814 </example>
2275 <returns>true if authentication was successful</returns> 2815 <remarks>
2816 All names in a form SHOULD be in lowercase.
2817 </remarks>
2276 </member> 2818 </member>
2277 <member name="M:HttpServer.Authentication.AuthenticationModule.AuthenticationRequired(HttpServer.IHttpRequest)"> 2819 <member name="F:HttpServer.HttpInputItem.Empty">
2820 <summary> Representation of a non-initialized <see cref="T:HttpServer.HttpInputItem"/>.</summary>
2821 </member>
2822 <member name="M:HttpServer.HttpInputItem.#ctor(System.String,System.String)">
2278 <summary> 2823 <summary>
2279 Determines if authentication is required. 2824 Initializes an input item setting its name/identifier and value
2280 </summary> 2825 </summary>
2281 <param name="request">HTTP request from browser</param> 2826 <param name="name">Parameter name/id</param>
2282 <returns>true if user should be authenticated.</returns> 2827 <param name="value">Parameter value</param>
2283 <remarks>throw <see cref="T:HttpServer.Exceptions.ForbiddenException"/> from your delegate if no more attempts are allowed.</remarks>
2284 <exception cref="T:HttpServer.Exceptions.ForbiddenException">If no more attempts are allowed</exception>
2285 </member> 2828 </member>
2286 <member name="P:HttpServer.Authentication.AuthenticationModule.Name"> 2829 <member name="M:HttpServer.HttpInputItem.#ctor(HttpServer.HttpInputItem)">
2830 <summary>Creates a deep copy of the item specified</summary>
2831 <param name="item">The item to copy</param>
2832 <remarks>The function makes a deep copy of quite a lot which can be slow</remarks>
2833 </member>
2834 <member name="M:HttpServer.HttpInputItem.Add(System.String)">
2287 <summary> 2835 <summary>
2288 name used in HTTP request. 2836 Add another value to this item
2289 </summary> 2837 </summary>
2838 <param name="value">Value to add.</param>
2839 <exception cref="T:System.InvalidOperationException">Cannot add stuff to <see cref="F:HttpServer.HttpInput.Empty"/>.</exception>
2290 </member> 2840 </member>
2291 <member name="M:HttpServer.Authentication.BasicAuthentication.#ctor(HttpServer.Authentication.AuthenticationHandler,HttpServer.Authentication.AuthenticationRequiredHandler)"> 2841 <member name="M:HttpServer.HttpInputItem.Contains(System.String)">
2292 <summary> 2842 <summary>
2293 Initializes a new instance of the <see cref="T:HttpServer.Authentication.BasicAuthentication"/> class. 2843 checks if a sub-item exists (and has a value).
2294 </summary> 2844 </summary>
2295 <param name="authenticator">Delegate used to provide information used during authentication.</param> 2845 <param name="name">name in lower case</param>
2296 <param name="authenticationRequiredHandler">Delegate used to determine if authentication is required (may be null).</param> 2846 <returns>true if the sub-item exists and has a value; otherwise false.</returns>
2297 </member> 2847 </member>
2298 <member name="M:HttpServer.Authentication.BasicAuthentication.#ctor(HttpServer.Authentication.AuthenticationHandler)"> 2848 <member name="M:HttpServer.HttpInputItem.ToString">
2849 <summary> Returns a formatted representation of the instance with the values of all contained parameters </summary>
2850 </member>
2851 <member name="M:HttpServer.HttpInputItem.ToString(System.String,System.Boolean)">
2299 <summary> 2852 <summary>
2300 Initializes a new instance of the <see cref="T:HttpServer.Authentication.BasicAuthentication"/> class. 2853 Outputs the string in a formatted manner
2301 </summary> 2854 </summary>
2302 <param name="authenticator">Delegate used to provide information used during authentication.</param> 2855 <param name="prefix">A prefix to append, used internally</param>
2856 <param name="asQuerySting">produce a query string</param>
2303 </member> 2857 </member>
2304 <member name="M:HttpServer.Authentication.BasicAuthentication.CreateResponse(System.String,System.Object[])"> 2858 <member name="M:HttpServer.HttpInputItem.Add(System.String,System.String)">
2305 <summary> 2859 <summary>
2306 Create a response that can be sent in the WWW-Authenticate header. 2860 Add a sub item.
2307 </summary> 2861 </summary>
2308 <param name="realm">Realm that the user should authenticate in</param> 2862 <param name="name">Can contain array formatting, the item is then parsed and added in multiple levels</param>
2309 <param name="options">Not used in basic auth</param> 2863 <param name="value">Value to add.</param>
2310 <returns>A correct auth request.</returns> 2864 <exception cref="T:System.ArgumentNullException">Argument is null.</exception>
2865 <exception cref="T:System.InvalidOperationException">Cannot add stuff to <see cref="F:HttpServer.HttpInput.Empty"/>.</exception>
2311 </member> 2866 </member>
2312 <member name="M:HttpServer.Authentication.BasicAuthentication.Authenticate(System.String,System.String,System.String,System.Object[])"> 2867 <member name="M:HttpServer.HttpInputItem.System#Collections#Generic#IEnumerable{HttpServer#HttpInputItem}#GetEnumerator">
2313 <summary> 2868 <summary>
2314 An authentication response have been received from the web browser. 2869 Returns an enumerator that iterates through the collection.
2315 Check if it's correct
2316 </summary> 2870 </summary>
2317 <param name="authenticationHeader">Contents from the Authorization header</param> 2871
2318 <param name="realm">Realm that should be authenticated</param> 2872 <returns>
2319 <param name="httpVerb">GET/POST/PUT/DELETE etc.</param> 2873 A <see cref="T:System.Collections.Generic.IEnumerator`1"></see> that can be used to iterate through the collection.
2320 <param name="options">Not used in basic auth</param> 2874 </returns>
2321 <returns>Authentication object that is stored for the request. A user class or something like that.</returns> 2875 <filterpriority>1</filterpriority>
2322 <exception cref="T:System.ArgumentException">if authenticationHeader is invalid</exception>
2323 <exception cref="T:System.ArgumentNullException">If any of the paramters is empty or null.</exception>
2324 </member> 2876 </member>
2325 <member name="P:HttpServer.Authentication.BasicAuthentication.Name"> 2877 <member name="M:HttpServer.HttpInputItem.GetEnumerator">
2326 <summary> 2878 <summary>
2327 name used in http request. 2879 Returns an enumerator that iterates through a collection.
2328 </summary> 2880 </summary>
2881
2882 <returns>
2883 An <see cref="T:System.Collections.IEnumerator"></see> object that can be used to iterate through the collection.
2884 </returns>
2885 <filterpriority>2</filterpriority>
2329 </member> 2886 </member>
2330 <member name="T:HttpServer.HttpModules.HttpModuleExceptionEventArgs"> 2887 <member name="M:HttpServer.HttpInputItem.ToString(System.String)">
2331 <summary> 2888 <summary>
2332 Used to inform http server that 2889 Outputs the string in a formatted manner
2333 </summary> 2890 </summary>
2891 <param name="prefix">A prefix to append, used internally</param>
2892 <returns></returns>
2334 </member> 2893 </member>
2335 <member name="M:HttpServer.HttpModules.HttpModuleExceptionEventArgs.#ctor(System.Exception)"> 2894 <member name="P:HttpServer.HttpInputItem.Count">
2336 <summary> 2895 <summary>
2337 Eventarguments used when an exception is thrown by a module 2896 Number of values
2338 </summary> 2897 </summary>
2339 <param name="e">the exception</param>
2340 </member> 2898 </member>
2341 <member name="P:HttpServer.HttpModules.HttpModuleExceptionEventArgs.Exception"> 2899 <member name="P:HttpServer.HttpInputItem.Item(System.String)">
2342 <summary> 2900 <summary>
2343 Exception thrown in a module 2901 Get a sub item
2344 </summary> 2902 </summary>
2903 <param name="name">name in lower case.</param>
2904 <returns><see cref="F:HttpServer.HttpInputItem.Empty"/> if no item was found.</returns>
2345 </member> 2905 </member>
2346 <member name="T:HttpServer.Helpers.Implementations.PrototypeImp"> 2906 <member name="P:HttpServer.HttpInputItem.Name">
2347 <summary> 2907 <summary>
2348 PrototypeJS implementation of the javascript functions. 2908 Name of item (in lower case).
2349 </summary> 2909 </summary>
2350 </member> 2910 </member>
2351 <member name="T:HttpServer.Helpers.JavascriptHelperImplementation"> 2911 <member name="P:HttpServer.HttpInputItem.Value">
2352 <summary> 2912 <summary>
2353 Purpose of this class is to create a javascript toolkit independent javascript helper. 2913 Returns the first value, or null if no value exist.
2354 </summary> 2914 </summary>
2355 </member> 2915 </member>
2356 <member name="M:HttpServer.Helpers.JavascriptHelperImplementation.GenerateOptions(System.Text.StringBuilder,System.String[],System.Boolean)"> 2916 <member name="P:HttpServer.HttpInputItem.LastValue">
2357 <summary> 2917 <summary>
2358 Generates a list with JS options. 2918 Returns the last value, or null if no value exist.
2359 </summary> 2919 </summary>
2360 <param name="sb">StringBuilder that the options should be added to.</param>
2361 <param name="options">the javascript options. name, value pairs. each string value should be escaped by YOU!</param>
2362 <param name="startWithComma">true if we should start with a comma.</param>
2363 </member> 2920 </member>
2364 <member name="M:HttpServer.Helpers.JavascriptHelperImplementation.RemoveJavascriptOptions(System.String[])"> 2921 <member name="P:HttpServer.HttpInputItem.Values">
2365 <summary> 2922 <summary>
2366 Removes any javascript parameters from an array of parameters 2923 Returns the list with values.
2367 </summary> 2924 </summary>
2368 <param name="options">The array of parameters to remove javascript params from</param>
2369 <returns>An array of html parameters</returns>
2370 </member> 2925 </member>
2371 <member name="M:HttpServer.Helpers.JavascriptHelperImplementation.AjaxFormOnSubmit(System.String[])"> 2926 <member name="P:HttpServer.HttpInputItem.HttpServer#IHttpInput#Item(System.String)">
2372 <summary> 2927 <summary>
2373 javascript action that should be added to the "onsubmit" event in the form tag. 2928
2374 </summary> 2929 </summary>
2930 <param name="name">name in lower case</param>
2375 <returns></returns> 2931 <returns></returns>
2376 <remarks>All javascript option names should end with colon.</remarks>
2377 <example>
2378 <code>
2379 JSHelper.AjaxRequest("/user/show/1", "onsuccess:", "$('userInfo').update(result);");
2380 </code>
2381 </example>
2382 </member> 2932 </member>
2383 <member name="M:HttpServer.Helpers.JavascriptHelperImplementation.AjaxRequest(System.String,System.String[])"> 2933 <member name="T:HttpServer.HttpFile">
2384 <summary> 2934 <summary>
2385 Requests a url through ajax 2935 Container class for posted files
2386 </summary> 2936 </summary>
2387 <param name="url">url to fetch</param>
2388 <param name="options">optional options in format "key, value, key, value", used in JS request object.</param>
2389 <returns>a link tag</returns>
2390 <remarks>All javascript option names should end with colon.</remarks>
2391 <example>
2392 <code>
2393 JSHelper.AjaxRequest("/user/show/1", "onsuccess:", "$('userInfo').update(result);");
2394 </code>
2395 </example>
2396 </member> 2937 </member>
2397 <member name="M:HttpServer.Helpers.JavascriptHelperImplementation.AjaxUpdater(System.String,System.String,System.String[])"> 2938 <member name="M:HttpServer.HttpFile.#ctor(System.String,System.String,System.String,System.String)">
2398 <summary> 2939 <summary>
2399 Ajax requests that updates an element with 2940 Creates a container for a posted file
2400 the fetched content
2401 </summary> 2941 </summary>
2402 <param name="url">Url to fetch content from</param> 2942 <param name="name">The identifier of the post field</param>
2403 <param name="targetId">element to update</param> 2943 <param name="filename">The file path</param>
2404 <param name="options">optional options in format "key, value, key, value", used in JS updater object.</param> 2944 <param name="contentType">The content type of the file</param>
2405 <returns>A link tag.</returns> 2945 <param name="uploadFilename">The name of the file uploaded</param>
2406 <remarks>All javascript option names should end with colon.</remarks> 2946 <exception cref="T:System.ArgumentNullException">If any parameter is null or empty</exception>
2407 <example>
2408 <code>
2409 JSHelper.AjaxUpdater("/user/show/1", "userInfo", "onsuccess:", "alert('Successful!');");
2410 </code>
2411 </example>
2412 </member> 2947 </member>
2413 <member name="M:HttpServer.Helpers.JavascriptHelperImplementation.DialogLink(System.String,System.String,System.String[])"> 2948 <member name="M:HttpServer.HttpFile.#ctor(System.String,System.String,System.String)">
2414 <summary> 2949 <summary>
2415 A link that pop ups a Dialog (overlay div) 2950 Creates a container for a posted file <see cref="M:HttpServer.HttpFile.#ctor(System.String,System.String,System.String,System.String)"/>
2416 </summary> 2951 </summary>
2417 <param name="url">url to contents of dialog</param> 2952 <exception cref="T:System.ArgumentNullException">If any parameter is null or empty</exception>
2418 <param name="title">link title</param>
2419 <returns>A "a"-tag that popups a dialog when clicked</returns>
2420 <param name="htmlAttributes">name/value of html attributes</param>
2421 <example>
2422 WebHelper.DialogLink("/user/show/1", "show user", "onmouseover", "alert('booh!');");
2423 </example>
2424 </member> 2953 </member>
2425 <member name="M:HttpServer.Helpers.JavascriptHelperImplementation.CloseDialog"> 2954 <member name="M:HttpServer.HttpFile.Finalize">
2955 <summary>Destructor disposing the file</summary>
2956 </member>
2957 <member name="M:HttpServer.HttpFile.Dispose(System.Boolean)">
2426 <summary> 2958 <summary>
2427 Close a javascript dialog window/div. 2959 Deletes the temporary file
2428 </summary> 2960 </summary>
2429 <returns>javascript for closing a dialog.</returns> 2961 <param name="disposing">True if manual dispose</param>
2430 <see cref="M:HttpServer.Helpers.JavascriptHelperImplementation.DialogLink(System.String,System.String,System.String[])"/>
2431 </member> 2962 </member>
2432 <member name="M:HttpServer.Helpers.JavascriptHelperImplementation.CreateDialog(System.String,System.String,System.String[])"> 2963 <member name="M:HttpServer.HttpFile.Dispose">
2433 <summary> 2964 <summary>
2434 Creates a new modal dialog window 2965 Disposing interface, cleans up managed resources (the temporary file) and suppresses finalization
2966 </summary>
2967 </member>
2968 <member name="P:HttpServer.HttpFile.Name">
2969 <summary>
2970 The name/id of the file
2971 </summary>
2972 </member>
2973 <member name="P:HttpServer.HttpFile.Filename">
2974 <summary>
2975 The full file path
2976 </summary>
2977 </member>
2978 <member name="P:HttpServer.HttpFile.UploadFilename">
2979 <summary>
2980 The name of the uploaded file
2981 </summary>
2982 </member>
2983 <member name="P:HttpServer.HttpFile.ContentType">
2984 <summary>
2985 The type of file
2986 </summary>
2987 </member>
2988 <member name="T:HttpServer.Helpers.Implementations.PrototypeImp">
2989 <summary>
2990 PrototypeJS implementation of the javascript functions.
2435 </summary> 2991 </summary>
2436 <param name="url">url to open in window.</param>
2437 <param name="title">window title (may not be supported by all js implementations)</param>
2438 <param name="options"></param>
2439 <returns></returns>
2440 </member> 2992 </member>
2441 <member name="M:HttpServer.Helpers.Implementations.PrototypeImp.AjaxRequest(System.String,System.String[])"> 2993 <member name="M:HttpServer.Helpers.Implementations.PrototypeImp.AjaxRequest(System.String,System.String[])">
2442 <summary> 2994 <summary>
@@ -2533,907 +3085,587 @@
2533 </code> 3085 </code>
2534 </example> 3086 </example>
2535 </member> 3087 </member>
2536 <member name="T:HttpServer.ContentType"> 3088 <member name="T:HttpServer.Exceptions.UnauthorizedException">
2537 <summary>
2538 Lists content type mime types.
2539 </summary>
2540 </member>
2541 <member name="F:HttpServer.ContentType.Text">
2542 <summary>
2543 text/plain
2544 </summary>
2545 </member>
2546 <member name="F:HttpServer.ContentType.Html">
2547 <summary>
2548 text/haml
2549 </summary>
2550 </member>
2551 <member name="F:HttpServer.ContentType.Javascript">
2552 <summary>
2553 content type for javascript documents = application/javascript
2554 </summary>
2555 <remarks>
2556 <para>
2557 RFC 4329 states that text/javascript have been superseeded by
2558 application/javascript. You might still want to check browser versions
2559 since older ones do not support application/javascript.
2560 </para>
2561 <para>Browser support: http://krijnhoetmer.nl/stuff/javascript/mime-types/</para>
2562 </remarks>
2563 </member>
2564 <member name="F:HttpServer.ContentType.Xml">
2565 <summary>
2566 text/xml
2567 </summary>
2568 </member>
2569 <member name="T:HttpServer.ContentTypes">
2570 <summary>
2571 A list of content types
2572 </summary>
2573 </member>
2574 <member name="M:HttpServer.ContentTypes.#ctor(System.String)">
2575 <summary> 3089 <summary>
3090 The request requires user authentication. The response MUST include a
3091 WWW-Authenticate header field (section 14.47) containing a challenge
3092 applicable to the requested resource.
2576 3093
2577 </summary> 3094 The client MAY repeat the request with a suitable Authorization header
2578 <param name="types">Semicolon separated content types.</param> 3095 field (section 14.8). If the request already included Authorization
2579 </member> 3096 credentials, then the 401 response indicates that authorization has been
2580 <member name="M:HttpServer.ContentTypes.GetEnumerator"> 3097 refused for those credentials. If the 401 response contains the same challenge
2581 <summary> 3098 as the prior response, and the user agent has already attempted authentication
2582 Returns an enumerator that iterates through a collection. 3099 at least once, then the user SHOULD be presented the entity that was given in the response,
2583 </summary> 3100 since that entity might include relevant diagnostic information.
2584 <returns>
2585 An <see cref="T:System.Collections.IEnumerator"/> object that can be used to iterate through the collection.
2586 </returns>
2587 </member>
2588 <member name="M:HttpServer.ContentTypes.Contains(System.String)">
2589 <summary>
2590 Searches for the specified type
2591 </summary>
2592 <param name="type">Can also be a part of a type (searching for "xml" would return true for "application/xml").</param>
2593 <returns>true if type was found.</returns>
2594 </member>
2595 <member name="P:HttpServer.ContentTypes.First">
2596 <summary>
2597 Get this first content type.
2598 </summary>
2599 </member>
2600 <member name="P:HttpServer.ContentTypes.Item(System.String)">
2601 <summary>
2602 Fetch a content type
2603 </summary>
2604 <param name="type">Part of type ("xml" would return "application/xml")</param>
2605 <returns></returns>
2606 <remarks>All content types are in lower case.</remarks>
2607 </member>
2608 <member name="T:HttpServer.Parser.HeaderEventArgs">
2609 <summary>
2610 Event arguments used when a new header have been parsed.
2611 </summary>
2612 </member>
2613 <member name="M:HttpServer.Parser.HeaderEventArgs.#ctor(System.String,System.String)">
2614 <summary>
2615 Initializes a new instance of the <see cref="T:HttpServer.Parser.HeaderEventArgs"/> class.
2616 </summary>
2617 <param name="name">Name of header.</param>
2618 <param name="value">Header value.</param>
2619 </member>
2620 <member name="M:HttpServer.Parser.HeaderEventArgs.#ctor">
2621 <summary>
2622 Initializes a new instance of the <see cref="T:HttpServer.Parser.HeaderEventArgs"/> class.
2623 </summary>
2624 </member>
2625 <member name="P:HttpServer.Parser.HeaderEventArgs.Name">
2626 <summary>
2627 Gets or sets header name.
2628 </summary>
2629 </member>
2630 <member name="P:HttpServer.Parser.HeaderEventArgs.Value">
2631 <summary>
2632 Gets or sets header value.
2633 </summary>
2634 </member>
2635 <member name="T:HttpServer.HttpModules.ReverseProxyModule">
2636 <summary>
2637 A reverse proxy are used to act as a bridge between local (protected/hidden) websites
2638 and public clients.
2639 3101
2640 A typical usage is to allow web servers on non standard ports to still be available 3102 HTTP access authentication is explained in rfc2617:
2641 to the public clients, or allow web servers on private ips to be available. 3103 http://www.ietf.org/rfc/rfc2617.txt
2642 </summary>
2643 </member>
2644 <member name="M:HttpServer.HttpModules.ReverseProxyModule.#ctor(System.String,System.String)">
2645 <summary>
2646 3104
3105 (description is taken from
3106 http://www.submissionchamber.com/help-guides/error-codes.php#sec10.4.2)
2647 </summary> 3107 </summary>
2648 <param name="source">Base url requested from browser</param>
2649 <param name="destination">Base url on private web server</param>
2650 <example>
2651 // this will return contents from http://192.168.1.128/view/jonas when client requests http://www.gauffin.com/user/view/jonas
2652 _server.Add(new ReverseProxyModule("http://www.gauffin.com/user/", "http://192.168.1.128/");
2653 </example>
2654 </member> 3108 </member>
2655 <member name="M:HttpServer.HttpModules.ReverseProxyModule.CanHandle(System.Uri)"> 3109 <member name="M:HttpServer.Exceptions.UnauthorizedException.#ctor">
2656 <summary> 3110 <summary>
2657 Method that determines if an url should be handled or not by the module 3111 Create a new unauhtorized exception.
2658 </summary> 3112 </summary>
2659 <param name="uri">Url requested by the client.</param> 3113 <seealso cref="T:HttpServer.Exceptions.UnauthorizedException"/>
2660 <returns>true if module should handle the url.</returns>
2661 </member> 3114 </member>
2662 <member name="M:HttpServer.HttpModules.ReverseProxyModule.Process(HttpServer.IHttpRequest,HttpServer.IHttpResponse,HttpServer.Sessions.IHttpSession)"> 3115 <member name="M:HttpServer.Exceptions.UnauthorizedException.#ctor(System.String,System.Exception)">
2663 <summary> 3116 <summary>
2664 Method that process the url 3117 Create a new unauhtorized exception.
2665 </summary> 3118 </summary>
2666 <param name="request">Information sent by the browser about the request</param> 3119 <param name="message">reason to why the request was unauthorized.</param>
2667 <param name="response">Information that is being sent back to the client.</param> 3120 <param name="inner">inner exception</param>
2668 <param name="session">Session used to </param>
2669 </member> 3121 </member>
2670 <member name="T:HttpServer.HttpClientContext"> 3122 <member name="M:HttpServer.Exceptions.UnauthorizedException.#ctor(System.String)">
2671 <summary> 3123 <summary>
2672 Contains a connection to a browser/client. 3124 Create a new unauhtorized exception.
2673 </summary> 3125 </summary>
2674 <remarks> 3126 <param name="message">reason to why the request was unauthorized.</param>
2675 Remember to <see cref="M:HttpServer.HttpClientContext.Start"/> after you have hooked the <see cref="E:HttpServer.HttpClientContext.RequestReceived"/> event.
2676 </remarks>
2677 TODO: Maybe this class should be broken up into HttpClientChannel and HttpClientContext?
2678 </member> 3127 </member>
2679 <member name="T:HttpServer.IHttpClientContext"> 3128 <member name="T:HttpServer.Exceptions.ForbiddenException">
2680 <summary> 3129 <summary>
2681 Contains a connection to a browser/client. 3130 The server understood the request, but is refusing to fulfill it.
3131 Authorization will not help and the request SHOULD NOT be repeated.
3132 If the request method was not HEAD and the server wishes to make public why the request has not been fulfilled,
3133 it SHOULD describe the reason for the refusal in the entity. If the server does not wish to make this information
3134 available to the client, the status code 404 (Not Found) can be used instead.
3135
3136 Text taken from: http://www.submissionchamber.com/help-guides/error-codes.php
2682 </summary> 3137 </summary>
2683 </member> 3138 </member>
2684 <member name="M:HttpServer.IHttpClientContext.Disconnect(System.Net.Sockets.SocketError)"> 3139 <member name="M:HttpServer.Exceptions.ForbiddenException.#ctor(System.String)">
2685 <summary> 3140 <summary>
2686 Disconnect from client 3141 Initializes a new instance of the <see cref="T:HttpServer.Exceptions.ForbiddenException"/> class.
2687 </summary> 3142 </summary>
2688 <param name="error">error to report in the <see cref="E:HttpServer.IHttpClientContext.Disconnected"/> event.</param> 3143 <param name="errorMsg">error message</param>
2689 </member> 3144 </member>
2690 <member name="M:HttpServer.IHttpClientContext.Respond(System.String,System.Net.HttpStatusCode,System.String,System.String,System.String)"> 3145 <member name="T:HttpServer.Authentication.BasicAuthentication">
2691 <summary> 3146 <summary>
2692 Send a response. 3147 The "basic" authentication scheme is based on the model that the
3148 client must authenticate itself with a user-ID and a password for
3149 each realm. The realm value should be considered an opaque string
3150 which can only be compared for equality with other realms on that
3151 server. The server will service the request only if it can validate
3152 the user-ID and password for the protection space of the Request-URI.
3153 There are no optional authentication parameters.
2693 </summary> 3154 </summary>
2694 <param name="httpVersion">Either <see cref="F:HttpServer.HttpHelper.HTTP10"/> or <see cref="F:HttpServer.HttpHelper.HTTP11"/></param>
2695 <param name="statusCode">HTTP status code</param>
2696 <param name="reason">reason for the status code.</param>
2697 <param name="body">HTML body contents, can be null or empty.</param>
2698 <param name="contentType">A content type to return the body as, i.e. 'text/html' or 'text/plain', defaults to 'text/html' if null or empty</param>
2699 <exception cref="T:System.ArgumentException">If <paramref name="httpVersion"/> is invalid.</exception>
2700 </member> 3155 </member>
2701 <member name="M:HttpServer.IHttpClientContext.Respond(System.String,System.Net.HttpStatusCode,System.String)"> 3156 <member name="M:HttpServer.Authentication.BasicAuthentication.#ctor(HttpServer.Authentication.AuthenticationHandler,HttpServer.Authentication.AuthenticationRequiredHandler)">
2702 <summary> 3157 <summary>
2703 Send a response. 3158 Initializes a new instance of the <see cref="T:HttpServer.Authentication.BasicAuthentication"/> class.
2704 </summary> 3159 </summary>
2705 <param name="httpVersion">Either <see cref="F:HttpServer.HttpHelper.HTTP10"/> or <see cref="F:HttpServer.HttpHelper.HTTP11"/></param> 3160 <param name="authenticator">Delegate used to provide information used during authentication.</param>
2706 <param name="statusCode">HTTP status code</param> 3161 <param name="authenticationRequiredHandler">Delegate used to determine if authentication is required (may be null).</param>
2707 <param name="reason">reason for the status code.</param>
2708 </member> 3162 </member>
2709 <member name="M:HttpServer.IHttpClientContext.Respond(System.String)"> 3163 <member name="M:HttpServer.Authentication.BasicAuthentication.#ctor(HttpServer.Authentication.AuthenticationHandler)">
2710 <summary> 3164 <summary>
2711 Send a response. 3165 Initializes a new instance of the <see cref="T:HttpServer.Authentication.BasicAuthentication"/> class.
2712 </summary> 3166 </summary>
2713 <exception cref="T:System.ArgumentNullException"></exception> 3167 <param name="authenticator">Delegate used to provide information used during authentication.</param>
2714 </member> 3168 </member>
2715 <member name="M:HttpServer.IHttpClientContext.Send(System.Byte[])"> 3169 <member name="M:HttpServer.Authentication.BasicAuthentication.CreateResponse(System.String,System.Object[])">
2716 <summary> 3170 <summary>
2717 send a whole buffer 3171 Create a response that can be sent in the WWW-Authenticate header.
2718 </summary> 3172 </summary>
2719 <param name="buffer">buffer to send</param> 3173 <param name="realm">Realm that the user should authenticate in</param>
2720 <exception cref="T:System.ArgumentNullException"></exception> 3174 <param name="options">Not used in basic auth</param>
3175 <returns>A correct auth request.</returns>
2721 </member> 3176 </member>
2722 <member name="M:HttpServer.IHttpClientContext.Send(System.Byte[],System.Int32,System.Int32)"> 3177 <member name="M:HttpServer.Authentication.BasicAuthentication.Authenticate(System.String,System.String,System.String,System.Object[])">
2723 <summary> 3178 <summary>
2724 Send data using the stream 3179 An authentication response have been received from the web browser.
3180 Check if it's correct
2725 </summary> 3181 </summary>
2726 <param name="buffer">Contains data to send</param> 3182 <param name="authenticationHeader">Contents from the Authorization header</param>
2727 <param name="offset">Start position in buffer</param> 3183 <param name="realm">Realm that should be authenticated</param>
2728 <param name="size">number of bytes to send</param> 3184 <param name="httpVerb">GET/POST/PUT/DELETE etc.</param>
2729 <exception cref="T:System.ArgumentNullException"></exception> 3185 <param name="options">Not used in basic auth</param>
2730 <exception cref="T:System.ArgumentOutOfRangeException"></exception> 3186 <returns>Authentication object that is stored for the request. A user class or something like that.</returns>
3187 <exception cref="T:System.ArgumentException">if authenticationHeader is invalid</exception>
3188 <exception cref="T:System.ArgumentNullException">If any of the paramters is empty or null.</exception>
2731 </member> 3189 </member>
2732 <member name="M:HttpServer.IHttpClientContext.Close"> 3190 <member name="P:HttpServer.Authentication.BasicAuthentication.Name">
2733 <summary> 3191 <summary>
2734 Closes the streams and disposes of the unmanaged resources 3192 name used in http request.
2735 </summary> 3193 </summary>
2736 </member> 3194 </member>
2737 <member name="P:HttpServer.IHttpClientContext.Secured"> 3195 <member name="T:HttpServer.Sessions.IHttpSessionStore">
2738 <summary> 3196 <summary>
2739 Using SSL or other encryption method. 3197 A session store is used to store and load sessions on a media.
3198 The default implementation (<see cref="T:HttpServer.Sessions.MemorySessionStore"/>) saves/retrieves sessions from memory.
2740 </summary> 3199 </summary>
2741 </member> 3200 </member>
2742 <member name="P:HttpServer.IHttpClientContext.IsSecured"> 3201 <member name="M:HttpServer.Sessions.IHttpSessionStore.Create">
2743 <summary> 3202 <summary>
2744 Using SSL or other encryption method. 3203 Creates a new http session with a generated id.
2745 </summary> 3204 </summary>
3205 <returns>A <see cref="T:HttpServer.Sessions.IHttpSession"/> object</returns>
2746 </member> 3206 </member>
2747 <member name="E:HttpServer.IHttpClientContext.Disconnected"> 3207 <member name="M:HttpServer.Sessions.IHttpSessionStore.Create(System.String)">
2748 <summary> 3208 <summary>
2749 The context have been disconnected. 3209 Creates a new http session with a specific id
2750 </summary> 3210 </summary>
3211 <param name="id">Id used to identify the new cookie..</param>
3212 <returns>A <see cref="T:HttpServer.Sessions.IHttpSession"/> object.</returns>
2751 <remarks> 3213 <remarks>
2752 Event can be used to clean up a context, or to reuse it. 3214 Id should be generated by the store implementation if it's null or <see cref="F:System.String.Empty"/>.
2753 </remarks> 3215 </remarks>
2754 </member> 3216 </member>
2755 <member name="E:HttpServer.IHttpClientContext.RequestReceived"> 3217 <member name="M:HttpServer.Sessions.IHttpSessionStore.Load(System.String)">
2756 <summary>
2757 A request have been received in the context.
2758 </summary>
2759 </member>
2760 <member name="M:HttpServer.HttpClientContext.#ctor(System.Boolean,System.Net.IPEndPoint,System.IO.Stream,HttpServer.IRequestParserFactory,System.Int32,System.Net.Sockets.Socket)">
2761 <summary>
2762 Initializes a new instance of the <see cref="T:HttpServer.HttpClientContext"/> class.
2763 </summary>
2764 <param name="secured">true if the connection is secured (SSL/TLS)</param>
2765 <param name="remoteEndPoint">client that connected.</param>
2766 <param name="stream">Stream used for communication</param>
2767 <param name="parserFactory">Used to create a <see cref="T:HttpServer.IHttpRequestParser"/>.</param>
2768 <param name="bufferSize">Size of buffer to use when reading data. Must be at least 4096 bytes.</param>
2769 <exception cref="T:System.Net.Sockets.SocketException">If <see cref="M:System.Net.Sockets.Socket.BeginReceive(System.Byte[],System.Int32,System.Int32,System.Net.Sockets.SocketFlags,System.AsyncCallback,System.Object)"/> fails</exception>
2770 <exception cref="T:System.ArgumentException">Stream must be writable and readable.</exception>
2771 </member>
2772 <member name="M:HttpServer.HttpClientContext.OnBodyBytesReceived(System.Object,HttpServer.Parser.BodyEventArgs)">
2773 <summary>
2774 Process incoming body bytes.
2775 </summary>
2776 <param name="sender"><see cref="T:HttpServer.IHttpRequestParser"/></param>
2777 <param name="e">Bytes</param>
2778 </member>
2779 <member name="M:HttpServer.HttpClientContext.OnHeaderReceived(System.Object,HttpServer.Parser.HeaderEventArgs)">
2780 <summary> 3218 <summary>
2781 3219 Load an existing session.
2782 </summary> 3220 </summary>
2783 <param name="sender"></param> 3221 <param name="sessionId">Session id (usually retrieved from a client side cookie).</param>
2784 <param name="e"></param> 3222 <returns>A session if found; otherwise null.</returns>
2785 </member> 3223 </member>
2786 <member name="M:HttpServer.HttpClientContext.Start"> 3224 <member name="M:HttpServer.Sessions.IHttpSessionStore.Save(HttpServer.Sessions.IHttpSession)">
2787 <summary> 3225 <summary>
2788 Start reading content. 3226 Save an updated session to the store.
2789 </summary> 3227 </summary>
2790 <remarks> 3228 <param name="session">Session id (usually retrieved from a client side cookie).</param>
2791 Make sure to call base.Start() if you override this method. 3229 <exception cref="T:System.ArgumentException">If Id property have not been specified.</exception>
2792 </remarks>
2793 </member> 3230 </member>
2794 <member name="M:HttpServer.HttpClientContext.Cleanup"> 3231 <member name="M:HttpServer.Sessions.IHttpSessionStore.AddUnused(HttpServer.Sessions.IHttpSession)">
2795 <summary> 3232 <summary>
2796 Clean up context. 3233 We use the flyweight pattern which reuses small objects
3234 instead of creating new each time.
2797 </summary> 3235 </summary>
2798 <remarks> 3236 <param name="session">Unused session that should be reused next time Create is called.</param>
2799 Make sure to call base.Cleanup() if you override the method.
2800 </remarks>
2801 </member> 3237 </member>
2802 <member name="M:HttpServer.HttpClientContext.Disconnect(System.Net.Sockets.SocketError)"> 3238 <member name="M:HttpServer.Sessions.IHttpSessionStore.Cleanup">
2803 <summary> 3239 <summary>
2804 Disconnect from client 3240 Remove expired sessions
2805 </summary> 3241 </summary>
2806 <param name="error">error to report in the <see cref="E:HttpServer.HttpClientContext.Disconnected"/> event.</param>
2807 </member>
2808 <member name="M:HttpServer.HttpClientContext.OnReceive(System.IAsyncResult)">
2809 <exception cref="T:HttpServer.Exceptions.BadRequestException"><c>BadRequestException</c>.</exception>
2810 </member> 3242 </member>
2811 <member name="M:HttpServer.HttpClientContext.Respond(System.String,System.Net.HttpStatusCode,System.String,System.String,System.String)"> 3243 <member name="M:HttpServer.Sessions.IHttpSessionStore.Remove(System.String)">
2812 <summary> 3244 <summary>
2813 Send a response. 3245 Remove a session
2814 </summary> 3246 </summary>
2815 <param name="httpVersion">Either <see cref="F:HttpServer.HttpHelper.HTTP10"/> or <see cref="F:HttpServer.HttpHelper.HTTP11"/></param> 3247 <param name="sessionId">id of the session.</param>
2816 <param name="statusCode">HTTP status code</param>
2817 <param name="reason">reason for the status code.</param>
2818 <param name="body">HTML body contents, can be null or empty.</param>
2819 <param name="contentType">A content type to return the body as, i.e. 'text/html' or 'text/plain', defaults to 'text/html' if null or empty</param>
2820 <exception cref="T:System.ArgumentException">If <paramref name="httpVersion"/> is invalid.</exception>
2821 </member> 3248 </member>
2822 <member name="M:HttpServer.HttpClientContext.Respond(System.String,System.Net.HttpStatusCode,System.String)"> 3249 <member name="P:HttpServer.Sessions.IHttpSessionStore.Item(System.String)">
2823 <summary> 3250 <summary>
2824 Send a response. 3251 Load a session from the store
2825 </summary> 3252 </summary>
2826 <param name="httpVersion">Either <see cref="F:HttpServer.HttpHelper.HTTP10"/> or <see cref="F:HttpServer.HttpHelper.HTTP11"/></param> 3253 <param name="sessionId"></param>
2827 <param name="statusCode">HTTP status code</param> 3254 <returns>null if session is not found.</returns>
2828 <param name="reason">reason for the status code.</param>
2829 </member> 3255 </member>
2830 <member name="M:HttpServer.HttpClientContext.Respond(System.String)"> 3256 <member name="P:HttpServer.Sessions.IHttpSessionStore.ExpireTime">
2831 <summary> 3257 <summary>
2832 Send a response. 3258 Number of minutes before a session expires.
2833 </summary> 3259 </summary>
2834 <exception cref="T:System.ArgumentNullException"></exception> 3260 <value>Default time is 20 minutes.</value>
2835 </member> 3261 </member>
2836 <member name="M:HttpServer.HttpClientContext.Send(System.Byte[])"> 3262 <member name="T:HttpServer.RequestCookies">
2837 <summary> 3263 <summary>
2838 send a whole buffer 3264 This class is created as a wrapper, since there are two different cookie types in .Net (Cookie and HttpCookie).
3265 The framework might switch class in the future and we dont want to have to replace all instances
2839 </summary> 3266 </summary>
2840 <param name="buffer">buffer to send</param>
2841 <exception cref="T:System.ArgumentNullException"></exception>
2842 </member> 3267 </member>
2843 <member name="M:HttpServer.HttpClientContext.Send(System.Byte[],System.Int32,System.Int32)"> 3268 <member name="M:HttpServer.RequestCookies.#ctor(System.String)">
2844 <summary> 3269 <summary>
2845 Send data using the stream 3270 Let's copy all the cookies.
2846 </summary> 3271 </summary>
2847 <param name="buffer">Contains data to send</param> 3272 <param name="cookies">value from cookie header.</param>
2848 <param name="offset">Start position in buffer</param>
2849 <param name="size">number of bytes to send</param>
2850 <exception cref="T:System.ArgumentNullException"></exception>
2851 <exception cref="T:System.ArgumentOutOfRangeException"></exception>
2852 </member> 3273 </member>
2853 <member name="E:HttpServer.HttpClientContext.Cleaned"> 3274 <member name="M:HttpServer.RequestCookies.Add(HttpServer.RequestCookie)">
2854 <summary> 3275 <summary>
2855 This context have been cleaned, which means that it can be reused. 3276 Adds a cookie in the collection.
2856 </summary> 3277 </summary>
3278 <param name="cookie">cookie to add</param>
3279 <exception cref="T:System.ArgumentNullException">cookie is null</exception>
2857 </member> 3280 </member>
2858 <member name="E:HttpServer.HttpClientContext.Started"> 3281 <member name="M:HttpServer.RequestCookies.GetEnumerator">
2859 <summary> 3282 <summary>
2860 Context have been started (a new client have connected) 3283 Gets a collection enumerator on the cookie list.
2861 </summary> 3284 </summary>
3285 <returns>collection enumerator</returns>
2862 </member> 3286 </member>
2863 <member name="P:HttpServer.HttpClientContext.CurrentRequest"> 3287 <member name="M:HttpServer.RequestCookies.Clear">
2864 <summary> 3288 <summary>
2865 Overload to specify own type. 3289 Remove all cookies.
2866 </summary> 3290 </summary>
2867 <remarks>
2868 Must be specified before the context is being used.
2869 </remarks>
2870 </member> 3291 </member>
2871 <member name="P:HttpServer.HttpClientContext.Secured"> 3292 <member name="M:HttpServer.RequestCookies.System#Collections#Generic#IEnumerable{HttpServer#RequestCookie}#GetEnumerator">
2872 <summary> 3293 <summary>
2873 Using SSL or other encryption method. 3294 Returns an enumerator that iterates through the collection.
2874 </summary> 3295 </summary>
3296
3297 <returns>
3298 A <see cref="T:System.Collections.Generic.IEnumerator`1"></see> that can be used to iterate through the collection.
3299 </returns>
3300 <filterpriority>1</filterpriority>
2875 </member> 3301 </member>
2876 <member name="P:HttpServer.HttpClientContext.IsSecured"> 3302 <member name="M:HttpServer.RequestCookies.Remove(System.String)">
2877 <summary> 3303 <summary>
2878 Using SSL or other encryption method. 3304 Remove a cookie from the collection.
2879 </summary> 3305 </summary>
3306 <param name="cookieName">Name of cookie.</param>
2880 </member> 3307 </member>
2881 <member name="P:HttpServer.HttpClientContext.LogWriter"> 3308 <member name="P:HttpServer.RequestCookies.Count">
2882 <summary> 3309 <summary>
2883 Specify which logger to use. 3310 Gets the count of cookies in the collection.
2884 </summary> 3311 </summary>
2885 </member> 3312 </member>
2886 <member name="P:HttpServer.HttpClientContext.Stream"> 3313 <member name="P:HttpServer.RequestCookies.Item(System.String)">
2887 <summary> 3314 <summary>
2888 Gets or sets the network stream. 3315 Gets the cookie of a given identifier (null if not existing).
2889 </summary> 3316 </summary>
2890 </member> 3317 </member>
2891 <member name="P:HttpServer.HttpClientContext.RemoteAddress"> 3318 <member name="T:HttpServer.IComponentProvider">
2892 <summary> 3319 <summary>
2893 Gets or sets IP address that the client connected from. 3320 Inversion of control interface.
2894 </summary> 3321 </summary>
2895 </member> 3322 </member>
2896 <member name="P:HttpServer.HttpClientContext.RemotePort"> 3323 <member name="M:HttpServer.IComponentProvider.AddInstance``1(System.Object)">
2897 <summary> 3324 <summary>
2898 Gets or sets port that the client connected from. 3325 Add a component instance
2899 </summary> 3326 </summary>
3327 <typeparam name="T">Interface type</typeparam>
3328 <param name="instance">Instance to add</param>
2900 </member> 3329 </member>
2901 <member name="E:HttpServer.HttpClientContext.Disconnected"> 3330 <member name="M:HttpServer.IComponentProvider.Get``1">
2902 <summary> 3331 <summary>
2903 The context have been disconnected. 3332 Get a component.
2904 </summary> 3333 </summary>
3334 <typeparam name="T">Interface type</typeparam>
3335 <returns>Component if registered, otherwise null.</returns>
2905 <remarks> 3336 <remarks>
2906 Event can be used to clean up a context, or to reuse it. 3337 Component will get created if needed.
2907 </remarks> 3338 </remarks>
2908 </member> 3339 </member>
2909 <member name="E:HttpServer.HttpClientContext.RequestReceived"> 3340 <member name="M:HttpServer.IComponentProvider.Contains(System.Type)">
2910 <summary> 3341 <summary>
2911 A request have been received in the context. 3342 Checks if the specified component interface have been added.
2912 </summary> 3343 </summary>
3344 <param name="interfaceType"></param>
3345 <returns>true if found; otherwise false.</returns>
2913 </member> 3346 </member>
2914 <member name="T:HttpServer.Helpers.XmlHelper"> 3347 <member name="M:HttpServer.IComponentProvider.Add``2">
2915 <summary> 3348 <summary>
2916 Helpers to make XML handling easier 3349 Add a component.
2917 </summary> 3350 </summary>
3351 <typeparam name="InterfaceType">Type being requested.</typeparam>
3352 <typeparam name="InstanceType">Type being created.</typeparam>
2918 </member> 3353 </member>
2919 <member name="M:HttpServer.Helpers.XmlHelper.Serialize(System.Object)"> 3354 <member name="T:HttpServer.HttpRequest">
2920 <summary> 3355 <summary>
2921 Serializes object to XML. 3356 Contains server side HTTP request information.
2922 </summary> 3357 </summary>
2923 <param name="value">object to serialize.</param>
2924 <returns>XML</returns>
2925 <remarks>
2926 Removes name spaces and adds indentation
2927 </remarks>
2928 </member> 3358 </member>
2929 <member name="M:HttpServer.Helpers.XmlHelper.Deserialize``1(System.String)"> 3359 <member name="F:HttpServer.HttpRequest.UriSplitters">
2930 <summary> 3360 <summary>
2931 Create an object from a XML string 3361 Chars used to split an URL path into multiple parts.
2932 </summary> 3362 </summary>
2933 <typeparam name="T">Type of object</typeparam>
2934 <param name="xml">XML string</param>
2935 <returns>object</returns>
2936 </member> 3363 </member>
2937 <member name="T:HttpServer.FormDecoders.UrlDecoder"> 3364 <member name="M:HttpServer.HttpRequest.AssignForm(HttpServer.HttpForm)">
2938 <summary> 3365 <summary>
2939 Can handle application/x-www-form-urlencoded 3366 Assign a form.
2940 </summary> 3367 </summary>
3368 <param name="form"></param>
2941 </member> 3369 </member>
2942 <member name="M:HttpServer.FormDecoders.UrlDecoder.Decode(System.IO.Stream,System.String,System.Text.Encoding)"> 3370 <member name="M:HttpServer.HttpRequest.Clone">
2943 <summary> 3371 <summary>
3372 Creates a new object that is a copy of the current instance.
2944 </summary> 3373 </summary>
2945 <param name="stream">Stream containing the content</param> 3374
2946 <param name="contentType">Content type (with any additional info like boundry). Content type is always supplied in lower case</param>
2947 <param name="encoding">Stream encoding</param>
2948 <returns> 3375 <returns>
2949 A HTTP form, or null if content could not be parsed. 3376 A new object that is a copy of this instance.
2950 </returns> 3377 </returns>
2951 <exception cref="T:System.IO.InvalidDataException">If contents in the stream is not valid input data.</exception> 3378 <filterpriority>2</filterpriority>
2952 </member>
2953 <member name="M:HttpServer.FormDecoders.UrlDecoder.CanParse(System.String)">
2954 <summary>
2955 Checks if the decoder can handle the mime type
2956 </summary>
2957 <param name="contentType">Content type (with any additional info like boundry). Content type is always supplied in lower case.</param>
2958 <returns>True if the decoder can parse the specified content type</returns>
2959 </member>
2960 <member name="T:HttpServer.Exceptions.ForbiddenException">
2961 <summary>
2962 The server understood the request, but is refusing to fulfill it.
2963 Authorization will not help and the request SHOULD NOT be repeated.
2964 If the request method was not HEAD and the server wishes to make public why the request has not been fulfilled,
2965 it SHOULD describe the reason for the refusal in the entity. If the server does not wish to make this information
2966 available to the client, the status code 404 (Not Found) can be used instead.
2967
2968 Text taken from: http://www.submissionchamber.com/help-guides/error-codes.php
2969 </summary>
2970 </member>
2971 <member name="M:HttpServer.Exceptions.ForbiddenException.#ctor(System.String)">
2972 <summary>
2973 Initializes a new instance of the <see cref="T:HttpServer.Exceptions.ForbiddenException"/> class.
2974 </summary>
2975 <param name="errorMsg">error message</param>
2976 </member>
2977 <member name="T:HttpServer.ClientAcceptedEventArgs">
2978 <summary>
2979 Invoked when a client have been accepted by the <see cref="T:HttpServer.HttpListener"/>
2980 </summary>
2981 <remarks>
2982 Can be used to revoke incoming connections
2983 </remarks>
2984 </member>
2985 <member name="M:HttpServer.ClientAcceptedEventArgs.#ctor(System.Net.Sockets.Socket)">
2986 <summary>
2987 Initializes a new instance of the <see cref="T:HttpServer.ClientAcceptedEventArgs"/> class.
2988 </summary>
2989 <param name="socket">The socket.</param>
2990 </member>
2991 <member name="M:HttpServer.ClientAcceptedEventArgs.Revoke">
2992 <summary>
2993 Client may not be handled.
2994 </summary>
2995 </member>
2996 <member name="P:HttpServer.ClientAcceptedEventArgs.Socket">
2997 <summary>
2998 Accepted socket.
2999 </summary>
3000 </member>
3001 <member name="P:HttpServer.ClientAcceptedEventArgs.Revoked">
3002 <summary>
3003 Client should be revoked.
3004 </summary>
3005 </member>
3006 <member name="T:HttpServer.Helpers.ResourceManager">
3007 <summary>Class to handle loading of resource files</summary>
3008 </member> 3379 </member>
3009 <member name="M:HttpServer.Helpers.ResourceManager.#ctor"> 3380 <member name="M:HttpServer.HttpRequest.DecodeBody(HttpServer.FormDecoders.FormDecoderProvider)">
3010 <summary> 3381 <summary>
3011 Initializes a new instance of the <see cref="T:HttpServer.Helpers.ResourceManager"/> class. 3382 Decode body into a form.
3012 </summary> 3383 </summary>
3384 <param name="providers">A list with form decoders.</param>
3385 <exception cref="T:System.IO.InvalidDataException">If body contents is not valid for the chosen decoder.</exception>
3386 <exception cref="T:System.InvalidOperationException">If body is still being transferred.</exception>
3013 </member> 3387 </member>
3014 <member name="M:HttpServer.Helpers.ResourceManager.#ctor(HttpServer.ILogWriter)"> 3388 <member name="M:HttpServer.HttpRequest.SetCookies(HttpServer.RequestCookies)">
3015 <summary> 3389 <summary>
3016 Initializes a new instance of the <see cref="T:HttpServer.Helpers.ResourceManager"/> class. 3390 Cookies
3017 </summary> 3391 </summary>
3018 <param name="writer">logger.</param> 3392 <param name="cookies">the cookies</param>
3019 </member> 3393 </member>
3020 <member name="M:HttpServer.Helpers.ResourceManager.LoadResources(System.String,System.Reflection.Assembly,System.String)"> 3394 <member name="M:HttpServer.HttpRequest.CreateResponse(HttpServer.IHttpClientContext)">
3021 <summary> 3395 <summary>
3022 Loads resources from a namespace in the given assembly to an URI 3396 Create a response object.
3023 </summary> 3397 </summary>
3024 <param name="toUri">The URI to map the resources to</param> 3398 <returns>A new <see cref="T:HttpServer.IHttpResponse"/>.</returns>
3025 <param name="fromAssembly">The assembly in which the resources reside</param>
3026 <param name="fromNamespace">The namespace from which to load the resources</param>
3027 <usage>
3028 <code>
3029 resourceLoader.LoadResources("/user/", typeof(User).Assembly, "MyLib.Models.User.Views");
3030 </code>
3031 Will make the resource MyLib.Models.User.Views.list.Haml accessible via /user/list.haml or /user/list/
3032 </usage>
3033 <returns>The amount of loaded files, giving you the possibility of making sure the resources needed gets loaded</returns>
3034 <exception cref="T:System.InvalidOperationException">If a resource has already been mapped to an uri</exception>
3035 </member> 3399 </member>
3036 <member name="M:HttpServer.Helpers.ResourceManager.GetResourceStream(System.String)"> 3400 <member name="M:HttpServer.HttpRequest.AddHeader(System.String,System.String)">
3037 <summary> 3401 <summary>
3038 Retrieves a stream for the specified resource path if loaded otherwise null 3402 Called during parsing of a <see cref="T:HttpServer.IHttpRequest"/>.
3039 </summary> 3403 </summary>
3040 <param name="path">Path to the resource to retrieve a stream for</param> 3404 <param name="name">Name of the header, should not be URL encoded</param>
3041 <returns>A stream or null if the resource couldn't be found</returns> 3405 <param name="value">Value of the header, should not be URL encoded</param>
3406 <exception cref="T:HttpServer.Exceptions.BadRequestException">If a header is incorrect.</exception>
3042 </member> 3407 </member>
3043 <member name="M:HttpServer.Helpers.ResourceManager.GetFiles(System.String)"> 3408 <member name="M:HttpServer.HttpRequest.AddToBody(System.Byte[],System.Int32,System.Int32)">
3044 <summary> 3409 <summary>
3045 Fetch all files from the resource that matches the specified arguments. 3410 Add bytes to the body
3046 </summary> 3411 </summary>
3047 <param name="path">The path to the resource to extract</param> 3412 <param name="bytes">buffer to read bytes from</param>
3048 <returns> 3413 <param name="offset">where to start read</param>
3049 a list of files if found; or an empty array if no files are found. 3414 <param name="length">number of bytes to read</param>
3050 </returns> 3415 <returns>Number of bytes actually read (same as length unless we got all body bytes).</returns>
3051 <exception cref="T:System.ArgumentException">Search path must end with an asterisk for finding arbitrary files</exception> 3416 <exception cref="T:System.InvalidOperationException">If body is not writable</exception>
3417 <exception cref="T:System.ArgumentNullException"><c>bytes</c> is null.</exception>
3418 <exception cref="T:System.ArgumentOutOfRangeException"><c>offset</c> is out of range.</exception>
3052 </member> 3419 </member>
3053 <member name="M:HttpServer.Helpers.ResourceManager.GetFiles(System.String,System.String)"> 3420 <member name="M:HttpServer.HttpRequest.Clear">
3054 <summary> 3421 <summary>
3055 Fetch all files from the resource that matches the specified arguments. 3422 Clear everything in the request
3056 </summary> 3423 </summary>
3057 <param name="path">Where the file should reside.</param>
3058 <param name="filename">Files to check</param>
3059 <returns>
3060 a list of files if found; or an empty array if no files are found.
3061 </returns>
3062 </member> 3424 </member>
3063 <member name="M:HttpServer.Helpers.ResourceManager.ContainsResource(System.String)"> 3425 <member name="P:HttpServer.HttpRequest.Secure">
3064 <summary> 3426 <summary>
3065 Returns whether or not the loader has an instance of the file requested 3427 Gets or sets a value indicating whether this <see cref="T:HttpServer.HttpRequest"/> is secure.
3066 </summary> 3428 </summary>
3067 <param name="filename">The name of the template/file</param>
3068 <returns>True if the loader can provide the file</returns>
3069 </member> 3429 </member>
3070 <member name="M:HttpServer.FormDecoders.HttpMultipart.ReadLine"> 3430 <member name="P:HttpServer.HttpRequest.UriPath">
3071 <summary> 3431 <summary>
3072 3432 Path and query (will be merged with the host header) and put in Uri
3073 </summary> 3433 </summary>
3074 <returns></returns> 3434 <see cref="P:HttpServer.HttpRequest.Uri"/>
3075 <exception cref="T:System.ArgumentOutOfRangeException"></exception>
3076 <exception cref="T:System.ObjectDisposedException"></exception>
3077 </member>
3078 <member name="T:HttpServer.FormDecoders.HttpMultipart.Element">
3079 <summary>Represents a field in a multipart form</summary>
3080 </member> 3435 </member>
3081 <member name="T:HttpServer.FormDecoders.FormDecoderProvider"> 3436 <member name="P:HttpServer.HttpRequest.BodyIsComplete">
3082 <summary> 3437 <summary>
3083 This provider is used to let us implement any type of form decoding we want without 3438 Gets whether the body is complete.
3084 having to rewrite anything else in the server.
3085 </summary> 3439 </summary>
3086 </member> 3440 </member>
3087 <member name="M:HttpServer.FormDecoders.FormDecoderProvider.Decode(System.String,System.IO.Stream,System.Text.Encoding)"> 3441 <member name="P:HttpServer.HttpRequest.AcceptTypes">
3088 <summary> 3442 <summary>
3089 3443 Gets kind of types accepted by the client.
3090 </summary> 3444 </summary>
3091 <param name="contentType">Should contain boundary and type, as in: multipart/form-data; boundary=---------------------------230051238959</param>
3092 <param name="stream">Stream containing form data.</param>
3093 <param name="encoding">Encoding used when decoding the stream</param>
3094 <returns><see cref="F:HttpServer.HttpInput.Empty"/> if no parser was found.</returns>
3095 <exception cref="T:System.ArgumentException">If stream is null or not readable.</exception>
3096 <exception cref="T:System.IO.InvalidDataException">If stream contents cannot be decoded properly.</exception>
3097 </member> 3445 </member>
3098 <member name="M:HttpServer.FormDecoders.FormDecoderProvider.Add(HttpServer.FormDecoders.IFormDecoder)"> 3446 <member name="P:HttpServer.HttpRequest.Body">
3099 <summary> 3447 <summary>
3100 Add a decoder. 3448 Gets or sets body stream.
3101 </summary> 3449 </summary>
3102 <param name="decoder"></param>
3103 <exception cref="T:System.ArgumentNullException"></exception>
3104 </member> 3450 </member>
3105 <member name="P:HttpServer.FormDecoders.FormDecoderProvider.Count"> 3451 <member name="P:HttpServer.HttpRequest.Connection">
3106 <summary> 3452 <summary>
3107 Number of added decoders. 3453 Gets or sets kind of connection used for the session.
3108 </summary> 3454 </summary>
3109 </member> 3455 </member>
3110 <member name="P:HttpServer.FormDecoders.FormDecoderProvider.Decoders"> 3456 <member name="P:HttpServer.HttpRequest.ContentLength">
3111 <summary> 3457 <summary>
3112 Use with care. 3458 Gets or sets number of bytes in the body.
3113 </summary> 3459 </summary>
3114 </member> 3460 </member>
3115 <member name="P:HttpServer.FormDecoders.FormDecoderProvider.DefaultDecoder"> 3461 <member name="P:HttpServer.HttpRequest.Headers">
3116 <summary> 3462 <summary>
3117 Decoder used for unknown content types. 3463 Gets headers sent by the client.
3118 </summary> 3464 </summary>
3119 </member> 3465 </member>
3120 <member name="T:HttpServer.RealmHandler"> 3466 <member name="P:HttpServer.HttpRequest.HttpVersion">
3121 <summary> 3467 <summary>
3122 Delegate used to find a realm/domain. 3468 Gets or sets version of HTTP protocol that's used.
3123 </summary> 3469 </summary>
3124 <param name="domain"></param>
3125 <returns></returns>
3126 <remarks> 3470 <remarks>
3127 Realms are used during HTTP Authentication 3471 Probably <see cref="F:HttpServer.HttpHelper.HTTP10"/> or <see cref="F:HttpServer.HttpHelper.HTTP11"/>.
3128 </remarks> 3472 </remarks>
3129 <seealso cref="T:HttpServer.Authentication.AuthenticationModule"/> 3473 <seealso cref="T:HttpServer.HttpHelper"/>
3130 <seealso cref="T:HttpServer.Authentication.AuthenticationHandler"/>
3131 </member>
3132 <member name="T:HttpServer.HttpServer">
3133 <summary>
3134 A complete HTTP server, you need to add a module to it to be able to handle incoming requests.
3135 </summary>
3136 <example>
3137 <code>
3138 // this small example will add two web site modules, thus handling
3139 // two different sites. In reality you should add Controller modules or something
3140 // two the website modules to be able to handle different requests.
3141 HttpServer server = new HttpServer();
3142 server.Add(new WebSiteModule("www.gauffin.com", "Gauffin Telecom AB"));
3143 server.Add(new WebSiteModule("www.vapadi.se", "Remote PBX"));
3144
3145 // start regular http
3146 server.Start(IPAddress.Any, 80);
3147
3148 // start https
3149 server.Start(IPAddress.Any, 443, myCertificate);
3150 </code>
3151 </example>
3152 <seealso cref="T:HttpServer.HttpModules.HttpModule"/>
3153 <seealso cref="T:HttpServer.HttpModules.FileModule"/>
3154 <seealso cref="T:HttpServer.HttpListener"/>
3155 </member>
3156 <member name="M:HttpServer.HttpServer.#ctor(HttpServer.IComponentProvider)">
3157 <summary>
3158 Initializes a new instance of the <see cref="T:HttpServer.HttpServer"/> class.
3159 </summary>
3160 <param name="provider">Used to get all components used in the server..</param>
3161 </member>
3162 <member name="M:HttpServer.HttpServer.#ctor">
3163 <summary>
3164 Initializes a new instance of the <see cref="T:HttpServer.HttpServer"/> class.
3165 </summary>
3166 </member>
3167 <member name="M:HttpServer.HttpServer.#ctor(HttpServer.FormDecoders.FormDecoderProvider)">
3168 <summary>
3169 Initializes a new instance of the <see cref="T:HttpServer.HttpServer"/> class.
3170 </summary>
3171 <param name="decoderProvider">Form decoders are used to convert different types of posted data to the <see cref="T:HttpServer.HttpInput"/> object types.</param>
3172 <seealso cref="T:HttpServer.FormDecoders.IFormDecoder"/>
3173 <seealso cref="P:HttpServer.HttpServer.FormDecoderProviders"/>
3174 </member>
3175 <member name="M:HttpServer.HttpServer.#ctor(HttpServer.Sessions.IHttpSessionStore)">
3176 <summary>
3177 Initializes a new instance of the <see cref="T:HttpServer.HttpServer"/> class.
3178 </summary>
3179 <param name="sessionStore">A session store is used to save and retrieve sessions</param>
3180 <seealso cref="T:HttpServer.Sessions.IHttpSessionStore"/>
3181 </member>
3182 <member name="M:HttpServer.HttpServer.#ctor(HttpServer.ILogWriter)">
3183 <summary>
3184 Initializes a new instance of the <see cref="T:HttpServer.HttpServer"/> class.
3185 </summary>
3186 <param name="logWriter">The log writer.</param>
3187 <seealso cref="P:HttpServer.HttpServer.LogWriter"/>
3188 </member>
3189 <member name="M:HttpServer.HttpServer.#ctor(HttpServer.FormDecoders.FormDecoderProvider,HttpServer.ILogWriter)">
3190 <summary>
3191 Initializes a new instance of the <see cref="T:HttpServer.HttpServer"/> class.
3192 </summary>
3193 <param name="decoderProvider">Form decoders are used to convert different types of posted data to the <see cref="T:HttpServer.HttpInput"/> object types.</param>
3194 <param name="logWriter">The log writer.</param>
3195 <seealso cref="T:HttpServer.FormDecoders.IFormDecoder"/>
3196 <seealso cref="P:HttpServer.HttpServer.FormDecoderProviders"/>
3197 <seealso cref="P:HttpServer.HttpServer.LogWriter"/>
3198 </member>
3199 <member name="M:HttpServer.HttpServer.#ctor(HttpServer.FormDecoders.FormDecoderProvider,HttpServer.Sessions.IHttpSessionStore,HttpServer.ILogWriter)">
3200 <summary>
3201 Initializes a new instance of the <see cref="T:HttpServer.HttpServer"/> class.
3202 </summary>
3203 <param name="decoderProvider">Form decoders are used to convert different types of posted data to the <see cref="T:HttpServer.HttpInput"/> object types.</param>
3204 <param name="sessionStore">A session store is used to save and retrieve sessions</param>
3205 <param name="logWriter">The log writer.</param>
3206 <seealso cref="T:HttpServer.FormDecoders.IFormDecoder"/>
3207 <seealso cref="P:HttpServer.HttpServer.FormDecoderProviders"/>
3208 <seealso cref="P:HttpServer.HttpServer.LogWriter"/>
3209 <seealso cref="T:HttpServer.Sessions.IHttpSessionStore"/>
3210 </member>
3211 <member name="M:HttpServer.HttpServer.Add(HttpServer.Rules.IRule)">
3212 <summary>
3213 Adds the specified rule.
3214 </summary>
3215 <param name="rule">The rule.</param>
3216 </member>
3217 <member name="M:HttpServer.HttpServer.Add(HttpServer.HttpModules.HttpModule)">
3218 <summary>
3219 Add a <see cref="T:HttpServer.HttpModules.HttpModule"/> to the server.
3220 </summary>
3221 <param name="module">mode to add</param>
3222 </member> 3474 </member>
3223 <member name="M:HttpServer.HttpServer.DecodeBody(HttpServer.IHttpRequest)"> 3475 <member name="P:HttpServer.HttpRequest.Method">
3224 <summary> 3476 <summary>
3225 Decodes the request body. 3477 Gets or sets requested method.
3226 </summary> 3478 </summary>
3227 <param name="request">The request.</param> 3479 <value></value>
3228 <exception cref="T:HttpServer.Exceptions.InternalServerException">Failed to decode form data.</exception> 3480 <remarks>
3481 Will always be in upper case.
3482 </remarks>
3483 <see cref="!:HttpServer.Method"/>
3229 </member> 3484 </member>
3230 <member name="M:HttpServer.HttpServer.ErrorPage(HttpServer.IHttpResponse,System.Net.HttpStatusCode,System.String)"> 3485 <member name="P:HttpServer.HttpRequest.QueryString">
3231 <summary> 3486 <summary>
3232 Generate a HTTP error page (that will be added to the response body). 3487 Gets variables sent in the query string
3233 response status code is also set.
3234 </summary> 3488 </summary>
3235 <param name="response">Response that the page will be generated in.</param>
3236 <param name="error"><see cref="T:System.Net.HttpStatusCode"/>.</param>
3237 <param name="body">response body contents.</param>
3238 </member> 3489 </member>
3239 <member name="M:HttpServer.HttpServer.ErrorPage(HttpServer.IHttpResponse,HttpServer.Exceptions.HttpException)"> 3490 <member name="P:HttpServer.HttpRequest.Uri">
3240 <summary> 3491 <summary>
3241 Generate a HTTP error page (that will be added to the response body). 3492 Gets or sets requested URI.
3242 response status code is also set.
3243 </summary> 3493 </summary>
3244 <param name="response">Response that the page will be generated in.</param>
3245 <param name="err">exception.</param>
3246 </member> 3494 </member>
3247 <member name="M:HttpServer.HttpServer.GetRealm(HttpServer.IHttpRequest)"> 3495 <member name="P:HttpServer.HttpRequest.UriParts">
3248 <summary> 3496 <summary>
3249 Realms are used by the <see cref="T:HttpServer.Authentication.AuthenticationModule"/>s. 3497 Uri absolute path splitted into parts.
3250 </summary> 3498 </summary>
3251 <param name="request">HTTP request</param> 3499 <example>
3252 <returns>domain/realm.</returns> 3500 // uri is: http://gauffin.com/code/tiny/
3501 Console.WriteLine(request.UriParts[0]); // result: code
3502 Console.WriteLine(request.UriParts[1]); // result: tiny
3503 </example>
3504 <remarks>
3505 If you're using controllers than the first part is controller name,
3506 the second part is method name and the third part is Id property.
3507 </remarks>
3508 <seealso cref="P:HttpServer.HttpRequest.Uri"/>
3253 </member> 3509 </member>
3254 <member name="M:HttpServer.HttpServer.HandleRequest(HttpServer.IHttpClientContext,HttpServer.IHttpRequest,HttpServer.IHttpResponse,HttpServer.Sessions.IHttpSession)"> 3510 <member name="P:HttpServer.HttpRequest.Param">
3255 <summary> 3511 <summary>
3256 Process an incoming request. 3512 Gets parameter from <see cref="P:HttpServer.HttpRequest.QueryString"/> or <see cref="P:HttpServer.HttpRequest.Form"/>.
3257 </summary> 3513 </summary>
3258 <param name="context">connection to client</param>
3259 <param name="request">request information</param>
3260 <param name="response">response that should be filled</param>
3261 <param name="session">session information</param>
3262 </member> 3514 </member>
3263 <member name="M:HttpServer.HttpServer.OnClientDisconnected(HttpServer.IHttpClientContext,System.Net.Sockets.SocketError)"> 3515 <member name="P:HttpServer.HttpRequest.Form">
3264 <summary> 3516 <summary>
3265 Can be overloaded to implement stuff when a client have been connected. 3517 Gets form parameters.
3266 </summary> 3518 </summary>
3267 <remarks>
3268 Default implementation does nothing.
3269 </remarks>
3270 <param name="client">client that disconnected</param>
3271 <param name="error">disconnect reason</param>
3272 </member> 3519 </member>
3273 <member name="M:HttpServer.HttpServer.ProcessAuthentication(HttpServer.IHttpRequest,HttpServer.IHttpResponse,HttpServer.Sessions.IHttpSession)"> 3520 <member name="P:HttpServer.HttpRequest.IsAjax">
3274 <summary> 3521 <summary>
3275 Handle authentication 3522 Gets whether the request was made by Ajax (Asynchronous JavaScript)
3276 </summary> 3523 </summary>
3277 <param name="request"></param>
3278 <param name="response"></param>
3279 <param name="session"></param>
3280 <returns>true if request can be handled; false if not.</returns>
3281 <exception cref="T:HttpServer.Exceptions.BadRequestException">Invalid authorization header</exception>
3282 </member> 3524 </member>
3283 <member name="M:HttpServer.HttpServer.RequestAuthentication(HttpServer.Authentication.AuthenticationModule,HttpServer.IHttpRequest,HttpServer.IHttpResponse)"> 3525 <member name="P:HttpServer.HttpRequest.Cookies">
3284 <summary> 3526 <summary>
3285 Will request authentication. 3527 Gets cookies that was sent with the request.
3286 </summary> 3528 </summary>
3287 <remarks>
3288 Sends respond to client, nothing else can be done with the response after this.
3289 </remarks>
3290 <param name="mod"></param>
3291 <param name="request"></param>
3292 <param name="response"></param>
3293 </member> 3529 </member>
3294 <member name="M:HttpServer.HttpServer.OnRequest(System.Object,HttpServer.RequestEventArgs)"> 3530 <member name="T:HttpServer.Helpers.ObjectForm">
3295 <summary> 3531 <summary>
3296 Received from a <see cref="T:HttpServer.IHttpClientContext"/> when a request have been parsed successfully. 3532 The object form class takes an object and creates form items for it.
3297 </summary> 3533 </summary>
3298 <param name="source"><see cref="T:HttpServer.IHttpClientContext"/> that received the request.</param>
3299 <param name="args">The request.</param>
3300 </member> 3534 </member>
3301 <member name="M:HttpServer.HttpServer.ProcessRequestWrapper(HttpServer.IHttpClientContext,HttpServer.IHttpRequest)"> 3535 <member name="M:HttpServer.Helpers.ObjectForm.#ctor(System.String,System.String,System.Object,System.String)">
3302 <summary> 3536 <summary>
3303 To be able to track request count. 3537 Initializes a new instance of the <see cref="T:HttpServer.Helpers.ObjectForm"/> class.
3304 </summary> 3538 </summary>
3305 <param name="context"></param> 3539 <param name="method"></param>
3306 <param name="request"></param> 3540 <param name="name">form name *and* id.</param>
3541 <param name="action">action to do when form is posted.</param>
3542 <param name="obj"></param>
3307 </member> 3543 </member>
3308 <member name="M:HttpServer.HttpServer.Start(System.Net.IPAddress,System.Int32)"> 3544 <member name="M:HttpServer.Helpers.ObjectForm.#ctor(System.String,System.String,System.Object)">
3309 <summary> 3545 <summary>
3310 Start the web server using regular HTTP. 3546 Initializes a new instance of the <see cref="T:HttpServer.Helpers.ObjectForm"/> class.
3311 </summary> 3547 </summary>
3312 <param name="address">IP Address to listen on, use <c>IpAddress.Any </c>to accept connections on all IP addresses/network cards.</param> 3548 <param name="name">form name *and* id.</param>
3313 <param name="port">Port to listen on. 80 can be a good idea =)</param> 3549 <param name="action">action to do when form is posted.</param>
3314 <exception cref="T:System.ArgumentNullException"><c>address</c> is null.</exception> 3550 <param name="obj">object to get values from</param>
3315 <exception cref="T:System.ArgumentException">Port must be a positive number.</exception>
3316 </member> 3551 </member>
3317 <member name="M:HttpServer.HttpServer.Start(System.Net.IPAddress,System.Int32,System.Security.Cryptography.X509Certificates.X509Certificate)"> 3552 <member name="M:HttpServer.Helpers.ObjectForm.#ctor(System.String,System.Object)">
3318 <summary> 3553 <summary>
3319 Accept secure connections. 3554 Initializes a new instance of the <see cref="T:HttpServer.Helpers.ObjectForm"/> class.
3320 </summary> 3555 </summary>
3321 <param name="address">IP Address to listen on, use <see cref="F:System.Net.IPAddress.Any"/> to accept connections on all IP Addresses / network cards.</param> 3556 <param name="action">form action.</param>
3322 <param name="port">Port to listen on. 80 can be a good idea =)</param> 3557 <param name="obj">object to get values from.</param>
3323 <param name="certificate">Certificate to use</param>
3324 <exception cref="T:System.ArgumentNullException"><c>address</c> is null.</exception>
3325 <exception cref="T:System.ArgumentException">Port must be a positive number.</exception>
3326 </member> 3558 </member>
3327 <member name="M:HttpServer.HttpServer.Stop"> 3559 <member name="M:HttpServer.Helpers.ObjectForm.Begin">
3328 <summary> 3560 <summary>
3329 shut down the server and listeners 3561 write out the FORM-tag.
3330 </summary> 3562 </summary>
3563 <returns>generated html code</returns>
3331 </member> 3564 </member>
3332 <member name="M:HttpServer.HttpServer.WriteLog(HttpServer.LogPrio,System.String)"> 3565 <member name="M:HttpServer.Helpers.ObjectForm.Begin(System.Boolean)">
3333 <summary> 3566 <summary>
3334 write an entry to the log file 3567 Writeout the form tag
3335 </summary> 3568 </summary>
3336 <param name="prio">importance of the message</param> 3569 <param name="isAjax">form should be posted through ajax.</param>
3337 <param name="message">log message</param> 3570 <returns>generated html code</returns>
3338 </member> 3571 </member>
3339 <member name="M:HttpServer.HttpServer.WriteLog(System.Object,HttpServer.LogPrio,System.String)"> 3572 <member name="M:HttpServer.Helpers.ObjectForm.Tb(System.String,System.Object[])">
3340 <summary> 3573 <summary>
3341 write an entry to the log file 3574 Generates a text box.
3342 </summary> 3575 </summary>
3343 <param name="source">object that wrote the message</param> 3576 <param name="propertyName"></param>
3344 <param name="prio">importance of the message</param> 3577 <param name="options"></param>
3345 <param name="message">log message</param> 3578 <returns>generated html code</returns>
3346 </member> 3579 </member>
3347 <member name="P:HttpServer.HttpServer.Current"> 3580 <member name="M:HttpServer.Helpers.ObjectForm.Pb(System.String,System.Object[])">
3348 <summary> 3581 <summary>
3349 Server that is handling the current request. 3582 password box
3350 </summary> 3583 </summary>
3351 <remarks> 3584 <param name="propertyName"></param>
3352 Will be set as soon as a request arrives to the <see cref="T:HttpServer.HttpServer"/> object. 3585 <param name="options"></param>
3353 </remarks> 3586 <returns>generated html code</returns>
3354 </member> 3587 </member>
3355 <member name="P:HttpServer.HttpServer.AuthenticationModules"> 3588 <member name="M:HttpServer.Helpers.ObjectForm.Hidden(System.String,System.Object[])">
3356 <summary> 3589 <summary>
3357 Modules used for authentication. The module that is is added first is used as 3590 Hiddens the specified property name.
3358 the default authentication module.
3359 </summary> 3591 </summary>
3360 <remarks>Use the corresponding property 3592 <param name="propertyName">Name of the property.</param>
3361 in the <see cref="T:HttpServer.HttpModules.WebSiteModule"/> if you are using multiple websites.</remarks> 3593 <param name="options">The options.</param>
3594 <returns>generated html code</returns>
3362 </member> 3595 </member>
3363 <member name="P:HttpServer.HttpServer.FormDecoderProviders"> 3596 <member name="M:HttpServer.Helpers.ObjectForm.Label(System.String,System.String)">
3364 <summary> 3597 <summary>
3365 Form decoder providers are used to decode request body (which normally contains form data). 3598 Labels the specified property name.
3366 </summary> 3599 </summary>
3600 <param name="propertyName">property in object.</param>
3601 <param name="label">caption</param>
3602 <returns>generated html code</returns>
3367 </member> 3603 </member>
3368 <member name="P:HttpServer.HttpServer.ServerName"> 3604 <member name="M:HttpServer.Helpers.ObjectForm.Cb(System.String,System.String,System.Object[])">
3369 <summary> 3605 <summary>
3370 Server name sent in HTTP responses. 3606 Generate a checkbox
3371 </summary> 3607 </summary>
3372 <remarks> 3608 <param name="propertyName">property in object</param>
3373 Do NOT include version in name, since it makes it 3609 <param name="value">checkbox value</param>
3374 easier for hackers. 3610 <param name="options">additional html attributes.</param>
3375 </remarks> 3611 <returns>generated html code</returns>
3376 </member> 3612 </member>
3377 <member name="P:HttpServer.HttpServer.SessionCookieName"> 3613 <member name="M:HttpServer.Helpers.ObjectForm.Select(System.String,System.String,System.String,System.Object[])">
3378 <summary> 3614 <summary>
3379 Name of cookie where session id is stored. 3615 Write a html select tag
3380 </summary> 3616 </summary>
3617 <param name="propertyName">object property.</param>
3618 <param name="idColumn">id column</param>
3619 <param name="titleColumn">The title column.</param>
3620 <param name="options">The options.</param>
3621 <returns></returns>
3381 </member> 3622 </member>
3382 <member name="P:HttpServer.HttpServer.LogWriter"> 3623 <member name="M:HttpServer.Helpers.ObjectForm.Select(System.String,System.Collections.IEnumerable,System.String,System.String,System.Object[])">
3383 <summary> 3624 <summary>
3384 Specified where logging should go. 3625 Selects the specified property name.
3385 </summary> 3626 </summary>
3386 <seealso cref="T:HttpServer.NullLogWriter"/> 3627 <param name="propertyName">Name of the property.</param>
3387 <seealso cref="T:HttpServer.ConsoleLogWriter"/> 3628 <param name="items">The items.</param>
3388 <seealso cref="P:HttpServer.HttpServer.LogWriter"/> 3629 <param name="idColumn">The id column.</param>
3630 <param name="titleColumn">The title column.</param>
3631 <param name="options">The options.</param>
3632 <returns></returns>
3389 </member> 3633 </member>
3390 <member name="P:HttpServer.HttpServer.BackLog"> 3634 <member name="M:HttpServer.Helpers.ObjectForm.Submit(System.String)">
3391 <summary> 3635 <summary>
3392 Number of connections that can wait to be accepted by the server. 3636 Write a submit tag.
3393 </summary> 3637 </summary>
3394 <remarks>Default is 10.</remarks> 3638 <param name="value">button caption</param>
3639 <returns>html submit tag</returns>
3395 </member> 3640 </member>
3396 <member name="P:HttpServer.HttpServer.MaxRequestCount"> 3641 <member name="M:HttpServer.Helpers.ObjectForm.End">
3397 <summary> 3642 <summary>
3398 Gets or sets maximum number of allowed simultaneous requests. 3643 html end form tag
3399 </summary> 3644 </summary>
3400 <remarks> 3645 <returns>html</returns>
3401 <para>
3402 This property is useful in busy systems. The HTTP server
3403 will start queuing new requests if this limit is hit, instead
3404 of trying to process all incoming requests directly.
3405 </para>
3406 <para>
3407 The default number if allowed simultaneous requests are 10.
3408 </para>
3409 </remarks>
3410 </member> 3646 </member>
3411 <member name="P:HttpServer.HttpServer.MaxQueueSize"> 3647 <member name="T:HttpServer.FormDecoders.UrlDecoder">
3412 <summary> 3648 <summary>
3413 Gets or sets maximum number of requests queuing to be handled. 3649 Can handle application/x-www-form-urlencoded
3414 </summary> 3650 </summary>
3415 <remarks>
3416 <para>
3417 The WebServer will start turning requests away if response code
3418 <see cref="F:System.Net.HttpStatusCode.ServiceUnavailable"/> to indicate that the server
3419 is too busy to be able to handle the request.
3420 </para>
3421 </remarks>
3422 </member> 3651 </member>
3423 <member name="E:HttpServer.HttpServer.RealmWanted"> 3652 <member name="M:HttpServer.FormDecoders.UrlDecoder.Decode(System.IO.Stream,System.String,System.Text.Encoding)">
3424 <summary> 3653 <summary>
3425 Realms are used during HTTP authentication.
3426 Default realm is same as server name.
3427 </summary> 3654 </summary>
3655 <param name="stream">Stream containing the content</param>
3656 <param name="contentType">Content type (with any additional info like boundry). Content type is always supplied in lower case</param>
3657 <param name="encoding">Stream encoding</param>
3658 <returns>
3659 A HTTP form, or null if content could not be parsed.
3660 </returns>
3661 <exception cref="T:System.IO.InvalidDataException">If contents in the stream is not valid input data.</exception>
3428 </member> 3662 </member>
3429 <member name="E:HttpServer.HttpServer.ExceptionThrown"> 3663 <member name="M:HttpServer.FormDecoders.UrlDecoder.CanParse(System.String)">
3430 <summary> 3664 <summary>
3431 Let's to receive unhandled exceptions from the threads. 3665 Checks if the decoder can handle the mime type
3432 </summary> 3666 </summary>
3433 <remarks> 3667 <param name="contentType">Content type (with any additional info like boundry). Content type is always supplied in lower case.</param>
3434 Exceptions will be thrown during debug mode if this event is not used, 3668 <returns>True if the decoder can parse the specified content type</returns>
3435 exceptions will be printed to console and suppressed during release mode.
3436 </remarks>
3437 </member> 3669 </member>
3438 <member name="T:HttpServer.FormDecoders.MultipartDecoder"> 3670 <member name="T:HttpServer.FormDecoders.MultipartDecoder">
3439 <summary> 3671 <summary>
@@ -3471,40 +3703,34 @@
3471 <param name="contentType">Content type (with any additional info like boundry). Content type is always supplied in lower case.</param> 3703 <param name="contentType">Content type (with any additional info like boundry). Content type is always supplied in lower case.</param>
3472 <returns>True if the decoder can parse the specified content type</returns> 3704 <returns>True if the decoder can parse the specified content type</returns>
3473 </member> 3705 </member>
3474 <member name="M:HttpServer.ComponentProvider.AddInstance``1(System.Object)"> 3706 <member name="T:HttpServer.ClientAcceptedEventArgs">
3475 <summary> 3707 <summary>
3476 Add a component instance 3708 Invoked when a client have been accepted by the <see cref="T:HttpServer.HttpListener"/>
3477 </summary> 3709 </summary>
3478 <typeparam name="T">Interface type</typeparam> 3710 <remarks>
3479 <param name="instance">Instance to add</param> 3711 Can be used to revoke incoming connections
3712 </remarks>
3480 </member> 3713 </member>
3481 <member name="M:HttpServer.ComponentProvider.Get``1"> 3714 <member name="M:HttpServer.ClientAcceptedEventArgs.#ctor(System.Net.Sockets.Socket)">
3482 <summary> 3715 <summary>
3483 Get a component. 3716 Initializes a new instance of the <see cref="T:HttpServer.ClientAcceptedEventArgs"/> class.
3484 </summary> 3717 </summary>
3485 <typeparam name="T">Interface type</typeparam> 3718 <param name="socket">The socket.</param>
3486 <returns>Component if registered, otherwise null.</returns>
3487 <remarks>
3488 Component will get created if needed.
3489 </remarks>
3490 </member> 3719 </member>
3491 <member name="M:HttpServer.ComponentProvider.Create(HttpServer.ComponentProvider.TypeInformation)"> 3720 <member name="M:HttpServer.ClientAcceptedEventArgs.Revoke">
3492 <exception cref="T:System.InvalidOperationException">If instance cannot be created.</exception> 3721 <summary>
3722 Client may not be handled.
3723 </summary>
3493 </member> 3724 </member>
3494 <member name="M:HttpServer.ComponentProvider.Contains(System.Type)"> 3725 <member name="P:HttpServer.ClientAcceptedEventArgs.Socket">
3495 <summary> 3726 <summary>
3496 Checks if the specified component interface have been added. 3727 Accepted socket.
3497 </summary> 3728 </summary>
3498 <param name="interfaceType"></param>
3499 <returns>true if found; otherwise false.</returns>
3500 </member> 3729 </member>
3501 <member name="M:HttpServer.ComponentProvider.Add``2"> 3730 <member name="P:HttpServer.ClientAcceptedEventArgs.Revoked">
3502 <summary> 3731 <summary>
3503 Add a component. 3732 Client should be revoked.
3504 </summary> 3733 </summary>
3505 <typeparam name="InterfaceType">Type being requested.</typeparam>
3506 <typeparam name="InstanceType">Type being created.</typeparam>
3507 <exception cref="T:System.InvalidOperationException">Type have already been mapped.</exception>
3508 </member> 3734 </member>
3509 <member name="T:HttpServer.HttpModules.FileModule"> 3735 <member name="T:HttpServer.HttpModules.FileModule">
3510 <summary> 3736 <summary>
@@ -3581,1013 +3807,951 @@
3581 fileMod.ForbiddenChars = new string[]{ "\\", "..", ":" }; 3807 fileMod.ForbiddenChars = new string[]{ "\\", "..", ":" };
3582 </example> 3808 </example>
3583 </member> 3809 </member>
3584 <member name="T:HttpServer.HttpListenerBase"> 3810 <member name="T:HttpServer.Helpers.XmlHelper">
3585 <summary>
3586 Contains a listener that doesn't do anything with the connections.
3587 </summary>
3588 </member>
3589 <member name="M:HttpServer.HttpListenerBase.#ctor(System.Net.IPAddress,System.Int32,HttpServer.IHttpContextFactory)">
3590 <summary>
3591 Listen for regular HTTP connections
3592 </summary>
3593 <param name="address">IP Address to accept connections on</param>
3594 <param name="port">TCP Port to listen on, default HTTP port is 80.</param>
3595 <param name="factory">Factory used to create <see cref="T:HttpServer.IHttpClientContext"/>es.</param>
3596 <exception cref="T:System.ArgumentNullException"><c>address</c> is null.</exception>
3597 <exception cref="T:System.ArgumentException">Port must be a positive number.</exception>
3598 </member>
3599 <member name="M:HttpServer.HttpListenerBase.#ctor(System.Net.IPAddress,System.Int32,HttpServer.IHttpContextFactory,System.Security.Cryptography.X509Certificates.X509Certificate)">
3600 <summary> 3811 <summary>
3601 Initializes a new instance of the <see cref="T:HttpServer.HttpListenerBase"/> class. 3812 Helpers to make XML handling easier
3602 </summary> 3813 </summary>
3603 <param name="address">IP Address to accept connections on</param>
3604 <param name="port">TCP Port to listen on, default HTTPS port is 443</param>
3605 <param name="factory">Factory used to create <see cref="T:HttpServer.IHttpClientContext"/>es.</param>
3606 <param name="certificate">Certificate to use</param>
3607 </member> 3814 </member>
3608 <member name="M:HttpServer.HttpListenerBase.#ctor(System.Net.IPAddress,System.Int32,HttpServer.IHttpContextFactory,System.Security.Cryptography.X509Certificates.X509Certificate,System.Security.Authentication.SslProtocols)"> 3815 <member name="M:HttpServer.Helpers.XmlHelper.Serialize(System.Object)">
3609 <summary>
3610 Initializes a new instance of the <see cref="T:HttpServer.HttpListenerBase"/> class.
3611 </summary>
3612 <param name="address">IP Address to accept connections on</param>
3613 <param name="port">TCP Port to listen on, default HTTPS port is 443</param>
3614 <param name="factory">Factory used to create <see cref="T:HttpServer.IHttpClientContext"/>es.</param>
3615 <param name="certificate">Certificate to use</param>
3616 <param name="protocol">which HTTPS protocol to use, default is TLS.</param>
3617 </member>
3618 <member name="M:HttpServer.HttpListenerBase.OnAccept(System.IAsyncResult)">
3619 <exception cref="T:System.Exception"><c>Exception</c>.</exception>
3620 </member>
3621 <member name="M:HttpServer.HttpListenerBase.RetryBeginAccept">
3622 <summary> 3816 <summary>
3623 Will try to accept connections one more time. 3817 Serializes object to XML.
3624 </summary> 3818 </summary>
3625 <exception cref="T:System.Exception">If any exceptions is thrown.</exception> 3819 <param name="value">object to serialize.</param>
3820 <returns>XML</returns>
3821 <remarks>
3822 Removes name spaces and adds indentation
3823 </remarks>
3626 </member> 3824 </member>
3627 <member name="M:HttpServer.HttpListenerBase.OnAcceptingSocket(System.Net.Sockets.Socket)"> 3825 <member name="M:HttpServer.Helpers.XmlHelper.Deserialize``1(System.String)">
3628 <summary> 3826 <summary>
3629 Can be used to create filtering of new connections. 3827 Create an object from a XML string
3630 </summary> 3828 </summary>
3631 <param name="socket">Accepted socket</param> 3829 <typeparam name="T">Type of object</typeparam>
3632 <returns>true if connection can be accepted; otherwise false.</returns> 3830 <param name="xml">XML string</param>
3831 <returns>object</returns>
3633 </member> 3832 </member>
3634 <member name="M:HttpServer.HttpListenerBase.Start(System.Int32)"> 3833 <member name="T:HttpServer.Exceptions.NotFoundException">
3635 <summary> 3834 <summary>
3636 Start listen for new connections 3835 The requested resource was not found in the web server.
3637 </summary> 3836 </summary>
3638 <param name="backlog">Number of connections that can stand in a queue to be accepted.</param>
3639 <exception cref="T:System.InvalidOperationException">Listener have already been started.</exception>
3640 </member> 3837 </member>
3641 <member name="M:HttpServer.HttpListenerBase.Stop"> 3838 <member name="M:HttpServer.Exceptions.NotFoundException.#ctor(System.String,System.Exception)">
3642 <summary> 3839 <summary>
3643 Stop the listener 3840 Create a new exception
3644 </summary> 3841 </summary>
3645 <exception cref="T:System.Net.Sockets.SocketException"></exception> 3842 <param name="message">message describing the error</param>
3843 <param name="inner">inner exception</param>
3646 </member> 3844 </member>
3647 <member name="P:HttpServer.HttpListenerBase.LogWriter"> 3845 <member name="M:HttpServer.Exceptions.NotFoundException.#ctor(System.String)">
3648 <summary> 3846 <summary>
3649 Gives you a change to receive log entries for all internals of the HTTP library. 3847 Create a new exception
3650 </summary> 3848 </summary>
3651 <remarks> 3849 <param name="message">message describing the error</param>
3652 You may not switch log writer after starting the listener.
3653 </remarks>
3654 </member> 3850 </member>
3655 <member name="P:HttpServer.HttpListenerBase.UseTraceLogs"> 3851 <member name="T:HttpServer.RequestCookie">
3656 <summary> 3852 <summary>
3657 True if we should turn on trace logs. 3853 cookie sent by the client/browser
3658 </summary> 3854 </summary>
3855 <seealso cref="T:HttpServer.ResponseCookie"/>
3659 </member> 3856 </member>
3660 <member name="E:HttpServer.HttpListenerBase.ExceptionThrown"> 3857 <member name="M:HttpServer.RequestCookie.#ctor(System.String,System.String)">
3661 <summary> 3858 <summary>
3662 Catch exceptions not handled by the listener. 3859 Constructor.
3663 </summary> 3860 </summary>
3664 <remarks> 3861 <param name="id">cookie identifier</param>
3665 Exceptions will be thrown during debug mode if this event is not used, 3862 <param name="content">cookie content</param>
3666 exceptions will be printed to console and suppressed during release mode. 3863 <exception cref="T:System.ArgumentNullException">id or content is null</exception>
3667 </remarks> 3864 <exception cref="T:System.ArgumentException">id is empty</exception>
3668 </member> 3865 </member>
3669 <member name="E:HttpServer.HttpListenerBase.RequestReceived"> 3866 <member name="M:HttpServer.RequestCookie.ToString">
3670 <summary> 3867 <summary>
3671 A request have been received from a <see cref="T:HttpServer.IHttpClientContext"/>. 3868 Gets the cookie HTML representation.
3672 </summary> 3869 </summary>
3870 <returns>cookie string</returns>
3673 </member> 3871 </member>
3674 <member name="T:HttpServer.HttpFile"> 3872 <member name="P:HttpServer.RequestCookie.Name">
3675 <summary> 3873 <summary>
3676 Container class for posted files 3874 Gets the cookie identifier.
3677 </summary> 3875 </summary>
3678 </member> 3876 </member>
3679 <member name="M:HttpServer.HttpFile.#ctor(System.String,System.String,System.String,System.String)"> 3877 <member name="P:HttpServer.RequestCookie.Value">
3680 <summary> 3878 <summary>
3681 Creates a container for a posted file 3879 Cookie value. Set to null to remove cookie.
3682 </summary> 3880 </summary>
3683 <param name="name">The identifier of the post field</param>
3684 <param name="filename">The file path</param>
3685 <param name="contentType">The content type of the file</param>
3686 <param name="uploadFilename">The name of the file uploaded</param>
3687 <exception cref="T:System.ArgumentNullException">If any parameter is null or empty</exception>
3688 </member> 3881 </member>
3689 <member name="M:HttpServer.HttpFile.#ctor(System.String,System.String,System.String)"> 3882 <member name="T:HttpServer.HttpParam">
3690 <summary> 3883 <summary>
3691 Creates a container for a posted file <see cref="M:HttpServer.HttpFile.#ctor(System.String,System.String,System.String,System.String)"/> 3884 Returns item either from a form or a query string (checks them in that order)
3692 </summary> 3885 </summary>
3693 <exception cref="T:System.ArgumentNullException">If any parameter is null or empty</exception>
3694 </member> 3886 </member>
3695 <member name="M:HttpServer.HttpFile.Finalize"> 3887 <member name="F:HttpServer.HttpParam.Empty">
3696 <summary>Destructor disposing the file</summary> 3888 <summary> Representation of a non-initialized HttpParam </summary>
3697 </member> 3889 </member>
3698 <member name="M:HttpServer.HttpFile.Dispose(System.Boolean)"> 3890 <member name="M:HttpServer.HttpParam.#ctor(HttpServer.IHttpInput,HttpServer.IHttpInput)">
3699 <summary> 3891 <summary>Initialises the class to hold a value either from a post request or a querystring request</summary>
3700 Deletes the temporary file
3701 </summary>
3702 <param name="disposing">True if manual dispose</param>
3703 </member> 3892 </member>
3704 <member name="M:HttpServer.HttpFile.Dispose"> 3893 <member name="M:HttpServer.HttpParam.Add(System.String,System.String)">
3705 <summary> 3894 <summary>
3706 Disposing interface, cleans up managed resources (the temporary file) and suppresses finalization 3895 The add method is not availible for HttpParam
3896 since HttpParam checks both Request.Form and Request.QueryString
3707 </summary> 3897 </summary>
3898 <param name="name">name identifying the value</param>
3899 <param name="value">value to add</param>
3900 <exception cref="T:System.NotImplementedException"></exception>
3708 </member> 3901 </member>
3709 <member name="P:HttpServer.HttpFile.Name"> 3902 <member name="M:HttpServer.HttpParam.Contains(System.String)">
3710 <summary> 3903 <summary>
3711 The name/id of the file 3904 Checks whether the form or querystring has the specified value
3712 </summary> 3905 </summary>
3906 <param name="name">Name, case sensitive</param>
3907 <returns>true if found; otherwise false.</returns>
3713 </member> 3908 </member>
3714 <member name="P:HttpServer.HttpFile.Filename"> 3909 <member name="M:HttpServer.HttpParam.System#Collections#Generic#IEnumerable{HttpServer#HttpInputItem}#GetEnumerator">
3715 <summary> 3910 <summary>
3716 The full file path 3911 Returns an enumerator that iterates through the collection.
3717 </summary> 3912 </summary>
3913
3914 <returns>
3915 A <see cref="T:System.Collections.Generic.IEnumerator`1"></see> that can be used to iterate through the collection.
3916 </returns>
3917 <filterpriority>1</filterpriority>
3718 </member> 3918 </member>
3719 <member name="P:HttpServer.HttpFile.UploadFilename"> 3919 <member name="M:HttpServer.HttpParam.GetEnumerator">
3720 <summary> 3920 <summary>
3721 The name of the uploaded file 3921 Returns an enumerator that iterates through a collection.
3722 </summary> 3922 </summary>
3923
3924 <returns>
3925 An <see cref="T:System.Collections.IEnumerator"></see> object that can be used to iterate through the collection.
3926 </returns>
3927 <filterpriority>2</filterpriority>
3723 </member> 3928 </member>
3724 <member name="P:HttpServer.HttpFile.ContentType"> 3929 <member name="P:HttpServer.HttpParam.Item(System.String)">
3725 <summary> 3930 <summary>
3726 The type of file 3931 Fetch an item from the form or querystring (in that order).
3727 </summary> 3932 </summary>
3933 <param name="name"></param>
3934 <returns>Item if found; otherwise HttpInputItem.EmptyLanguageNode</returns>
3728 </member> 3935 </member>
3729 <member name="T:HttpServer.Authentication.DigestAuthentication"> 3936 <member name="T:HttpServer.HttpClientContext">
3730 <summary> 3937 <summary>
3731 Implements HTTP Digest authentication. It's more secure than Basic auth since password is 3938 Contains a connection to a browser/client.
3732 encrypted with a "key" from the server.
3733 </summary> 3939 </summary>
3734 <remarks> 3940 <remarks>
3735 Keep in mind that the password is encrypted with MD5. Use a combination of SSL and digest auth to be secure. 3941 Remember to <see cref="M:HttpServer.HttpClientContext.Start"/> after you have hooked the <see cref="E:HttpServer.HttpClientContext.RequestReceived"/> event.
3736 </remarks> 3942 </remarks>
3943 TODO: Maybe this class should be broken up into HttpClientChannel and HttpClientContext?
3737 </member> 3944 </member>
3738 <member name="M:HttpServer.Authentication.DigestAuthentication.#ctor(HttpServer.Authentication.AuthenticationHandler,HttpServer.Authentication.AuthenticationRequiredHandler)"> 3945 <member name="M:HttpServer.HttpClientContext.#ctor(System.Boolean,System.Net.IPEndPoint,System.IO.Stream,HttpServer.IRequestParserFactory,System.Int32,System.Net.Sockets.Socket)">
3739 <summary>
3740 Initializes a new instance of the <see cref="T:HttpServer.Authentication.DigestAuthentication"/> class.
3741 </summary>
3742 <param name="authenticator">Delegate used to provide information used during authentication.</param>
3743 <param name="authenticationRequiredHandler">Delegate used to determine if authentication is required (may be null).</param>
3744 </member>
3745 <member name="M:HttpServer.Authentication.DigestAuthentication.#ctor(HttpServer.Authentication.AuthenticationHandler)">
3746 <summary>
3747 Initializes a new instance of the <see cref="T:HttpServer.Authentication.DigestAuthentication"/> class.
3748 </summary>
3749 <param name="authenticator">Delegate used to provide information used during authentication.</param>
3750 </member>
3751 <member name="F:HttpServer.Authentication.DigestAuthentication.DisableNonceCheck">
3752 <summary>
3753 Used by test classes to be able to use hardcoded values
3754 </summary>
3755 </member>
3756 <member name="M:HttpServer.Authentication.DigestAuthentication.Authenticate(System.String,System.String,System.String,System.Object[])">
3757 <summary> 3946 <summary>
3758 An authentication response have been received from the web browser. 3947 Initializes a new instance of the <see cref="T:HttpServer.HttpClientContext"/> class.
3759 Check if it's correct
3760 </summary> 3948 </summary>
3761 <param name="authenticationHeader">Contents from the Authorization header</param> 3949 <param name="secured">true if the connection is secured (SSL/TLS)</param>
3762 <param name="realm">Realm that should be authenticated</param> 3950 <param name="remoteEndPoint">client that connected.</param>
3763 <param name="httpVerb">GET/POST/PUT/DELETE etc.</param> 3951 <param name="stream">Stream used for communication</param>
3764 <param name="options">First option: true if username/password is correct but not cnonce</param> 3952 <param name="parserFactory">Used to create a <see cref="T:HttpServer.IHttpRequestParser"/>.</param>
3765 <returns> 3953 <param name="bufferSize">Size of buffer to use when reading data. Must be at least 4096 bytes.</param>
3766 Authentication object that is stored for the request. A user class or something like that. 3954 <exception cref="T:System.Net.Sockets.SocketException">If <see cref="M:System.Net.Sockets.Socket.BeginReceive(System.Byte[],System.Int32,System.Int32,System.Net.Sockets.SocketFlags,System.AsyncCallback,System.Object)"/> fails</exception>
3767 </returns> 3955 <exception cref="T:System.ArgumentException">Stream must be writable and readable.</exception>
3768 <exception cref="T:System.ArgumentException">if authenticationHeader is invalid</exception>
3769 <exception cref="T:System.ArgumentNullException">If any of the paramters is empty or null.</exception>
3770 </member> 3956 </member>
3771 <member name="M:HttpServer.Authentication.DigestAuthentication.Encrypt(System.String,System.String,System.String,System.String,System.String,System.String,System.String,System.String,System.String)"> 3957 <member name="M:HttpServer.HttpClientContext.OnBodyBytesReceived(System.Object,HttpServer.Parser.BodyEventArgs)">
3772 <summary> 3958 <summary>
3773 Encrypts parameters into a Digest string 3959 Process incoming body bytes.
3774 </summary> 3960 </summary>
3775 <param name="realm">Realm that the user want to log into.</param> 3961 <param name="sender"><see cref="T:HttpServer.IHttpRequestParser"/></param>
3776 <param name="userName">User logging in</param> 3962 <param name="e">Bytes</param>
3777 <param name="password">Users password.</param>
3778 <param name="method">HTTP method.</param>
3779 <param name="uri">Uri/domain that generated the login prompt.</param>
3780 <param name="qop">Quality of Protection.</param>
3781 <param name="nonce">"Number used ONCE"</param>
3782 <param name="nc">Hexadecimal request counter.</param>
3783 <param name="cnonce">"Client Number used ONCE"</param>
3784 <returns>Digest encrypted string</returns>
3785 </member> 3963 </member>
3786 <member name="M:HttpServer.Authentication.DigestAuthentication.Encrypt(System.String,System.String,System.String,System.String,System.String,System.String)"> 3964 <member name="M:HttpServer.HttpClientContext.OnHeaderReceived(System.Object,HttpServer.Parser.HeaderEventArgs)">
3787 <summary> 3965 <summary>
3788 3966
3789 </summary> 3967 </summary>
3790 <param name="ha1">Md5 hex encoded "userName:realm:password", without the quotes.</param> 3968 <param name="sender"></param>
3791 <param name="ha2">Md5 hex encoded "method:uri", without the quotes</param> 3969 <param name="e"></param>
3792 <param name="qop">Quality of Protection</param>
3793 <param name="nonce">"Number used ONCE"</param>
3794 <param name="nc">Hexadecimal request counter.</param>
3795 <param name="cnonce">Client number used once</param>
3796 <returns></returns>
3797 </member> 3970 </member>
3798 <member name="M:HttpServer.Authentication.DigestAuthentication.CreateResponse(System.String,System.Object[])"> 3971 <member name="M:HttpServer.HttpClientContext.Start">
3799 <summary> 3972 <summary>
3800 Create a response that can be sent in the WWW-Authenticate header. 3973 Start reading content.
3801 </summary> 3974 </summary>
3802 <param name="realm">Realm that the user should authenticate in</param> 3975 <remarks>
3803 <param name="options">First options specifies if true if username/password is correct but not cnonce.</param> 3976 Make sure to call base.Start() if you override this method.
3804 <returns>A correct auth request.</returns> 3977 </remarks>
3805 <exception cref="T:System.ArgumentNullException">If realm is empty or null.</exception>
3806 </member> 3978 </member>
3807 <member name="M:HttpServer.Authentication.DigestAuthentication.Decode(System.String,System.Text.Encoding)"> 3979 <member name="M:HttpServer.HttpClientContext.Cleanup">
3808 <summary> 3980 <summary>
3809 Decodes authorization header value 3981 Clean up context.
3810 </summary> 3982 </summary>
3811 <param name="buffer">header value</param> 3983 <remarks>
3812 <param name="encoding">Encoding that the buffer is in</param> 3984 Make sure to call base.Cleanup() if you override the method.
3813 <returns>All headers and their values if successful; otherwise null</returns> 3985 </remarks>
3814 <example>
3815 NameValueCollection header = DigestAuthentication.Decode("response=\"6629fae49393a05397450978507c4ef1\",\r\nc=00001", Encoding.ASCII);
3816 </example>
3817 <remarks>Can handle lots of whitespaces and new lines without failing.</remarks>
3818 </member> 3986 </member>
3819 <member name="M:HttpServer.Authentication.DigestAuthentication.GetCurrentNonce"> 3987 <member name="M:HttpServer.HttpClientContext.Disconnect(System.Net.Sockets.SocketError)">
3820 <summary> 3988 <summary>
3821 Gets the current nonce. 3989 Disconnect from client
3822 </summary> 3990 </summary>
3823 <returns></returns> 3991 <param name="error">error to report in the <see cref="E:HttpServer.HttpClientContext.Disconnected"/> event.</param>
3824 </member> 3992 </member>
3825 <member name="M:HttpServer.Authentication.DigestAuthentication.GetMD5HashBinHex2(System.String)"> 3993 <member name="M:HttpServer.HttpClientContext.OnReceive(System.IAsyncResult)">
3826 <summary> 3994 <exception cref="T:HttpServer.Exceptions.BadRequestException"><c>BadRequestException</c>.</exception>
3827 Gets the Md5 hash bin hex2.
3828 </summary>
3829 <param name="toBeHashed">To be hashed.</param>
3830 <returns></returns>
3831 </member> 3995 </member>
3832 <member name="M:HttpServer.Authentication.DigestAuthentication.IsValidNonce(System.String)"> 3996 <member name="M:HttpServer.HttpClientContext.Respond(System.String,System.Net.HttpStatusCode,System.String,System.String,System.String)">
3833 <summary> 3997 <summary>
3834 determines if the nonce is valid or has expired. 3998 Send a response.
3835 </summary> 3999 </summary>
3836 <param name="nonce">nonce value (check wikipedia for info)</param> 4000 <param name="httpVersion">Either <see cref="F:HttpServer.HttpHelper.HTTP10"/> or <see cref="F:HttpServer.HttpHelper.HTTP11"/></param>
3837 <returns>true if the nonce has not expired.</returns> 4001 <param name="statusCode">HTTP status code</param>
4002 <param name="reason">reason for the status code.</param>
4003 <param name="body">HTML body contents, can be null or empty.</param>
4004 <param name="contentType">A content type to return the body as, i.e. 'text/html' or 'text/plain', defaults to 'text/html' if null or empty</param>
4005 <exception cref="T:System.ArgumentException">If <paramref name="httpVersion"/> is invalid.</exception>
3838 </member> 4006 </member>
3839 <member name="P:HttpServer.Authentication.DigestAuthentication.Name"> 4007 <member name="M:HttpServer.HttpClientContext.Respond(System.String,System.Net.HttpStatusCode,System.String)">
3840 <summary> 4008 <summary>
3841 name used in http request. 4009 Send a response.
3842 </summary> 4010 </summary>
4011 <param name="httpVersion">Either <see cref="F:HttpServer.HttpHelper.HTTP10"/> or <see cref="F:HttpServer.HttpHelper.HTTP11"/></param>
4012 <param name="statusCode">HTTP status code</param>
4013 <param name="reason">reason for the status code.</param>
3843 </member> 4014 </member>
3844 <member name="P:HttpServer.Authentication.DigestAuthentication.TokenIsHA1"> 4015 <member name="M:HttpServer.HttpClientContext.Respond(System.String)">
3845 <summary> 4016 <summary>
3846 Gets or sets whether the token supplied in <see cref="T:HttpServer.Authentication.AuthenticationHandler"/> is a 4017 Send a response.
3847 HA1 generated string.
3848 </summary> 4018 </summary>
4019 <exception cref="T:System.ArgumentNullException"></exception>
3849 </member> 4020 </member>
3850 <member name="T:HttpServer.RequestParserState"> 4021 <member name="M:HttpServer.HttpClientContext.Send(System.Byte[])">
3851 <summary> 4022 <summary>
3852 Current state in the parsing. 4023 send a whole buffer
3853 </summary> 4024 </summary>
4025 <param name="buffer">buffer to send</param>
4026 <exception cref="T:System.ArgumentNullException"></exception>
3854 </member> 4027 </member>
3855 <member name="F:HttpServer.RequestParserState.FirstLine"> 4028 <member name="M:HttpServer.HttpClientContext.Send(System.Byte[],System.Int32,System.Int32)">
3856 <summary> 4029 <summary>
3857 Should parse the request line 4030 Send data using the stream
3858 </summary> 4031 </summary>
4032 <param name="buffer">Contains data to send</param>
4033 <param name="offset">Start position in buffer</param>
4034 <param name="size">number of bytes to send</param>
4035 <exception cref="T:System.ArgumentNullException"></exception>
4036 <exception cref="T:System.ArgumentOutOfRangeException"></exception>
3859 </member> 4037 </member>
3860 <member name="F:HttpServer.RequestParserState.HeaderName"> 4038 <member name="E:HttpServer.HttpClientContext.Cleaned">
3861 <summary> 4039 <summary>
3862 Searching for a complete header name 4040 This context have been cleaned, which means that it can be reused.
3863 </summary> 4041 </summary>
3864 </member> 4042 </member>
3865 <member name="F:HttpServer.RequestParserState.AfterName"> 4043 <member name="E:HttpServer.HttpClientContext.Started">
3866 <summary> 4044 <summary>
3867 Searching for colon after header name (ignoring white spaces) 4045 Context have been started (a new client have connected)
3868 </summary> 4046 </summary>
3869 </member> 4047 </member>
3870 <member name="F:HttpServer.RequestParserState.Between"> 4048 <member name="P:HttpServer.HttpClientContext.CurrentRequest">
3871 <summary> 4049 <summary>
3872 Searching for start of header value (ignoring white spaces) 4050 Overload to specify own type.
3873 </summary> 4051 </summary>
4052 <remarks>
4053 Must be specified before the context is being used.
4054 </remarks>
3874 </member> 4055 </member>
3875 <member name="F:HttpServer.RequestParserState.HeaderValue"> 4056 <member name="P:HttpServer.HttpClientContext.Secured">
3876 <summary> 4057 <summary>
3877 Searching for a complete header value (can span over multiple lines, as long as they are prefixed with one/more whitespaces) 4058 Using SSL or other encryption method.
3878 </summary> 4059 </summary>
3879 </member> 4060 </member>
3880 <member name="F:HttpServer.RequestParserState.Body"> 4061 <member name="P:HttpServer.HttpClientContext.IsSecured">
3881 <summary> 4062 <summary>
3882 Adding bytes to body 4063 Using SSL or other encryption method.
3883 </summary> 4064 </summary>
3884 </member> 4065 </member>
3885 <member name="T:HttpServer.Rules.RegexRedirectRule"> 4066 <member name="P:HttpServer.HttpClientContext.LogWriter">
3886 <summary> 4067 <summary>
3887 Class to make dynamic binding of redirects. Instead of having to specify a number of similar redirect rules 4068 Specify which logger to use.
3888 a regular expression can be used to identify redirect URLs and their targets.
3889 </summary> 4069 </summary>
3890 <example>
3891 <![CDATA[
3892 new RegexRedirectRule("/(?<target>[a-z0-9]+)", "/users/${target}?find=true", RegexOptions.IgnoreCase)
3893 ]]>
3894 </example>
3895 </member> 4070 </member>
3896 <member name="M:HttpServer.Rules.RegexRedirectRule.#ctor(System.String,System.String)"> 4071 <member name="P:HttpServer.HttpClientContext.Stream">
3897 <summary> 4072 <summary>
3898 Initializes a new instance of the <see cref="T:HttpServer.Rules.RegexRedirectRule"/> class. 4073 Gets or sets the network stream.
3899 </summary> 4074 </summary>
3900 <param name="fromUrlExpression">Expression to match URL</param>
3901 <param name="toUrlExpression">Expression to generate URL</param>
3902 <example>
3903 <![CDATA[
3904 server.Add(new RegexRedirectRule("/(?<first>[a-zA-Z0-9]+)", "/user/${first}"));
3905 Result of ie. /employee1 will then be /user/employee1
3906 ]]>
3907 </example>
3908 </member> 4075 </member>
3909 <member name="M:HttpServer.Rules.RegexRedirectRule.#ctor(System.String,System.String,System.Text.RegularExpressions.RegexOptions)"> 4076 <member name="P:HttpServer.HttpClientContext.RemoteAddress">
3910 <summary> 4077 <summary>
3911 Initializes a new instance of the <see cref="T:HttpServer.Rules.RegexRedirectRule"/> class. 4078 Gets or sets IP address that the client connected from.
3912 </summary> 4079 </summary>
3913 <param name="fromUrlExpression">Expression to match URL</param>
3914 <param name="toUrlExpression">Expression to generate URL</param>
3915 <param name="options">Regular expression options to use, can be null</param>
3916 <example>
3917 <![CDATA[
3918 server.Add(new RegexRedirectRule("/(?<first>[a-zA-Z0-9]+)", "/user/{first}", RegexOptions.IgnoreCase));
3919 Result of ie. /employee1 will then be /user/employee1
3920 ]]>
3921 </example>
3922 </member> 4080 </member>
3923 <member name="M:HttpServer.Rules.RegexRedirectRule.#ctor(System.String,System.String,System.Text.RegularExpressions.RegexOptions,System.Boolean)"> 4081 <member name="P:HttpServer.HttpClientContext.RemotePort">
3924 <summary> 4082 <summary>
3925 Initializes a new instance of the <see cref="T:HttpServer.Rules.RegexRedirectRule"/> class. 4083 Gets or sets port that the client connected from.
3926 </summary> 4084 </summary>
3927 <param name="fromUrlExpression">Expression to match URL</param>
3928 <param name="toUrlExpression">Expression to generate URL</param>
3929 <param name="options">Regular expression options to apply</param>
3930 <param name="shouldRedirect"><c>true</c> if request should be redirected, <c>false</c> if the request URI should be replaced.</param>
3931 <example>
3932 <![CDATA[
3933 server.Add(new RegexRedirectRule("/(?<first>[a-zA-Z0-9]+)", "/user/${first}", RegexOptions.None));
3934 Result of ie. /employee1 will then be /user/employee1
3935 ]]>
3936 </example>
3937 <exception cref="T:System.ArgumentNullException">Argument is null.</exception>
3938 <seealso cref="P:HttpServer.Rules.RedirectRule.ShouldRedirect"/>
3939 </member> 4085 </member>
3940 <member name="M:HttpServer.Rules.RegexRedirectRule.Process(HttpServer.IHttpRequest,HttpServer.IHttpResponse)"> 4086 <member name="E:HttpServer.HttpClientContext.Disconnected">
3941 <summary> 4087 <summary>
3942 Process the incoming request. 4088 The context have been disconnected.
3943 </summary> 4089 </summary>
3944 <param name="request">incoming HTTP request</param>
3945 <param name="response">outgoing HTTP response</param>
3946 <returns>true if response should be sent to the browser directly (no other rules or modules will be processed).</returns>
3947 <remarks> 4090 <remarks>
3948 returning true means that no modules will get the request. Returning true is typically being done 4091 Event can be used to clean up a context, or to reuse it.
3949 for redirects.
3950 </remarks> 4092 </remarks>
3951 <exception cref="T:System.ArgumentNullException">If request or response is null</exception>
3952 </member> 4093 </member>
3953 <member name="T:HttpServer.RequestCookies"> 4094 <member name="E:HttpServer.HttpClientContext.RequestReceived">
3954 <summary> 4095 <summary>
3955 This class is created as a wrapper, since there are two different cookie types in .Net (Cookie and HttpCookie). 4096 A request have been received in the context.
3956 The framework might switch class in the future and we dont want to have to replace all instances
3957 </summary> 4097 </summary>
3958 </member> 4098 </member>
3959 <member name="M:HttpServer.RequestCookies.#ctor(System.String)"> 4099 <member name="T:HttpServer.Helpers.ResourceManager">
4100 <summary>Class to handle loading of resource files</summary>
4101 </member>
4102 <member name="M:HttpServer.Helpers.ResourceManager.#ctor">
3960 <summary> 4103 <summary>
3961 Let's copy all the cookies. 4104 Initializes a new instance of the <see cref="T:HttpServer.Helpers.ResourceManager"/> class.
3962 </summary> 4105 </summary>
3963 <param name="cookies">value from cookie header.</param>
3964 </member> 4106 </member>
3965 <member name="M:HttpServer.RequestCookies.Add(HttpServer.RequestCookie)"> 4107 <member name="M:HttpServer.Helpers.ResourceManager.#ctor(HttpServer.ILogWriter)">
3966 <summary> 4108 <summary>
3967 Adds a cookie in the collection. 4109 Initializes a new instance of the <see cref="T:HttpServer.Helpers.ResourceManager"/> class.
3968 </summary> 4110 </summary>
3969 <param name="cookie">cookie to add</param> 4111 <param name="writer">logger.</param>
3970 <exception cref="T:System.ArgumentNullException">cookie is null</exception>
3971 </member> 4112 </member>
3972 <member name="M:HttpServer.RequestCookies.GetEnumerator"> 4113 <member name="M:HttpServer.Helpers.ResourceManager.LoadResources(System.String,System.Reflection.Assembly,System.String)">
3973 <summary> 4114 <summary>
3974 Gets a collection enumerator on the cookie list. 4115 Loads resources from a namespace in the given assembly to an URI
3975 </summary> 4116 </summary>
3976 <returns>collection enumerator</returns> 4117 <param name="toUri">The URI to map the resources to</param>
4118 <param name="fromAssembly">The assembly in which the resources reside</param>
4119 <param name="fromNamespace">The namespace from which to load the resources</param>
4120 <usage>
4121 <code>
4122 resourceLoader.LoadResources("/user/", typeof(User).Assembly, "MyLib.Models.User.Views");
4123 </code>
4124 Will make the resource MyLib.Models.User.Views.list.Haml accessible via /user/list.haml or /user/list/
4125 </usage>
4126 <returns>The amount of loaded files, giving you the possibility of making sure the resources needed gets loaded</returns>
4127 <exception cref="T:System.InvalidOperationException">If a resource has already been mapped to an uri</exception>
3977 </member> 4128 </member>
3978 <member name="M:HttpServer.RequestCookies.Clear"> 4129 <member name="M:HttpServer.Helpers.ResourceManager.GetResourceStream(System.String)">
3979 <summary> 4130 <summary>
3980 Remove all cookies. 4131 Retrieves a stream for the specified resource path if loaded otherwise null
3981 </summary> 4132 </summary>
4133 <param name="path">Path to the resource to retrieve a stream for</param>
4134 <returns>A stream or null if the resource couldn't be found</returns>
3982 </member> 4135 </member>
3983 <member name="M:HttpServer.RequestCookies.System#Collections#Generic#IEnumerable{HttpServer#RequestCookie}#GetEnumerator"> 4136 <member name="M:HttpServer.Helpers.ResourceManager.GetFiles(System.String)">
3984 <summary> 4137 <summary>
3985 Returns an enumerator that iterates through the collection. 4138 Fetch all files from the resource that matches the specified arguments.
3986 </summary> 4139 </summary>
3987 4140 <param name="path">The path to the resource to extract</param>
3988 <returns> 4141 <returns>
3989 A <see cref="T:System.Collections.Generic.IEnumerator`1"></see> that can be used to iterate through the collection. 4142 a list of files if found; or an empty array if no files are found.
3990 </returns> 4143 </returns>
3991 <filterpriority>1</filterpriority> 4144 <exception cref="T:System.ArgumentException">Search path must end with an asterisk for finding arbitrary files</exception>
3992 </member> 4145 </member>
3993 <member name="M:HttpServer.RequestCookies.Remove(System.String)"> 4146 <member name="M:HttpServer.Helpers.ResourceManager.GetFiles(System.String,System.String)">
3994 <summary> 4147 <summary>
3995 Remove a cookie from the collection. 4148 Fetch all files from the resource that matches the specified arguments.
3996 </summary> 4149 </summary>
3997 <param name="cookieName">Name of cookie.</param> 4150 <param name="path">Where the file should reside.</param>
4151 <param name="filename">Files to check</param>
4152 <returns>
4153 a list of files if found; or an empty array if no files are found.
4154 </returns>
3998 </member> 4155 </member>
3999 <member name="P:HttpServer.RequestCookies.Count"> 4156 <member name="M:HttpServer.Helpers.ResourceManager.ContainsResource(System.String)">
4000 <summary> 4157 <summary>
4001 Gets the count of cookies in the collection. 4158 Returns whether or not the loader has an instance of the file requested
4002 </summary> 4159 </summary>
4160 <param name="filename">The name of the template/file</param>
4161 <returns>True if the loader can provide the file</returns>
4003 </member> 4162 </member>
4004 <member name="P:HttpServer.RequestCookies.Item(System.String)"> 4163 <member name="T:HttpServer.Check">
4005 <summary> 4164 <summary>
4006 Gets the cookie of a given identifier (null if not existing). 4165 Small design by contract implementation.
4007 </summary> 4166 </summary>
4008 </member> 4167 </member>
4009 <member name="T:HttpServer.Parser.BodyEventArgs"> 4168 <member name="M:HttpServer.Check.NotEmpty(System.String,System.String)">
4010 <summary> 4169 <summary>
4011 Arguments used when more body bytes have come. 4170 Check whether a parameter is empty.
4012 </summary> 4171 </summary>
4172 <param name="value">Parameter value</param>
4173 <param name="parameterOrErrorMessage">Parameter name, or error description.</param>
4174 <exception cref="T:System.ArgumentException">value is empty.</exception>
4013 </member> 4175 </member>
4014 <member name="M:HttpServer.Parser.BodyEventArgs.#ctor(System.Byte[],System.Int32,System.Int32)"> 4176 <member name="M:HttpServer.Check.Require(System.Object,System.String)">
4015 <summary> 4177 <summary>
4016 Initializes a new instance of the <see cref="T:HttpServer.Parser.BodyEventArgs"/> class. 4178 Checks whether a parameter is null.
4017 </summary> 4179 </summary>
4018 <param name="buffer">buffer that contains the received bytes.</param> 4180 <param name="value">Parameter value</param>
4019 <param name="offset">offset in buffer where to start processing.</param> 4181 <param name="parameterOrErrorMessage">Parameter name, or error description.</param>
4020 <param name="count">number of bytes from <paramref name="offset"/> that should be parsed.</param> 4182 <exception cref="T:System.ArgumentNullException">value is null.</exception>
4021 </member> 4183 </member>
4022 <member name="M:HttpServer.Parser.BodyEventArgs.#ctor"> 4184 <member name="M:HttpServer.Check.Min(System.Int32,System.Object,System.String)">
4023 <summary> 4185 <summary>
4024 Initializes a new instance of the <see cref="T:HttpServer.Parser.BodyEventArgs"/> class. 4186 Checks whether a parameter is null.
4025 </summary> 4187 </summary>
4188 <param name="minValue"></param>
4189 <param name="value">Parameter value</param>
4190 <param name="parameterOrErrorMessage">Parameter name, or error description.</param>
4191 <exception cref="T:System.ArgumentException">value is null.</exception>
4026 </member> 4192 </member>
4027 <member name="P:HttpServer.Parser.BodyEventArgs.Buffer"> 4193 <member name="T:HttpServer.ResponseCookie">
4028 <summary> 4194 <summary>
4029 Gets or sets buffer that contains the received bytes. 4195 cookie being sent back to the browser.
4030 </summary> 4196 </summary>
4197 <seealso cref="T:HttpServer.ResponseCookie"/>
4031 </member> 4198 </member>
4032 <member name="P:HttpServer.Parser.BodyEventArgs.Count"> 4199 <member name="M:HttpServer.ResponseCookie.#ctor(System.String,System.String,System.DateTime)">
4033 <summary> 4200 <summary>
4034 Gets or sets number of bytes from <see cref="P:HttpServer.Parser.BodyEventArgs.Offset"/> that should be parsed. 4201 Constructor.
4035 </summary> 4202 </summary>
4203 <param name="id">cookie identifier</param>
4204 <param name="content">cookie content</param>
4205 <param name="expiresAt">cookie expiration date. Use DateTime.MinValue for session cookie.</param>
4206 <exception cref="T:System.ArgumentNullException">id or content is null</exception>
4207 <exception cref="T:System.ArgumentException">id is empty</exception>
4036 </member> 4208 </member>
4037 <member name="P:HttpServer.Parser.BodyEventArgs.Offset"> 4209 <member name="M:HttpServer.ResponseCookie.#ctor(System.String,System.String,System.DateTime,System.String,System.String)">
4038 <summary> 4210 <summary>
4039 Gets or sets offset in buffer where to start processing. 4211 Create a new cookie
4040 </summary> 4212 </summary>
4213 <param name="name">name identifying the cookie</param>
4214 <param name="value">cookie value</param>
4215 <param name="expires">when the cookie expires. Setting DateTime.MinValue will delete the cookie when the session is closed.</param>
4216 <param name="path">Path to where the cookie is valid</param>
4217 <param name="domain">Domain that the cookie is valid for.</param>
4041 </member> 4218 </member>
4042 <member name="T:HttpServer.HttpParam"> 4219 <member name="M:HttpServer.ResponseCookie.#ctor(HttpServer.RequestCookie,System.DateTime)">
4043 <summary> 4220 <summary>
4044 Returns item either from a form or a query string (checks them in that order) 4221 Create a new cookie
4045 </summary> 4222 </summary>
4223 <param name="cookie">Name and value will be used</param>
4224 <param name="expires">when the cookie expires.</param>
4046 </member> 4225 </member>
4047 <member name="F:HttpServer.HttpParam.Empty"> 4226 <member name="M:HttpServer.ResponseCookie.ToString">
4048 <summary> Representation of a non-initialized HttpParam </summary> 4227 <summary>
4049 </member> 4228 Gets the cookie HTML representation.
4050 <member name="M:HttpServer.HttpParam.#ctor(HttpServer.IHttpInput,HttpServer.IHttpInput)"> 4229 </summary>
4051 <summary>Initialises the class to hold a value either from a post request or a querystring request</summary> 4230 <returns>cookie string</returns>
4052 </member> 4231 </member>
4053 <member name="M:HttpServer.HttpParam.Add(System.String,System.String)"> 4232 <member name="P:HttpServer.ResponseCookie.Expires">
4054 <summary> 4233 <summary>
4055 The add method is not availible for HttpParam 4234 When the cookie expires.
4056 since HttpParam checks both Request.Form and Request.QueryString 4235 DateTime.MinValue means that the cookie expires when the session do so.
4057 </summary> 4236 </summary>
4058 <param name="name">name identifying the value</param>
4059 <param name="value">value to add</param>
4060 <exception cref="T:System.NotImplementedException"></exception>
4061 </member> 4237 </member>
4062 <member name="M:HttpServer.HttpParam.Contains(System.String)"> 4238 <member name="P:HttpServer.ResponseCookie.Path">
4063 <summary> 4239 <summary>
4064 Checks whether the form or querystring has the specified value 4240 Cookie is only valid under this path.
4065 </summary> 4241 </summary>
4066 <param name="name">Name, case sensitive</param>
4067 <returns>true if found; otherwise false.</returns>
4068 </member> 4242 </member>
4069 <member name="M:HttpServer.HttpParam.System#Collections#Generic#IEnumerable{HttpServer#HttpInputItem}#GetEnumerator"> 4243 <member name="T:HttpServer.Parser.RequestLineEventArgs">
4070 <summary> 4244 <summary>
4071 Returns an enumerator that iterates through the collection. 4245 Used when the request line have been successfully parsed.
4072 </summary> 4246 </summary>
4073
4074 <returns>
4075 A <see cref="T:System.Collections.Generic.IEnumerator`1"></see> that can be used to iterate through the collection.
4076 </returns>
4077 <filterpriority>1</filterpriority>
4078 </member> 4247 </member>
4079 <member name="M:HttpServer.HttpParam.GetEnumerator"> 4248 <member name="M:HttpServer.Parser.RequestLineEventArgs.#ctor(System.String,System.String,System.String)">
4080 <summary> 4249 <summary>
4081 Returns an enumerator that iterates through a collection. 4250 Initializes a new instance of the <see cref="T:HttpServer.Parser.RequestLineEventArgs"/> class.
4082 </summary> 4251 </summary>
4083 4252 <param name="httpMethod">The HTTP method.</param>
4084 <returns> 4253 <param name="uriPath">The URI path.</param>
4085 An <see cref="T:System.Collections.IEnumerator"></see> object that can be used to iterate through the collection. 4254 <param name="httpVersion">The HTTP version.</param>
4086 </returns>
4087 <filterpriority>2</filterpriority>
4088 </member> 4255 </member>
4089 <member name="P:HttpServer.HttpParam.Item(System.String)"> 4256 <member name="M:HttpServer.Parser.RequestLineEventArgs.#ctor">
4090 <summary> 4257 <summary>
4091 Fetch an item from the form or querystring (in that order). 4258 Initializes a new instance of the <see cref="T:HttpServer.Parser.RequestLineEventArgs"/> class.
4092 </summary> 4259 </summary>
4093 <param name="name"></param>
4094 <returns>Item if found; otherwise HttpInputItem.EmptyLanguageNode</returns>
4095 </member> 4260 </member>
4096 <member name="T:HttpServer.ExceptionHandler"> 4261 <member name="P:HttpServer.Parser.RequestLineEventArgs.HttpMethod">
4097 <summary> 4262 <summary>
4098 We dont want to let the server to die due to exceptions thrown in worker threads. 4263 Gets or sets http method.
4099 therefore we use this delegate to give you a change to handle uncaught exceptions.
4100 </summary> 4264 </summary>
4101 <param name="source">Class that the exception was thrown in.</param>
4102 <param name="exception">Exception</param>
4103 <remarks> 4265 <remarks>
4104 Server will throw a InternalServerException in release version if you dont 4266 Should be one of the methods declared in <see cref="T:HttpServer.Method"/>.
4105 handle this delegate.
4106 </remarks> 4267 </remarks>
4107 </member> 4268 </member>
4108 <member name="T:HttpServer.Authentication.AuthenticationHandler"> 4269 <member name="P:HttpServer.Parser.RequestLineEventArgs.HttpVersion">
4109 <summary> 4270 <summary>
4110 Delegate used to let authentication modules authenticate the user name and password. 4271 Gets or sets the version of the HTTP protocol that the client want to use.
4111 </summary> 4272 </summary>
4112 <param name="realm">Realm that the user want to authenticate in</param>
4113 <param name="userName">User name specified by client</param>
4114 <param name="token">Can either be user password or implementation specific token.</param>
4115 <param name="login">object that will be stored in a session variable called <see cref="F:HttpServer.Authentication.AuthenticationModule.AuthenticationTag"/> if authentication was successful.</param>
4116 <exception cref="T:HttpServer.Exceptions.ForbiddenException">throw forbidden exception if too many attempts have been made.</exception>
4117 <remarks>
4118 <para>
4119 Use <see cref="P:HttpServer.Authentication.DigestAuthentication.TokenIsHA1"/> to specify that the token is a HA1 token. (MD5 generated
4120 string from realm, user name and password); Md5String(userName + ":" + realm + ":" + password);
4121 </para>
4122 </remarks>
4123 </member> 4273 </member>
4124 <member name="T:HttpServer.Authentication.AuthenticationRequiredHandler"> 4274 <member name="P:HttpServer.Parser.RequestLineEventArgs.UriPath">
4125 <summary> 4275 <summary>
4126 Let's you decide on a system level if authentication is required. 4276 Gets or sets requested URI path.
4127 </summary> 4277 </summary>
4128 <param name="request">HTTP request from client</param>
4129 <returns>true if user should be authenticated.</returns>
4130 <remarks>throw <see cref="T:HttpServer.Exceptions.ForbiddenException"/> if no more attempts are allowed.</remarks>
4131 <exception cref="T:HttpServer.Exceptions.ForbiddenException">If no more attempts are allowed</exception>
4132 </member> 4278 </member>
4133 <member name="T:HttpServer.HttpListener"> 4279 <member name="T:HttpServer.RealmHandler">
4134 <summary> 4280 <summary>
4135 New implementation of the HTTP listener. 4281 Delegate used to find a realm/domain.
4136 </summary> 4282 </summary>
4283 <param name="domain"></param>
4284 <returns></returns>
4137 <remarks> 4285 <remarks>
4138 Use the <c>Create</c> methods to create a default listener. 4286 Realms are used during HTTP Authentication
4139 </remarks> 4287 </remarks>
4288 <seealso cref="T:HttpServer.Authentication.AuthenticationModule"/>
4289 <seealso cref="T:HttpServer.Authentication.AuthenticationHandler"/>
4140 </member> 4290 </member>
4141 <member name="M:HttpServer.HttpListener.#ctor(System.Net.IPAddress,System.Int32,HttpServer.IHttpContextFactory)"> 4291 <member name="T:HttpServer.HttpServer">
4142 <summary> 4292 <summary>
4143 Initializes a new instance of the <see cref="T:HttpServer.HttpListener"/> class. 4293 A complete HTTP server, you need to add a module to it to be able to handle incoming requests.
4144 </summary> 4294 </summary>
4145 <param name="address">IP Address to accept connections on</param> 4295 <example>
4146 <param name="port">TCP Port to listen on, default HTTP port is 80.</param> 4296 <code>
4147 <param name="factory">Factory used to create <see cref="T:HttpServer.IHttpClientContext"/>es.</param> 4297 // this small example will add two web site modules, thus handling
4148 <exception cref="T:System.ArgumentNullException"><c>address</c> is null.</exception> 4298 // two different sites. In reality you should add Controller modules or something
4149 <exception cref="T:System.ArgumentException">Port must be a positive number.</exception> 4299 // two the website modules to be able to handle different requests.
4300 HttpServer server = new HttpServer();
4301 server.Add(new WebSiteModule("www.gauffin.com", "Gauffin Telecom AB"));
4302 server.Add(new WebSiteModule("www.vapadi.se", "Remote PBX"));
4303
4304 // start regular http
4305 server.Start(IPAddress.Any, 80);
4306
4307 // start https
4308 server.Start(IPAddress.Any, 443, myCertificate);
4309 </code>
4310 </example>
4311 <seealso cref="T:HttpServer.HttpModules.HttpModule"/>
4312 <seealso cref="T:HttpServer.HttpModules.FileModule"/>
4313 <seealso cref="T:HttpServer.HttpListener"/>
4150 </member> 4314 </member>
4151 <member name="M:HttpServer.HttpListener.#ctor(System.Net.IPAddress,System.Int32,HttpServer.IHttpContextFactory,System.Security.Cryptography.X509Certificates.X509Certificate)"> 4315 <member name="M:HttpServer.HttpServer.#ctor(HttpServer.IComponentProvider)">
4152 <summary> 4316 <summary>
4153 Initializes a new instance of the <see cref="T:HttpServer.HttpListener"/> class. 4317 Initializes a new instance of the <see cref="T:HttpServer.HttpServer"/> class.
4154 </summary> 4318 </summary>
4155 <param name="address">The address.</param> 4319 <param name="provider">Used to get all components used in the server..</param>
4156 <param name="port">The port.</param>
4157 <param name="factory">The factory.</param>
4158 <param name="certificate">The certificate.</param>
4159 </member> 4320 </member>
4160 <member name="M:HttpServer.HttpListener.#ctor(System.Net.IPAddress,System.Int32,HttpServer.IHttpContextFactory,System.Security.Cryptography.X509Certificates.X509Certificate,System.Security.Authentication.SslProtocols)"> 4321 <member name="M:HttpServer.HttpServer.#ctor">
4161 <summary> 4322 <summary>
4162 Initializes a new instance of the <see cref="T:HttpServer.HttpListener"/> class. 4323 Initializes a new instance of the <see cref="T:HttpServer.HttpServer"/> class.
4163 </summary> 4324 </summary>
4164 <param name="address">The address.</param>
4165 <param name="port">The port.</param>
4166 <param name="factory">The factory.</param>
4167 <param name="certificate">The certificate.</param>
4168 <param name="protocol">The protocol.</param>
4169 </member> 4325 </member>
4170 <member name="M:HttpServer.HttpListener.Create(System.Net.IPAddress,System.Int32)"> 4326 <member name="M:HttpServer.HttpServer.#ctor(HttpServer.FormDecoders.FormDecoderProvider)">
4171 <summary> 4327 <summary>
4172 Creates a new <see cref="T:HttpServer.HttpListener"/> instance with default factories. 4328 Initializes a new instance of the <see cref="T:HttpServer.HttpServer"/> class.
4173 </summary> 4329 </summary>
4174 <param name="address">Address that the listener should accept connections on.</param> 4330 <param name="decoderProvider">Form decoders are used to convert different types of posted data to the <see cref="T:HttpServer.HttpInput"/> object types.</param>
4175 <param name="port">Port that listener should accept connections on.</param> 4331 <seealso cref="T:HttpServer.FormDecoders.IFormDecoder"/>
4176 <returns>Created HTTP listener.</returns> 4332 <seealso cref="P:HttpServer.HttpServer.FormDecoderProviders"/>
4177 </member> 4333 </member>
4178 <member name="M:HttpServer.HttpListener.Create(System.Net.IPAddress,System.Int32,System.Security.Cryptography.X509Certificates.X509Certificate)"> 4334 <member name="M:HttpServer.HttpServer.#ctor(HttpServer.Sessions.IHttpSessionStore)">
4179 <summary> 4335 <summary>
4180 Creates a new <see cref="T:HttpServer.HttpListener"/> instance with default factories. 4336 Initializes a new instance of the <see cref="T:HttpServer.HttpServer"/> class.
4181 </summary> 4337 </summary>
4182 <param name="address">Address that the listener should accept connections on.</param> 4338 <param name="sessionStore">A session store is used to save and retrieve sessions</param>
4183 <param name="port">Port that listener should accept connections on.</param> 4339 <seealso cref="T:HttpServer.Sessions.IHttpSessionStore"/>
4184 <param name="certificate">Certificate to use</param>
4185 <returns>Created HTTP listener.</returns>
4186 </member> 4340 </member>
4187 <member name="M:HttpServer.HttpListener.Create(System.Net.IPAddress,System.Int32,System.Security.Cryptography.X509Certificates.X509Certificate,System.Security.Authentication.SslProtocols)"> 4341 <member name="M:HttpServer.HttpServer.#ctor(HttpServer.ILogWriter)">
4188 <summary> 4342 <summary>
4189 Creates a new <see cref="T:HttpServer.HttpListener"/> instance with default factories. 4343 Initializes a new instance of the <see cref="T:HttpServer.HttpServer"/> class.
4190 </summary> 4344 </summary>
4191 <param name="address">Address that the listener should accept connections on.</param> 4345 <param name="logWriter">The log writer.</param>
4192 <param name="port">Port that listener should accept connections on.</param> 4346 <seealso cref="P:HttpServer.HttpServer.LogWriter"/>
4193 <param name="certificate">Certificate to use</param>
4194 <param name="protocol">which HTTPS protocol to use, default is TLS.</param>
4195 <returns>Created HTTP listener.</returns>
4196 </member> 4347 </member>
4197 <member name="M:HttpServer.HttpListener.OnAcceptingSocket(System.Net.Sockets.Socket)"> 4348 <member name="M:HttpServer.HttpServer.#ctor(HttpServer.FormDecoders.FormDecoderProvider,HttpServer.ILogWriter)">
4198 <summary> 4349 <summary>
4199 Can be used to create filtering of new connections. 4350 Initializes a new instance of the <see cref="T:HttpServer.HttpServer"/> class.
4200 </summary> 4351 </summary>
4201 <param name="socket">Accepted socket</param> 4352 <param name="decoderProvider">Form decoders are used to convert different types of posted data to the <see cref="T:HttpServer.HttpInput"/> object types.</param>
4202 <returns> 4353 <param name="logWriter">The log writer.</param>
4203 true if connection can be accepted; otherwise false. 4354 <seealso cref="T:HttpServer.FormDecoders.IFormDecoder"/>
4204 </returns> 4355 <seealso cref="P:HttpServer.HttpServer.FormDecoderProviders"/>
4356 <seealso cref="P:HttpServer.HttpServer.LogWriter"/>
4205 </member> 4357 </member>
4206 <member name="E:HttpServer.HttpListener.Accepted"> 4358 <member name="M:HttpServer.HttpServer.#ctor(HttpServer.FormDecoders.FormDecoderProvider,HttpServer.Sessions.IHttpSessionStore,HttpServer.ILogWriter)">
4207 <summary> 4359 <summary>
4208 A client have been accepted, but not handled, by the listener. 4360 Initializes a new instance of the <see cref="T:HttpServer.HttpServer"/> class.
4209 </summary> 4361 </summary>
4362 <param name="decoderProvider">Form decoders are used to convert different types of posted data to the <see cref="T:HttpServer.HttpInput"/> object types.</param>
4363 <param name="sessionStore">A session store is used to save and retrieve sessions</param>
4364 <param name="logWriter">The log writer.</param>
4365 <seealso cref="T:HttpServer.FormDecoders.IFormDecoder"/>
4366 <seealso cref="P:HttpServer.HttpServer.FormDecoderProviders"/>
4367 <seealso cref="P:HttpServer.HttpServer.LogWriter"/>
4368 <seealso cref="T:HttpServer.Sessions.IHttpSessionStore"/>
4210 </member> 4369 </member>
4211 <member name="T:HttpServer.Helpers.WebHelper"> 4370 <member name="M:HttpServer.HttpServer.Add(HttpServer.Rules.IRule)">
4212 <summary> 4371 <summary>
4213 Webhelper provides helpers for common tasks in HTML. 4372 Adds the specified rule.
4214 </summary> 4373 </summary>
4374 <param name="rule">The rule.</param>
4215 </member> 4375 </member>
4216 <member name="F:HttpServer.Helpers.WebHelper.JSImplementation"> 4376 <member name="M:HttpServer.HttpServer.Add(HttpServer.HttpModules.HttpModule)">
4217 <summary> 4377 <summary>
4218 Used to let the website use different javascript libraries. 4378 Add a <see cref="T:HttpServer.HttpModules.HttpModule"/> to the server.
4219 Default is <see cref="T:HttpServer.Helpers.Implementations.PrototypeImp"/>
4220 </summary> 4379 </summary>
4380 <param name="module">mode to add</param>
4221 </member> 4381 </member>
4222 <member name="M:HttpServer.Helpers.WebHelper.AjaxRequest(System.String,System.String,System.String[])"> 4382 <member name="M:HttpServer.HttpServer.DecodeBody(HttpServer.IHttpRequest)">
4223 <summary> 4383 <summary>
4224 Creates a link that invokes through ajax. 4384 Decodes the request body.
4225 </summary> 4385 </summary>
4226 <param name="url">url to fetch</param> 4386 <param name="request">The request.</param>
4227 <param name="title">link title</param> 4387 <exception cref="T:HttpServer.Exceptions.InternalServerException">Failed to decode form data.</exception>
4228 <param name="options">
4229 optional options in format "key, value, key, value".
4230 Javascript options starts with ':'.
4231 </param>
4232 <returns>a link tag</returns>
4233 <example>
4234 WebHelper.AjaxRequest("/users/add/", "Add user", "method:", "post", "onclick", "validate('this');");
4235 </example>
4236 </member> 4388 </member>
4237 <member name="M:HttpServer.Helpers.WebHelper.AjaxUpdater(System.String,System.String,System.String,System.String[])"> 4389 <member name="M:HttpServer.HttpServer.ErrorPage(HttpServer.IHttpResponse,System.Net.HttpStatusCode,System.String)">
4238 <summary> 4390 <summary>
4239 Builds a link that updates an element with the fetched ajax content. 4391 Generate a HTTP error page (that will be added to the response body).
4392 response status code is also set.
4240 </summary> 4393 </summary>
4241 <param name="url">Url to fetch content from</param> 4394 <param name="response">Response that the page will be generated in.</param>
4242 <param name="title">link title</param> 4395 <param name="error"><see cref="T:System.Net.HttpStatusCode"/>.</param>
4243 <param name="targetId">html element to update with the results of the ajax request.</param> 4396 <param name="body">response body contents.</param>
4244 <param name="options">optional options in format "key, value, key, value"</param>
4245 <returns>A link tag.</returns>
4246 </member> 4397 </member>
4247 <member name="M:HttpServer.Helpers.WebHelper.DialogLink(System.String,System.String,System.String[])"> 4398 <member name="M:HttpServer.HttpServer.ErrorPage(HttpServer.IHttpResponse,HttpServer.Exceptions.HttpException)">
4248 <summary> 4399 <summary>
4249 A link that pop ups a Dialog (overlay div) 4400 Generate a HTTP error page (that will be added to the response body).
4401 response status code is also set.
4250 </summary> 4402 </summary>
4251 <param name="url">url to contents of dialog</param> 4403 <param name="response">Response that the page will be generated in.</param>
4252 <param name="title">link title</param> 4404 <param name="err">exception.</param>
4253 <param name="htmlAttributes">name/value of html attributes.</param>
4254 <returns>A "a"-tag that popups a dialog when clicked</returns>
4255 <example>
4256 WebHelper.DialogLink("/user/show/1", "show user", "onmouseover", "alert('booh!');");
4257 </example>
4258 </member> 4405 </member>
4259 <member name="M:HttpServer.Helpers.WebHelper.CreateDialog(System.String,System.String,System.String[])"> 4406 <member name="M:HttpServer.HttpServer.GetRealm(HttpServer.IHttpRequest)">
4260 <summary> 4407 <summary>
4261 Create/Open a dialog box using ajax 4408 Realms are used by the <see cref="T:HttpServer.Authentication.AuthenticationModule"/>s.
4262 </summary> 4409 </summary>
4263 <param name="url"></param> 4410 <param name="request">HTTP request</param>
4264 <param name="title"></param> 4411 <returns>domain/realm.</returns>
4265 <param name="parameters"></param>
4266 <returns></returns>
4267 </member> 4412 </member>
4268 <member name="M:HttpServer.Helpers.WebHelper.CloseDialog"> 4413 <member name="M:HttpServer.HttpServer.HandleRequest(HttpServer.IHttpClientContext,HttpServer.IHttpRequest,HttpServer.IHttpResponse,HttpServer.Sessions.IHttpSession)">
4269 <summary> 4414 <summary>
4270 Close a javascript dialog window/div. 4415 Process an incoming request.
4271 </summary> 4416 </summary>
4272 <returns>javascript for closing a dialog.</returns> 4417 <param name="context">connection to client</param>
4273 <see cref="M:HttpServer.Helpers.WebHelper.DialogLink(System.String,System.String,System.String[])"/> 4418 <param name="request">request information</param>
4419 <param name="response">response that should be filled</param>
4420 <param name="session">session information</param>
4274 </member> 4421 </member>
4275 <member name="M:HttpServer.Helpers.WebHelper.FormStart(System.String,System.String,System.Boolean)"> 4422 <member name="M:HttpServer.HttpServer.OnClientDisconnected(HttpServer.IHttpClientContext,System.Net.Sockets.SocketError)">
4276 <summary> 4423 <summary>
4277 Create a &lt;form&gt; tag. 4424 Can be overloaded to implement stuff when a client have been connected.
4278 </summary> 4425 </summary>
4279 <param name="name">name of form</param> 4426 <remarks>
4280 <param name="action">action to invoke on submit</param> 4427 Default implementation does nothing.
4281 <param name="isAjax">form should be posted as ajax</param> 4428 </remarks>
4282 <returns>html code</returns> 4429 <param name="client">client that disconnected</param>
4283 <example> 4430 <param name="error">disconnect reason</param>
4284 WebHelper.FormStart("frmLogin", "/user/login", Request.IsAjax);
4285 </example>
4286 </member> 4431 </member>
4287 <member name="M:HttpServer.Helpers.WebHelper.Link(System.String,System.String,System.String[])"> 4432 <member name="M:HttpServer.HttpServer.ProcessAuthentication(HttpServer.IHttpRequest,HttpServer.IHttpResponse,HttpServer.Sessions.IHttpSession)">
4288 <summary> 4433 <summary>
4289 Create a link tag. 4434 Handle authentication
4290 </summary> 4435 </summary>
4291 <param name="url">url to go to</param> 4436 <param name="request"></param>
4292 <param name="title">link title (text that is displayed)</param> 4437 <param name="response"></param>
4293 <param name="htmlAttributes">html attributes, name, value, name, value</param> 4438 <param name="session"></param>
4294 <returns>html code</returns> 4439 <returns>true if request can be handled; false if not.</returns>
4295 <example> 4440 <exception cref="T:HttpServer.Exceptions.BadRequestException">Invalid authorization header</exception>
4296 WebHelper.Link("/user/show/1", "Show user", "id", "showUser", "onclick", "return confirm('Are you shure?');");
4297 </example>
4298 </member> 4441 </member>
4299 <member name="M:HttpServer.Helpers.WebHelper.BuildLink(System.String,System.String,System.String[])"> 4442 <member name="M:HttpServer.HttpServer.RequestAuthentication(HttpServer.Authentication.AuthenticationModule,HttpServer.IHttpRequest,HttpServer.IHttpResponse)">
4300 <summary> 4443 <summary>
4301 Build a link 4444 Will request authentication.
4302 </summary> 4445 </summary>
4303 <param name="url">url to go to.</param> 4446 <remarks>
4304 <param name="title">title of link (displayed text)</param> 4447 Sends respond to client, nothing else can be done with the response after this.
4305 <param name="htmlAttributes">extra html attributes.</param> 4448 </remarks>
4306 <returns>a complete link</returns> 4449 <param name="mod"></param>
4450 <param name="request"></param>
4451 <param name="response"></param>
4307 </member> 4452 </member>
4308 <member name="M:HttpServer.Helpers.WebHelper.BuildLink(System.String,System.String,System.String[],System.String[])"> 4453 <member name="M:HttpServer.HttpServer.OnRequest(System.Object,HttpServer.RequestEventArgs)">
4309 <summary> 4454 <summary>
4310 Build a link 4455 Received from a <see cref="T:HttpServer.IHttpClientContext"/> when a request have been parsed successfully.
4311 </summary> 4456 </summary>
4312 <param name="url">url to go to.</param> 4457 <param name="source"><see cref="T:HttpServer.IHttpClientContext"/> that received the request.</param>
4313 <param name="title">title of link (displayed text)</param> 4458 <param name="args">The request.</param>
4314 <param name="htmlAttributes">extra html attributes.</param>
4315 <returns>a complete link</returns>
4316 <param name="options">more options</param>
4317 </member> 4459 </member>
4318 <member name="M:HttpServer.Helpers.WebHelper.Select(System.String,System.Collections.ICollection,HttpServer.Helpers.GetIdTitle,System.Object,System.Boolean)"> 4460 <member name="M:HttpServer.HttpServer.ProcessRequestWrapper(HttpServer.IHttpClientContext,HttpServer.IHttpRequest)">
4319 <summary> 4461 <summary>
4320 Obsolete 4462 To be able to track request count.
4321 </summary> 4463 </summary>
4322 <param name="name">Obsolete</param> 4464 <param name="context"></param>
4323 <param name="collection">Obsolete</param> 4465 <param name="request"></param>
4324 <param name="getIdTitle">Obsolete</param>
4325 <param name="selectedValue">Obsolete</param>
4326 <param name="firstEmpty">Obsolete</param>
4327 <returns>Obsolete</returns>
4328 </member> 4466 </member>
4329 <member name="M:HttpServer.Helpers.WebHelper.Select(System.String,System.String,System.Collections.ICollection,HttpServer.Helpers.GetIdTitle,System.Object,System.Boolean)"> 4467 <member name="M:HttpServer.HttpServer.Start(System.Net.IPAddress,System.Int32)">
4330 <summary> 4468 <summary>
4331 Obsolete 4469 Start the web server using regular HTTP.
4332 </summary> 4470 </summary>
4333 <param name="name">Obsolete</param> 4471 <param name="address">IP Address to listen on, use <c>IpAddress.Any </c>to accept connections on all IP addresses/network cards.</param>
4334 <param name="id">Obsolete</param> 4472 <param name="port">Port to listen on. 80 can be a good idea =)</param>
4335 <param name="collection">Obsolete</param> 4473 <exception cref="T:System.ArgumentNullException"><c>address</c> is null.</exception>
4336 <param name="getIdTitle">Obsolete</param> 4474 <exception cref="T:System.ArgumentException">Port must be a positive number.</exception>
4337 <param name="selectedValue">Obsolete</param>
4338 <param name="firstEmpty">Obsolete</param>
4339 <returns>Obsolete</returns>
4340 </member> 4475 </member>
4341 <member name="M:HttpServer.Helpers.WebHelper.List(System.Collections.Generic.IEnumerable{System.Object},System.String)"> 4476 <member name="M:HttpServer.HttpServer.Start(System.Net.IPAddress,System.Int32,System.Security.Cryptography.X509Certificates.X509Certificate)">
4342 <summary> 4477 <summary>
4343 Render errors into a UL with class "errors" 4478 Accept secure connections.
4344 </summary> 4479 </summary>
4345 <param name="className">class used by UL-tag.</param> 4480 <param name="address">IP Address to listen on, use <see cref="F:System.Net.IPAddress.Any"/> to accept connections on all IP Addresses / network cards.</param>
4346 <param name="theList">items to list</param> 4481 <param name="port">Port to listen on. 80 can be a good idea =)</param>
4347 <returns>an unordered html list.</returns> 4482 <param name="certificate">Certificate to use</param>
4483 <exception cref="T:System.ArgumentNullException"><c>address</c> is null.</exception>
4484 <exception cref="T:System.ArgumentException">Port must be a positive number.</exception>
4348 </member> 4485 </member>
4349 <member name="M:HttpServer.Helpers.WebHelper.List(System.Collections.Specialized.NameValueCollection,System.String)"> 4486 <member name="M:HttpServer.HttpServer.Stop">
4350 <summary> 4487 <summary>
4351 Render errors into a UL with class "errors" 4488 shut down the server and listeners
4352 </summary> 4489 </summary>
4353 <param name="className">class used by UL-tag.</param>
4354 <param name="theList">items to list</param>
4355 <returns>an unordered html list.</returns>
4356 </member> 4490 </member>
4357 <member name="M:HttpServer.Helpers.WebHelper.Errors(System.Collections.Specialized.NameValueCollection)"> 4491 <member name="M:HttpServer.HttpServer.WriteLog(HttpServer.LogPrio,System.String)">
4358 <summary> 4492 <summary>
4359 Render errors into a UL with class "errors" 4493 write an entry to the log file
4360 </summary> 4494 </summary>
4361 <param name="errors"></param> 4495 <param name="prio">importance of the message</param>
4362 <returns></returns> 4496 <param name="message">log message</param>
4363 </member> 4497 </member>
4364 <member name="M:HttpServer.Helpers.WebHelper.GenerateHtmlAttributes(System.Text.StringBuilder,System.String[],System.String[])"> 4498 <member name="M:HttpServer.HttpServer.WriteLog(System.Object,HttpServer.LogPrio,System.String)">
4365 <summary> 4499 <summary>
4366 Generates a list with html attributes. 4500 write an entry to the log file
4367 </summary> 4501 </summary>
4368 <param name="sb">StringBuilder that the options should be added to.</param> 4502 <param name="source">object that wrote the message</param>
4369 <param name="firstOptions">attributes set by user.</param> 4503 <param name="prio">importance of the message</param>
4370 <param name="secondOptions">attributes set by any of the helper classes.</param> 4504 <param name="message">log message</param>
4371 </member> 4505 </member>
4372 <member name="M:HttpServer.Helpers.WebHelper.GenerateHtmlAttributes(System.Text.StringBuilder,System.String[])"> 4506 <member name="P:HttpServer.HttpServer.Current">
4373 <summary> 4507 <summary>
4374 Generates a list with html attributes. 4508 Server that is handling the current request.
4375 </summary> 4509 </summary>
4376 <param name="sb">StringBuilder that the options should be added to.</param> 4510 <remarks>
4377 <param name="options"></param> 4511 Will be set as soon as a request arrives to the <see cref="T:HttpServer.HttpServer"/> object.
4512 </remarks>
4378 </member> 4513 </member>
4379 <member name="T:HttpServer.ResponseCookie"> 4514 <member name="P:HttpServer.HttpServer.AuthenticationModules">
4380 <summary> 4515 <summary>
4381 cookie being sent back to the browser. 4516 Modules used for authentication. The module that is is added first is used as
4517 the default authentication module.
4382 </summary> 4518 </summary>
4383 <seealso cref="T:HttpServer.ResponseCookie"/> 4519 <remarks>Use the corresponding property
4520 in the <see cref="T:HttpServer.HttpModules.WebSiteModule"/> if you are using multiple websites.</remarks>
4384 </member> 4521 </member>
4385 <member name="M:HttpServer.ResponseCookie.#ctor(System.String,System.String,System.DateTime)"> 4522 <member name="P:HttpServer.HttpServer.FormDecoderProviders">
4386 <summary> 4523 <summary>
4387 Constructor. 4524 Form decoder providers are used to decode request body (which normally contains form data).
4388 </summary> 4525 </summary>
4389 <param name="id">cookie identifier</param>
4390 <param name="content">cookie content</param>
4391 <param name="expiresAt">cookie expiration date. Use DateTime.MinValue for session cookie.</param>
4392 <exception cref="T:System.ArgumentNullException">id or content is null</exception>
4393 <exception cref="T:System.ArgumentException">id is empty</exception>
4394 </member> 4526 </member>
4395 <member name="M:HttpServer.ResponseCookie.#ctor(System.String,System.String,System.DateTime,System.String,System.String)"> 4527 <member name="P:HttpServer.HttpServer.ServerName">
4396 <summary> 4528 <summary>
4397 Create a new cookie 4529 Server name sent in HTTP responses.
4398 </summary> 4530 </summary>
4399 <param name="name">name identifying the cookie</param> 4531 <remarks>
4400 <param name="value">cookie value</param> 4532 Do NOT include version in name, since it makes it
4401 <param name="expires">when the cookie expires. Setting DateTime.MinValue will delete the cookie when the session is closed.</param> 4533 easier for hackers.
4402 <param name="path">Path to where the cookie is valid</param> 4534 </remarks>
4403 <param name="domain">Domain that the cookie is valid for.</param>
4404 </member> 4535 </member>
4405 <member name="M:HttpServer.ResponseCookie.#ctor(HttpServer.RequestCookie,System.DateTime)"> 4536 <member name="P:HttpServer.HttpServer.SessionCookieName">
4406 <summary> 4537 <summary>
4407 Create a new cookie 4538 Name of cookie where session id is stored.
4408 </summary> 4539 </summary>
4409 <param name="cookie">Name and value will be used</param>
4410 <param name="expires">when the cookie expires.</param>
4411 </member> 4540 </member>
4412 <member name="M:HttpServer.ResponseCookie.ToString"> 4541 <member name="P:HttpServer.HttpServer.LogWriter">
4413 <summary> 4542 <summary>
4414 Gets the cookie HTML representation. 4543 Specified where logging should go.
4415 </summary> 4544 </summary>
4416 <returns>cookie string</returns> 4545 <seealso cref="T:HttpServer.NullLogWriter"/>
4546 <seealso cref="T:HttpServer.ConsoleLogWriter"/>
4547 <seealso cref="P:HttpServer.HttpServer.LogWriter"/>
4417 </member> 4548 </member>
4418 <member name="P:HttpServer.ResponseCookie.Expires"> 4549 <member name="P:HttpServer.HttpServer.BackLog">
4419 <summary> 4550 <summary>
4420 When the cookie expires. 4551 Number of connections that can wait to be accepted by the server.
4421 DateTime.MinValue means that the cookie expires when the session do so.
4422 </summary> 4552 </summary>
4553 <remarks>Default is 10.</remarks>
4423 </member> 4554 </member>
4424 <member name="P:HttpServer.ResponseCookie.Path"> 4555 <member name="P:HttpServer.HttpServer.MaxRequestCount">
4425 <summary> 4556 <summary>
4426 Cookie is only valid under this path. 4557 Gets or sets maximum number of allowed simultaneous requests.
4427 </summary> 4558 </summary>
4559 <remarks>
4560 <para>
4561 This property is useful in busy systems. The HTTP server
4562 will start queuing new requests if this limit is hit, instead
4563 of trying to process all incoming requests directly.
4564 </para>
4565 <para>
4566 The default number if allowed simultaneous requests are 10.
4567 </para>
4568 </remarks>
4428 </member> 4569 </member>
4429 <member name="T:HttpServer.IHttpRequest"> 4570 <member name="P:HttpServer.HttpServer.MaxQueueSize">
4430 <summary> 4571 <summary>
4431 Contains server side HTTP request information. 4572 Gets or sets maximum number of requests queuing to be handled.
4432 </summary> 4573 </summary>
4574 <remarks>
4575 <para>
4576 The WebServer will start turning requests away if response code
4577 <see cref="F:System.Net.HttpStatusCode.ServiceUnavailable"/> to indicate that the server
4578 is too busy to be able to handle the request.
4579 </para>
4580 </remarks>
4433 </member> 4581 </member>
4434 <member name="M:HttpServer.IHttpRequest.AddHeader(System.String,System.String)"> 4582 <member name="E:HttpServer.HttpServer.RealmWanted">
4435 <summary> 4583 <summary>
4436 Called during parsing of a <see cref="T:HttpServer.IHttpRequest"/>. 4584 Realms are used during HTTP authentication.
4585 Default realm is same as server name.
4437 </summary> 4586 </summary>
4438 <param name="name">Name of the header, should not be URL encoded</param>
4439 <param name="value">Value of the header, should not be URL encoded</param>
4440 <exception cref="T:HttpServer.Exceptions.BadRequestException">If a header is incorrect.</exception>
4441 </member> 4587 </member>
4442 <member name="M:HttpServer.IHttpRequest.AddToBody(System.Byte[],System.Int32,System.Int32)"> 4588 <member name="E:HttpServer.HttpServer.ExceptionThrown">
4443 <summary> 4589 <summary>
4444 Add bytes to the body 4590 Let's to receive unhandled exceptions from the threads.
4445 </summary> 4591 </summary>
4446 <param name="bytes">buffer to read bytes from</param> 4592 <remarks>
4447 <param name="offset">where to start read</param> 4593 Exceptions will be thrown during debug mode if this event is not used,
4448 <param name="length">number of bytes to read</param> 4594 exceptions will be printed to console and suppressed during release mode.
4449 <returns>Number of bytes actually read (same as length unless we got all body bytes).</returns> 4595 </remarks>
4450 <exception cref="T:System.InvalidOperationException">If body is not writable</exception>
4451 <exception cref="T:System.ArgumentNullException"><c>bytes</c> is null.</exception>
4452 <exception cref="T:System.ArgumentOutOfRangeException"><c>offset</c> is out of range.</exception>
4453 </member> 4596 </member>
4454 <member name="M:HttpServer.IHttpRequest.Clear"> 4597 <member name="T:HttpServer.HttpModules.ResourceFileModule">
4455 <summary> 4598 <summary>
4456 Clear everything in the request 4599 Serves files that are stored in embedded resources.
4457 </summary> 4600 </summary>
4458 </member> 4601 </member>
4459 <member name="M:HttpServer.IHttpRequest.DecodeBody(HttpServer.FormDecoders.FormDecoderProvider)"> 4602 <member name="M:HttpServer.HttpModules.ResourceFileModule.#ctor">
4460 <summary> 4603 <summary>
4461 Decode body into a form. 4604 Initializes a new instance of the <see cref="T:HttpServer.HttpModules.ResourceFileModule"/> class.
4605 Runs <see cref="M:HttpServer.HttpModules.ResourceFileModule.AddDefaultMimeTypes"/> to make sure the basic mime types are available, they can be cleared later
4606 through the use of <see cref="P:HttpServer.HttpModules.ResourceFileModule.MimeTypes"/> if desired.
4462 </summary> 4607 </summary>
4463 <param name="providers">A list with form decoders.</param>
4464 <exception cref="T:System.IO.InvalidDataException">If body contents is not valid for the chosen decoder.</exception>
4465 <exception cref="T:System.InvalidOperationException">If body is still being transferred.</exception>
4466 </member> 4608 </member>
4467 <member name="M:HttpServer.IHttpRequest.SetCookies(HttpServer.RequestCookies)"> 4609 <member name="M:HttpServer.HttpModules.ResourceFileModule.#ctor(HttpServer.ILogWriter)">
4468 <summary> 4610 <summary>
4469 Sets the cookies. 4611 Initializes a new instance of the <see cref="T:HttpServer.HttpModules.ResourceFileModule"/> class.
4612 Runs <see cref="M:HttpServer.HttpModules.ResourceFileModule.AddDefaultMimeTypes"/> to make sure the basic mime types are available, they can be cleared later
4613 through the use of <see cref="P:HttpServer.HttpModules.ResourceFileModule.MimeTypes"/> if desired.
4470 </summary> 4614 </summary>
4471 <param name="cookies">The cookies.</param> 4615 <param name="logWriter">The log writer to use when logging events</param>
4472 </member> 4616 </member>
4473 <member name="M:HttpServer.IHttpRequest.CreateResponse(HttpServer.IHttpClientContext)"> 4617 <member name="M:HttpServer.HttpModules.ResourceFileModule.AddDefaultMimeTypes">
4474 <summary> 4618 <summary>
4475 Create a response object. 4619 Mimtypes that this class can handle per default
4476 </summary> 4620 </summary>
4477 <param name="context">Context for the connected client.</param>
4478 <returns>A new <see cref="T:HttpServer.IHttpResponse"/>.</returns>
4479 </member> 4621 </member>
4480 <member name="P:HttpServer.IHttpRequest.AcceptTypes"> 4622 <member name="M:HttpServer.HttpModules.ResourceFileModule.AddResources(System.String,System.Reflection.Assembly,System.String)">
4481 <summary> 4623 <summary>
4482 Gets kind of types accepted by the client. 4624 Loads resources from a namespace in the given assembly to an uri
4483 </summary> 4625 </summary>
4626 <param name="toUri">The uri to map the resources to</param>
4627 <param name="fromAssembly">The assembly in which the resources reside</param>
4628 <param name="fromNamespace">The namespace from which to load the resources</param>
4629 <usage>
4630 resourceLoader.LoadResources("/user/", typeof(User).Assembly, "MyLib.Models.User.Views");
4631
4632 will make ie the resource MyLib.Models.User.Views.stylesheet.css accessible via /user/stylesheet.css
4633 </usage>
4634 <returns>The amount of loaded files, giving you the possibility of making sure the resources needed gets loaded</returns>
4484 </member> 4635 </member>
4485 <member name="P:HttpServer.IHttpRequest.Body"> 4636 <member name="M:HttpServer.HttpModules.ResourceFileModule.CanHandle(HttpServer.IHttpRequest)">
4486 <summary> 4637 <summary>
4487 Gets or sets body stream. 4638 Returns true if the module can handle the request
4488 </summary> 4639 </summary>
4489 </member> 4640 </member>
4490 <member name="P:HttpServer.IHttpRequest.BodyIsComplete"> 4641 <member name="M:HttpServer.HttpModules.ResourceFileModule.Process(HttpServer.IHttpRequest,HttpServer.IHttpResponse,HttpServer.Sessions.IHttpSession)">
4491 <summary> 4642 <summary>
4492 Gets whether the body is complete. 4643 Method that process the url
4493 </summary> 4644 </summary>
4645 <param name="request">Information sent by the browser about the request</param>
4646 <param name="response">Information that is being sent back to the client.</param>
4647 <param name="session">Session used to </param>
4648 <returns>true if this module handled the request.</returns>
4494 </member> 4649 </member>
4495 <member name="P:HttpServer.IHttpRequest.Connection"> 4650 <member name="P:HttpServer.HttpModules.ResourceFileModule.MimeTypes">
4496 <summary> 4651 <summary>
4497 Gets or sets kind of connection used for the session. 4652 List with all mime-type that are allowed.
4498 </summary> 4653 </summary>
4654 <remarks>All other mime types will result in a Forbidden http status code.</remarks>
4499 </member> 4655 </member>
4500 <member name="P:HttpServer.IHttpRequest.ContentLength"> 4656 <member name="T:HttpServer.Helpers.ResourceInfo">
4501 <summary> 4657 <summary>
4502 Gets or sets number of bytes in the body. 4658 Container to bind resource names to assemblies
4503 </summary> 4659 </summary>
4504 </member> 4660 </member>
4505 <member name="P:HttpServer.IHttpRequest.Cookies"> 4661 <member name="M:HttpServer.Helpers.ResourceInfo.#ctor(System.String,System.String,System.Reflection.Assembly)">
4506 <summary> 4662 <summary>
4507 Gets cookies that was sent with the request. 4663 Instantiates an instance of <see cref="T:HttpServer.Helpers.ResourceInfo"/>
4508 </summary> 4664 </summary>
4665 <param name="uri">The dot seperated uri the resource maps to</param>
4666 <param name="resourceName">The full resource name</param>
4667 <param name="assembly">The assembly the resource exists in</param>
4509 </member> 4668 </member>
4510 <member name="P:HttpServer.IHttpRequest.Form"> 4669 <member name="M:HttpServer.Helpers.ResourceInfo.GetStream">
4511 <summary> 4670 <summary>
4512 Gets form parameters. 4671 Retrieves a stream to the resource
4513 </summary> 4672 </summary>
4673 <returns>Null if the resource couldn't be located somehow</returns>
4514 </member> 4674 </member>
4515 <member name="P:HttpServer.IHttpRequest.Headers"> 4675 <member name="P:HttpServer.Helpers.ResourceInfo.Assembly">
4516 <summary> 4676 <summary>
4517 Gets headers sent by the client. 4677 Retrieves the assembly the resource resides in
4518 </summary> 4678 </summary>
4519 </member> 4679 </member>
4520 <member name="P:HttpServer.IHttpRequest.HttpVersion"> 4680 <member name="P:HttpServer.Helpers.ResourceInfo.Uri">
4521 <summary> 4681 <summary>
4522 Gets or sets version of HTTP protocol that's used. 4682 Retrieves the full name/path of the assembly
4523 </summary> 4683 </summary>
4524 <remarks>
4525 Probably <see cref="F:HttpServer.HttpHelper.HTTP10"/> or <see cref="F:HttpServer.HttpHelper.HTTP11"/>.
4526 </remarks>
4527 <seealso cref="T:HttpServer.HttpHelper"/>
4528 </member> 4684 </member>
4529 <member name="P:HttpServer.IHttpRequest.IsAjax"> 4685 <member name="P:HttpServer.Helpers.ResourceInfo.Extension">
4530 <summary> 4686 <summary>
4531 Gets whether the request was made by Ajax (Asynchronous JavaScript) 4687 Retrieves the extension of the resource
4532 </summary> 4688 </summary>
4533 </member> 4689 </member>
4534 <member name="P:HttpServer.IHttpRequest.Method"> 4690 <member name="P:HttpServer.Helpers.ResourceInfo.ExtensionLessUri">
4535 <summary> 4691 <summary>Returns the Uri without extension</summary>
4536 Gets or sets requested method.
4537 </summary>
4538 <remarks>
4539 Will always be in upper case.
4540 </remarks>
4541 <see cref="P:HttpServer.IHttpRequest.Method"/>
4542 </member> 4692 </member>
4543 <member name="P:HttpServer.IHttpRequest.Param"> 4693 <member name="P:HttpServer.Helpers.ResourceInfo.ResourceName">
4544 <summary> 4694 <summary>Retrieves the full path name to the resource file</summary>
4545 Gets parameter from <see cref="P:HttpServer.IHttpRequest.QueryString"/> or <see cref="P:HttpServer.IHttpRequest.Form"/>.
4546 </summary>
4547 </member> 4695 </member>
4548 <member name="P:HttpServer.IHttpRequest.QueryString"> 4696 <member name="T:HttpServer.Helpers.FormHelper">
4549 <summary> 4697 <summary>
4550 Gets variables sent in the query string 4698 Helpers making it easier to work with forms.
4551 </summary> 4699 </summary>
4700 <seealso cref="T:HttpServer.Helpers.ObjectForm"/>
4552 </member> 4701 </member>
4553 <member name="P:HttpServer.IHttpRequest.Uri"> 4702 <member name="F:HttpServer.Helpers.FormHelper.JSImplementation">
4554 <summary> 4703 <summary>
4555 Gets or sets requested URI. 4704 Used to let the website use different JavaScript libraries.
4705 Default is <see cref="T:HttpServer.Helpers.Implementations.PrototypeImp"/>
4556 </summary> 4706 </summary>
4557 </member> 4707 </member>
4558 <member name="P:HttpServer.IHttpRequest.UriParts"> 4708 <member name="M:HttpServer.Helpers.FormHelper.Start(System.String,System.String,System.Boolean,System.String[])">
4559 <summary> 4709 <summary>
4560 Gets URI absolute path divided into parts. 4710 Create a &lt;form&gt; tag.
4561 </summary> 4711 </summary>
4712 <param name="id">name of form</param>
4713 <param name="action">action to invoke on submit</param>
4714 <param name="isAjax">form should be posted as Ajax</param>
4715 <returns>HTML code</returns>
4562 <example> 4716 <example>
4563 // URI is: http://gauffin.com/code/tiny/ 4717 <code>
4564 Console.WriteLine(request.UriParts[0]); // result: code 4718 // without options
4565 Console.WriteLine(request.UriParts[1]); // result: tiny 4719 WebHelper.FormStart("frmLogin", "/user/login", Request.IsAjax);
4720
4721 // with options
4722 WebHelper.FormStart("frmLogin", "/user/login", Request.IsAjax, "style", "display:inline", "class", "greenForm");
4723 </code>
4566 </example> 4724 </example>
4567 <remarks> 4725 <param name="options">HTML attributes or JavaScript options.</param>
4568 If you're using controllers than the first part is controller name, 4726 <remarks>Method will ALWAYS be POST.</remarks>
4569 the second part is method name and the third part is Id property. 4727 <exception cref="T:System.ArgumentException">options must consist of name, value, name, value</exception>
4570 </remarks>
4571 <seealso cref="P:HttpServer.IHttpRequest.Uri"/>
4572 </member> 4728 </member>
4573 <member name="P:HttpServer.IHttpRequest.UriPath"> 4729 <member name="M:HttpServer.Helpers.FormHelper.Select(System.String,System.Collections.IEnumerable,HttpServer.Helpers.GetIdTitle,System.Object,System.Boolean)">
4574 <summary> 4730 <summary>
4575 Gets or sets path and query. 4731 Creates a select list with the values in a collection.
4576 </summary> 4732 </summary>
4577 <see cref="P:HttpServer.IHttpRequest.Uri"/> 4733 <param name="name">Name of the SELECT-tag</param>
4578 <remarks> 4734 <param name="collection">collection used to generate options.</param>
4579 Are only used during request parsing. Cannot be set after "Host" header have been 4735 <param name="getIdTitle">delegate used to return id and title from objects.</param>
4580 added. 4736 <param name="selectedValue">value that should be marked as selected.</param>
4581 </remarks> 4737 <param name="firstEmpty">First row should contain an empty value.</param>
4738 <returns>string containing a SELECT-tag.</returns>
4739 <seealso cref="T:HttpServer.Helpers.GetIdTitle"/>
4582 </member> 4740 </member>
4583 <member name="T:HttpServer.Helpers.GetIdTitle"> 4741 <member name="M:HttpServer.Helpers.FormHelper.Select(System.String,System.String,System.Collections.IEnumerable,HttpServer.Helpers.GetIdTitle,System.Object,System.Boolean)">
4584 <summary> 4742 <summary>
4585 Delegate used by <see cref="M:HttpServer.Helpers.FormHelper.Select(System.String,System.Collections.IEnumerable,HttpServer.Helpers.GetIdTitle,System.Object,System.Boolean)"/> to populate select options. 4743 Creates a select list with the values in a collection.
4586 </summary> 4744 </summary>
4587 <param name="obj">current object (for instance a User).</param> 4745 <param name="name">Name of the SELECT-tag</param>
4588 <param name="id">Text that should be displayed in the value part of a &lt;optiongt;-tag.</param> 4746 <param name="id">Id of the SELECT-tag</param>
4589 <param name="title">Text shown in the select list.</param> 4747 <param name="collection">collection used to generate options.</param>
4748 <param name="getIdTitle">delegate used to return id and title from objects.</param>
4749 <param name="selectedValue">value that should be marked as selected.</param>
4750 <param name="firstEmpty">First row should contain an empty value.</param>
4751 <returns>string containing a SELECT-tag.</returns>
4752 <seealso cref="T:HttpServer.Helpers.GetIdTitle"/>
4590 <example> 4753 <example>
4754 <code>
4591 // Class that is going to be used in a SELECT-tag. 4755 // Class that is going to be used in a SELECT-tag.
4592 public class User 4756 public class User
4593 { 4757 {
@@ -4640,817 +4804,653 @@
4640 User user = (User)o; 4804 User user = (User)o;
4641 id = user.Id; 4805 id = user.Id;
4642 value = user.RealName; 4806 value = user.RealName;
4643 } /// </example> 4807 }
4644 </member> 4808 </code>
4645 <member name="T:HttpServer.Exceptions.UnauthorizedException"> 4809 </example>
4646 <summary> 4810 <exception cref="T:System.ArgumentNullException"><c>name</c>, <c>id</c>, <c>collection</c> or <c>getIdTitle</c> is null.</exception>
4647 The request requires user authentication. The response MUST include a
4648 WWW-Authenticate header field (section 14.47) containing a challenge
4649 applicable to the requested resource.
4650
4651 The client MAY repeat the request with a suitable Authorization header
4652 field (section 14.8). If the request already included Authorization
4653 credentials, then the 401 response indicates that authorization has been
4654 refused for those credentials. If the 401 response contains the same challenge
4655 as the prior response, and the user agent has already attempted authentication
4656 at least once, then the user SHOULD be presented the entity that was given in the response,
4657 since that entity might include relevant diagnostic information.
4658
4659 HTTP access authentication is explained in rfc2617:
4660 http://www.ietf.org/rfc/rfc2617.txt
4661
4662 (description is taken from
4663 http://www.submissionchamber.com/help-guides/error-codes.php#sec10.4.2)
4664 </summary>
4665 </member>
4666 <member name="M:HttpServer.Exceptions.UnauthorizedException.#ctor">
4667 <summary>
4668 Create a new unauhtorized exception.
4669 </summary>
4670 <seealso cref="T:HttpServer.Exceptions.UnauthorizedException"/>
4671 </member>
4672 <member name="M:HttpServer.Exceptions.UnauthorizedException.#ctor(System.String,System.Exception)">
4673 <summary>
4674 Create a new unauhtorized exception.
4675 </summary>
4676 <param name="message">reason to why the request was unauthorized.</param>
4677 <param name="inner">inner exception</param>
4678 </member>
4679 <member name="M:HttpServer.Exceptions.UnauthorizedException.#ctor(System.String)">
4680 <summary>
4681 Create a new unauhtorized exception.
4682 </summary>
4683 <param name="message">reason to why the request was unauthorized.</param>
4684 </member> 4811 </member>
4685 <member name="T:HttpServer.Exceptions.NotFoundException"> 4812 <member name="M:HttpServer.Helpers.FormHelper.Select(System.String,System.String,System.Collections.IEnumerable,HttpServer.Helpers.GetIdTitle,System.Object,System.Boolean,System.String[])">
4686 <summary> 4813 <summary>
4687 The requested resource was not found in the web server. 4814 Creates a select list with the values in a collection.
4688 </summary> 4815 </summary>
4816 <param name="name">Name of the SELECT-tag</param>
4817 <param name="id">Id of the SELECT-tag</param>
4818 <param name="collection">collection used to generate options.</param>
4819 <param name="getIdTitle">delegate used to return id and title from objects.</param>
4820 <param name="selectedValue">value that should be marked as selected.</param>
4821 <param name="firstEmpty">First row should contain an empty value.</param>
4822 <param name="htmlAttributes">name, value collection of extra HTML attributes.</param>
4823 <returns>string containing a SELECT-tag.</returns>
4824 <seealso cref="T:HttpServer.Helpers.GetIdTitle"/>
4825 <exception cref="T:System.ArgumentNullException"><c>name</c>, <c>id</c>, <c>collection</c> or <c>getIdTitle</c> is null.</exception>
4826 <exception cref="T:System.ArgumentException">Invalid HTML attribute list.</exception>
4689 </member> 4827 </member>
4690 <member name="M:HttpServer.Exceptions.NotFoundException.#ctor(System.String,System.Exception)"> 4828 <member name="M:HttpServer.Helpers.FormHelper.Options(System.Collections.IEnumerable,HttpServer.Helpers.GetIdTitle,System.Object,System.Boolean)">
4691 <summary> 4829 <summary>
4692 Create a new exception 4830 Generate a list of HTML options
4693 </summary> 4831 </summary>
4694 <param name="message">message describing the error</param> 4832 <param name="collection">collection used to generate options.</param>
4695 <param name="inner">inner exception</param> 4833 <param name="getIdTitle">delegate used to return id and title from objects.</param>
4834 <param name="selectedValue">value that should be marked as selected.</param>
4835 <param name="firstEmpty">First row should contain an empty value.</param>
4836 <returns></returns>
4837 <exception cref="T:System.ArgumentNullException"><c>collection</c> or <c>getIdTitle</c> is null.</exception>
4696 </member> 4838 </member>
4697 <member name="M:HttpServer.Exceptions.NotFoundException.#ctor(System.String)"> 4839 <member name="M:HttpServer.Helpers.FormHelper.Options(System.Text.StringBuilder,System.Collections.IEnumerable,HttpServer.Helpers.GetIdTitle,System.Object,System.Boolean)">
4698 <summary> 4840 <exception cref="T:System.ArgumentNullException"><c>sb</c> is null.</exception>
4699 Create a new exception
4700 </summary>
4701 <param name="message">message describing the error</param>
4702 </member> 4841 </member>
4703 <member name="T:HttpServer.ConnectionType"> 4842 <member name="M:HttpServer.Helpers.FormHelper.CheckBox(System.String,System.Object,System.Object,System.String[])">
4704 <summary> 4843 <summary>
4705 Type of HTTP connection 4844 Creates a check box.
4706 </summary> 4845 </summary>
4846 <param name="name">element name</param>
4847 <param name="value">element value</param>
4848 <param name="isChecked">determines if the check box is selected or not. This is done differently depending on the
4849 type of variable. A boolean simply triggers checked or not, all other types are compared with "value" to determine if
4850 the box is checked or not. </param>
4851 <param name="htmlAttributes">a list with additional attributes (name, value, name, value).</param>
4852 <returns>a generated radio button</returns>
4707 </member> 4853 </member>
4708 <member name="F:HttpServer.ConnectionType.Close"> 4854 <member name="M:HttpServer.Helpers.FormHelper.CheckBox(System.String,System.String,System.Object,System.Object,System.String[])">
4709 <summary> 4855 <summary>
4710 Connection is closed after each request-response 4856 Creates a check box.
4711 </summary> 4857 </summary>
4858 <param name="name">element name</param>
4859 <param name="id">element id</param>
4860 <param name="value">element value</param>
4861 <param name="isChecked">determines if the check box is selected or not. This is done differently depending on the
4862 type of variable. A boolean simply triggers checked or not, all other types are compared with "value" to determine if
4863 the box is checked or not. </param>
4864 <param name="htmlAttributes">a list with additional attributes (name, value, name, value).</param>
4865 <returns>a generated radio button</returns>
4866 <remarks>
4867 value in your business object. (check box will be selected if it matches the element value)
4868 </remarks>
4712 </member> 4869 </member>
4713 <member name="F:HttpServer.ConnectionType.KeepAlive"> 4870 <member name="M:HttpServer.Helpers.FormHelper.CheckBox(System.String,System.String,System.Object,System.String[])">
4714 <summary> 4871 <summary>
4715 Connection is kept alive for X seconds (unless another request have been made) 4872 Creates a check box.
4716 </summary> 4873 </summary>
4874 <param name="name">element name</param>
4875 <param name="id">element id</param>
4876 <param name="isChecked">determines if the check box is selected or not. This is done differently depending on the
4877 type of variable. A boolean simply triggers checked or not, all other types are compared with "value" to determine if
4878 the box is checked or not. </param>
4879 <param name="htmlAttributes">a list with additional attributes (name, value, name, value).</param>
4880 <returns>a generated radio button</returns>
4881 <remarks>will set value to "1".</remarks>
4717 </member> 4882 </member>
4718 <member name="T:HttpServer.DisconnectedEventArgs"> 4883 <member name="M:HttpServer.Helpers.FormHelper.RadioButton(System.String,System.Object,System.Object,System.String[])">
4719 <summary> 4884 <summary>
4720 A <see cref="T:HttpServer.IHttpClientContext"/> have been disconnected. 4885 Creates a RadioButton.
4721 </summary> 4886 </summary>
4887 <param name="name">element name</param>
4888 <param name="value">element value</param>
4889 <param name="isSelected">determines if the radio button is selected or not. This is done differently depending on the
4890 type of variable. A boolean simply triggers checked or not, all other types are compared with "value" to determine if
4891 the box is checked or not. </param>
4892 <param name="htmlAttributes">a list with additional attributes (name, value, name, value).</param>
4893 <returns>a generated radio button</returns>
4722 </member> 4894 </member>
4723 <member name="M:HttpServer.DisconnectedEventArgs.#ctor(System.Net.Sockets.SocketError)"> 4895 <member name="M:HttpServer.Helpers.FormHelper.RadioButton(System.String,System.String,System.Object,System.Object,System.String[])">
4724 <summary> 4896 <summary>
4725 Initializes a new instance of the <see cref="T:HttpServer.DisconnectedEventArgs"/> class. 4897 Creates a RadioButton.
4726 </summary> 4898 </summary>
4727 <param name="error">Reason to disconnection.</param> 4899 <param name="name">element name</param>
4900 <param name="id">element id</param>
4901 <param name="value">element value</param>
4902 <param name="isSelected">determines if the radio button is selected or not. This is done differently depending on the
4903 type of variable. A boolean simply triggers checked or not, all other types are compared with "value" to determine if
4904 the box is checked or not. </param>
4905 <param name="htmlAttributes">a list with additional attributes (name, value, name, value).</param>
4906 <returns>a generated radio button</returns>
4728 </member> 4907 </member>
4729 <member name="P:HttpServer.DisconnectedEventArgs.Error"> 4908 <member name="M:HttpServer.Helpers.FormHelper.End">
4730 <summary> 4909 <summary>
4731 Gets reason to why client disconnected. 4910 form close tag
4732 </summary> 4911 </summary>
4912 <returns></returns>
4733 </member> 4913 </member>
4734 <member name="T:HttpServer.RequestEventArgs"> 4914 <member name="M:HttpServer.ComponentProvider.AddInstance``1(System.Object)">
4735 <summary> 4915 <summary>
4736 4916 Add a component instance
4737 </summary> 4917 </summary>
4918 <typeparam name="T">Interface type</typeparam>
4919 <param name="instance">Instance to add</param>
4738 </member> 4920 </member>
4739 <member name="M:HttpServer.RequestEventArgs.#ctor(HttpServer.IHttpRequest)"> 4921 <member name="M:HttpServer.ComponentProvider.Get``1">
4740 <summary> 4922 <summary>
4741 Initializes a new instance of the <see cref="T:HttpServer.RequestEventArgs"/> class. 4923 Get a component.
4742 </summary> 4924 </summary>
4743 <param name="request">The request.</param> 4925 <typeparam name="T">Interface type</typeparam>
4926 <returns>Component if registered, otherwise null.</returns>
4927 <remarks>
4928 Component will get created if needed.
4929 </remarks>
4744 </member> 4930 </member>
4745 <member name="P:HttpServer.RequestEventArgs.Request"> 4931 <member name="M:HttpServer.ComponentProvider.Create(HttpServer.ComponentProvider.TypeInformation)">
4746 <summary> 4932 <exception cref="T:System.InvalidOperationException">If instance cannot be created.</exception>
4747 Gets received request.
4748 </summary>
4749 </member> 4933 </member>
4750 <member name="T:HttpServer.HttpRequest"> 4934 <member name="M:HttpServer.ComponentProvider.Contains(System.Type)">
4751 <summary> 4935 <summary>
4752 Contains server side HTTP request information. 4936 Checks if the specified component interface have been added.
4753 </summary> 4937 </summary>
4938 <param name="interfaceType"></param>
4939 <returns>true if found; otherwise false.</returns>
4754 </member> 4940 </member>
4755 <member name="F:HttpServer.HttpRequest.UriSplitters"> 4941 <member name="M:HttpServer.ComponentProvider.Add``2">
4756 <summary> 4942 <summary>
4757 Chars used to split an URL path into multiple parts. 4943 Add a component.
4758 </summary> 4944 </summary>
4945 <typeparam name="InterfaceType">Type being requested.</typeparam>
4946 <typeparam name="InstanceType">Type being created.</typeparam>
4947 <exception cref="T:System.InvalidOperationException">Type have already been mapped.</exception>
4759 </member> 4948 </member>
4760 <member name="M:HttpServer.HttpRequest.AssignForm(HttpServer.HttpForm)"> 4949 <member name="T:HttpServer.Sessions.MemorySessionStore">
4761 <summary> 4950 <summary>
4762 Assign a form. 4951 Session store using memory for each session.
4763 </summary> 4952 </summary>
4764 <param name="form"></param>
4765 </member> 4953 </member>
4766 <member name="M:HttpServer.HttpRequest.Clone"> 4954 <member name="M:HttpServer.Sessions.MemorySessionStore.#ctor">
4767 <summary> 4955 <summary>
4768 Creates a new object that is a copy of the current instance. 4956 Initializes the class setting the expirationtimer to clean the session every minute
4769 </summary> 4957 </summary>
4770
4771 <returns>
4772 A new object that is a copy of this instance.
4773 </returns>
4774 <filterpriority>2</filterpriority>
4775 </member> 4958 </member>
4776 <member name="M:HttpServer.HttpRequest.DecodeBody(HttpServer.FormDecoders.FormDecoderProvider)"> 4959 <member name="M:HttpServer.Sessions.MemorySessionStore.Cleanup(System.Object)">
4777 <summary> 4960 <summary>
4778 Decode body into a form. 4961 Delegate for the cleanup timer
4779 </summary> 4962 </summary>
4780 <param name="providers">A list with form decoders.</param>
4781 <exception cref="T:System.IO.InvalidDataException">If body contents is not valid for the chosen decoder.</exception>
4782 <exception cref="T:System.InvalidOperationException">If body is still being transferred.</exception>
4783 </member> 4963 </member>
4784 <member name="M:HttpServer.HttpRequest.SetCookies(HttpServer.RequestCookies)"> 4964 <member name="M:HttpServer.Sessions.MemorySessionStore.Create">
4785 <summary> 4965 <summary>
4786 Cookies 4966 Creates a new http session
4787 </summary> 4967 </summary>
4788 <param name="cookies">the cookies</param> 4968 <returns></returns>
4789 </member> 4969 </member>
4790 <member name="M:HttpServer.HttpRequest.CreateResponse(HttpServer.IHttpClientContext)"> 4970 <member name="M:HttpServer.Sessions.MemorySessionStore.Create(System.String)">
4791 <summary> 4971 <summary>
4792 Create a response object. 4972 Creates a new http session with a specific id
4793 </summary> 4973 </summary>
4794 <returns>A new <see cref="T:HttpServer.IHttpResponse"/>.</returns> 4974 <param name="id">Id used to identify the new cookie..</param>
4975 <returns>A <see cref="T:HttpServer.Sessions.IHttpSession"/> object.</returns>
4976 <remarks>
4977 Id should be generated by the store implementation if it's null or <see cref="F:System.String.Empty"/>.
4978 </remarks>
4795 </member> 4979 </member>
4796 <member name="M:HttpServer.HttpRequest.AddHeader(System.String,System.String)"> 4980 <member name="M:HttpServer.Sessions.MemorySessionStore.Load(System.String)">
4797 <summary> 4981 <summary>
4798 Called during parsing of a <see cref="T:HttpServer.IHttpRequest"/>. 4982 Load an existing session.
4799 </summary> 4983 </summary>
4800 <param name="name">Name of the header, should not be URL encoded</param> 4984 <param name="sessionId"></param>
4801 <param name="value">Value of the header, should not be URL encoded</param> 4985 <returns></returns>
4802 <exception cref="T:HttpServer.Exceptions.BadRequestException">If a header is incorrect.</exception>
4803 </member> 4986 </member>
4804 <member name="M:HttpServer.HttpRequest.AddToBody(System.Byte[],System.Int32,System.Int32)"> 4987 <member name="M:HttpServer.Sessions.MemorySessionStore.Save(HttpServer.Sessions.IHttpSession)">
4805 <summary> 4988 <summary>
4806 Add bytes to the body 4989 Save an updated session to the store.
4807 </summary> 4990 </summary>
4808 <param name="bytes">buffer to read bytes from</param> 4991 <param name="session"></param>
4809 <param name="offset">where to start read</param>
4810 <param name="length">number of bytes to read</param>
4811 <returns>Number of bytes actually read (same as length unless we got all body bytes).</returns>
4812 <exception cref="T:System.InvalidOperationException">If body is not writable</exception>
4813 <exception cref="T:System.ArgumentNullException"><c>bytes</c> is null.</exception>
4814 <exception cref="T:System.ArgumentOutOfRangeException"><c>offset</c> is out of range.</exception>
4815 </member> 4992 </member>
4816 <member name="M:HttpServer.HttpRequest.Clear"> 4993 <member name="M:HttpServer.Sessions.MemorySessionStore.AddUnused(HttpServer.Sessions.IHttpSession)">
4817 <summary> 4994 <summary>
4818 Clear everything in the request 4995 We use the flyweight pattern which reuses small objects
4996 instead of creating new each time.
4819 </summary> 4997 </summary>
4998 <param name="session">EmptyLanguageNode (unused) session that should be reused next time Create is called.</param>
4820 </member> 4999 </member>
4821 <member name="P:HttpServer.HttpRequest.Secure"> 5000 <member name="M:HttpServer.Sessions.MemorySessionStore.Cleanup">
4822 <summary> 5001 <summary>
4823 Gets or sets a value indicating whether this <see cref="T:HttpServer.HttpRequest"/> is secure. 5002 Remove expired sessions
4824 </summary> 5003 </summary>
4825 </member> 5004 </member>
4826 <member name="P:HttpServer.HttpRequest.UriPath"> 5005 <member name="M:HttpServer.Sessions.MemorySessionStore.Remove(System.String)">
4827 <summary> 5006 <summary>
4828 Path and query (will be merged with the host header) and put in Uri 5007 Remove a session
4829 </summary> 5008 </summary>
4830 <see cref="P:HttpServer.HttpRequest.Uri"/> 5009 <param name="sessionId">id of the session.</param>
4831 </member> 5010 </member>
4832 <member name="P:HttpServer.HttpRequest.BodyIsComplete"> 5011 <member name="P:HttpServer.Sessions.MemorySessionStore.Item(System.String)">
4833 <summary> 5012 <summary>
4834 Gets whether the body is complete. 5013 Load a session from the store
4835 </summary> 5014 </summary>
5015 <param name="sessionId"></param>
5016 <returns>null if session is not found.</returns>
4836 </member> 5017 </member>
4837 <member name="P:HttpServer.HttpRequest.AcceptTypes"> 5018 <member name="P:HttpServer.Sessions.MemorySessionStore.ExpireTime">
4838 <summary> 5019 <summary>
4839 Gets kind of types accepted by the client. 5020 Number of minutes before a session expires.
5021 Default is 20 minutes.
4840 </summary> 5022 </summary>
4841 </member> 5023 </member>
4842 <member name="P:HttpServer.HttpRequest.Body"> 5024 <member name="T:HttpServer.RequestQueue">
4843 <summary> 5025 <summary>
4844 Gets or sets body stream. 5026 Used to queue incoming requests.
4845 </summary> 5027 </summary>
4846 </member> 5028 </member>
4847 <member name="P:HttpServer.HttpRequest.Connection"> 5029 <member name="M:HttpServer.RequestQueue.#ctor(HttpServer.ProcessRequestHandler)">
4848 <summary> 5030 <summary>
4849 Gets or sets kind of connection used for the session. 5031 Initializes a new instance of the <see cref="T:HttpServer.RequestQueue"/> class.
4850 </summary> 5032 </summary>
5033 <param name="handler">Called when a request should be processed.</param>
4851 </member> 5034 </member>
4852 <member name="P:HttpServer.HttpRequest.ContentLength"> 5035 <member name="M:HttpServer.RequestQueue.QueueThread">
4853 <summary> 5036 <summary>
4854 Gets or sets number of bytes in the body. 5037 Used to process queued requests.
4855 </summary> 5038 </summary>
4856 </member> 5039 </member>
4857 <member name="P:HttpServer.HttpRequest.Headers"> 5040 <member name="P:HttpServer.RequestQueue.MaxRequestCount">
4858 <summary> 5041 <summary>
4859 Gets headers sent by the client. 5042 Gets or sets maximum number of allowed simultaneous requests.
4860 </summary> 5043 </summary>
4861 </member> 5044 </member>
4862 <member name="P:HttpServer.HttpRequest.HttpVersion"> 5045 <member name="P:HttpServer.RequestQueue.MaxQueueSize">
4863 <summary> 5046 <summary>
4864 Gets or sets version of HTTP protocol that's used. 5047 Gets or sets maximum number of requests queuing to be handled.
4865 </summary> 5048 </summary>
4866 <remarks>
4867 Probably <see cref="F:HttpServer.HttpHelper.HTTP10"/> or <see cref="F:HttpServer.HttpHelper.HTTP11"/>.
4868 </remarks>
4869 <seealso cref="T:HttpServer.HttpHelper"/>
4870 </member> 5049 </member>
4871 <member name="P:HttpServer.HttpRequest.Method"> 5050 <member name="P:HttpServer.RequestQueue.CurrentRequestCount">
4872 <summary> 5051 <summary>
4873 Gets or sets requested method. 5052 Specifies how many requests the HTTP server is currently processing.
4874 </summary> 5053 </summary>
4875 <value></value>
4876 <remarks>
4877 Will always be in upper case.
4878 </remarks>
4879 <see cref="!:HttpServer.Method"/>
4880 </member> 5054 </member>
4881 <member name="P:HttpServer.HttpRequest.QueryString"> 5055 <member name="T:HttpServer.RequestQueue.QueueItem">
4882 <summary> 5056 <summary>
4883 Gets variables sent in the query string 5057 Used two queue incoming requests to avoid
5058 thread starvation.
4884 </summary> 5059 </summary>
4885 </member> 5060 </member>
4886 <member name="P:HttpServer.HttpRequest.Uri"> 5061 <member name="T:HttpServer.ProcessRequestHandler">
4887 <summary> 5062 <summary>
4888 Gets or sets requested URI. 5063 Method used to process a queued request
4889 </summary> 5064 </summary>
5065 <param name="context">Context that the request was received from.</param>
5066 <param name="request">Request to process.</param>
4890 </member> 5067 </member>
4891 <member name="P:HttpServer.HttpRequest.UriParts"> 5068 <member name="T:HttpServer.HttpResponse">
4892 <summary> 5069 <summary>
4893 Uri absolute path splitted into parts. 5070 Response that is sent back to the web browser / client.
4894 </summary> 5071 </summary>
4895 <example>
4896 // uri is: http://gauffin.com/code/tiny/
4897 Console.WriteLine(request.UriParts[0]); // result: code
4898 Console.WriteLine(request.UriParts[1]); // result: tiny
4899 </example>
4900 <remarks> 5072 <remarks>
4901 If you're using controllers than the first part is controller name, 5073 <para>
4902 the second part is method name and the third part is Id property. 5074 A response can be sent if different ways. The easiest one is
5075 to just fill the Body stream with content, everything else
5076 will then be taken care of by the framework. The default content-type
5077 is text/html, you should change it if you send anything else.
5078 </para><para>
5079 The second and slightly more complex way is to send the response
5080 as parts. Start with sending the header using the SendHeaders method and
5081 then you can send the body using SendBody method, but do not forget
5082 to set <see cref="P:HttpServer.HttpResponse.ContentType"/> and <see cref="P:HttpServer.HttpResponse.ContentLength"/> before doing so.
5083 </para>
4903 </remarks> 5084 </remarks>
4904 <seealso cref="P:HttpServer.HttpRequest.Uri"/>
4905 </member>
4906 <member name="P:HttpServer.HttpRequest.Param">
4907 <summary>
4908 Gets parameter from <see cref="P:HttpServer.HttpRequest.QueryString"/> or <see cref="P:HttpServer.HttpRequest.Form"/>.
4909 </summary>
4910 </member>
4911 <member name="P:HttpServer.HttpRequest.Form">
4912 <summary>
4913 Gets form parameters.
4914 </summary>
4915 </member>
4916 <member name="P:HttpServer.HttpRequest.IsAjax">
4917 <summary>
4918 Gets whether the request was made by Ajax (Asynchronous JavaScript)
4919 </summary>
4920 </member>
4921 <member name="P:HttpServer.HttpRequest.Cookies">
4922 <summary>
4923 Gets cookies that was sent with the request.
4924 </summary>
4925 </member>
4926 <member name="T:HttpServer.HttpInputItem">
4927 <summary>
4928 represents a HTTP input item. Each item can have multiple sub items, a sub item
4929 is made in a HTML form by using square brackets
4930 </summary>
4931 <example> 5085 <example>
4932 // <input type="text" name="user[FirstName]" value="jonas" /> becomes: 5086 <code>
4933 Console.WriteLine("Value: {0}", form["user"]["FirstName"].Value); 5087 // Example using response body.
4934 </example> 5088 class MyModule : HttpModule
4935 <remarks> 5089 {
4936 All names in a form SHOULD be in lowercase. 5090 public override bool Process(IHttpRequest request, IHttpResponse response, IHttpSession session)
4937 </remarks> 5091 {
4938 </member> 5092 StreamWriter writer = new StreamWriter(response.Body);
4939 <member name="F:HttpServer.HttpInputItem.Empty"> 5093 writer.WriteLine("Hello dear World!");
4940 <summary> Representation of a non-initialized <see cref="T:HttpServer.HttpInputItem"/>.</summary> 5094 writer.Flush();
4941 </member>
4942 <member name="M:HttpServer.HttpInputItem.#ctor(System.String,System.String)">
4943 <summary>
4944 Initializes an input item setting its name/identifier and value
4945 </summary>
4946 <param name="name">Parameter name/id</param>
4947 <param name="value">Parameter value</param>
4948 </member>
4949 <member name="M:HttpServer.HttpInputItem.#ctor(HttpServer.HttpInputItem)">
4950 <summary>Creates a deep copy of the item specified</summary>
4951 <param name="item">The item to copy</param>
4952 <remarks>The function makes a deep copy of quite a lot which can be slow</remarks>
4953 </member>
4954 <member name="M:HttpServer.HttpInputItem.Add(System.String)">
4955 <summary>
4956 Add another value to this item
4957 </summary>
4958 <param name="value">Value to add.</param>
4959 <exception cref="T:System.InvalidOperationException">Cannot add stuff to <see cref="F:HttpServer.HttpInput.Empty"/>.</exception>
4960 </member>
4961 <member name="M:HttpServer.HttpInputItem.Contains(System.String)">
4962 <summary>
4963 checks if a sub-item exists (and has a value).
4964 </summary>
4965 <param name="name">name in lower case</param>
4966 <returns>true if the sub-item exists and has a value; otherwise false.</returns>
4967 </member>
4968 <member name="M:HttpServer.HttpInputItem.ToString">
4969 <summary> Returns a formatted representation of the instance with the values of all contained parameters </summary>
4970 </member>
4971 <member name="M:HttpServer.HttpInputItem.ToString(System.String,System.Boolean)">
4972 <summary>
4973 Outputs the string in a formatted manner
4974 </summary>
4975 <param name="prefix">A prefix to append, used internally</param>
4976 <param name="asQuerySting">produce a query string</param>
4977 </member>
4978 <member name="M:HttpServer.HttpInputItem.Add(System.String,System.String)">
4979 <summary>
4980 Add a sub item.
4981 </summary>
4982 <param name="name">Can contain array formatting, the item is then parsed and added in multiple levels</param>
4983 <param name="value">Value to add.</param>
4984 <exception cref="T:System.ArgumentNullException">Argument is null.</exception>
4985 <exception cref="T:System.InvalidOperationException">Cannot add stuff to <see cref="F:HttpServer.HttpInput.Empty"/>.</exception>
4986 </member>
4987 <member name="M:HttpServer.HttpInputItem.System#Collections#Generic#IEnumerable{HttpServer#HttpInputItem}#GetEnumerator">
4988 <summary>
4989 Returns an enumerator that iterates through the collection.
4990 </summary>
4991
4992 <returns>
4993 A <see cref="T:System.Collections.Generic.IEnumerator`1"></see> that can be used to iterate through the collection.
4994 </returns>
4995 <filterpriority>1</filterpriority>
4996 </member>
4997 <member name="M:HttpServer.HttpInputItem.GetEnumerator">
4998 <summary>
4999 Returns an enumerator that iterates through a collection.
5000 </summary>
5001 5095
5002 <returns> 5096 // return true to tell webserver that we've handled the url
5003 An <see cref="T:System.Collections.IEnumerator"></see> object that can be used to iterate through the collection. 5097 return true;
5004 </returns> 5098 }
5005 <filterpriority>2</filterpriority> 5099 }
5006 </member> 5100 </code>
5007 <member name="M:HttpServer.HttpInputItem.ToString(System.String)"> 5101 </example>
5008 <summary> 5102 todo: add two examples, using SendHeaders/SendBody and just the Body stream.
5009 Outputs the string in a formatted manner
5010 </summary>
5011 <param name="prefix">A prefix to append, used internally</param>
5012 <returns></returns>
5013 </member>
5014 <member name="P:HttpServer.HttpInputItem.Count">
5015 <summary>
5016 Number of values
5017 </summary>
5018 </member> 5103 </member>
5019 <member name="P:HttpServer.HttpInputItem.Item(System.String)"> 5104 <member name="M:HttpServer.HttpResponse.#ctor(HttpServer.IHttpClientContext,HttpServer.IHttpRequest)">
5020 <summary> 5105 <summary>
5021 Get a sub item 5106 Initializes a new instance of the <see cref="T:HttpServer.IHttpResponse"/> class.
5022 </summary> 5107 </summary>
5023 <param name="name">name in lower case.</param> 5108 <param name="context">Client that send the <see cref="T:HttpServer.IHttpRequest"/>.</param>
5024 <returns><see cref="F:HttpServer.HttpInputItem.Empty"/> if no item was found.</returns> 5109 <param name="request">Contains information of what the client want to receive.</param>
5110 <exception cref="T:System.ArgumentException"><see cref="P:HttpServer.IHttpRequest.HttpVersion"/> cannot be empty.</exception>
5025 </member> 5111 </member>
5026 <member name="P:HttpServer.HttpInputItem.Name"> 5112 <member name="M:HttpServer.HttpResponse.#ctor(HttpServer.IHttpClientContext,System.String,HttpServer.ConnectionType)">
5027 <summary> 5113 <summary>
5028 Name of item (in lower case). 5114 Initializes a new instance of the <see cref="T:HttpServer.IHttpResponse"/> class.
5029 </summary> 5115 </summary>
5116 <param name="context">Client that send the <see cref="T:HttpServer.IHttpRequest"/>.</param>
5117 <param name="httpVersion">Version of HTTP protocol that the client uses.</param>
5118 <param name="connectionType">Type of HTTP connection used.</param>
5030 </member> 5119 </member>
5031 <member name="P:HttpServer.HttpInputItem.Value"> 5120 <member name="M:HttpServer.HttpResponse.AddHeader(System.String,System.String)">
5032 <summary> 5121 <summary>
5033 Returns the first value, or null if no value exist. 5122 Add another header to the document.
5034 </summary> 5123 </summary>
5124 <param name="name">Name of the header, case sensitive, use lower cases.</param>
5125 <param name="value">Header values can span over multiple lines as long as each line starts with a white space. New line chars should be \r\n</param>
5126 <exception cref="T:System.InvalidOperationException">If headers already been sent.</exception>
5127 <exception cref="T:System.ArgumentException">If value conditions have not been met.</exception>
5128 <remarks>Adding any header will override the default ones and those specified by properties.</remarks>
5035 </member> 5129 </member>
5036 <member name="P:HttpServer.HttpInputItem.LastValue"> 5130 <member name="M:HttpServer.HttpResponse.Send">
5037 <summary> 5131 <summary>
5038 Returns the last value, or null if no value exist. 5132 Send headers and body to the browser.
5039 </summary> 5133 </summary>
5134 <exception cref="T:System.InvalidOperationException">If content have already been sent.</exception>
5040 </member> 5135 </member>
5041 <member name="P:HttpServer.HttpInputItem.Values"> 5136 <member name="M:HttpServer.HttpResponse.SendBody(System.Byte[],System.Int32,System.Int32)">
5042 <summary> 5137 <summary>
5043 Returns the list with values. 5138 Make sure that you have specified <see cref="P:HttpServer.HttpResponse.ContentLength"/> and sent the headers first.
5044 </summary> 5139 </summary>
5140 <param name="buffer"></param>
5141 <exception cref="T:System.InvalidOperationException">If headers have not been sent.</exception>
5142 <see cref="M:HttpServer.HttpResponse.SendHeaders"/>
5143 <param name="offset">offset of first byte to send</param>
5144 <param name="count">number of bytes to send.</param>
5145 <seealso cref="M:HttpServer.HttpResponse.Send"/>
5146 <seealso cref="M:HttpServer.HttpResponse.SendHeaders"/>
5147 <remarks>This method can be used if you want to send body contents without caching them first. This
5148 is recommended for larger files to keep the memory usage low.</remarks>
5045 </member> 5149 </member>
5046 <member name="P:HttpServer.HttpInputItem.HttpServer#IHttpInput#Item(System.String)"> 5150 <member name="M:HttpServer.HttpResponse.SendBody(System.Byte[])">
5047 <summary> 5151 <summary>
5048 5152 Make sure that you have specified <see cref="P:HttpServer.HttpResponse.ContentLength"/> and sent the headers first.
5049 </summary> 5153 </summary>
5050 <param name="name">name in lower case</param> 5154 <param name="buffer"></param>
5051 <returns></returns> 5155 <exception cref="T:System.InvalidOperationException">If headers have not been sent.</exception>
5156 <see cref="M:HttpServer.HttpResponse.SendHeaders"/>
5157 <seealso cref="M:HttpServer.HttpResponse.Send"/>
5158 <seealso cref="M:HttpServer.HttpResponse.SendHeaders"/>
5159 <remarks>This method can be used if you want to send body contents without caching them first. This
5160 is recommended for larger files to keep the memory usage low.</remarks>
5052 </member> 5161 </member>
5053 <member name="T:HttpServer.HttpHelper"> 5162 <member name="M:HttpServer.HttpResponse.SendHeaders">
5054 <summary> 5163 <summary>
5055 Generic helper functions for HTTP 5164 Send headers to the client.
5056 </summary> 5165 </summary>
5166 <exception cref="T:System.InvalidOperationException">If headers already been sent.</exception>
5167 <seealso cref="M:HttpServer.HttpResponse.AddHeader(System.String,System.String)"/>
5168 <seealso cref="M:HttpServer.HttpResponse.Send"/>
5169 <seealso cref="M:HttpServer.HttpResponse.SendBody(System.Byte[])"/>
5057 </member> 5170 </member>
5058 <member name="F:HttpServer.HttpHelper.HTTP10"> 5171 <member name="M:HttpServer.HttpResponse.Redirect(System.Uri)">
5059 <summary> 5172 <summary>
5060 Version string for HTTP v1.0 5173 Redirect client to somewhere else using the 302 status code.
5061 </summary> 5174 </summary>
5175 <param name="uri">Destination of the redirect</param>
5176 <exception cref="T:System.InvalidOperationException">If headers already been sent.</exception>
5177 <remarks>You can not do anything more with the request when a redirect have been done. This should be your last
5178 action.</remarks>
5062 </member> 5179 </member>
5063 <member name="F:HttpServer.HttpHelper.HTTP11"> 5180 <member name="M:HttpServer.HttpResponse.Redirect(System.String)">
5064 <summary> 5181 <summary>
5065 Version string for HTTP v1.1 5182 redirect to somewhere
5066 </summary> 5183 </summary>
5184 <param name="url">where the redirect should go</param>
5185 <remarks>
5186 No body are allowed when doing redirects.
5187 </remarks>
5067 </member> 5188 </member>
5068 <member name="F:HttpServer.HttpHelper.EmptyUri"> 5189 <member name="P:HttpServer.HttpResponse.Body">
5069 <summary> 5190 <summary>
5070 An empty URI 5191 The body stream is used to cache the body contents
5192 before sending everything to the client. It's the simplest
5193 way to serve documents.
5071 </summary> 5194 </summary>
5072 </member> 5195 </member>
5073 <member name="M:HttpServer.HttpHelper.ParseQueryString(System.String)"> 5196 <member name="P:HttpServer.HttpResponse.Chunked">
5074 <summary> 5197 <summary>
5075 Parses a query string. 5198 The chunked encoding modifies the body of a message in order to
5199 transfer it as a series of chunks, each with its own size indicator,
5200 followed by an OPTIONAL trailer containing entity-header fields. This
5201 allows dynamically produced content to be transferred along with the
5202 information necessary for the recipient to verify that it has
5203 received the full message.
5076 </summary> 5204 </summary>
5077 <param name="queryString">Query string (URI encoded)</param>
5078 <returns>A <see cref="T:HttpServer.HttpInput"/> object if successful; otherwise <see cref="F:HttpServer.HttpInput.Empty"/></returns>
5079 <exception cref="T:System.ArgumentNullException"><c>queryString</c> is null.</exception>
5080 <exception cref="T:System.FormatException">If string cannot be parsed.</exception>
5081 </member> 5205 </member>
5082 <member name="T:HttpServer.Parser.RequestLineEventArgs"> 5206 <member name="P:HttpServer.HttpResponse.ProtocolVersion">
5083 <summary> 5207 <summary>
5084 Used when the request line have been successfully parsed. 5208 Defines the version of the HTTP Response for applications where it's required
5209 for this to be forced.
5085 </summary> 5210 </summary>
5086 </member> 5211 </member>
5087 <member name="M:HttpServer.Parser.RequestLineEventArgs.#ctor(System.String,System.String,System.String)"> 5212 <member name="P:HttpServer.HttpResponse.Connection">
5088 <summary> 5213 <summary>
5089 Initializes a new instance of the <see cref="T:HttpServer.Parser.RequestLineEventArgs"/> class. 5214 Kind of connection
5090 </summary> 5215 </summary>
5091 <param name="httpMethod">The HTTP method.</param>
5092 <param name="uriPath">The URI path.</param>
5093 <param name="httpVersion">The HTTP version.</param>
5094 </member> 5216 </member>
5095 <member name="M:HttpServer.Parser.RequestLineEventArgs.#ctor"> 5217 <member name="P:HttpServer.HttpResponse.Encoding">
5096 <summary> 5218 <summary>
5097 Initializes a new instance of the <see cref="T:HttpServer.Parser.RequestLineEventArgs"/> class. 5219 Encoding to use when sending stuff to the client.
5098 </summary> 5220 </summary>
5221 <remarks>Default is UTF8</remarks>
5099 </member> 5222 </member>
5100 <member name="P:HttpServer.Parser.RequestLineEventArgs.HttpMethod"> 5223 <member name="P:HttpServer.HttpResponse.KeepAlive">
5101 <summary> 5224 <summary>
5102 Gets or sets http method. 5225 Number of seconds to keep connection alive
5103 </summary> 5226 </summary>
5104 <remarks> 5227 <remarks>Only used if Connection property is set to <see cref="F:HttpServer.ConnectionType.KeepAlive"/>.</remarks>
5105 Should be one of the methods declared in <see cref="T:HttpServer.Method"/>.
5106 </remarks>
5107 </member> 5228 </member>
5108 <member name="P:HttpServer.Parser.RequestLineEventArgs.HttpVersion"> 5229 <member name="P:HttpServer.HttpResponse.Status">
5109 <summary> 5230 <summary>
5110 Gets or sets the version of the HTTP protocol that the client want to use. 5231 Status code that is sent to the client.
5111 </summary> 5232 </summary>
5233 <remarks>Default is <see cref="F:System.Net.HttpStatusCode.OK"/></remarks>
5112 </member> 5234 </member>
5113 <member name="P:HttpServer.Parser.RequestLineEventArgs.UriPath"> 5235 <member name="P:HttpServer.HttpResponse.Reason">
5114 <summary> 5236 <summary>
5115 Gets or sets requested URI path. 5237 Information about why a specific status code was used.
5116 </summary> 5238 </summary>
5117 </member> 5239 </member>
5118 <member name="T:HttpServer.Method"> 5240 <member name="P:HttpServer.HttpResponse.ContentLength">
5119 <summary> 5241 <summary>
5120 Contains all HTTP Methods (according to the HTTP 1.1 specification) 5242 Size of the body. MUST be specified before sending the header,
5121 <para> 5243 unless property Chunked is set to true.
5122 See: http://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html
5123 </para>
5124 </summary> 5244 </summary>
5125 </member> 5245 </member>
5126 <member name="F:HttpServer.Method.Delete"> 5246 <member name="P:HttpServer.HttpResponse.ContentType">
5127 <summary> 5247 <summary>
5128 The DELETE method requests that the origin server delete the resource identified by the Request-URI. 5248 Kind of content in the body
5129 </summary> 5249 </summary>
5130 <remarks> 5250 <remarks>Default type is "text/html"</remarks>
5131 <para>
5132 This method MAY be overridden by human intervention (or other means) on the origin server.
5133 The client cannot be guaranteed that the operation has been carried out, even if the status code
5134 returned from the origin server indicates that the action has been completed successfully.
5135 </para>
5136 <para>
5137 However, the server SHOULD NOT indicate success unless, at the time the response is given,
5138 it intends to delete the resource or move it to an inaccessible location.
5139 </para>
5140 <para>
5141 A successful response SHOULD be 200 (OK) if the response includes an entity describing the status,
5142 202 (Accepted) if the action has not yet been enacted,
5143 or 204 (No Content) if the action has been enacted but the response does not include an entity.
5144 </para>
5145 <para>
5146 If the request passes through a cache and the Request-URI identifies one or more currently cached entities,
5147 those entries SHOULD be treated as stale. Responses to this method are not cacheable.
5148 </para>
5149 </remarks>
5150 </member> 5251 </member>
5151 <member name="F:HttpServer.Method.Get"> 5252 <member name="P:HttpServer.HttpResponse.HeadersSent">
5152 <summary> 5253 <summary>
5153 The GET method means retrieve whatever information (in the form of an entity) is identified by the Request-URI. 5254 Headers have been sent to the client-
5154 </summary> 5255 </summary>
5155 <remarks> 5256 <remarks>You can not send any additional headers if they have already been sent.</remarks>
5156 <para>
5157 If the Request-URI refers to a data-producing process, it is the produced data which shall be returned as the
5158 entity in the response and not the source text of the process, unless that text happens to be the output of the process.
5159 </para>
5160 <para>
5161 The semantics of the GET method change to a "conditional GET" if the request message includes an
5162 If-Modified-Since, If-Unmodified-Since, If-Match, If-None-Match, or If-Range header field.
5163 A conditional GET method requests that the entity be transferred only under the circumstances described
5164 by the conditional header field(s). The conditional GET method is intended to reduce unnecessary network
5165 usage by allowing cached entities to be refreshed without requiring multiple requests or transferring
5166 data already held by the client.
5167 </para>
5168 </remarks>
5169 </member> 5257 </member>
5170 <member name="F:HttpServer.Method.Header"> 5258 <member name="P:HttpServer.HttpResponse.Sent">
5171 <summary> 5259 <summary>
5172 The HEAD method is identical to GET except that the server MUST NOT return a message-body in the response. 5260 The whole response have been sent.
5173 </summary> 5261 </summary>
5174 <remarks>
5175 The meta information contained in the HTTP headers in response to a HEAD request SHOULD be identical to the
5176 information sent in response to a GET request. This method can be used for obtaining meta information about
5177 the entity implied by the request without transferring the entity-body itself.
5178
5179 This method is often used for testing hypertext links for validity, accessibility, and recent modification.
5180 </remarks>
5181 </member> 5262 </member>
5182 <member name="F:HttpServer.Method.Options"> 5263 <member name="P:HttpServer.HttpResponse.Cookies">
5183 <summary> 5264 <summary>
5184 <para>The OPTIONS method represents a request for information about the communication options available on the request/response chain identified by the Request-URI.</para> 5265 Cookies that should be created/changed.
5185 </summary> 5266 </summary>
5186 <remarks>
5187 <para>This method allows the client to determine the options and/or requirements associated with a resource, or the capabilities of a server, without implying a resource action or initiating a resource retrieval.</para>
5188 </remarks>
5189 </member> 5267 </member>
5190 <member name="F:HttpServer.Method.Post"> 5268 <member name="T:HttpServer.HttpContextFactory">
5191 <summary> 5269 <summary>
5192 The POST method is used to request that the origin server accept the entity enclosed 5270 Used to create and reuse contexts.
5193 in the request as a new subordinate of the resource identified by the Request-URI in the Request-Line.
5194 </summary> 5271 </summary>
5195 <remarks>
5196 POST is designed to allow a uniform method to cover the following functions:
5197 <list type="bullet">
5198 <item>
5199 Annotation of existing resources;
5200 </item><item>
5201 Posting a message to a bulletin board, newsgroup, mailing list, or similar group of articles;
5202 </item><item>
5203 Providing a block of data, such as the result of submitting a form, to a data-handling process;
5204 </item><item>
5205 Extending a database through an append operation.
5206 </item>
5207 </list>
5208 <para>
5209 If a resource has been created on the origin server, the response SHOULD be 201 (Created) and
5210 contain an entity which describes the status of the request and refers to the new resource, and a
5211 Location header (see section 14.30).
5212 </para>
5213 <para>
5214 The action performed by the POST method might not result in a resource that can be identified by a URI.
5215 In this case, either 200 (OK) or 204 (No Content) is the appropriate response status, depending on
5216 whether or not the response includes an entity that describes the result.
5217 </para><para>
5218 Responses to this method are not cacheable, unless the response includes appropriate Cache-Control
5219 or Expires header fields. However, the 303 (See Other) response can be used to direct the user agent
5220 to retrieve a cacheable resource.
5221 </para>
5222 </remarks>
5223 </member> 5272 </member>
5224 <member name="F:HttpServer.Method.Put"> 5273 <member name="T:HttpServer.IHttpContextFactory">
5225 <summary> 5274 <summary>
5226 The PUT method requests that the enclosed entity be stored under the supplied Request-URI. 5275 Used to create <see cref="T:HttpServer.IHttpClientContext"/>es.
5227 </summary> 5276 </summary>
5228 <remarks>
5229 <list type="bullet">
5230 <item>
5231 If the Request-URI refers to an already existing resource, the enclosed entity SHOULD be considered as a
5232 modified version of the one residing on the origin server.
5233 </item><item>
5234 If the Request-URI does not point to an existing resource, and that URI is capable of being defined as a new
5235 resource by the requesting user agent, the origin server can create the resource with that URI.
5236 </item><item>
5237 If a new resource is created, the origin server MUST inform the user agent via the 201 (Created) response.
5238 </item><item>
5239 If an existing resource is modified, either the 200 (OK) or 204 (No Content) response codes SHOULD be sent to
5240 indicate successful completion of the request.
5241 </item><item>
5242 If the resource could not be created or modified with the Request-URI, an appropriate error response SHOULD be
5243 given that reflects the nature of the problem.
5244 </item>
5245 </list>
5246 <para>
5247 The recipient of the entity MUST NOT ignore any Content-* (e.g. Content-Range) headers that it does not
5248 understand or implement and MUST return a 501 (Not Implemented) response in such cases.
5249 </para>
5250 </remarks>
5251 </member> 5277 </member>
5252 <member name="F:HttpServer.Method.Trace"> 5278 <member name="M:HttpServer.IHttpContextFactory.CreateContext(System.Net.Sockets.Socket)">
5253 <summary> 5279 <summary>
5254 The TRACE method is used to invoke a remote, application-layer loop- back of the request message. 5280 Creates a <see cref="T:HttpServer.IHttpClientContext"/> that handles a connected client.
5255 </summary> 5281 </summary>
5282 <param name="socket">Client socket (accepted by the <see cref="T:HttpServer.HttpListener"/>).</param>
5283 <returns>A creates <see cref="T:HttpServer.IHttpClientContext"/>.</returns>
5256 </member> 5284 </member>
5257 <member name="T:HttpServer.Methods"> 5285 <member name="M:HttpServer.IHttpContextFactory.CreateSecureContext(System.Net.Sockets.Socket,System.Security.Cryptography.X509Certificates.X509Certificate,System.Security.Authentication.SslProtocols)">
5258 <summary> 5286 <summary>
5259 Contains all HTTP Methods (according to the HTTP 1.1 specification) 5287 Create a secure <see cref="T:HttpServer.IHttpClientContext"/>.
5260 <para>
5261 See: http://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html
5262 </para>
5263 </summary> 5288 </summary>
5289 <param name="socket">Client socket (accepted by the <see cref="T:HttpServer.HttpListener"/>).</param>
5290 <param name="certificate">HTTPS certificate to use.</param>
5291 <param name="protocol">Kind of HTTPS protocol. Usually TLS or SSL.</param>
5292 <returns>A created <see cref="T:HttpServer.IHttpClientContext"/>.</returns>
5264 </member> 5293 </member>
5265 <member name="F:HttpServer.Methods.Delete"> 5294 <member name="E:HttpServer.IHttpContextFactory.RequestReceived">
5266 <summary> 5295 <summary>
5267 The DELETE method requests that the origin server delete the resource identified by the Request-URI. 5296 A request have been received from one of the contexts.
5268 </summary> 5297 </summary>
5269 <remarks>
5270 <para>
5271 This method MAY be overridden by human intervention (or other means) on the origin server.
5272 The client cannot be guaranteed that the operation has been carried out, even if the status code
5273 returned from the origin server indicates that the action has been completed successfully.
5274 </para>
5275 <para>
5276 However, the server SHOULD NOT indicate success unless, at the time the response is given,
5277 it intends to delete the resource or move it to an inaccessible location.
5278 </para>
5279 <para>
5280 A successful response SHOULD be 200 (OK) if the response includes an entity describing the status,
5281 202 (Accepted) if the action has not yet been enacted,
5282 or 204 (No Content) if the action has been enacted but the response does not include an entity.
5283 </para>
5284 <para>
5285 If the request passes through a cache and the Request-URI identifies one or more currently cached entities,
5286 those entries SHOULD be treated as stale. Responses to this method are not cacheable.
5287 </para>
5288 </remarks>
5289 </member> 5298 </member>
5290 <member name="F:HttpServer.Methods.Get"> 5299 <member name="M:HttpServer.HttpContextFactory.#ctor(HttpServer.ILogWriter,System.Int32,HttpServer.IRequestParserFactory)">
5291 <summary> 5300 <summary>
5292 The GET method means retrieve whatever information (in the form of an entity) is identified by the Request-URI. 5301 Initializes a new instance of the <see cref="T:HttpServer.HttpContextFactory"/> class.
5293 </summary> 5302 </summary>
5294 <remarks> 5303 <param name="writer">The writer.</param>
5295 <para> 5304 <param name="bufferSize">Amount of bytes to read from the incoming socket stream.</param>
5296 If the Request-URI refers to a data-producing process, it is the produced data which shall be returned as the 5305 <param name="factory">Used to create a request parser.</param>
5297 entity in the response and not the source text of the process, unless that text happens to be the output of the process.
5298 </para>
5299 <para>
5300 The semantics of the GET method change to a "conditional GET" if the request message includes an
5301 If-Modified-Since, If-Unmodified-Since, If-Match, If-None-Match, or If-Range header field.
5302 A conditional GET method requests that the entity be transferred only under the circumstances described
5303 by the conditional header field(s). The conditional GET method is intended to reduce unnecessary network
5304 usage by allowing cached entities to be refreshed without requiring multiple requests or transferring
5305 data already held by the client.
5306 </para>
5307 </remarks>
5308 </member> 5306 </member>
5309 <member name="F:HttpServer.Methods.Header"> 5307 <member name="M:HttpServer.HttpContextFactory.CreateContext(System.Boolean,System.Net.IPEndPoint,System.IO.Stream,System.Net.Sockets.Socket)">
5310 <summary> 5308 <summary>
5311 The HEAD method is identical to GET except that the server MUST NOT return a message-body in the response. 5309 Create a new context.
5312 </summary> 5310 </summary>
5313 <remarks> 5311 <param name="isSecured">true if socket is running HTTPS.</param>
5314 The meta information contained in the HTTP headers in response to a HEAD request SHOULD be identical to the 5312 <param name="endPoint">Client that connected</param>
5315 information sent in response to a GET request. This method can be used for obtaining meta information about 5313 <param name="stream">Network/SSL stream.</param>
5316 the entity implied by the request without transferring the entity-body itself. 5314 <returns>A context.</returns>
5317
5318 This method is often used for testing hypertext links for validity, accessibility, and recent modification.
5319 </remarks>
5320 </member> 5315 </member>
5321 <member name="F:HttpServer.Methods.Options"> 5316 <member name="M:HttpServer.HttpContextFactory.CreateNewContext(System.Boolean,System.Net.IPEndPoint,System.IO.Stream,System.Net.Sockets.Socket)">
5322 <summary> 5317 <summary>
5323 <para>The OPTIONS method represents a request for information about the communication options available on the request/response chain identified by the Request-URI.</para> 5318 Create a new context.
5324 </summary> 5319 </summary>
5325 <remarks> 5320 <param name="isSecured">true if HTTPS is used.</param>
5326 <para>This method allows the client to determine the options and/or requirements associated with a resource, or the capabilities of a server, without implying a resource action or initiating a resource retrieval.</para> 5321 <param name="endPoint">Remote client</param>
5327 </remarks> 5322 <param name="stream">Network stream, <see cref="T:HttpServer.HttpClientContext"/> uses <see cref="T:HttpServer.ReusableSocketNetworkStream"/>.</param>
5323 <returns>A new context (always).</returns>
5328 </member> 5324 </member>
5329 <member name="F:HttpServer.Methods.Post"> 5325 <member name="M:HttpServer.HttpContextFactory.CreateSecureContext(System.Net.Sockets.Socket,System.Security.Cryptography.X509Certificates.X509Certificate,System.Security.Authentication.SslProtocols)">
5330 <summary> 5326 <summary>
5331 The POST method is used to request that the origin server accept the entity enclosed 5327 Create a secure <see cref="T:HttpServer.IHttpClientContext"/>.
5332 in the request as a new subordinate of the resource identified by the Request-URI in the Request-Line.
5333 </summary> 5328 </summary>
5334 <remarks> 5329 <param name="socket">Client socket (accepted by the <see cref="T:HttpServer.HttpListener"/>).</param>
5335 POST is designed to allow a uniform method to cover the following functions: 5330 <param name="certificate">HTTPS certificate to use.</param>
5336 <list type="bullet"> 5331 <param name="protocol">Kind of HTTPS protocol. Usually TLS or SSL.</param>
5337 <item> 5332 <returns>
5338 Annotation of existing resources; 5333 A created <see cref="T:HttpServer.IHttpClientContext"/>.
5339 </item><item> 5334 </returns>
5340 Posting a message to a bulletin board, newsgroup, mailing list, or similar group of articles;
5341 </item><item>
5342 Providing a block of data, such as the result of submitting a form, to a data-handling process;
5343 </item><item>
5344 Extending a database through an append operation.
5345 </item>
5346 </list>
5347 <para>
5348 If a resource has been created on the origin server, the response SHOULD be 201 (Created) and
5349 contain an entity which describes the status of the request and refers to the new resource, and a
5350 Location header (see section 14.30).
5351 </para>
5352 <para>
5353 The action performed by the POST method might not result in a resource that can be identified by a URI.
5354 In this case, either 200 (OK) or 204 (No Content) is the appropriate response status, depending on
5355 whether or not the response includes an entity that describes the result.
5356 </para><para>
5357 Responses to this method are not cacheable, unless the response includes appropriate Cache-Control
5358 or Expires header fields. However, the 303 (See Other) response can be used to direct the user agent
5359 to retrieve a cacheable resource.
5360 </para>
5361 </remarks>
5362 </member> 5335 </member>
5363 <member name="F:HttpServer.Methods.Put"> 5336 <member name="M:HttpServer.HttpContextFactory.CreateContext(System.Net.Sockets.Socket)">
5364 <summary> 5337 <summary>
5365 The PUT method requests that the enclosed entity be stored under the supplied Request-URI. 5338 Creates a <see cref="T:HttpServer.IHttpClientContext"/> that handles a connected client.
5366 </summary> 5339 </summary>
5367 <remarks> 5340 <param name="socket">Client socket (accepted by the <see cref="T:HttpServer.HttpListener"/>).</param>
5368 <list type="bullet"> 5341 <returns>
5369 <item> 5342 A creates <see cref="T:HttpServer.IHttpClientContext"/>.
5370 If the Request-URI refers to an already existing resource, the enclosed entity SHOULD be considered as a 5343 </returns>
5371 modified version of the one residing on the origin server.
5372 </item><item>
5373 If the Request-URI does not point to an existing resource, and that URI is capable of being defined as a new
5374 resource by the requesting user agent, the origin server can create the resource with that URI.
5375 </item><item>
5376 If a new resource is created, the origin server MUST inform the user agent via the 201 (Created) response.
5377 </item><item>
5378 If an existing resource is modified, either the 200 (OK) or 204 (No Content) response codes SHOULD be sent to
5379 indicate successful completion of the request.
5380 </item><item>
5381 If the resource could not be created or modified with the Request-URI, an appropriate error response SHOULD be
5382 given that reflects the nature of the problem.
5383 </item>
5384 </list>
5385 <para>
5386 The recipient of the entity MUST NOT ignore any Content-* (e.g. Content-Range) headers that it does not
5387 understand or implement and MUST return a 501 (Not Implemented) response in such cases.
5388 </para>
5389 </remarks>
5390 </member> 5344 </member>
5391 <member name="F:HttpServer.Methods.Trace"> 5345 <member name="P:HttpServer.HttpContextFactory.UseTraceLogs">
5392 <summary> 5346 <summary>
5393 The TRACE method is used to invoke a remote, application-layer loop- back of the request message. 5347 True if detailed trace logs should be written.
5394 </summary> 5348 </summary>
5395 </member> 5349 </member>
5396 <member name="T:HttpServer.HttpModules.ResourceFileModule"> 5350 <member name="E:HttpServer.HttpContextFactory.RequestReceived">
5397 <summary> 5351 <summary>
5398 Serves files that are stored in embedded resources. 5352 A request have been received from one of the contexts.
5399 </summary> 5353 </summary>
5400 </member> 5354 </member>
5401 <member name="M:HttpServer.HttpModules.ResourceFileModule.#ctor"> 5355 <member name="T:HttpServer.ReusableSocketNetworkStream">
5402 <summary> 5356 <summary>
5403 Initializes a new instance of the <see cref="T:HttpServer.HttpModules.ResourceFileModule"/> class. 5357 Custom network stream to mark sockets as reusable when disposing the stream.
5404 Runs <see cref="M:HttpServer.HttpModules.ResourceFileModule.AddDefaultMimeTypes"/> to make sure the basic mime types are available, they can be cleared later
5405 through the use of <see cref="P:HttpServer.HttpModules.ResourceFileModule.MimeTypes"/> if desired.
5406 </summary> 5358 </summary>
5407 </member> 5359 </member>
5408 <member name="M:HttpServer.HttpModules.ResourceFileModule.#ctor(HttpServer.ILogWriter)"> 5360 <member name="M:HttpServer.ReusableSocketNetworkStream.#ctor(System.Net.Sockets.Socket)">
5409 <summary> 5361 <summary>
5410 Initializes a new instance of the <see cref="T:HttpServer.HttpModules.ResourceFileModule"/> class. 5362 Creates a new instance of the <see cref="T:System.Net.Sockets.NetworkStream" /> class for the specified <see cref="T:System.Net.Sockets.Socket" />.
5411 Runs <see cref="M:HttpServer.HttpModules.ResourceFileModule.AddDefaultMimeTypes"/> to make sure the basic mime types are available, they can be cleared later
5412 through the use of <see cref="P:HttpServer.HttpModules.ResourceFileModule.MimeTypes"/> if desired.
5413 </summary> 5363 </summary>
5414 <param name="logWriter">The log writer to use when logging events</param> 5364 <param name="socket">
5365 The <see cref="T:System.Net.Sockets.Socket" /> that the <see cref="T:System.Net.Sockets.NetworkStream" /> will use to send and receive data.
5366 </param>
5367 <exception cref="T:System.ArgumentNullException">
5368 The <paramref name="socket" /> parameter is null.
5369 </exception>
5370 <exception cref="T:System.IO.IOException">
5371 The <paramref name="socket" /> parameter is not connected.
5372 -or-
5373 The <see cref="P:System.Net.Sockets.Socket.SocketType" /> property of the <paramref name="socket" /> parameter is not <see cref="F:System.Net.Sockets.SocketType.Stream" />.
5374 -or-
5375 The <paramref name="socket" /> parameter is in a nonblocking state.
5376 </exception>
5415 </member> 5377 </member>
5416 <member name="M:HttpServer.HttpModules.ResourceFileModule.AddDefaultMimeTypes"> 5378 <member name="M:HttpServer.ReusableSocketNetworkStream.#ctor(System.Net.Sockets.Socket,System.Boolean)">
5417 <summary> 5379 <summary>
5418 Mimtypes that this class can handle per default 5380 Initializes a new instance of the <see cref="T:System.Net.Sockets.NetworkStream" /> class for the specified <see cref="T:System.Net.Sockets.Socket" /> with the specified <see cref="T:System.Net.Sockets.Socket" /> ownership.
5419 </summary> 5381 </summary>
5382 <param name="socket">
5383 The <see cref="T:System.Net.Sockets.Socket" /> that the <see cref="T:System.Net.Sockets.NetworkStream" /> will use to send and receive data.
5384 </param>
5385 <param name="ownsSocket">
5386 Set to true to indicate that the <see cref="T:System.Net.Sockets.NetworkStream" /> will take ownership of the <see cref="T:System.Net.Sockets.Socket" />; otherwise, false.
5387 </param>
5388 <exception cref="T:System.ArgumentNullException">
5389 The <paramref name="socket" /> parameter is null.
5390 </exception>
5391 <exception cref="T:System.IO.IOException">
5392 The <paramref name="socket" /> parameter is not connected.
5393 -or-
5394 the value of the <see cref="P:System.Net.Sockets.Socket.SocketType" /> property of the <paramref name="socket" /> parameter is not <see cref="F:System.Net.Sockets.SocketType.Stream" />.
5395 -or-
5396 the <paramref name="socket" /> parameter is in a nonblocking state.
5397 </exception>
5420 </member> 5398 </member>
5421 <member name="M:HttpServer.HttpModules.ResourceFileModule.AddResources(System.String,System.Reflection.Assembly,System.String)"> 5399 <member name="M:HttpServer.ReusableSocketNetworkStream.#ctor(System.Net.Sockets.Socket,System.IO.FileAccess)">
5422 <summary> 5400 <summary>
5423 Loads resources from a namespace in the given assembly to an uri 5401 Creates a new instance of the <see cref="T:System.Net.Sockets.NetworkStream" /> class for the specified <see cref="T:System.Net.Sockets.Socket" /> with the specified access rights.
5424 </summary> 5402 </summary>
5425 <param name="toUri">The uri to map the resources to</param> 5403 <param name="socket">
5426 <param name="fromAssembly">The assembly in which the resources reside</param> 5404 The <see cref="T:System.Net.Sockets.Socket" /> that the <see cref="T:System.Net.Sockets.NetworkStream" /> will use to send and receive data.
5427 <param name="fromNamespace">The namespace from which to load the resources</param> 5405 </param>
5428 <usage> 5406 <param name="access">
5429 resourceLoader.LoadResources("/user/", typeof(User).Assembly, "MyLib.Models.User.Views"); 5407 A bitwise combination of the <see cref="T:System.IO.FileAccess" /> values that specify the type of access given to the <see cref="T:System.Net.Sockets.NetworkStream" /> over the provided <see cref="T:System.Net.Sockets.Socket" />.
5430 5408 </param>
5431 will make ie the resource MyLib.Models.User.Views.stylesheet.css accessible via /user/stylesheet.css 5409 <exception cref="T:System.ArgumentNullException">
5432 </usage> 5410 The <paramref name="socket" /> parameter is null.
5433 <returns>The amount of loaded files, giving you the possibility of making sure the resources needed gets loaded</returns> 5411 </exception>
5412 <exception cref="T:System.IO.IOException">
5413 The <paramref name="socket" /> parameter is not connected.
5414 -or-
5415 the <see cref="P:System.Net.Sockets.Socket.SocketType" /> property of the <paramref name="socket" /> parameter is not <see cref="F:System.Net.Sockets.SocketType.Stream" />.
5416 -or-
5417 the <paramref name="socket" /> parameter is in a nonblocking state.
5418 </exception>
5434 </member> 5419 </member>
5435 <member name="M:HttpServer.HttpModules.ResourceFileModule.CanHandle(HttpServer.IHttpRequest)"> 5420 <member name="M:HttpServer.ReusableSocketNetworkStream.#ctor(System.Net.Sockets.Socket,System.IO.FileAccess,System.Boolean)">
5436 <summary> 5421 <summary>
5437 Returns true if the module can handle the request 5422 Creates a new instance of the <see cref="T:System.Net.Sockets.NetworkStream" /> class for the specified <see cref="T:System.Net.Sockets.Socket" /> with the specified access rights and the specified <see cref="T:System.Net.Sockets.Socket" /> ownership.
5438 </summary> 5423 </summary>
5424 <param name="socket">
5425 The <see cref="T:System.Net.Sockets.Socket" /> that the <see cref="T:System.Net.Sockets.NetworkStream" /> will use to send and receive data.
5426 </param>
5427 <param name="access">
5428 A bitwise combination of the <see cref="T:System.IO.FileAccess" /> values that specifies the type of access given to the <see cref="T:System.Net.Sockets.NetworkStream" /> over the provided <see cref="T:System.Net.Sockets.Socket" />.
5429 </param>
5430 <param name="ownsSocket">
5431 Set to true to indicate that the <see cref="T:System.Net.Sockets.NetworkStream" /> will take ownership of the <see cref="T:System.Net.Sockets.Socket" />; otherwise, false.
5432 </param>
5433 <exception cref="T:System.ArgumentNullException">
5434 The <paramref name="socket" /> parameter is null.
5435 </exception>
5436 <exception cref="T:System.IO.IOException">
5437 The <paramref name="socket" /> parameter is not connected.
5438 -or-
5439 The <see cref="P:System.Net.Sockets.Socket.SocketType" /> property of the <paramref name="socket" /> parameter is not <see cref="F:System.Net.Sockets.SocketType.Stream" />.
5440 -or-
5441 The <paramref name="socket" /> parameter is in a nonblocking state.
5442 </exception>
5439 </member> 5443 </member>
5440 <member name="M:HttpServer.HttpModules.ResourceFileModule.Process(HttpServer.IHttpRequest,HttpServer.IHttpResponse,HttpServer.Sessions.IHttpSession)"> 5444 <member name="M:HttpServer.ReusableSocketNetworkStream.Close">
5441 <summary> 5445 <summary>
5442 Method that process the url 5446 Closes the current stream and releases any resources (such as sockets and file handles) associated with the current stream.
5443 </summary> 5447 </summary>
5444 <param name="request">Information sent by the browser about the request</param>
5445 <param name="response">Information that is being sent back to the client.</param>
5446 <param name="session">Session used to </param>
5447 <returns>true if this module handled the request.</returns>
5448 </member> 5448 </member>
5449 <member name="P:HttpServer.HttpModules.ResourceFileModule.MimeTypes"> 5449 <member name="M:HttpServer.ReusableSocketNetworkStream.Dispose(System.Boolean)">
5450 <summary> 5450 <summary>
5451 List with all mime-type that are allowed. 5451 Releases the unmanaged resources used by the <see cref="T:System.Net.Sockets.NetworkStream"/> and optionally releases the managed resources.
5452 </summary> 5452 </summary>
5453 <remarks>All other mime types will result in a Forbidden http status code.</remarks> 5453 <param name="disposing">true to release both managed and unmanaged resources; false to release only unmanaged resources.</param>
5454 </member> 5454 </member>
5455 </members> 5455 </members>
5456</doc> 5456</doc>
generated by cgit v1.1 at 2024-11-17 00:45:08 +0000