public void ConfigureServices(IServiceCollection services)
{
services.AddMvc();
// Configure our proxy however we want
var proxyConfiguration = ProxyConfigurationBuilder
.CreateBuilder()
.Build();
// You can either inject the ProxyConfiguration and new the proxy up each time yourself
// (We recommmend injecting as a singleton)
services.AddSingleton(proxyConfiguration);
// Or you can inject the proxy
services.AddSingleton <IProxy>(new Proxy(proxyConfiguration));
}
private static async Task MainAsync(string[] args)
{
using (var environment = ExampleEnvironment.Start())
{
var baseUri = environment.GetResourceWebService <Resource.Api.Startup>().BaseUri;
/*
* Configuring the proxy allows you to customize the proxy's behavior.
* For example, you can inject your own delegating handler into the
* request pipeline or set default request headers for every request!
*/
#region Setting a Default Request Header
// In order to configure the proxy, you need to create a ProxyConfiguration using the ProxyConfigurationBuilder
var proxyConfigurationBuilder = ProxyConfigurationBuilder.CreateBuilder();
/*
* The ProxyConfigurationBuilder exposes a few things to use that we can take
* advantage of for every request. For example, if we always want
* to Accept application/json, we can set the default Accept header to
* always be application/json
*/
proxyConfigurationBuilder.UseDefaultAcceptHeader(new MediaTypeWithQualityHeaderValue("application/json"));
// Now, we use the ProxyConfigurationBuilder.Build() to create a ProxyConfiguration
var proxyConfiguration = proxyConfigurationBuilder.Build();
// Now, you use the ProxyConfiguration when creating the Proxy to tell the Proxy how to be configured
using (var proxy = new Proxy(proxyConfiguration))
{
// Notice on this request we did not use the Accept() method to add an accept header
var proxyRequest = ProxyRequestBuilder <string[]>
.CreateBuilder(baseUri, HttpRequestMethod.Get)
.AppendToRoute("api/example")
.Build();
var proxyResponse = await proxy.InvokeAsync(proxyRequest).ConfigureAwait(false);
if (proxyResponse.IsSuccessfulStatusCode)
{
// Let's see what the accept header looks like
var requestHeaders = proxyResponse.RequestHeaders;
var acceptHeader = requestHeaders.Accept;
Console.WriteLine("The Accept Header Value:");
Console.WriteLine($"\t{acceptHeader}");
Console.WriteLine();
// Show the API response
var valuesArray = proxyResponse.ResponseDto;
Writer.WriteValues(valuesArray);
}
}
#endregion
Console.WriteLine("\n==========\n");
#region Overriding a Default Request Header
/*
* But what if we want application/xml as the default, but for a certain request we want application/json?
* Great question, you can use the ProxyRequest to override the ProxyConfiguration's default header values.
*/
proxyConfiguration = ProxyConfigurationBuilder.CreateBuilder()
// Setting the default Accept header to "application/xml"
.UseDefaultAcceptHeader(new MediaTypeWithQualityHeaderValue("application/xml"))
.Build();
using (var proxy = new Proxy(proxyConfiguration))
{
var proxyRequest = ProxyRequestBuilder <string[]>
.CreateBuilder(baseUri, HttpRequestMethod.Get)
.AppendToRoute("api/example")
// Override the default Accept header value
.Accept("application/json")
.Build();
var proxyResponse = await proxy.InvokeAsync(proxyRequest).ConfigureAwait(false);
if (proxyResponse.IsSuccessfulStatusCode)
{
// Let's see what the accept header looks like
var requestHeaders = proxyResponse.RequestHeaders;
var acceptHeader = requestHeaders.Accept;
Console.WriteLine("The Overriden Accept Header Value:");
Console.WriteLine($"\t{acceptHeader}");
Console.WriteLine();
// Show the API response
var valuesArray = proxyResponse.ResponseDto;
Writer.WriteValues(valuesArray);
}
}
#endregion
Console.WriteLine("\n==========\n");
#region Injecting Delegating Handlers
/*
* Another incredibly awesome thing we can do is inject a DelegatingHandler into the
* request pipeline of the Proxy. A DelegatingHandler sits between your request and
* the actual request out to the RESTful service. Think of it like a translator where
* you can give the translator a message, they can manipulate the message and send it
* to someone else. One really awesome thing you can do with Delegating Handlers is
* insert logging into your request pipeline!
*
* Note: The order of which you inject your Delegating Handlers matters. It is a
* First In First Out order (i.e. the first registered DelegatingHandler will execute first).
*/
proxyConfiguration = ProxyConfigurationBuilder
.CreateBuilder()
// Inject our LoggingDelegatingHandler
.AddDelegatingHandlers(new LoggingDelegatingHandler())
.UseDefaultAcceptHeader(new MediaTypeWithQualityHeaderValue("application/json"))
.Build();
using (var proxy = new Proxy(proxyConfiguration))
{
var proxyRequest = ProxyRequestBuilder <string[]>
.CreateBuilder(baseUri, HttpRequestMethod.Get)
.AppendToRoute("api/example")
.Build();
var proxyResponse = await proxy.InvokeAsync(proxyRequest).ConfigureAwait(false);
if (proxyResponse.IsSuccessfulStatusCode)
{
var valuesArray = proxyResponse.ResponseDto;
Writer.WriteValues(valuesArray);
}
}
#endregion
Console.WriteLine("\n==========\n");
#region Using Delegating Actions
/*
* Even cooler than Delegating Handlers are Delegating Actions. RestWell allows for
* you to specify an Action Delegate to be injected into the request pipeline. This
* allows you to inject logic into the request pipeline without having to extend
* and override the DelegatingHandler class yourself.
*
* Note: You can even mix and match Delegating Handlers and Delegating Actions.
* Just remember, though, they are injected in FIFO order.
*/
proxyConfiguration = ProxyConfigurationBuilder
.CreateBuilder()
// Inject our Delegating Actions
.AddDelegatingAction((request, _) =>
{
Console.WriteLine($"Delegating Action Picked Up Request:");
Console.WriteLine($"\tRequest Method: {request.Method.Method}");
Console.WriteLine($"\tAccept Header: {request.Headers.Accept}");
Console.WriteLine($"\tRequest URI: {request.RequestUri}");
Console.WriteLine();
}
)
.UseDefaultAcceptHeader(new MediaTypeWithQualityHeaderValue("application/json"))
.Build();
using (var proxy = new Proxy(proxyConfiguration))
{
var proxyRequest = ProxyRequestBuilder <string[]>
.CreateBuilder(baseUri, HttpRequestMethod.Get)
.AppendToRoute("api/example")
.Build();
var proxyResponse = await proxy.InvokeAsync(proxyRequest).ConfigureAwait(false);
if (proxyResponse.IsSuccessfulStatusCode)
{
var valuesArray = proxyResponse.ResponseDto;
Writer.WriteValues(valuesArray);
}
}
#endregion
}
Console.ReadKey();
}