https://github.com/tbertuzzi/xamarin.helpers
:package: Extensions for HttpClient, Objects, Tasks and image manipulation.
https://github.com/tbertuzzi/xamarin.helpers
Last synced: 6 months ago
JSON representation
:package: Extensions for HttpClient, Objects, Tasks and image manipulation.
- Host: GitHub
- URL: https://github.com/tbertuzzi/xamarin.helpers
- Owner: TBertuzzi
- Created: 2018-08-16T13:46:39.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2019-09-10T13:05:52.000Z (about 6 years ago)
- Last Synced: 2025-04-14T16:08:47.717Z (6 months ago)
- Language: C#
- Homepage:
- Size: 371 KB
- Stars: 3
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Xamarin.Helpers
Extensions for HttpClient, Objects, Tasks and image manipulation.
###### This is the component, works on iOS, Android and UWP.
**NuGet**
|Name|Info|
| ------------------- | :------------------: |
|Xamarin.Helpers|[](https://www.nuget.org/packages/Xamarin.Helpers/)|
**Platform Support**
Xamarin.Helpers is a .NET Standard 2.0 library.Can be used with Xamarin and Xamarin.Forms.
## Setup / Usage
There are no initial settings. Simply import the package into the shared project only to enable the extensions.
**HttpClient Extensions**
Extensions to make using HttpClient easy.
To enable :
```csharp
using HttpExtension;
```
* GetAsync : Gets the return of a Get Rest and converts to the object or collection of pre-defined objects.
You can use only the path of the rest method, or pass a parameter dictionary. In case the url has parameters.
```csharp
public static async Task> GetAsync(this HttpClient httpClient, string address);
public static async Task> GetAsync(this HttpClient httpClient, string address,
Dictionary values);
```
* PostAsync : Use post service methods rest asynchronously and return objects if necessary.
```csharp
public static async Task PostAsync(this HttpClient httpClient,string address, object dto);
public static async Task> PostAsync(this HttpClient httpClient, string address, object dto);
```
* ServiceResponse : Object that facilitates the return of requests Rest. It returns the Http code of the request, already converted object and the contents in case of errors.
```csharp
public class ServiceResponse
{
public HttpStatusCode StatusCode { get; private set; }
public T Value { get; set; }
public string Content { get; set; }
public Exception Error { get; set; }
}
```
Example of use :
```csharp
public async Task> GetTodos()
{
try
{
//GetAsync Return with Object
var response = await _httpClient.GetAsync>("todos");
if (response.StatusCode == HttpStatusCode.OK)
{
return response.Value;
}
else
{
throw new Exception(
$"HttpStatusCode: {response.StatusCode.ToString()} Message: {response.Content}");
}
}
catch (Exception ex)
{
throw new Exception(ex.Message);
}
}
```
**Object Extensions**
Copy the equal properties from one object to another. Useful for converting rest objects to those of your app.
A simple cast extension for objetcs.
Example of use :
```csharp
private async void LoadTodo()
{
SampleService sampleService = new SampleService();
//Set Timeout on task
var todosResult = await sampleService.GetTodos().WithTimeout(5000);
foreach (var todo in todosResult)
{
//Cast Extension
Todos.Add(todo.Cast());
}
}
```
**Task Extensions**
Adds a possibility of timeout on your tasks. Based on MVVM Helpers by James Montemagno (https://github.com/jamesmontemagno/mvvm-helpers).
Example of use :
```csharp
var todosResult = await sampleService.GetTodos().WithTimeout(5000);
```
**Image Helpers**
Methods of manipulation of images obtained through a url
```csharp
public static Stream GetImageStreamFromUrl(string url);
public static byte[] GetImageByteFromUrl(string url);
public static string ConvertToBase64(Stream stream);
public static byte[] ConvertToByteArray(Stream stream);
```
The complete example can be downloaded here: https://github.com/TBertuzzi/Xamarin.Helpers/tree/master/Xamarin.Helpers.Sample