You can declare a dependency on Cask with the following using
directive:
//> using dep com.lihaoyi::cask::0.9.2
In your build.sbt
, you can add a dependency on Cask:
lazy val example = project.in(file("example"))
.settings(
scalaVersion := "3.4.2",
libraryDependencies += "com.lihaoyi" %% "cask" % "0.9.2",
fork := true
)
In your build.sc
, you can add a dependency on Cask:
object example extends RootModule with ScalaModule {
def scalaVersion = "3.3.4"
def ivyDeps = Agg(
ivy"com.lihaoyi::cask::0.9.2"
)
}
Query parameters are the key-value pairs coming after the question mark in a URL. They can be used for filtering,
sorting or limiting the results provided by the server. For example, in the <host>/time?city=Paris
URL, the city
part
is the name of a parameter, and Paris
is its value. Cask allows for reading the query parameters by defining an endpoint
method with arguments matching the names of the expected parameters and not matching any of the URL segments.
In this example, we give an Option
type and the default value None
to the city
parameter. This tells Cask that it is optional.
If not provided, the time for the current timezone will be returned.
import java.time.{ZoneId, ZonedDateTime}
object Example extends cask.MainRoutes {
private def getZoneIdForCity(city: String): Option[ZoneId] = {
import scala.jdk.CollectionConverters._
ZoneId.getAvailableZoneIds.asScala.find(_.endsWith("/" + city)).map(ZoneId.of)
}
@cask.get("/time")
def dynamicWithParam(city: Option[String] = None): String = {
city match {
case Some(value) => getZoneIdForCity(value) match {
case Some(zoneId) => s"Current date is: ${ZonedDateTime.now().withZoneSameInstant(zoneId)}"
case None => s"Couldn't find time zone for city $value"
}
case None => s"Current date is: ${ZonedDateTime.now()}"
}
}
initialize()
}
import java.time.{ZoneId, ZonedDateTime}
object Example extends cask.MainRoutes:
private def getZoneIdForCity(city: String): Option[ZoneId] =
import scala.jdk.CollectionConverters.*
ZoneId.getAvailableZoneIds.asScala.find(_.endsWith("/" + city)).map(ZoneId.of)
@cask.get("/time")
def dynamicWithParam(city: Option[String] = None): String =
city match
case Some(value) => getZoneIdForCity(value) match
case Some(zoneId) => s"Current date is: ${ZonedDateTime.now().withZoneSameInstant(zoneId)}"
case None => s"Couldn't find time zone for city $value"
case None => s"Current date is: ${ZonedDateTime.now()}"
initialize()
Run the example as before and access the endpoint at http://localhost:8080/time?city=Paris. You should get a result similar to the following one.
Current date is: 2024-07-22T10:08:18.218736+02:00[Europe/Paris]