From 7db4336f1cf612ac8694cd6bd20624d97cf4a7ff Mon Sep 17 00:00:00 2001
From: Justin Clark-Casey (justincc)
Date: Mon, 12 May 2014 22:05:02 +0100
Subject: minor: Add method doc to SynchronousRestObjectRequester.MakeRequest()
methods
---
OpenSim/Framework/WebUtil.cs | 32 +++++++++++++++++++++++++++-----
1 file changed, 27 insertions(+), 5 deletions(-)
diff --git a/OpenSim/Framework/WebUtil.cs b/OpenSim/Framework/WebUtil.cs
index 2a309a7..37ecd46 100644
--- a/OpenSim/Framework/WebUtil.cs
+++ b/OpenSim/Framework/WebUtil.cs
@@ -1085,21 +1085,43 @@ namespace OpenSim.Framework
/// </summary>
/// <param name="verb"></param>
/// <param name="requestUrl"></param>
- /// <param name="obj"> </param>
- /// <returns></returns>
- ///
- /// <exception cref="System.Net.WebException">Thrown if we encounter a network issue while posting
- /// the request. You'll want to make sure you deal with this as they're not uncommon</exception>
+ /// <param name="obj"></param>
+ /// <returns>
+ /// The response. If there was an internal exception, then the default(TResponse) is returned.
+ /// </returns>
public static TResponse MakeRequest<TRequest, TResponse>(string verb, string requestUrl, TRequest obj)
{
return MakeRequest<TRequest, TResponse>(verb, requestUrl, obj, 0);
}
+ /// <summary>
+ /// Perform a synchronous REST request.
+ /// </summary>
+ /// <param name="verb"></param>
+ /// <param name="requestUrl"></param>
+ /// <param name="obj"></param>
+ /// <param name="pTimeout">Request timeout in milliseconds.</param>
+ /// <returns>
+ /// The response. If there was an internal exception or the request timed out,
+ /// then the default(TResponse) is returned.
+ /// </returns>
public static TResponse MakeRequest<TRequest, TResponse>(string verb, string requestUrl, TRequest obj, int pTimeout)
{
return MakeRequest<TRequest, TResponse>(verb, requestUrl, obj, pTimeout, 0);
}
+ /// <summary>
+ /// Perform a synchronous REST request.
+ /// </summary>
+ /// <param name="verb"></param>
+ /// <param name="requestUrl"></param>
+ /// <param name="obj"></param>
+ /// <param name="pTimeout">Request timeout in milliseconds.</param>
+ /// <param name="maxConnections"></param>
+ /// <returns>
+ /// The response. If there was an internal exception or the request timed out,
+ /// then the default(TResponse) is returned.
+ /// </returns>
public static TResponse MakeRequest<TRequest, TResponse>(string verb, string requestUrl, TRequest obj, int pTimeout, int maxConnections)
{
int reqnum = WebUtil.RequestNumber++;
--
cgit v1.1