httpx.md

这段代码定义了一个名为httpx的包，用于发送HTTP请求并处理响应。下面是详细的解释：

1. 导入依赖:

   • 导入了许多必要的包，用于处理HTTP请求、加密、URL解析、正则表达式匹配等。

2. HTTPX结构体:

   • 定义了一个名为HTTPX的结构体，它代表了一个HTTP客户端实例。
   • 包含了一个retryablehttp.Client和一个http.Client，分别用于发送可重试的HTTP请求和普通的HTTP请求。
   • 还包含了一个自定义头部映射、一个fastdialer.Dialer用于快速拨号，以及一个HTTPOptions结构体指针，用于配置HTTP请求的选项。

3. NewHttpx函数:

   • 用于创建一个新的HTTPX实例。
   • 接受一个HTTPOptions指针作为参数，用于配置HTTP请求的选项。
   • 初始化了一个fastdialer.Dialer，用于快速拨号。
   • 根据提供的选项配置了retryablehttp.Client和http.Client。
   • 如果启用了重定向跟随，则设置重定向函数为nil，否则设置为不跟随重定向。
   • 如果提供了HTTP代理，则配置代理。
   • 返回创建的HTTPX实例和可能的错误。

4. Do函数:

   • 是HTTPX结构体的一个方法，用于发送HTTP请求并处理响应。
   • 接受一个retryablehttp.Request指针作为参数。
   • 使用getResponse函数发送请求并获取响应。
   • 处理响应，包括解析头部、读取响应体、关闭响应体等。
   • 如果响应体不是UTF-8编码，则尝试将其转换为UTF-8编码。
   • 返回一个Response结构体指针，其中包含了解析后的响应数据。

5. getResponse函数:

   • 是HTTPX结构体的一个私有方法，用于发送HTTP请求并获取响应。
   • 如果启用了不安全模式，则使用doUnsafe函数发送请求；否则，使用retryablehttp.Client发送请求。

6. doUnsafe函数:

   • 是HTTPX结构体的一个私有方法，用于发送不安全的HTTP请求。
   • 使用rawhttp.DoRaw函数发送原始HTTP请求。

7. NewRequest函数:

   • 是HTTPX结构体的一个方法，用于创建一个新的retryablehttp.Request。
   • 接受HTTP方法和目标URL作为参数。
   • 如果未启用不安全模式，则设置默认的User-Agent和Accept-Charset头部。
   • 返回创建的请求和可能的错误。

8. SetCustomHeaders函数:

   • 是HTTPX结构体的一个方法，用于在提供的请求上设置自定义头部。
   • 接受一个请求和一个头部映射作为参数。
   • 遍历头部映射，并将每个头部设置到请求上。
   • 如果头部名称是"host"，则还将其设置为请求的Host字段。

总的来说，这段代码提供了一个功能强大的HTTP客户端，支持可重试的HTTP请求、自定义头部、快速拨号、代理配置、重定向跟随等特性。同时，还提供了处理响应的功能，包括解析头部、读取响应体、转换编码等。