STTP的基本使用(1):Request、Response

2022-05-30 14:05:16 浏览数 (1)

试试看get一下新技能:STTP with AKKA。

1)定义 request。 请求由不可变的数据结构 RequestT 来表示,其值可以由 sttp.client.clientRequest 来表示,并可通过它提供的各种方法(cookie, body, responseAs…)来细力度的来设定 reqeust 对象的数据(包括返回的 response 格式)。

2)发送请求。 为了发送请求,这里需要一个隐式对象backend。核心的绝大部分工作都发生在backend。比如把请求转为特定backend格式、打开 HTTP 连接、发送接收数据、把接收到的数据转为 STTP的response格式等。 Backend 管理着连接池、处理 response的线程池,根据backend的情况还支持streaming和 websockets。 请求可以同步发送,返回值类型为 Response[T]。 请求也可以异步发送,返回值类型为 Future[Response[T]]。Monix这种backend的返回值则是 Task[Resonse[T]]。

关于更详细的如何使用request,比如设置cookie、认证、form、上传文件、proxy 等,可参考:https://sttp.readthedocs.io/en/latest/requests/basics.html

如何使用 AKKA 这样支持 streaming 的 backend,参考: 发送流:https://sttp.readthedocs.io/en/latest/requests/streaming.html 接收流:https://sttp.readthedocs.io/en/latest/responses/body.html#streaming

3)Responses Response是 case class Response[T]的一个实例,其中T是response body的type。 如果connection出现问题,在同步的backend情况下exception会被返回,对于异步来说就是 failed future。详见:https://sttp.readthedocs.io/en/latest/responses/exceptions.html 使用.body: T 方法来获取 response body。

Reference:

https://sttp.readthedocs.io/en/v2.0.0-rc13/requests/type.html

0 人点赞