主要内容

本页采用了机器翻译。点击此处可查看最新英文版本。

配置客户端-服务器连接

您使用实现 MWHttpClientConfig 接口的对象配置客户端-服务器连接。该接口定义了以下属性:

  • TimeoutMilliSeconds 确定客户端在超时前等待响应的时间(以毫秒为单位)

  • ResponseSizeLimit 确定客户端接受的响应的最大大小(以字节为单位)。

API 提供了一个默认实现 MWHttpClientDefaultConfig,在实例化 HTTP 客户端时自动使用。要修改配置,请扩展 MWHttpClientDefaultConfig 并将其传递给 HTTP 客户端构造函数。

使用默认配置创建连接

当您使用默认构造函数 MWHttpClient() 创建客户端连接时,会自动使用 MWHttpClientDefaultConfig 的实例来配置客户端-服务器连接。默认配置设置这些连接属性。

  • TimeOutMs = 120000

  • ResponseSizeLimit = 64*1024*1024 (64 MB)

使用自定义配置创建连接

要更改一个或多个连接属性:

  1. 通过扩展 MWHttpClientDefaultConfig 接口实现自定义连接配置。

  2. 使用接受配置对象的构造函数之一创建客户端连接。

    • MWHttpClient(MWHttpClientConfig config)

    • MWHttpClient(MWHttpClientConfig config, MWSSLConfig securityConfig)

以下代码示例创建一个超时值为 1000 毫秒的客户端连接。

class MyClientConfig : MWHttpClientDefaultConfig
{
  public override int TimeoutMilliSeconds
  {
    get { return 1000; }
  }
}
...
MWClient client = new MWHttpClient(new MyClientConfig());
...

实现自定义连接配置

要实现自定义连接配置,请扩展 MWHttpClientDefaultConfig 接口。MWHttpClientDefaultConfig 接口对每个配置属性都有一个 getter 方法。

指定客户端在 1 秒后超时并且只能接受 4 MB 响应:

class MyClientConfig : MWHttpClientDefaultConfig
{
  public override int TimeoutMilliSeconds
  {
    get { return 60000; }
  }
  public override int ResponseSizeLimit
  {
    get { return 4*1024*1024; }
  }
}

另请参阅

主题