From 0d3d6764633e7412ff345f161748ebc87b2f715f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Halil=20=C4=B0brahim=20Kalkan?= Date: Fri, 15 Apr 2022 17:44:35 +0300 Subject: [PATCH] Added new document: Static-CSharp-API-Clients --- docs/en/API/Dynamic-CSharp-API-Clients.md | 12 +- docs/en/API/Static-CSharp-API-Clients.md | 217 ++++++++++++++++++ .../generated-static-client-proxies.png | Bin 0 -> 7118 bytes 3 files changed, 228 insertions(+), 1 deletion(-) create mode 100644 docs/en/API/Static-CSharp-API-Clients.md create mode 100644 docs/en/images/generated-static-client-proxies.png diff --git a/docs/en/API/Dynamic-CSharp-API-Clients.md b/docs/en/API/Dynamic-CSharp-API-Clients.md index 31032e6392..3ece459842 100644 --- a/docs/en/API/Dynamic-CSharp-API-Clients.md +++ b/docs/en/API/Dynamic-CSharp-API-Clients.md @@ -13,6 +13,12 @@ Dynamic C# proxies automatically handle the following stuff for you; This system can be used by any type of .NET client to consume your HTTP APIs. +## Static vs Dynamic Client Proxies + +ABP provides **two types** of client proxy generation system. This document explains the **dynamic client proxies**, which generates client-side proxies on runtime. You can also see the [Static C# API Client Proxies](Static-CSharp-API-Clients.md) documentation to learn how to generate proxies on development time. + +Development-time (static) client proxy generation has a **performance advantage** since it doesn't need to obtain the HTTP API definition on runtime. However, you should **re-generate** the client proxy code whenever you change your API endpoint definition. On the other hand, dynamic client proxies are generated on runtime and provides an **easier development experience**. + ## Service Interface Your service/controller should implement an interface that is shared between the server and the client. So, first define a service interface in a shared library project, typically in the `Application.Contracts` project if you've created your solution using the startup templates. @@ -72,7 +78,7 @@ public class MyClientAppModule : AbpModule ### Endpoint Configuration -`RemoteServices` section in the `appsettings.json` file is used to get remote service address by default. Simplest configuration is shown below: +`RemoteServices` section in the `appsettings.json` file is used to get remote service address by default. The simplest configuration is shown below: ```json { @@ -204,3 +210,7 @@ public override void PreConfigureServices(ServiceConfigurationContext context) ```` This example uses the [Microsoft.Extensions.Http.Polly](https://www.nuget.org/packages/Microsoft.Extensions.Http.Polly) package. You also need to import the `Polly` namespace (`using Polly;`) to be able to use the `WaitAndRetryAsync` method. + +## See Also + +* [Static C# Client Proxies](Static-CSharp-API-Clients.md) diff --git a/docs/en/API/Static-CSharp-API-Clients.md b/docs/en/API/Static-CSharp-API-Clients.md new file mode 100644 index 0000000000..a5996158b6 --- /dev/null +++ b/docs/en/API/Static-CSharp-API-Clients.md @@ -0,0 +1,217 @@ +# Static C# API Client Proxies + +ABP can create C# API client proxy code to call your remote HTTP services (REST APIs). In this way, you don't need to deal with `HttpClient` and other low level details to call remote services and get results. + +Static C# proxies automatically handle the following stuff for you; + +* Maps C# **method calls** to remote server **HTTP calls** by considering the HTTP method, route, query string parameters, request payload and other details. +* **Authenticates** the HTTP Client by adding access token to the HTTP header. +* **Serializes** to and deserialize from JSON. +* Handles HTTP API **versioning**. +* Add **correlation id**, current **tenant** id and the current **culture** to the request. +* Properly **handles the error messages** sent by the server and throws proper exceptions. + +This system can be used by any type of .NET client to consume your HTTP APIs. + +## Static vs Dynamic Client Proxies + +ABP provides **two types** of client proxy generation system. This document explains the **static client proxies**, which generates client-side code in your development time. You can also see the [Dynamic C# API Client Proxies](Dynamic-CSharp-API-Clients.md) documentation to learn how to use proxies generated on runtime. + +Development-time (static) client proxy generation has a **performance advantage** since it doesn't need to obtain the HTTP API definition on runtime. However, you should **re-generate** the client proxy code whenever you change your API endpoint definition. On the other hand, dynamic client proxies are generated on runtime and provides an **easier development experience**. + +## Service Interface + +Your service/controller should implement an interface that is shared between the server and the client. So, first define a service interface in a shared library project, typically in the `Application.Contracts` project if you've created your solution using the startup templates. + +Example: + +````csharp +public interface IBookAppService : IApplicationService +{ + Task> GetListAsync(); +} +```` + +> Your interface should implement the `IRemoteService` interface to be automatically discovered. Since the `IApplicationService` inherits the `IRemoteService` interface, the `IBookAppService` above satisfies this condition. + +Implement this class in your service application. You can use [auto API controller system](Auto-API-Controllers.md) to expose the service as a REST API endpoint. + +## Client Proxy Generation + +First, add [Volo.Abp.Http.Client](https://www.nuget.org/packages/Volo.Abp.Http.Client) nuget package to your client project: + +```` +Install-Package Volo.Abp.Http.Client +```` + +Then add `AbpHttpClientModule` dependency to your module: + +````csharp +[DependsOn(typeof(AbpHttpClientModule))] //add the dependency +public class MyClientAppModule : AbpModule +{ +} +```` + +Now, it's ready to configure the application for the static client proxy generation. Example: + +````csharp +[DependsOn( + typeof(AbpHttpClientModule), //used to create client proxies + typeof(BookStoreApplicationContractsModule) //contains the application service interfaces + )] +public class MyClientAppModule : AbpModule +{ + public override void ConfigureServices(ServiceConfigurationContext context) + { + // Prepare for static client proxy generation + context.Services.AddStaticHttpClientProxies( + typeof(BookStoreApplicationContractsModule).Assembly + ); + } +} +```` + +`AddStaticHttpClientProxies` method gets an assembly, finds all service interfaces in the given assembly, and prepares for static client proxy generation. + +> The [application startup template](../Startup-Templates/Application.md) comes pre-configured for the **dynamic** client proxy generation, in the `HttpApi.Client` project. If you want to switch to the **static** client proxies, change `context.Services.AddHttpClientProxies` to `context.Services.AddStaticHttpClientProxies` in the module class of your `HttpApi.Client` project. + +### Endpoint Configuration + +`RemoteServices` section in the `appsettings.json` file is used to get remote service address by default. The simplest configuration is shown below: + +```json +{ + "RemoteServices": { + "Default": { + "BaseUrl": "http://localhost:53929/" + } + } +} +``` + +See the *AbpRemoteServiceOptions* section below for more detailed configuration. + +### Code Generation + +Server side must be up and running while generating the client proxy code. So, run your application that serves the HTTP APIs on the `BaseUrl` that is configured like explained in the *Endpoint Configuration* section. + +Open a command-line terminal in the root folder of your client project (`.csproj`) and type the following command: + +````bash +abp generate-proxy -t csharp -u http://localhost:53929/ +```` + +> If you haven't installed yet, you should install the [ABP CLI](../CLI.md). + +This command should generate the following files under the `ClientProxies` folder: + +![generated-static-client-proxies](../images/generated-static-client-proxies.png) + +`BookClientProxy.Generated.cs` is the actual generated proxy class in this example. `BookClientProxy` is a `partial` class where you can write your custom code (ABP won't override it). `app-generate-proxy.json` contains information about the remote HTTP endpoint, so ABP can properly perform HTTP requests. + +> `generate-proxy` command generates proxies for only the APIs you've defined in your application. If you are developing a modular application, you can specify the `-m` (or `--module`) parameter to specify the module you want to generate proxies. See the *generate-proxy* section in the [ABP CLI](../CLI.md) documentation for other options. + +## Usage + +It's straightforward to use the client proxies. Just inject the service interface in the client application code: + +````csharp +public class MyService : ITransientDependency +{ + private readonly IBookAppService _bookService; + + public MyService(IBookAppService bookService) + { + _bookService = bookService; + } + + public async Task DoItAsync() + { + var books = await _bookService.GetListAsync(); + foreach (var book in books) + { + Console.WriteLine($"[BOOK {book.Id}] Name={book.Name}"); + } + } +} +```` + +This sample injects the `IBookAppService` service interface defined above. The static client proxy implementation makes an HTTP call whenever a service method is called by the client. + +## Configuration + +### AbpRemoteServiceOptions + +`AbpRemoteServiceOptions` is automatically set from the `appsettings.json` by default. Alternatively, you can configure it in the `ConfigureServices` method of your [module](../Module-Development-Basics.md) to set or override it. Example: + +````csharp +public override void ConfigureServices(ServiceConfigurationContext context) +{ + context.Services.Configure(options => + { + options.RemoteServices.Default = + new RemoteServiceConfiguration("http://localhost:53929/"); + }); + + //... +} +```` + +### Multiple Remote Service Endpoints + +The examples above have configured the "Default" remote service endpoint. You may have different endpoints for different services (as like in a microservice approach where each microservice has different endpoints). In this case, you can add other endpoints to your configuration file: + +````json +{ + "RemoteServices": { + "Default": { + "BaseUrl": "http://localhost:53929/" + }, + "BookStore": { + "BaseUrl": "http://localhost:48392/" + } + } +} +```` + +`AddStaticHttpClientProxies` method can get an additional parameter for the remote service name. Example: + +````csharp +context.Services.AddStaticHttpClientProxies( + typeof(BookStoreApplicationContractsModule).Assembly, + remoteServiceConfigurationName: "BookStore" +); +```` + +`remoteServiceConfigurationName` parameter matches the service endpoint configured via `AbpRemoteServiceOptions`. If the `BookStore` endpoint is not defined then it fallbacks to the `Default` endpoint. + +### Retry/Failure Logic & Polly Integration + +If you want to add retry logic for the failing remote HTTP calls for the client proxies, you can configure the `AbpHttpClientBuilderOptions` in the `PreConfigureServices` method of your module class. + +**Example: Use the [Polly](https://github.com/App-vNext/Polly) library to re-try 3 times on a failure** + +````csharp +public override void PreConfigureServices(ServiceConfigurationContext context) +{ + PreConfigure(options => + { + options.ProxyClientBuildActions.Add((remoteServiceName, clientBuilder) => + { + clientBuilder.AddTransientHttpErrorPolicy(policyBuilder => + policyBuilder.WaitAndRetryAsync( + 3, + i => TimeSpan.FromSeconds(Math.Pow(2, i)) + ) + ); + }); + }); +} +```` + +This example uses the [Microsoft.Extensions.Http.Polly](https://www.nuget.org/packages/Microsoft.Extensions.Http.Polly) package. You also need to import the `Polly` namespace (`using Polly;`) to be able to use the `WaitAndRetryAsync` method. + +## See Also + +* [Dynamic C# Client Proxies](Dynamic-CSharp-API-Clients.md) diff --git a/docs/en/images/generated-static-client-proxies.png b/docs/en/images/generated-static-client-proxies.png new file mode 100644 index 0000000000000000000000000000000000000000..4c1678aebd329b210673f4f247de5c00ac34417c GIT binary patch literal 7118 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 Q