ZIO HTTP is a scala library for building http apps. It is powered by ZIO and Netty and aims at being the defacto solution for writing, highly scalable and performant web applications using idiomatic Scala.
Setup via build.sbt
:
libraryDependencies += "dev.zio" %% "zio-http" % "3.0.0-RC3"
NOTES ON VERSIONING:
- Older library versions
1.x
or2.x
with organizationio.d11
of ZIO Http are derived from Dream11, the organization that donated ZIO Http to the ZIO organization in 2022. - Newer library versions, starting in 2023 and resulting from the ZIO organization (
dev.zio
) started with0.0.x
, reaching1.0.0
release candidates in April of 2023
A simple Http server can be built using a few lines of code.
import zio._
import zio.http._
object HelloWorld extends ZIOAppDefault {
val app: HttpApp[Any] =
Routes(
Method.GET / "text" -> handler(Response.text("Hello World!"))
).toHttpApp
override val run =
Server.serve(app).provide(Server.default)
}
- Edit the RunSettings - modify
className
to the example you'd like to run. - From sbt shell, run
~example/reStart
. You should seeServer started on port: 8080
. - Send curl request for defined
http Routes
, for eg :curl -i "http://localhost:8080/text"
forexample.HelloWorld
.
You can use the sbt-revolver plugin to start the server and run it in watch mode using ~ reStart
command on the SBT console.
Learn more on the ZIO Http homepage!
For the general guidelines, see ZIO contributor's guide.
See the Code of Conduct