minor: add some more documentation for IHttpServer.AddHTTPHandler() to tell the caller that the best match for an incoming request URI is invoked

slimupdates
Justin Clark-Casey (justincc) 2010-03-11 23:33:55 +00:00
parent e844524b41
commit 2313d14acb
2 changed files with 7 additions and 5 deletions

View File

@ -202,16 +202,14 @@ namespace OpenSim.Framework.Servers.HttpServer
if (!m_pollHandlers.ContainsKey(methodName)) if (!m_pollHandlers.ContainsKey(methodName))
{ {
m_pollHandlers.Add(methodName,args); m_pollHandlers.Add(methodName,args);
pollHandlerResult = true; pollHandlerResult = true;
} }
} }
if (pollHandlerResult) if (pollHandlerResult)
return AddHTTPHandler(methodName, handler); return AddHTTPHandler(methodName, handler);
return false; return false;
} }
// Note that the agent string is provided simply to differentiate // Note that the agent string is provided simply to differentiate

View File

@ -47,7 +47,7 @@ namespace OpenSim.Framework.Servers.HttpServer
bool AddAgentHandler(string agent, IHttpAgentHandler handler); bool AddAgentHandler(string agent, IHttpAgentHandler handler);
/// <summary> /// <summary>
/// Add a handler for an HTTP request /// Add a handler for an HTTP request.
/// </summary> /// </summary>
/// ///
/// This handler can actually be invoked either as /// This handler can actually be invoked either as
@ -66,6 +66,10 @@ namespace OpenSim.Framework.Servers.HttpServer
/// or /// or
/// ///
/// http://localhost:9000/object/ /// http://localhost:9000/object/
///
/// In addition, the handler invoked by the HTTP server for any request is the one when best matches the request
/// URI. So if a handler for "/myapp/" is registered and a request for "/myapp/page" is received, then
/// the "/myapp/" handler is invoked if no "/myapp/page" handler exists.
/// ///
/// <param name="methodName"></param> /// <param name="methodName"></param>
/// <param name="handler"></param> /// <param name="handler"></param>