Writing the same code repeatedly when processing HTTP requests is time-consuming and can introduce inconsistencies and maintenance issues. The HttpRequestExtensions class in DotNetTips.Spargine.Extensions provides reusable extension methods for common request-handling tasks, including reading request bodies, retrieving headers, extracting bearer tokens, validating content types, and constructing absolute URIs.

These methods include input validation and are supported by unit tests and performance benchmarks, helping you write cleaner, safer, and more maintainable HTTP request code.

Available Methods

The following methods are available in HttpRequestExtensions.

• AddRequestId()
  Adds a unique request identifier to the HTTP headers.
• GetAbsoluteUri()
  Builds the absolute URI from the request’s scheme, host, path base, path, and query string.
• GetBearerToken()
  Extracts the bearer token from the request’s Authorization header.
• GetHeaderValue(string headerName)
  Retrieves the value of a specific request header by name.
• GetRawBodyBytesAsync(CancellationToken cancellationToken)
  Asynchronously reads the request body stream and returns its raw contents as a byte array.
• GetRawBodyStringAsync(Encoding encoding, CancellationToken cancellationToken)
  Asynchronously reads the request body stream and returns its contents as a string using the specified encoding.
• HasJsonContentType()
  Determines whether the request uses the application/json content type.
• IsContentType(string contentType)
  Determines whether the request content type matches the specified value using an ordinal, case-insensitive comparison.
• TryGetBody<T>(out T? value)
  Attempts to deserialize the request body into an instance of T.
• TryGetBody(out byte[] value)
  Attempts to read the raw request body into a byte array.
• TryGetBody<T>(JsonTypeInfo<T> typeInfo, out T? value)
  Attempts to deserialize the request body into an instance of T using a source-generated JsonTypeInfo<T>. This overload supports trim-safe and AOT-compatible JSON deserialization.

Summary

The HttpRequestExtensions class simplifies common HTTP request operations while reducing repetitive code throughout your applications. Its methods make it easier to retrieve headers, inspect content types, read request bodies, extract authentication tokens, and deserialize JSON data.

For additional HTTP-related functionality, also explore Spargine’s HttpClientExtensions, HttpContextExtensions, and HttpResponseHeaderExtensions classes.

Pick up any books by David McCarter by going to Amazon.com: http://bit.ly/RockYourCodeBooks

If you liked this article, please buy David a cup of Coffee by going here: https://www.buymeacoffee.com/dotnetdave

© The information in this article is copywritten and cannot be reproduced in any way without express permission from David McCarter.