目录

DnsConfiguration:定制DNS

场景介绍

在远程通信服务框架中,Remote Communication Kit提供了一套高度可定制的 DNS(Domain Name System)请求规则服务,这一服务允许开发者根据自身需求调整 DNS 查询行为。此外,支持用户自定义 DNS 服务器设置。开发者可根据具体的网络环境或安全需求,选择最适合的 DNS 服务器进行配置。通过这些功能,开发者不仅能够实现网络管理的高效性,还能增强网络的安全性,确保数据传输的稳定与安全。DnsConfiguration中可设置dnsRules、dnsOverHttps。

约束与限制

定制DNS能力支持Phone、2in1、Tablet、Wearable设备。并且从5.1.1(19)开始,新增支持TV设备;从API版本26.0.1开始,新增支持Car设备。

使用示例

下面以定制DNS服务器、重写DNS解析函数两个示例来说明如何进行DNS的定制,从而获取最佳的DNS性能体验。

[h2]定制DNS服务器

  1. 导入需要的模块。

    import { rcp } from '@kit.RemoteCommunicationKit';
    import { BusinessError } from '@kit.BasicServicesKit';
  2. 创建一个新的会话对象和请求,会话用于管理后续的网络请求。同时需要定义一个具体的请求,请求中指定了需要请求的URL。

    const session = rcp.createSession();
    // 其中的URL需要根据自身业务需要调整
    const request = new rcp.Request('https://example.com');
  3. 设置请求的DNS规则,可根据自身业务的需要对DNS的ip和port进行设置。

    request.configuration = {
      dns: {
        dnsRules: [
          {
            ip: '192.168.1.1', // DNS服务器的IP地址
            port: 53, // DNS服务器的端口号
          },
        ]
      }
    };
  4. 利用fetch发起网络请求并在成功或失败时进行响应的处理,此处只给出示例,对成功或失败的处理请根据实际业务来实现。

    session.fetch(request).then((response: rcp.Response) => {
      console.info(`The response is ${JSON.stringify(response)}`); // 处理成功响应
      // ...
      // 关闭会话
      session.close();
    }).catch((err: BusinessError) => {
      console.error(`The error code is ${err.code}, error data is ${err.data}`); // 处理错误
      // ...
      // 关闭会话
      session.close();
    })

[h2]定制DNS解析函数

  1. 导入需要的模块。

    import { rcp } from '@kit.RemoteCommunicationKit';
    import { BusinessError } from '@kit.BasicServicesKit';
  2. 创建一个新的会话对象和请求,会话用于管理后续的网络请求。同时需要定义一个具体的请求,请求中指定了需要请求的URL。

    const session = rcp.createSession();
    // 定义请求的URL(请根据实际需求调整)
    const requestURL = 'https://example.com';
    const request = new rcp.Request(requestURL);
  3. 设置DNS解析规则,此处请根据自身业务进行逻辑处理,本例只给出简单示例。

    request.configuration = {
      dns: {
        dnsRules: (host: string, port: number): rcp.IpAddress[] => {
          if (host === 'example.com') {
            return ['192.168.1.1', '192.168.1.2']; // 此处请根据实际情况填写
          }
          return [];
        }
      }
    };
  4. 利用fetch发起网络请求并在成功或失败时进行响应的处理,此处只给出示例,对成功或失败的处理请根据实际业务来实现。

    session.fetch(request).then((response: rcp.Response) => {
      // 处理成功响应
      console.info(`The response is ${JSON.stringify(response)}`);
      // ...
      // 关闭会话
      session.close();
    }).catch((err: BusinessError) => {
      // 处理错误
      console.error(`The error code is ${err.code}, error data is ${err.data}`);
      // ...
      // 关闭会话
      session.close();
    })