Nrk.HttpRequester

Library for sending Http Requests, including a fluent interface for creating HttpClient instances

Why

This library tries to solve the common issues with HttpClient, by giving an easy way to set up an HttpClient that can be re-used through the life of an application.

The recommended usage of HttpClient is not to dispose it after every request. It indirectly implements the IDisposable interface, which can explain the misunderstanding. Instantiating an HttpClient for every request can possible exhaust the number of sockets available under heavy loads. Microsoft patterns & practices goes into detail on this issue.

A re-usable HttpClient introduces the risk of not honoring DNS changes. We try to fix this by setting the ConnectionLeaseTimeout for the Service Endpoint, which is by default infinite.

Usage

Set up WebRequester with baseUrl:

var httpClient = WebRequestHttpClientFactory
    .Configure(new Uri("www.yourBaseUrl.com"))
    .Create()
var webRequester = new WebRequester(httpClient);

The WebRequestHttpClientFactory uses a fluent interface, which can be used to set Timeout, DefaultRequestheaders, DelegatingHandler and DelegatingHandlers for caching.

var httpClient = WebRequestHttpClientFactory
    .Configure(new Uri("www.yourBaseUrl.com"))
    .WithDefaultRequestHeaders(new Dictionary<string, string> {{"header", "value"}})
    .WithHandler(yourHandler)
    .WithConnectionLeaseTimeout(60000)
    .Create()
var webRequester = new WebRequester(httpClient);

The following methods are available from IWebRequester:

        Task<string> GetResponseAsStringAsync(string url, int retries = 0);
        Task<string> GetResponseAsStringAsync(string pathTemplate, NameValueCollection parameters, int retries = 0);
        Task<HttpResponseMessage> GetResponseAsync(string url, int retries = 0);
        Task<HttpResponseMessage> GetResponseAsync(string pathTemplate, NameValueCollection parameters, int retries = 0);

You can either send a path example/path/123 or a URI Template string with matching parameters in a NameValueCollection:

var response = webRequester.GetResponseAsync(
        "example/path/{id}",
        new NameValueCollection { { "id", "123" } }
    );

Contributing

Building and packaging

Use build.cmd to run our FAKE build script. This will restore NuGet packages, build the project, run the tests and create a NuGet package.

Code style

Make sure your editor has support for .editorconfig files (http://editorconfig.org/), or use the same formatting as specified in the file.

Versioning

Versioning of the NuGet package adhers to the Semantic Versioning 2.0 standard:

Given a version number MAJOR.MINOR.PATCH, increment the:

1. MAJOR version when you make incompatible API changes,
2. MINOR version when you add functionality in a backwards-compatible manner, and
3. PATCH version when you make backwards-compatible bug fixes.

Additional labels for pre-release and build metadata are available as extensions to the MAJOR.MINOR.PATCH format.

License

MIT