Apache Pekko HTTP 使用教程-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00373/article/details/147317681

Apache Pekko HTTP 使用教程

1. 项目介绍

Apache Pekko HTTP 是一个基于 Apache Pekko 的 HTTP 服务器和客户端模块。它不是一个完整的 Web 框架，而是一个更通用的工具集，用于提供和消费基于 HTTP 的服务。尽管与浏览器的交互也是其应用范围之一，但它并不是 Pekko HTTP 的主要关注点。

Pekko HTTP 是 Akka HTTP 的一个分支，源自 Akka 项目采用商业源代码许可之前的 10.2.x 版本。Pekko HTTP 采取了一种非常开放的设计理念，并且通常为执行相同操作提供多个不同层次的 API。这意味着，如果您在使用高级 API 时遇到困难，很可能可以通过使用更底层的 API 来实现您的目标，尽管这可能需要您编写更多的应用代码。

2. 项目快速启动

环境准备

在开始之前，请确保已经安装了以下环境：

Java Development Kit (JDK) 版本 8 或更高版本
sbt (Scala Build Tool)
Graphviz (用于生成 scaladoc)

克隆仓库

使用以下命令克隆 Apache Pekko HTTP 的 Git 仓库：

git clone https://github.com/apache/incubator-pekko-http.git
cd incubator-pekko-http

构建项目

在项目根目录下运行以下 sbt 命令来编译项目：

sbt compile

如果要为所有支持的 Scala 版本编译，可以使用：

sbt +compile

运行单元测试：

sbt test

构建项目 JAR 包：

sbt package

创建一个简单的 HTTP 服务器

以下是一个简单的例子，展示如何使用 Pekko HTTP 创建一个基本的 HTTP 服务器：

import akka.actor.ActorSystem
import akka.http.scaladsl.Http
import akka.http.scaladsl.server.Directives._
import scala.io.StdIn

object HttpServerApp {
  def main(args: Array[String]): Unit = {
    implicit val system = ActorSystem("my-system")
    implicit val executionContext = system.dispatcher

    val route = get {
      pathSingleSlash {
        complete("Hello, world!")
      }
    }

    val bindingFuture = Http().newServerAt("localhost", 8080).bind(route)

    println(s"Server online at http://localhost:8080/\nPress RETURN to stop...")
    StdIn.readLine() // 等待用户输入，以停止服务器
    bindingFuture
      .flatMap(_.unbind())
      .onComplete(_ => system.terminate())
  }
}

运行上述代码将启动一个在本地 8080 端口上监听的 HTTP 服务器。访问 http://localhost:8080/ 将返回 "Hello, world!"。

3. 应用案例和最佳实践

RESTful API 的创建

使用 Pekko HTTP，您可以轻松创建 RESTful API。以下是一个简单的例子：

import akka.http.scaladsl.server.Route
import spray.json.DefaultJsonProtocol._
import spray.json._

case class Person(name: String, age: Int)

object MyService {
  implicit val personFormat = jsonFormat2(Person)
  
  def personRoute: Route = {
    path("person" / Segment) { name =>
      get {
        complete(Person(name, 30).toJson.prettyPrint)
      }
    }
  }
}

异步处理

Pekko HTTP 支持异步处理，这对于提高性能和响应性非常有用。以下是一个例子，展示如何在处理请求时执行异步操作：

import scala.concurrent.Future
import scala.util.Success

val futureInt = Future { intensiveComputation() }

val route: Route = {
  path("compute") {
    get {
      complete(futureInt.map(i => s"The result is $i").andThen {
        case Success(value) => Future.successful(HttpResponse(entity = value))
        case _ => Future.successful(HttpResponse(status = StatusCodes.InternalServerError))
      })
    }
  }
}

def intensiveComputation(): Int = {
  // 模拟耗时计算
  Thread.sleep(1000)
  42
}