scalaj-http 使用教程

1、项目介绍

scalaj-http 是一个为 Scala 设计的 HTTP 客户端库，它封装了 Java 的 HttpURLConnection。该库具有以下特点：

• 零依赖
• 支持 Scala 2.10、2.11、2.12 和 2.13-M3
• OAuth v1 请求签名
• 自动支持 gzip 和 deflate 编码
• 易于添加查询字符串或表单参数
• URL 编码自动处理
• 支持多部分文件上传

该库不支持异步执行，但 HttpRequest 和 HttpResponse 是不可变的，因此可以轻松地在其上构建执行框架。

2、项目快速启动

安装

在 build.sbt 中添加以下依赖：

libraryDependencies += "org.scalaj" %% "scalaj-http" % "2.4.2"

简单 GET 请求

以下是一个简单的 GET 请求示例：

import scalaj.http.Http

val response = Http("http://example.com/search")
  .param("q", "monkeys")
  .asString

println(response.body)
println(response.code)
println(response.headers)
println(response.cookies)

简单 POST 请求

以下是一个简单的 POST 请求示例：

import scalaj.http.Http

val response = Http("http://example.com/post")
  .postData("key1=value1&key2=value2")
  .header("Content-Type", "application/x-www-form-urlencoded")
  .asString

println(response.body)
println(response.code)
println(response.headers)
println(response.cookies)

3、应用案例和最佳实践

处理 JSON 响应

假设服务器返回 JSON 数据，可以使用 spray-json 库进行解析：

import scalaj.http.Http
import spray.json._
import DefaultJsonProtocol._

case class User(id: Int, name: String)

implicit val userFormat = jsonFormat2(User)

val response = Http("http://example.com/user/1")
  .asString

val user = response.body.parseJson.convertTo[User]
println(user)

上传文件

以下是一个上传文件的示例：

import scalaj.http.Http
import java.io.File

val response = Http("http://example.com/upload")
  .postMulti(
    MultiPart("file", "filename.txt", "text/plain", new File("/path/to/filename.txt"))
  )
  .asString

println(response.body)
println(response.code)
println(response.headers)
println(response.cookies)

4、典型生态项目

spray-json

spray-json 是一个轻量级的 JSON 库，用于 JSON 的序列化和反序列化。它可以与 scalaj-http 结合使用，方便地处理 JSON 数据。

Akka HTTP

Akka HTTP 是一个全功能的 HTTP 服务器和客户端库，提供了更高级的功能和更好的性能。如果 scalaj-http 不能满足需求，可以考虑使用 Akka HTTP。

以上是 scalaj-http 的基本使用教程，希望对你有所帮助。