介绍
Session 类表示可用于发出HTTP请求的通信会话。它提供了各种HTTP方法(FETCH、GET、POST、PUT、HEAD、DELETE、CANCEL、CLOSE)。
创建 Session
定义
function createSession(sessionConfiguration?: SessionConfiguration): Session
参数:
- sessionConfiguration:
SessionConfiguration类型,非必填,会话配置,应用于会话请求的设置。
返回值: 返回 Session 对象,代表一个会话,用于发送HTTP请求并管理其配置、取消和关闭的生命周期。
注意
当前最多可创建16个session实例
例子
import { rcp } from '@kit.RemoteCommunicationKit';
const session = rcp.createSession();
Session 属性
id:
string类型,表示会话的标识符。configuration:
SessionConfiguration | undefined类型,表示会话的配置设置。
SessionConfiguration
SessionConfiguration接口定义了会话的配置参数,为开发人员提供了对HTTP会话各个方面的详细控制。
属性
interceptors:
Interceptor[]类型,请求/响应拦截器baseAddress:
URLOrString类型,设置会话中URL的基地址。这允许开发人员为会话中的多个请求定义一个通用的基本URL。headers:
RequestHeaders类型,为Session发出的HTTP请求定义自定义headers。cookies:
RequestCookies类型,提供一种在与会话关联的HTTP请求中包含自定义cookie的方法。sessionListener:
SessionListener类型,允许开发人员将侦听器附加到会话,接收会话取消或关闭等事件的通知