Class HttpClientExtensions

Helper methods for IHttpClient.

Inheritance

Object

HttpClientExtensions

Inherited Members

Object.ToString()

Object.Equals(Object)

Object.Equals(Object, Object)

Object.ReferenceEquals(Object, Object)

Object.GetHashCode()

Object.GetType()

Object.MemberwiseClone()

Namespace: Unity.Cloud.Common

Syntax

public static class HttpClientExtensions

Methods

CreateUri(String)

Creates a from a specified String.

Declaration

public static Uri CreateUri(string uri)

Parameters

Type	Name	Description
String	uri	The String to convert.

Returns

Type	Description
Uri	The created .

DeleteAsync(IHttpClient, String, HttpContent, CancellationToken)

Sends an asynchronous DELETE request to the specified Uri.

Declaration

public static Task<HttpResponseMessage> DeleteAsync(this IHttpClient httpClient, string requestUri, HttpContent content, CancellationToken cancellationToken = default(CancellationToken))

Parameters

Type	Name	Description
IHttpClient	httpClient	The HTTP client.
String	requestUri	The uri for the request.
HttpContent	content	The HTTP content for the request.
CancellationToken	cancellationToken	The cancellation token.

Returns

Type	Description
Task<HttpResponseMessage>	An HttpResponseMessage.

DeleteAsync(IHttpClient, String, CancellationToken)

Sends an asynchronous DELETE request to the specified Uri.

Declaration

public static Task<HttpResponseMessage> DeleteAsync(this IHttpClient httpClient, string requestUri, CancellationToken cancellationToken = default(CancellationToken))

Parameters

Type	Name	Description
IHttpClient	httpClient	The HTTP client.
String	requestUri	The uri for the request.
CancellationToken	cancellationToken	The cancellation token.

Returns

Type	Description
Task<HttpResponseMessage>	An HttpResponseMessage.

DeleteAsync(IHttpClient, Uri, HttpContent, CancellationToken)

Sends an asynchronous DELETE request to the specified Uri.

Declaration

public static Task<HttpResponseMessage> DeleteAsync(this IHttpClient httpClient, Uri requestUri, HttpContent content, CancellationToken cancellationToken = default(CancellationToken))

Parameters

Type	Name	Description
IHttpClient	httpClient	The HTTP client.
Uri	requestUri	The uri for the request.
HttpContent	content	The HTTP content for the request.
CancellationToken	cancellationToken	The cancellation token.

Returns

Type	Description
Task<HttpResponseMessage>	An HttpResponseMessage.

DeleteAsync(IHttpClient, Uri, CancellationToken)

Sends an asynchronous DELETE request to the specified Uri.

Declaration

public static Task<HttpResponseMessage> DeleteAsync(this IHttpClient httpClient, Uri requestUri, CancellationToken cancellationToken = default(CancellationToken))

Parameters

Type	Name	Description
IHttpClient	httpClient	The HTTP client.
Uri	requestUri	The uri for the request.
CancellationToken	cancellationToken	The cancellation token.

Returns

Type	Description
Task<HttpResponseMessage>	An HttpResponseMessage.

GetAsync(IHttpClient, String, CancellationToken)

Sends an asynchronous GET request to the specified Uri.

Declaration

public static Task<HttpResponseMessage> GetAsync(this IHttpClient httpClient, string requestUri, CancellationToken cancellationToken = default(CancellationToken))

Parameters

Type	Name	Description
IHttpClient	httpClient	The HTTP client.
String	requestUri	The uri for the request.
CancellationToken	cancellationToken	The cancellation token.

Returns

Type	Description
Task<HttpResponseMessage>	An HttpResponseMessage.

GetAsync(IHttpClient, Uri, CancellationToken)

Sends an asynchronous GET request to the specified Uri.

Declaration

public static Task<HttpResponseMessage> GetAsync(this IHttpClient httpClient, Uri requestUri, CancellationToken cancellationToken = default(CancellationToken))

Parameters

Type	Name	Description
IHttpClient	httpClient	The HTTP client.
Uri	requestUri	The uri for the request.
CancellationToken	cancellationToken	The cancellation token.

Returns

Type	Description
Task<HttpResponseMessage>	An HttpResponseMessage.

PostAsync(IHttpClient, String, HttpContent, String, CancellationToken)

Sends an asynchronous POST request to the specified Uri.

Declaration

public static Task<HttpResponseMessage> PostAsync(this IHttpClient httpClient, string requestUri, HttpContent content, string downloadFilePath = null, CancellationToken cancellationToken = default(CancellationToken))

Parameters

Type	Name	Description
IHttpClient	httpClient	The HTTP client.
String	requestUri	The uri for the request.
HttpContent	content	The HTTP content for the request.
String	downloadFilePath	The path for the downloaded file.
CancellationToken	cancellationToken	The cancellation token.

Returns

Type	Description
Task<HttpResponseMessage>	An HttpResponseMessage.

PostAsync(IHttpClient, Uri, HttpContent, String, CancellationToken)

Sends an asynchronous POST request to the specified Uri.

Declaration

public static Task<HttpResponseMessage> PostAsync(this IHttpClient httpClient, Uri requestUri, HttpContent content, string downloadFilePath = null, CancellationToken cancellationToken = default(CancellationToken))

Parameters

Type	Name	Description
IHttpClient	httpClient	The HTTP client.
Uri	requestUri	The uri for the request.
HttpContent	content	The HTTP content for the request.
String	downloadFilePath	The path for the downloaded file.
CancellationToken	cancellationToken	The cancellation token.

Returns

Type	Description
Task<HttpResponseMessage>	An HttpResponseMessage.

PutAsync(IHttpClient, String, HttpContent, CancellationToken)

Sends an asynchronous PUT request to the specified Uri.

Declaration

public static Task<HttpResponseMessage> PutAsync(this IHttpClient httpClient, string requestUri, HttpContent content, CancellationToken cancellationToken = default(CancellationToken))

Parameters

Type	Name	Description
IHttpClient	httpClient	The HTTP client.
String	requestUri	The uri for the request.
HttpContent	content	The HTTP content for the request.
CancellationToken	cancellationToken	The cancellation token.

Returns

Type	Description
Task<HttpResponseMessage>	An HttpResponseMessage.

PutAsync(IHttpClient, Uri, HttpContent, CancellationToken)

Sends an asynchronous PUT request to the specified Uri.

Declaration

public static Task<HttpResponseMessage> PutAsync(this IHttpClient httpClient, Uri requestUri, HttpContent content, CancellationToken cancellationToken = default(CancellationToken))

Parameters

Type	Name	Description
IHttpClient	httpClient	The HTTP client.
Uri	requestUri	The uri for the request.
HttpContent	content	The HTTP content for the request.
CancellationToken	cancellationToken	The cancellation token.

Returns

Type	Description
Task<HttpResponseMessage>	An HttpResponseMessage.

WithApiSourceHeaders(IHttpClient, String, String)

Creates an instance of Unity.Cloud.Common.HttpClientHeaderModifier which adds the API source headers to each request.

Declaration

public static IHttpClient WithApiSourceHeaders(this IHttpClient baseHttpClient, string name, string version)

Parameters

Type	Name	Description
IHttpClient	baseHttpClient	The client for which to modify the request headers.
String	name	The API source name.
String	version	The API source version.

Returns

Type	Description
IHttpClient	The created Unity.Cloud.Common.HttpClientHeaderModifier.

Exceptions

Type	Condition
ArgumentNullException	Thrown is name or version are null or empty.

WithApiSourceHeadersFromAssembly(IHttpClient, Assembly)

Creates an instance of Unity.Cloud.Common.HttpClientHeaderModifier which adds the API source headers to each request. The source values are retrieved from the ApiSourceVersionAttribute which must be defined in the calling Assembly.

Declaration

public static IHttpClient WithApiSourceHeadersFromAssembly(this IHttpClient baseHttpClient, Assembly assembly)

Parameters

Type	Name	Description
IHttpClient	baseHttpClient	The client for which to modify the request headers.
Assembly	assembly	The target assembly.

Returns

Type	Description
IHttpClient	The created Unity.Cloud.Common.HttpClientHeaderModifier.

Remarks

An instance of the ApiSourceVersionAttribute must be defined at the assembly-level in the calling Assembly in order for the correct API source values to be added as a header.

Exceptions

Type	Condition
ArgumentNullException	Thrown if assembly is null or the name or version defined in the retrieved ApiSourceVersionAttribute are null or white space.
InvalidOperationException	Thrown if ApiSourceVersionAttribute does not exist or is not initialized in the calling assembly.
InvalidArgumentException	Thrown if ApiSourceVersionAttribute is initialized with null or empty values in the calling assembly.