porting IDE tooltip-friendly documentation tweaks from Aurora-Sim

Signed-off-by: BlueWall <jamesh@bluewallgroup.com>
0.7.4.1
SignpostMarv 2012-05-24 15:47:40 +01:00 committed by BlueWall
parent f4cd4c8e28
commit 87f9aa9d08
1 changed files with 218 additions and 129 deletions

View File

@ -28,143 +28,232 @@
namespace OpenSim.Framework.Servers.HttpServer namespace OpenSim.Framework.Servers.HttpServer
{ {
/// <summary> /// <summary>
/// HTTP status codes (almost) as defined by W3C in /// HTTP status codes (almost) as defined by W3C in http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html
/// http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html
/// </summary> /// </summary>
public enum OSHttpStatusCode: int public enum OSHttpStatusCode: int
{ {
// 1xx Informational status codes providing a provisional #region 1xx Informational status codes providing a provisional response.
// response.
// 100 Tells client that to keep on going sending its request
InfoContinue = 100,
// 101 Server understands request, proposes to switch to different
// application level protocol
InfoSwitchingProtocols = 101,
/// <summary>
/// 100 Tells client that to keep on going sending its request
/// </summary>
InfoContinue = 100,
// 2xx Success codes /// <summary>
// 200 Request successful /// 101 Server understands request, proposes to switch to different application level protocol
SuccessOk = 200, /// </summary>
// 201 Request successful, new resource created InfoSwitchingProtocols = 101,
SuccessOkCreated = 201,
// 202 Request accepted, processing still on-going
SuccessOkAccepted = 202,
// 203 Request successful, meta information not authoritative
SuccessOkNonAuthoritativeInformation = 203,
// 204 Request successful, nothing to return in the body
SuccessOkNoContent = 204,
// 205 Request successful, reset displayed content
SuccessOkResetContent = 205,
// 206 Request successful, partial content returned
SuccessOkPartialContent = 206,
// 3xx Redirect code: user agent needs to go somewhere else #endregion
// 300 Redirect: different presentation forms available, take
// a pick
RedirectMultipleChoices = 300,
// 301 Redirect: requested resource has moved and now lives
// somewhere else
RedirectMovedPermanently = 301,
// 302 Redirect: Resource temporarily somewhere else, location
// might change
RedirectFound = 302,
// 303 Redirect: See other as result of a POST
RedirectSeeOther = 303,
// 304 Redirect: Resource still the same as before
RedirectNotModified = 304,
// 305 Redirect: Resource must be accessed via proxy provided
// in location field
RedirectUseProxy = 305,
// 307 Redirect: Resource temporarily somewhere else, location
// might change
RedirectMovedTemporarily = 307,
// 4xx Client error: the client borked the request #region 2xx Success codes
// 400 Client error: bad request, server does not grok what
// the client wants /// <summary>
ClientErrorBadRequest = 400, /// 200 Request successful
// 401 Client error: the client is not authorized, response /// </summary>
// provides WWW-Authenticate header field with a challenge SuccessOk = 200,
ClientErrorUnauthorized = 401,
// 402 Client error: Payment required (reserved for future use) /// <summary>
ClientErrorPaymentRequired = 402, /// 201 Request successful, new resource created
// 403 Client error: Server understood request, will not /// </summary>
// deliver, do not try again. SuccessOkCreated = 201,
ClientErrorForbidden = 403,
// 404 Client error: Server cannot find anything matching the /// <summary>
// client request. /// 202 Request accepted, processing still on-going
ClientErrorNotFound = 404, /// </summary>
// 405 Client error: The method specified by the client in the SuccessOkAccepted = 202,
// request is not allowed for the resource requested
ClientErrorMethodNotAllowed = 405, /// <summary>
// 406 Client error: Server cannot generate suitable response /// 203 Request successful, meta information not authoritative
// for the resource and content characteristics requested by /// </summary>
// the client SuccessOkNonAuthoritativeInformation = 203,
ClientErrorNotAcceptable = 406,
// 407 Client error: Similar to 401, Server requests that /// <summary>
// client authenticate itself with the proxy first /// 204 Request successful, nothing to return in the body
ClientErrorProxyAuthRequired = 407, /// </summary>
// 408 Client error: Server got impatient with client and SuccessOkNoContent = 204,
// decided to give up waiting for the client's request to
// arrive /// <summary>
ClientErrorRequestTimeout = 408, /// 205 Request successful, reset displayed content
// 409 Client error: Server could not fulfill the request for /// </summary>
// a resource as there is a conflict with the current state of SuccessOkResetContent = 205,
// the resource but thinks client can do something about this
ClientErrorConflict = 409, /// <summary>
// 410 Client error: The resource has moved somewhere else, /// 206 Request successful, partial content returned
// but server has no clue where. /// </summary>
ClientErrorGone = 410, SuccessOkPartialContent = 206,
// 411 Client error: The server is picky again and insists on
// having a content-length header field in the request #endregion
ClientErrorLengthRequired = 411,
// 412 Client error: one or more preconditions supplied in the #region 3xx Redirect code: user agent needs to go somewhere else
// client's request is false
ClientErrorPreconditionFailed = 412, /// <summary>
// 413 Client error: For fear of reflux, the server refuses to /// 300 Redirect: different presentation forms available, take a pick
// swallow that much data. /// </summary>
ClientErrorRequestEntityToLarge = 413, RedirectMultipleChoices = 300,
// 414 Client error: The server considers the Request-URI to
// be indecently long and refuses to even look at it. /// <summary>
ClientErrorRequestURITooLong = 414, /// 301 Redirect: requested resource has moved and now lives somewhere else
// 415 Client error: The server has no clue about the media /// </summary>
// type requested by the client (contrary to popular belief it RedirectMovedPermanently = 301,
// is not a warez server)
ClientErrorUnsupportedMediaType = 415, /// <summary>
// 416 Client error: The requested range cannot be delivered /// 302 Redirect: Resource temporarily somewhere else, location might change
// by the server. /// </summary>
RedirectFound = 302,
/// <summary>
/// 303 Redirect: See other as result of a POST
/// </summary>
RedirectSeeOther = 303,
/// <summary>
/// 304 Redirect: Resource still the same as before
/// </summary>
RedirectNotModified = 304,
/// <summary>
/// 305 Redirect: Resource must be accessed via proxy provided in location field
/// </summary>
RedirectUseProxy = 305,
/// <summary>
/// 307 Redirect: Resource temporarily somewhere else, location might change
/// </summary>
RedirectMovedTemporarily = 307,
#endregion
#region 4xx Client error: the client borked the request
/// <summary>
/// 400 Client error: bad request, server does not grok what the client wants
/// </summary>
ClientErrorBadRequest = 400,
/// <summary>
/// 401 Client error: the client is not authorized, response provides WWW-Authenticate header field with a challenge
/// </summary>
ClientErrorUnauthorized = 401,
/// <summary>
/// 402 Client error: Payment required (reserved for future use)
/// </summary>
ClientErrorPaymentRequired = 402,
/// <summary>
/// 403 Client error: Server understood request, will not deliver, do not try again.
ClientErrorForbidden = 403,
/// <summary>
/// 404 Client error: Server cannot find anything matching the client request.
/// </summary>
ClientErrorNotFound = 404,
/// <summary>
/// 405 Client error: The method specified by the client in the request is not allowed for the resource requested
/// </summary>
ClientErrorMethodNotAllowed = 405,
/// <summary>
/// 406 Client error: Server cannot generate suitable response for the resource and content characteristics requested by the client
/// </summary>
ClientErrorNotAcceptable = 406,
/// <summary>
/// 407 Client error: Similar to 401, Server requests that client authenticate itself with the proxy first
/// </summary>
ClientErrorProxyAuthRequired = 407,
/// <summary>
/// 408 Client error: Server got impatient with client and decided to give up waiting for the client's request to arrive
/// </summary>
ClientErrorRequestTimeout = 408,
/// <summary>
/// 409 Client error: Server could not fulfill the request for a resource as there is a conflict with the current state of the resource but thinks client can do something about this
/// </summary>
ClientErrorConflict = 409,
/// <summary>
/// 410 Client error: The resource has moved somewhere else, but server has no clue where.
/// </summary>
ClientErrorGone = 410,
/// <summary>
/// 411 Client error: The server is picky again and insists on having a content-length header field in the request
/// </summary>
ClientErrorLengthRequired = 411,
/// <summary>
/// 412 Client error: one or more preconditions supplied in the client's request is false
/// </summary>
ClientErrorPreconditionFailed = 412,
/// <summary>
/// 413 Client error: For fear of reflux, the server refuses to swallow that much data.
/// </summary>
ClientErrorRequestEntityToLarge = 413,
/// <summary>
/// 414 Client error: The server considers the Request-URI to be indecently long and refuses to even look at it.
/// </summary>
ClientErrorRequestURITooLong = 414,
/// <summary>
/// 415 Client error: The server has no clue about the media type requested by the client (contrary to popular belief it is not a warez server)
/// </summary>
ClientErrorUnsupportedMediaType = 415,
/// <summary>
/// 416 Client error: The requested range cannot be delivered by the server.
/// </summary>
ClientErrorRequestRangeNotSatisfiable = 416, ClientErrorRequestRangeNotSatisfiable = 416,
// 417 Client error: The expectations of the client as
// expressed in one or more Expect header fields cannot be met
// by the server, the server is awfully sorry about this.
ClientErrorExpectationFailed = 417,
// 499 Client error: Wildcard error.
ClientErrorJoker = 499,
// 5xx Server errors (rare) /// <summary>
// 500 Server error: something really strange and unexpected /// 417 Client error: The expectations of the client as expressed in one or more Expect header fields cannot be met by the server, the server is awfully sorry about this.
// happened /// </summary>
ServerErrorInternalError = 500, ClientErrorExpectationFailed = 417,
// 501 Server error: The server does not do the functionality
// required to carry out the client request. not at /// <summary>
// all. certainly not before breakfast. but also not after /// 499 Client error: Wildcard error.
// breakfast. /// </summary>
ServerErrorNotImplemented = 501, ClientErrorJoker = 499,
// 502 Server error: While acting as a proxy or a gateway, the
// server got ditched by the upstream server and as a #endregion
// consequence regretfully cannot fulfill the client's request
ServerErrorBadGateway = 502, #region 5xx Server errors (rare)
// 503 Server error: Due to unforseen circumstances the server
// cannot currently deliver the service requested. Retry-After /// <summary>
// header might indicate when to try again. /// 500 Server error: something really strange and unexpected happened
ServerErrorServiceUnavailable = 503, /// </summary>
// 504 Server error: The server blames the upstream server ServerErrorInternalError = 500,
// for not being able to deliver the service requested and
// claims that the upstream server is too slow delivering the /// <summary>
// goods. /// 501 Server error: The server does not do the functionality required to carry out the client request. not at all. certainly not before breakfast. but also not after breakfast.
ServerErrorGatewayTimeout = 504, /// </summary>
// 505 Server error: The server does not support the HTTP ServerErrorNotImplemented = 501,
// version conveyed in the client's request.
ServerErrorHttpVersionNotSupported = 505, /// <summary>
/// 502 Server error: While acting as a proxy or a gateway, the server got ditched by the upstream server and as a consequence regretfully cannot fulfill the client's request
/// </summary>
ServerErrorBadGateway = 502,
/// <summary>
/// 503 Server error: Due to unforseen circumstances the server cannot currently deliver the service requested. Retry-After header might indicate when to try again.
/// </summary>
ServerErrorServiceUnavailable = 503,
/// <summary>
/// 504 Server error: The server blames the upstream server for not being able to deliver the service requested and claims that the upstream server is too slow delivering the goods.
/// </summary>
ServerErrorGatewayTimeout = 504,
/// <summary>
/// 505 Server error: The server does not support the HTTP version conveyed in the client's request.
/// </summary>
ServerErrorHttpVersionNotSupported = 505,
#endregion
} }
} }