Home > JettyS

JettyS

JettyS is a project mainly written in Scala, it's free.

Scala API for servlets in general and Jetty in particular

The aim of this pimped servlet API is to add the minimum to javax.servlet to scalaize it. There is no routing engine, no ORM layer, just the usual scala pimping techniques.

One good idea is to recast the servlet service methods as:

HttpServletRequest => HttpServletResponse => Unit

The HttpServletResponse => Unit part can then be factored into stock objects called Responders. You can then concentrate on the HttpServletRequest => Responder part.

The result is not too shabby. It lets you write hello world like this:

get("/") { request =>

Hello {request("yourname") getOrElse "stranger"}!

}

Here the request is implicitly wrapped to allow easy parameter access as in request("yourname") and the result, a scala.xml.Node, is implicitly converted to a suitable Responder.

OK, to be fair, lets expand that out with all the imports and proper XHTML:

package example import au.com.langdale.webserver. import Driver. // start and stop Jetty import Connectors. // Jetty-specific connection methods such as listen() import Handlers. // Jetty-specific binding methods get("...") and post("...") import Responders. // generic responders and implicit conversions for responses import Requests. // generic request extractors and wrapper

object HelloWorld { val host = "127.0.0.1" val port = 9986

// tell Jetty where to receive connections listen(host, port)

// may be omitted since this is the default for XML responses implicit val contentType = ContentType("application/xhtml+xml")

// hello world server get("/test") { request =>

The Test Page

Test

Hello {request("yourname") getOrElse "stranger"}!

}

def main(args: Array[String]) = { start; join } }

Instead of querying the (wrapped) HttpServletRequest, you can use pattern matching. Here is a KML service for google earth that shows this:

implicit val contentType = ContentType("application/vnd.google-earth.kml+xml") // note 1

get("/cafe") { case Params(BBox(w, s, e, n)) => // note 2

{ for((name, lon, lat) <- findCafesIn(w, s, e, n)) yield {name} {lon},{lat},0 }

case _ => 404 // note 3 }

The example extracts the coordinates of a bounding box (w, s, e, n) from a Google Earth request and uses them to find a collection of locations via findCafes(..), which is supposedly a spatial query on some data source.

The locations are wrapped in KML markup and returned.

This shows how to:

  • set an implicit content type (note 1);
  • use extractors to obtain request parameters (note 2);
  • implicitly convert responses such as XML or integers. e.g an integer gets converted to an error response (note 3).

There is a longer writeup here: http://notes.langdale.com.au/Pimping_Servlet_and_Jetty.html

Previous:overlay