/// <summary>
/// Send a RESTful HTTP request. All exceptions are thrown to the caller.
/// </summary>
/// <param name="URL">The URL to which the request should be sent.</param>
/// <param name="ContentType">The type of content contained in Data (the request body).</param>
/// <param name="Method">The HTTP verb to use for this request (GET, PUT, POST, DELETE, HEAD).</param>
/// <param name="User">The HTTP user authorization field data.</param>
/// <param name="Password">The HTTP password authorization field data.</param>
/// <param name="EncodeCredentials">Specify whether or not credentials should be encoded in the HTTP authorization header.</param>
/// <param name="UserHeaders">Supply any custom or user-specified headers.</param>
/// <param name="Data">A byte array containing the data you wish to send to the server (does not work with GET requests).</param>
/// <returns>A RestResponse object containing response data.</returns>
public static RestResponse SendRequest(
string URL,
string ContentType,
string Method,
string User,
string Password,
bool EncodeCredentials,
Dictionary<string, string> UserHeaders,
byte[] Data
)
{
#region Check-for-Null-Values
if (String.IsNullOrEmpty(URL)) throw new ArgumentNullException(nameof(URL));
if (String.IsNullOrEmpty(URL)) throw new ArgumentNullException(nameof(Method));
#endregion
#region Check-Method
if ((String.Compare(Method.ToLower().Trim(), "head") != 0) &&
(String.Compare(Method.ToLower().Trim(), "get") != 0) &&
(String.Compare(Method.ToLower().Trim(), "post") != 0) &&
(String.Compare(Method.ToLower().Trim(), "put") != 0) &&
(String.Compare(Method.ToLower().Trim(), "delete") != 0))
{
throw new ArgumentOutOfRangeException(nameof(Method));
}
#endregion
#region Setup-Webrequest
HttpWebRequest client = (HttpWebRequest)WebRequest.Create(URL);
client.KeepAlive = false;
client.Method = Method.ToUpper().Trim();
client.AllowAutoRedirect = true;
client.Timeout = 30000;
client.ContentLength = 0;
client.ContentType = ContentType;
#endregion
#region Add-Headers
if (UserHeaders != null && UserHeaders.Count > 0)
{
foreach (KeyValuePair<string, string> pair in UserHeaders)
{
if (String.IsNullOrEmpty(pair.Key)) continue;
if (String.IsNullOrEmpty(pair.Value)) continue;
if (String.Compare(pair.Key.ToLower().Trim(), "accept") == 0)
{
client.Accept = pair.Value;
continue;
}
if (String.Compare(pair.Key.ToLower().Trim(), "content-type") == 0)
{
client.ContentType = pair.Value;
continue;
}
if (String.Compare(pair.Key.ToLower().Trim(), "host") == 0)
{
client.Host = pair.Value;
}
client.Headers.Add(pair.Key, pair.Value);
}
}
#endregion
#region Add-Auth-Info
if (!String.IsNullOrEmpty(User))
{
if (EncodeCredentials)
{
string authInfo = User + ":" + Password;
authInfo = Convert.ToBase64String(Encoding.Default.GetBytes(authInfo));
client.Headers.Add("Authorization", "Basic " + authInfo);
}
else
{
client.Headers.Add("Authorization", User);
}
}
#endregion
#region Package-Payload
if ((String.Compare(Method.ToLower().Trim(), "post") == 0) ||
(String.Compare(Method.ToLower().Trim(), "put") == 0) ||
(String.Compare(Method.ToLower().Trim(), "delete") == 0))
{
if (Data != null && Data.Length > 0)
{
client.ContentLength = Data.Length;
client.ContentType = ContentType;
Stream clientStream = client.GetRequestStream();
clientStream.Write(Data, 0, Data.Length);
clientStream.Close();
}
}
#endregion
#region Submit-Request-and-Build-Response
HttpWebResponse response = (HttpWebResponse)client.GetResponse();
RestResponse ret = new RestResponse();
ret.ContentEncoding = response.ContentEncoding;
ret.ContentType = response.ContentType;
ret.ContentLength = response.ContentLength;
ret.ResponseURI = response.ResponseUri.ToString();
ret.StatusCode = (int)response.StatusCode;
ret.StatusDescripion = response.StatusDescription;
#endregion
#region Headers
if (response.Headers != null)
{
if (response.Headers.Count > 0)
{
ret.Headers = new Dictionary<string, string>();
for (int i = 0; i < response.Headers.Count; i++)
{
string key = response.Headers.GetKey(i);
string val = "";
int valCount = 0;
foreach (string value in response.Headers.GetValues(i))
{
if (valCount == 0)
{
val += value;
valCount++;
}
else
{
val += "," + value;
valCount++;
}
}
ret.Headers.Add(key, val);
}
}
}
#endregion
#region Payload
Stream responseStream = response.GetResponseStream();
if (responseStream != null)
{
if (responseStream.CanRead)
{
ret.Data = StreamToBytes(responseStream);
ret.ContentLength = ret.Data.Length;
responseStream.Close();
}
else
{
ret.Data = null;
ret.ContentLength = 0;
}
}
else
{
ret.Data = null;
ret.ContentLength = 0;
}
#endregion
return ret;
}
/// <summary>
/// Send a RESTful HTTP request. WebExceptions are managed and formed into a response object and are not thrown. Uncaught exceptions are thrown to the caller.
/// </summary>
/// <param name="URL"></param>
/// <param name="ContentType"></param>
/// <param name="Method"></param>
/// <param name="User"></param>
/// <param name="Password"></param>
/// <param name="EncodeCredentials"></param>
/// <param name="UserHeaders"></param>
/// <param name="Data"></param>
/// <returns></returns>
public static RestResponse SendRequestSafe(
string URL,
string ContentType,
string Method,
string User,
string Password,
bool EncodeCredentials,
Dictionary<string, string> UserHeaders,
byte[] Data
)
{
try
{
return SendRequest(URL, ContentType, Method, User, Password, EncodeCredentials, UserHeaders, Data);
}
catch (WebException we)
{
#region WebException
RestResponse resp = new RestResponse();
resp.Headers = null;
resp.ContentEncoding = null;
resp.ContentType = null;
resp.ContentLength = 0;
resp.ResponseURI = null;
resp.StatusCode = 0;
resp.StatusDescripion = null;
resp.Data = null;
HttpWebResponse exceptionResponse = we.Response as HttpWebResponse;
if (exceptionResponse != null)
{
resp.ContentEncoding = exceptionResponse.ContentEncoding;
resp.ContentType = exceptionResponse.ContentType;
resp.ContentLength = exceptionResponse.ContentLength;
resp.ResponseURI = exceptionResponse.ResponseUri.ToString();
resp.StatusCode = (int)exceptionResponse.StatusCode;
resp.StatusDescripion = exceptionResponse.StatusDescription;
if (exceptionResponse.Headers != null && exceptionResponse.Headers.Count > 0)
{
resp.Headers = new Dictionary<string, string>();
for (int i = 0; i < exceptionResponse.Headers.Count; i++)
{
string key = exceptionResponse.Headers.GetKey(i);
string val = "";
int valCount = 0;
foreach (string value in exceptionResponse.Headers.GetValues(i))
{
if (valCount == 0)
{
val += value;
valCount++;
}
else
{
val += "," + value;
valCount++;
}
}
resp.Headers.Add(key, val);
}
}
resp.Data = StreamToBytes(exceptionResponse.GetResponseStream());
}
return resp;
#endregion
}
catch (Exception e)
{
throw e;
}
}