This package supports
API definition with interface
Auto generating implementation using Castle.Core
Attribute routing
Asynchronous implementation
Action Filters
Sinch WebApiClient is © 2015 Sinch AB. It is free software, and may be redistributed under the terms of the MIT license.
Map methods, reguest and response using an interface.
public interface IEchoApi
{
[HttpGet("echo/{name}")]
Task<string> Echo(string name);
}An implementation is generated for the defined interface using Castle.Core dynamic proxy.
var factory = new WebApiClientFactory();
var echoApi = factory.CreateClient<IEchoApi>("http://127.0.0.1:4711");
var echoResult = await echoApi.Echo("Hello world!");
Console.WriteLine(echoResult);Routing is performed similar to WebApi Controllers.
public interface IAttributeRoutingApi
{
[HttpGet("products")]
Task<ProductList> GetAll();
[HttpGet("products/{id}")]
Task<Product> GetById(string id);
[HttpPost("products/{id}")]
Task UpdateById(string id, Product product);
[HttpDelete("products/{id}")]
Task DeleteById(string id);
}Also support [ToUri] and [ToBody] attribute routing.
public class Name
{
public string First { get; set; }
public string Last { get; set; }
}
public interface IUserApi
{
[
6CDA
HttpGet("users/{last}/{first}")]
public Task<UserList> QueryByName([ToUri] Name name);
}Action filters are hooks into pre/post processing. The request can be modified in OnActionExecuting and the response can be accessed before it is processed in OnActionExecuted
public class ConsoleLoggerActionFilter : IActionFilter
{
public Task OnActionExecuting(HttpRequestMessage requestMessage)
{
Console.WriteLine($"[{requestMessage.Method}] {requestMethod.RequestUri}");
return Task.FromResult(true);
}
public Task OnActionExecuted(HttpResponseMessage responseMessage)
{
Console.WriteLine($"[{responseMessage.StatusCode} {responseMessage.ReasonPhrase}]");
return Task.FromResult(true);
}
}
var factory = new WebApiClientFactory();
var echoApi = factory.CreateClient<IEchoApi>("http://127.0.0.1:4711", new ConsoleLoggerActionFilter());
var echoResult = await echoApi.Echo("Hello world!");
Console.WriteLine(echoResult);And that's all, folks. If you have any questions, email us at support@sinch.com.