On static data and HTTP

Usually, if you fetch a file via HTTP, it ships with an ETag. An ETag specifies a file version. So the next time the browser requests that information, it sends the ETag along, and gets a 304 Not Modified back, so you don’t have to send the data over the wire again.

All of these solutions are most likely slower than the equivalent in nginx or a similar static file hoster, but they’re often fast enough.

Serving static files

Http4s provides a few helpers to handle ETags for you, they’re located in StaticFile.

import org.http4s._
// import org.http4s._

import org.http4s.dsl._
// import org.http4s.dsl._

import java.io.File
// import java.io.File

import scalaz.concurrent.Task
// import scalaz.concurrent.Task

val service = HttpService {
  case request @ GET -> Root / "index.html" =>
    StaticFile.fromFile(new File("relative/path/to/index.html"), Some(request))
      .map(Task.now) // This one is require to make the types match up
      .getOrElse(NotFound()) // In case the file doesn't exist
// service: org.http4s.HttpService = Kleisli(org.http4s.package$HttpService$$$Lambda$27711/1266352555@599fc7c2)

Serving from jars

For simple file serving, it’s possible to package resources with the jar and deliver them from there. Append to the List as needed.

def static(file: String, request: Request) =
  StaticFile.fromResource("/" + file, Some(request)).map(Task.now).getOrElse(NotFound())
// static: (file: String, request: org.http4s.Request)scalaz.concurrent.Task[org.http4s.Response]

val service = HttpService {
  case request @ GET -> Root / path if List(".js", ".css", ".map", ".html", ".webm").exists(path.endsWith) =>
    static(path, request)
// service: org.http4s.HttpService = Kleisli(org.http4s.package$HttpService$$$Lambda$27711/1266352555@3b2f06cf)