requests.Session()のsession.mountについて

Question

Qiita記事にて、requestsについて調べていたのですが、分からない部分があった為、質問させて貰いました。

以下は、該当部分のコードになります

import requests
from urllib3.util import Retry
from requests.adapters import HTTPAdapter
import json

header = {'content-type': "Application/json"}

parameter = {
        'key0': 'value0',
        'key1': 'value1'
    }

session = requests.Session()

retries = Retry(total=5,  # リトライ回数
                backoff_factor=1,  # sleep時間
                status_forcelist=[500, 502, 503, 504])  # timeout以外でリトライするステータスコード

session.mount("https://", HTTPAdapter(max_retries=retries))

# connect timeoutを10秒, read timeoutを30秒に設定
response = session.get(url="https://xxx",
                       headers=header,
                       params=parameter,
                       stream=True,
                       timeout=(10.0, 30.0))

print(response.status_code)
print(response.json())

分からない箇所はsession.mount("https://", HTTPAdapter(max_retries=retries))こちらのメソッドではどのような処理を行っているのかといった点です。
リファレンスを読んでいましたが、正直全く分かりませんでした。

マウントされると、そのセッションを使用して作成され、そのURLが特定のプレフィックスで始まるHTTPリクエストは、特定のトランスポートアダプタを使用します。

「トランスポートアダプタ」について検索してみたのですが、こちらもよく分からないといった状況です...

どなたか、こちらの疑問点につきまして、アドバイスなど頂けましたら幸いです。

Answer 1

session.mount("https://", HTTPAdapter(max_retries=retries))こちらのメソッドではどのような処理を行っているのかといった点です。

Session.mount(prefix, adapter) はこのセッションで行う URL が prefix で始まる HTTP 通信に対して、アダプター adapter を設定する関数です。

今回の場合、prefix="https://" なので、URL が https:// で始まるすべての通信が対象となります。

設定したアダプターは、以下の内容です。

• status_forcelist: リトライ対象のエラーコード (今回の場合、500, 502, 503, 504エラーが対象)
• total: リトライ回数 (今回の場合、5回までリトライ)
• backoff_factor: リトライするまでの待機時間 1回失敗するごとに backoff_factor 秒待機時間を長くする。(今回の場合、1回目は1秒、2回目が2秒、... と待機時間が伸びる。)

retries = Retry(total=5,  # リトライ回数
                backoff_factor=1,  # sleep時間
                status_forcelist=[500, 502, 503, 504])
HTTPAdapter(max_retries=retries)

まとめると、すべての HTTPS 通信に上記設定を適用するというのが、session.mount("https://", HTTPAdapter(max_retries=retries)) の内容です。

アダプターという用語は、Adapter パターン というデザインパターンを使って実装されていることに由来します。

Comments

[study_111]

ご丁寧にご回答下さいまして、ありがとうございます。
「adapter」という単語を調べますと「ACアダプタ」などと出てきてしまい、混乱してしまっていたのですが、いわゆる、クラスに対して、何か設定を適用させる為の手段な訳だったのですね。
「adapter」という単語を調べた際に、どのような関係があるのだろうと、どうしても疑問が払拭出来ませんでした...