■ HttpClientBuilderExtensions 클래스의 SetHandlerLifetime 확장 메소드를 사용해 HttpMessageHandler 인스턴스 수명을 설정하는 방법을 보여준다.
▶ Startup.cs
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 |
using Microsoft.AspNetCore.Builder; using Microsoft.AspNetCore.Hosting; using Microsoft.Extensions.Configuration; using Microsoft.Extensions.DependencyInjection; using Microsoft.Extensions.Hosting; using System; namespace TestProject { /// <summary> /// 시작 /// </summary> public class Startup { //////////////////////////////////////////////////////////////////////////////////////////////////// Property ////////////////////////////////////////////////////////////////////////////////////////// Public #region 구성 - Configuration /// <summary> /// 구성 /// </summary> public IConfiguration Configuration { get; } #endregion //////////////////////////////////////////////////////////////////////////////////////////////////// Constructor ////////////////////////////////////////////////////////////////////////////////////////// Public #region 생성자 - Startup(configuration) /// <summary> /// 생성자 /// </summary> /// <param name="configuration">구성</param> public Startup(IConfiguration configuration) { Configuration = configuration; } #endregion //////////////////////////////////////////////////////////////////////////////////////////////////// Method ////////////////////////////////////////////////////////////////////////////////////////// Public #region 서비스 컬렉션 구성하기 - ConfigureServices(services) /// <summary> /// 서비스 컬렉션 구성하기 /// </summary> /// <param name="services">서비스 컬렉션</param> public void ConfigureServices(IServiceCollection services) { services.AddHttpClient("test") .SetHandlerLifetime(TimeSpan.FromMinutes(5)); services.AddControllers(); services.AddRazorPages(); } #endregion #region 구성하기 - Configure(app, environment) /// <summary> /// 구성하기 /// </summary> /// <param name="app">애플리케이션 빌더</param> /// <param name="environment">웹 호스트 환경</param> public void Configure(IApplicationBuilder app, IWebHostEnvironment environment) { if(environment.IsDevelopment()) { app.UseDeveloperExceptionPage(); } else { app.UseExceptionHandler("/Error"); } app.UseRouting(); app.UseEndpoints ( endpoints => { endpoints.MapControllerRoute ( name : "default", pattern : "{controller=Home}/{action=Index}/{id?}" ); endpoints.MapRazorPages(); } ); } #endregion } } |
– IHttpClientFactory에서 CreateClient가 호출될 때마다 새로운 HttpClient 인스턴스가 반환된다.
– 명명된 클라이언트마다 HttpMessageHandler가 생성된다.
– 팩토리는 HttpMessageHandler 인스턴스의 수명을 관리한다.
– IHttpClientFactory는 리소스 사용을 줄이기 위해 팩토리에서 만든 HttpMessageHandler 인스턴스를 풀링한다.
– 수명이 만료되지 않은 경우, 새 HttpClient 인스턴스를 만들 때 풀에서 HttpMessageHandler 인스턴스가 재사용될 수 있다.
– 일반적으로 각 처리기는 자체적인 기본 HTTP 연결을 관리하므로 처리기의 풀링이 적합하다.
– 필요한 것보다 많은 처리기를 만들면 연결 지연이 발생할 수 있다.
– 또한 일부 처리기는 무한정으로 연결을 열어 놓아 처리기가 DNS(Domain Name System) 변경에 대응하는 것을 막을 수 있다.
– 기본 처리기 수명은 2분이다.
– 명명된 클라이언트별 기준으로 기본값을 재정의할 수 있다.
– HttpClient 인스턴스는 일반적으로 삭제가 필요하지 않은 .NET 개체로 간주할 수 있다.
– 삭제는 나가는 요청을 취소하고 Dispose를 호출한 후에는 지정된 HttpClient 인스턴스가 사용될 수 없도록 보장한다.
– IHttpClientFactory는 HttpClient 인스턴스에서 사용되는 리소스를 추적하고 삭제한다.
– 장기간 단일 HttpClient 인스턴스를 활성 상태로 유지하는 것은 IHttpClientFactory가 등장하기 전에 사용되던 일반적인 패턴이다.
– 이 패턴은 IHttpClientFactory로 마이그레이션한 이후에는 불필요하다.