简单，简洁的Scala HTTP客户端库

我需要一个成熟的HTTP客户端库，它对scala来说是惯用的，用法简洁，语义简单。我看了Apache HTTP和Scala Dispatch以及许多新的库，它们承诺了惯用的Scala包装。Apache HTTP客户端肯定要求冗长，而Dispatch容易造成混乱。

什么是适合Scala使用的HTTP客户端？

我最近开始使用Dispatch，有点神秘（很棒的一般介绍，严重缺乏基于详细场景/用例的文档）。Dispatch 0.9.1是围绕Ning的Async Http Client的Scala包装器；要完全了解发生了什么，需要向该库介绍自己的知识。在实践中，我真正需要看的唯一一件事是RequestBuilder-其他一切都很好地落入了我对HTTP的理解中。

一旦完成该初始学习曲线，我就很简单地给0.9发布版表示赞许（到目前为止！）。

Dispatch的Http“构建器”是不可变的，并且似乎在线程环境中运行良好。尽管我在文档中找不到任何内容来声明它是线程安全的；一般阅读资料表明确实如此。

请注意，RequestBuilder是可变的，因此不是线程安全的。

以下是一些我发现有帮助的其他链接：

• 我找不到0.9。*版本的ScalaDoc链接，所以我浏览了0.9。*版本的源代码；

• 适用于0.8版本的ScalaDoc; 一个基本上不同的野兽（今天）大于0.9。

• 运算符的“周期”表也与0.8相关。

• 较旧的0.8版“经典派遣”文档帮助我了解了他们如何使用url构建器，并给出了一些提示，说明如何将事情紧密联系在一起，并最终发展到0.9版。

我比较了大多数可用的主要HTTP客户端库

调度和其他一些库不再维护。目前，唯一的严重问题是Spray-client和Play！WS。

spray-client的语法有点奥秘。玩游戏非常易于使用：

（build.sbt）

libraryDependencies += "com.typesafe.play" %% "play-ws" % "2.4.3"

（基本用法）

val wsClient = NingWSClient()
wsClient
  .url("http://wwww.something.com")
  .get()
  .map { wsResponse =>
    // read the response
}

在这里参加聚会有点晚了，但是我对Spray-client印象深刻。

它具有用于构建请求的不错的DSL，支持同步和异步执行以及各种（非）编组类型（JSON，XML，表单）。它也可以和Akka一起很好地玩。

二六年后最初回应这篇文章中，我将有一个不同的答案。

我一直在使用akka-http，这是浪花团队和akka团队之间的合作。它得到了Lightbend的支持，与akka异步环境紧密结合……这是完成此任务的正确工具。

在对Apa​​che客户端有一些不愉快的经历之后，我着手编写自己的。内置HttpURLConnection被广泛认为是错误的。但这不是我的经验。实际上，情况正好相反，Apache客户端的线程模型有些问题。从Java6（或5？）开始，HttpURLConnection就提供了有效的HTTP1.1连接，并内置了诸如keep-alive之类的基本功能，并且可以轻松处理并发使用情况。

因此，为了补偿HttpURLConnection提供的不便的API，我着手在Scala中编写一个新API作为开源项目。它只是HttpURLConnection的包装，但是与HttpURLConnection不同，它的目标是易于使用。与Apache客户端不同，它应该容易地适合现有项目。与Dispatch不同，它应该易于学习。

叫做蜜蜂客户端

• 网站： http //www.bigbeeconsultants.co.uk/bee-client
• API文档：http : //www.bigbeeconsultants.co.uk/docs/bee-client/latest.html

对于无耻的插件，我深表歉意。:)

sttp是我们一直在等待的Scala HTTP库！

它具有流利的DSL，用于形成和执行请求（来自其README的代码示例）：

val request = sttp
  .cookie("session", "*!@#!@!$")
  .body(file) // of type java.io.File
  .put(uri"http://httpbin.org/put")
  .auth.basic("me", "1234")
  .header("Custom-Header", "Custom-Value")
  .response(asByteArray)

它通过可插入的后端（包括Akka-HTTP（以前称为Spray）和古老的AsyncHttpClient（Netty））支持同步，异步和流式调用：

implicit val sttpHandler = AsyncHttpClientFutureHandler()
val futureFirstResponse: Future[Response[String]] = request.send()

它支持scala.concurrent.Future，scalaz.concurrent.Task，monix.eval.Task，和cats.effect.IO-所有主要斯卡拉IO单子库。

另外，它还有其他一些技巧：

• 它具有用于请求和响应的案例类表示形式（尽管不如具有强类型的标头）：https : //github.com/softwaremill/sttp/blob/master/core/src/main/scala /com/softwaremill/sttp/RequestT.scala https://github.com/softwaremill/sttp/blob/master/core/src/main/scala/com/softwaremill/sttp/Response.scala

• 它提供URI字符串插值器：

val test = "chrabąszcz majowy" val testUri: Uri = uri"http://httpbin.org/get?bug=$test"

• 它支持用于请求正文/响应的编码器/解码器，例如通过Circe的JSON：

import com.softwaremill.sttp.circe._ val response: Either[io.circe.Error, Response] = sttp .post(uri"...") .body(requestPayload) .response(asJson[Response]) .send()

最后，它由Softwaremill的可靠人员维护，并且具有大量文档。

除了调度外，那里没有太多东西。scalaz尝试构建功能正常的http客户端。但是它已经过时了一段时间，在scalaz7分支中不存在任何版本。此外，在播放框架中还提供了ning async-http-client的有用包装。在那里您可以拨打电话，例如：

WS.url("http://example.com/feed").get()
WS.url("http://example.com/item").post("content")

如果您不使用游戏，则可以将此API用作灵感！在您的项目中，并且不喜欢Dispatch API。

喷雾

您确实应该考虑使用Spray。我认为它的语法有些棘手，但是如果您打算构建高性能的HTTP客户端，它仍然非常有用。使用Spray的主要优点是它基于akka actor库，它具有极好的可扩展性和强大的功能。您只需更改conf文件即可将http客户端扩展到多台计算机。

此外，几个月前Spray加入Typesafe，据我了解，它将成为基本Akka发行版的一部分。证明

播放2

另一个选择是Play2 WS lib用法（doc）。据我所知，它仍然没有从Play发行版中分离出来，但是由于其极其简单，值得花一些时间附加整个Play框架来获得这一部分。为它提供配置存在一些问题，因此这对于拖放使用情况而言并不是很好。但是，我们在少数非基于Play的项目中使用了它，一切都很好。

ScalaJ-Http是一个非常简单的同步http客户端

https://github.com/scalaj/scalaj-http

如果您需要无礼的Scala客户端，我建议您使用。

感到惊讶的是，没有人提到这里。使用起来超级简单：

import com.twitter.finagle.{Http, Service}
import com.twitter.finagle.http
import com.twitter.util.{Await, Future}

object Client extends App {
  val client: Service[http.Request, http.Response] = Http.newService("www.scala-lang.org:80")
  val request = http.Request(http.Method.Get, "/")
  request.host = "www.scala-lang.org"
  val response: Future[http.Response] = client(request)
  Await.result(response.onSuccess { rep: http.Response =>
    println("GET success: " + rep)
  })
}

有关更多详细信息，请参见快速入门指南：https : //twitter.github.io/finagle/guide/Quickstart.html

我已经使用了Dispatch，Spray Client和Play WS Client Library ...它们都不是简单地使用或配置的。因此，我创建了一个更简单的HTTP客户端库，该库可让您以简单的单行代码执行所有经典的HTTP请求。

看一个例子：

import cirrus.clients.BasicHTTP.GET

import scala.concurrent.Await
import scala.concurrent.duration._

object MinimalExample extends App {

  val html = Await.result(Cirrus(GET("https://www.google.co.uk")), 3 seconds)

  println(html)
}

...产生...

<!doctype html><html itemscope="" itemtype="http://schema.org/WebPage" lang="en-GB">...</html>

该库称为Cirrus，可通过Maven Central访问

libraryDependencies += "com.github.godis" % "cirrus_2.11" % "1.4.1"

该文档可在GitHub上找到

https://github.com/Godis/Cirrus