NDW

アプリ開発やトラブルシューティング等のノウハウ、キャンプや登山の紹介や体験談など。

1. システムエンジニアリング ASP.NET Core 実装技術

ASP.NET Core: IHttpClientFactoryの単純サンプル

投稿日:2020年5月16日 更新日:


IHttpClientの使い方やサンプルの記事を書きましたが、後から見るとちょっと量が多いと感じました。
とりあえず動かしてみたい、概略を知りたい、急いでいる等の人向けに、もっと単純なサンプルを用意してみました。
冒頭の「IHttpClientの使い方やサンプルの記事」については下記をご覧ください。

使い方の要点

単純なサンプル

ASP.NET CoreのコントローラからIHttpClientFactoryを使ってWebAPIを実行するサンプルになります。

  1. サービス登録
    IHttpClientFactoryを使ってHttpClientクライアントを使う方法は、既定のクライアントを使う方法、名前付きクライアントを使う方法、型付きクライアントを使う方法等があります。
    その中で最も単純な「既定のクライアント」を使う場合、次のようにAddHttpClient()を宣言するのみです。
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddControllersWithViews();
    
        services.AddHttpClient();
    ...
    
  2. GET/POSTの実行
    IHttpClientFactoryは「依存関係の注入」で使用するため、コンストラクタの引数で指定します。
    HTTP要求を送信する場合、汎用的なHttpClient.SendAsync()を使う方法、シンプルなGetAsync(), PostAsync()等を使う方法があります。ここではシンプルな後者の方法で記載しています。
    public class HomeController : Controller
    {
    
        private readonly IHttpClientFactory _factory;
    
        private readonly ILogger<HomeController> _logger;
    
        public HomeController(
            IHttpClientFactory factory, 
            ILogger<HomeController> logger)
        {
            _factory = factory;
            _logger = logger;
        }
    
        public IActionResult Index()
        {
            return View();
        }
    
        public async Task<IActionResult> DoGet()
        {
            // HTTP要求の実行
            HttpClient client = _factory.CreateClient();
            HttpResponseMessage response = 
                await client.GetAsync("https://localhost:44372/api/ApiTest?param1=abc&param2=xyz");
    
            // ApiTestから取得した応答をテキストとして応答
            return Content(await response.Content.ReadAsStringAsync(), "text/plain");
        }
    
        public async Task<IActionResult> DoPost()
        {
            // フォームデータの作成
            var values = new Dictionary<string, string>();
            values.Add("param1", "123");
            values.Add("param2", "234");
            HttpContent content = new FormUrlEncodedContent(values);
    
            // HTTP要求の実行
            HttpClient client = _factory.CreateClient();
            HttpResponseMessage response =
                await client.PostAsync("https://localhost:44372/api/ApiTest", content);
    
            // ApiTestから取得した応答をテキストとして応答
            string responseBody = await response.Content.ReadAsStringAsync();
            return Content(responseBody, "text/plain");
        }
    
    }
    
  3. 参考:WebAPIのサンプル

    前述のIHttpClientFactory/HttpClientの接続先として使っているWebAPIも載せておきます。
    これらのWebAPIのURLはhttps://localhost:44372/api/ApiTestであり、GET/POSTに対応しています。
    GETの場合、クエリパラメータをJSONに格納して応答します。
    POSTの場合、フォーム内容をJSONに格納して応答します。

    
    [Route("api/[controller]")]
    public class ApiTestController : Controller
    {
        private ILogger<ApiTestController> _logger;
    
        public ApiTestController(ILogger<ApiTestController> logger)
        {
            _logger = logger;
        }
    
        [HttpGet]
        public IActionResult Get([FromQuery]string param1, [FromQuery]string param2)
        {
            _logger.LogDebug("Get() is invoked!");
    
            var dic = new Dictionary<string, string>();
            dic.Add("from", "ApiTest.Get()");
            dic.Add("param1", param1);
            dic.Add("param2", param2);
            return Json(dic);
        }
    
        [HttpPost]
        public IActionResult Post([FromForm]string param1, [FromForm]string param2)
        {
            _logger.LogDebug("Post() is invoked!");
    
            var dic = new Dictionary<string, string>();
            dic.Add("from", "ApiTest.Post()");
            dic.Add("param1", param1);
            dic.Add("param2", param2);
            return Json(dic);
        }
    
    }
    






-1. システムエンジニアリング, ASP.NET Core, 実装技術

関連記事

おすすめキーボード: MX Keys(KX800)レビュー

キーが浅く指の移動が最小限で抑えられ、多少打鍵位置がずれても正確に押せるので、入力がとても楽で、肩こりや首の痛みが軽減されました。また、在宅勤務用PCや副業用PC等の複数PCの切り替えをキーボードから …

SLF4Jの仕組みと使用方法

何気に使用しているSLF4Jの仕様やその仕組みを整理したいと思います。 前提 元ネタはSLF4J Manualサイトです。 2021年1月時点でSLF4Jは2.0系、1.8系、1.7系の3つがあります …

OfficeアプリのコントロールはPowerShellかVBAか?

Windowsサーバの監視のお仕事での話です。 月次で各サーバのパフォーマンスモニタのログファイル(.blg)が送られてきます。このデータ群から、各種のグラフや表を作成して、PowerPointでそれ …

Windows Updateが終わらない問題

ふと会社で使っているPCのWindows Updateがほとんど当たっていないことに気づいた。 手動でWindows Updateを実行すると、30分、1時間たっても終わらない… これは何 …

Java正規表現によるパラメータ置換

mybatis-generatorが生成するクエリカスタマイズのために、生成されたクエリ上のパラメータを置換する方法を調べたので記載しておきます。 サンプルプログラム Java言語の場合、標準ライブラ …