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
的基本使用教程,希望对你有所帮助。