scamper.http.server

Attributes

See also

LifecycleHook, LifecycleEvent

Supertypes

class Object

trait Matchable

class Any

Self type

LifecycleHook

Attributes

Companion

object

Supertypes

class Object

trait Matchable

class Any

Attributes

Companion

trait

Supertypes

class Object

trait Matchable

class Any

Self type

ErrorHandler.type

Attributes

See also

HttpServer.app(), ServerApplication

Companion

object

Supertypes

trait AutoCloseable

class Object

trait Matchable

class Any

Attributes

Companion

trait

Supertypes

class Object

trait Matchable

class Any

Self type

HttpServer.type

Attributes

Supertypes

trait Enum

trait Product

trait Equals

class EventObject

trait Serializable

class Object

trait Matchable

class Any

Show all

Known subtypes

case Start

case Stop

Value parameters

cause

underlying cause

message

detail message

Attributes

Constructor

Creates exception with supplied message and cause.

Supertypes

class RuntimeException

class Exception

class Throwable

trait Serializable

class Object

trait Matchable

class Any

Show all

Attributes

See also

CriticalService

Supertypes

trait EventListener

class Object

trait Matchable

class Any

Attributes

Supertypes

trait Product

trait Equals

class HttpException

class RuntimeException

class Exception

class Throwable

trait Serializable

class Object

trait Matchable

class Any

Show all

Attributes

Supertypes

trait Product

trait Equals

class HttpException

class RuntimeException

class Exception

class Throwable

trait Serializable

class Object

trait Matchable

class Any

Show all

Attributes

Supertypes

class Object

trait Matchable

class Any

Attributes

Companion

object

Supertypes

class Object

trait Matchable

class Any

Attributes

Companion

trait

Supertypes

class Object

trait Matchable

class Any

Self type

RequestHandler.type

Attributes

Supertypes

trait Product

trait Equals

class HttpException

class RuntimeException

class Exception

class Throwable

trait Serializable

class Object

trait Matchable

class Any

Show all

Attributes

Companion

object

Supertypes

class Object

trait Matchable

class Any

Attributes

Companion

trait

Supertypes

class Object

trait Matchable

class Any

Self type

ResponseFilter.type

import scala.language.implicitConversions

import scamper.http.ResponseStatus.Registry.{ BadRequest, NotFound, Ok }
import scamper.http.server.{ ParameterNotConvertible, ServerApplication, toServerHttpRequest }
import scamper.http.stringToEntity

val app = ServerApplication()

// Mount router to /api
app.route("/api") { router =>
 val messages = Map(1 -> "Hello, world!", 2 -> "Goodbye, cruel world!")

 // Map handler to /api/messages
 router.get("/messages") { req =>
   Ok(messages.mkString("\r\n"))
 }

 // Map handler to /api/messages/:id
 router.get("/messages/:id") { req =>
   val id = req.pathParams.getInt("id")
   messages.get(id)
    .map(Ok(_))
    .getOrElse(NotFound())
 }

 router.recover { req =>
   { case _: ParameterNotConvertible => BadRequest(req.target.toString) }
 }
}

Attributes

Supertypes

class Object

trait Matchable

class Any

Known subtypes

class ServerApplication

Attributes

Supertypes

class Object

trait Matchable

class Any

import java.io.File

import scala.language.implicitConversions

import scamper.http.{ BodyParser, stringToEntity }
import scamper.http.ResponseStatus.Registry.{ NotFound, NoContent, Ok }
import scamper.http.server.{ *, given }

// Get server application
val app = ServerApplication()

// Add request handler to log all requests
app.incoming { req =>
 println(req.startLine)
 req
}

// Add request handler for GET requests at specified path
app.get("/about") { req =>
 Ok("This server is powered by Scamper.")
}

// Add request handler for PUT requests at specified path
app.put("/data/:id") { req =>
 def update(id: Int, data: String): Boolean = ???

 given BodyParser[String] = BodyParser.string()

 // Get path parameter
 val id = req.pathParams.getInt("id")

 update(id, req.as[String]) match
   case true  => NoContent()
   case false => NotFound()
}

// Serve files from file directory
app.files("/main", File("/path/to/public"))

// Gzip response body if not empty
app.outgoing { res =>
 res.body.isKnownEmpty match
   case true  => res
   case false => res.setGzipContentEncoding()
}

// Create server
val server = app.toHttpServer(8080)

try
 printf("Host: %s%n", server.host)
 printf("Port: %d%n", server.port)

 // Run server for 60 seconds
 Thread.sleep(60 * 1000)
finally
 // Close server when done
 server.close()

Attributes

Supertypes

trait Router

class Object

trait Matchable

class Any

Attributes

Supertypes

class AnyVal

trait Matchable

class Any

Attributes

Supertypes

class AnyVal

trait Matchable

class Any

Attributes

Supertypes

class AnyVal

trait Matchable

class Any

import scamper.http.HttpRequest
import scamper.http.ResponseStatus.Registry.Unauthorized
import scamper.http.server.{ ServerApplication, WebSocketUpgrade }

val app = ServerApplication()

app.get("/chat/:roomId") { req =>
 def authorize(req: HttpRequest): Boolean = ...

 authorize(req) match
   case true  =>
     WebSocketUpgrade(req) { session =>
       // Set up session
       ...
       session.open()
     }
   case false => Unauthorized()
}

Attributes

Supertypes

class Object

trait Matchable

class Any

Self type

WebSocketUpgrade.type

Attributes

Attributes

Attributes