This project is a fork of the original Google Maps Web Services API wrapper for .NET (https://github.com/maximn/google-maps), extended to include a minimal API using Fast Endpoints and a refactor of the HttpClient usage. By introducing a standalone project named HttpClientUtility, we've employed generics to decouple HttpClient management from the Google API mapping, enhancing modularity and maintainability.
Implemented a minimal API layer using Fast Endpoints to provide streamlined and efficient endpoint handling.
Introduced HttpClientUtility, a separate project to manage HttpClient instances using generics. This abstraction facilitates better resource management and simplifies interactions with the Google Maps API.
The new HttpClientUtility introduces a structured way to handle HTTP requests and responses, encapsulating them in generic types for easier and more flexible management. It uses an HttpResponseContent class to represent responses, with generics allowing for various content types. The utility includes methods for different HTTP verbs like GET, POST, PUT, and DELETE, simplifying client-server communication. Moreover, it employs an IHttpClientFactory for creating HttpClient instances, promoting efficient resource usage and lifecycle management. This design separates concerns between HTTP client management and Google API mapping, enhancing code maintainability.
HttpResponseContent
HttpResponseContent: A generic class that serves as a container for the response from an HTTP request. It includes information about the success or failure of the request, the status code, any error messages, and the response content itself.
- Purpose: Encapsulates the response from an HTTP request, including the status code, success status, content of the response, and any error messages.
- Usage: Instances of this class are created through the Success and Failure static methods, representing successful and failed HTTP responses, respectively.
HttpClientService
Acts as a wrapper around HttpClient, simplifying the process of sending HTTP requests and handling responses. It abstracts away some of the complexities associated with HttpClient, such as instance management, request configuration, and response parsing.
- Purpose: Provides a service for making HTTP requests using HttpClient, handling request execution, and processing responses.
- Usage: After instantiation with the necessary dependencies (IHttpClientFactory and IStringConverter), it offers methods for sending HTTP requests (GetAsync, PostAsync, PutAsync, DeleteAsync) and customizing the request timeout.
- Error Handling: Errors during request execution are captured and returned as part of the HttpResponseContent failure instance, including HTTP request exceptions, timeout exceptions, and other unexpected exceptions.
IStringConverter
An interface expected to provide methods for converting between strings and objects. It's used for serializing request payloads and deserializing response content. The actual implementation must be provided by the user of the HttpClientService.