目录

关闭会话(ArkTS)

当一个HTTP请求完成,即数据已经成功发送并收到确认,或者在某些情况下,由于超时或其他错误原因,通信尝试失败,此时应立即调用相应的“关闭会话”或“释放资源”方法。这一操作的主要目的是:

在请求结束后,及时关闭会话并释放相关资源是保持系统健康和高效运行的关键步骤。这不仅有助于优化资源利用,还能提高系统的稳定性和可靠性。

约束与限制

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

接口说明

具体API说明详见接口文档。

接口名 描述
close(): void 关闭会话。返回为空。

使用示例

  1. 导入模块。

    import { rcp } from '@kit.RemoteCommunicationKit';
    import { BusinessError } from '@kit.BasicServicesKit';
  2. 创建会话,会话发起请求后关闭会话。

    // 1、创建会话
    const session = rcp.createSession();
    // 2、创建Request,"http://www.example.com/fetch"请根据实际情况替换为想要请求的URL地址。
    let req = new rcp.Request('http://www.example.com/fetch', 'GET');
    // 3、利用fetch发起网络请求
    session.fetch(req).then((response) => {
      // 4、对响应的处理,此处为示例,只做打印处理
      console.info(`Response succeeded: ${response}`);
      // ...
    }).catch((err: BusinessError) => {
      // 5、请求错误处理
      console.error(`Response error code is ${err.code}, error data is ${err.data}`);
    });
    session.close();