Packages

•  package root

  Provided herein is API documentation for Scamper, the HTTP library for Scala.

  Provided herein is API documentation for Scamper, the HTTP library for Scala.

  Definition Classes

  root

•  package scamper

  Defines core types.

  Defines core types.

  HTTP Messages

  At the core of Scamper is HttpMessage, which is a trait that defines the fundamental characteristics of an HTTP message. HttpRequest and HttpResponse extend the specification to define characteristics specific to their respective message types.

  An HttpRequest is created using a factory method defined in its companion object. Or you can start with a RequestMethod and use builder methods to further define the request.

  import scamper.Header
  import scamper.Implicits.stringToUri
  import scamper.RequestMethod.Registry.Get
  
  val request = Get("/motd").setHeaders(
    Header("Host: localhost:8080"),
    Header("Accept: text/plain")
  )
  
  printf("Request Method: %s%n", request.method)
  printf("Target URI: %s%n", request.target)
  
  request.headers.foreach(println)
  
  val host: Option[String] = request.getHeaderValue("Host")

  An HttpResponse is created using a factory method defined in its companion object. Or you can start with a ResponseStatus and use builder methods to further define the response.

  import scamper.{ BodyParser, Header }
  import scamper.Implicits.stringToEntity
  import scamper.ResponseStatus.Registry.Ok
  
  val response = Ok("There is an answer.").setHeaders(
    Header("Content-Type: text/plain"),
    Header("Connection: close")
  )
  
  printf("Status Code: %s%n", response.statusCode)
  printf("Reason Phrase: %s%n", response.reasonPhrase)
  
  response.headers.foreach(println)
  
  val contentType: Option[String] = response.getHeaderValue("Content-Type")
  
  implicit val parser = BodyParser.text()
  
  printf("Body: %s%n", response.as[String])

  Definition Classes

  root

•  package auth

  Provides specialized access to authentication headers.

  Provides specialized access to authentication headers.

  Challenges and Credentials

  When working with authentication, a Challenge is presented in the response, and Credentials in the request. Each of these has an assigned scheme, which is associated with either a token or a set of parameters.

  import scamper.Implicits.stringToUri
  import scamper.RequestMethod.Registry.Get
  import scamper.ResponseStatus.Registry.Unauthorized
  import scamper.auth.{ Authorization, Challenge, Credentials, WwwAuthenticate }
  
  // Present response challenge (scheme and parameters)
  val challenge = Challenge("Bearer", "realm" -> "developer")
  val res = Unauthorized().setWwwAuthenticate(challenge)
  
  // Present request credentials (scheme and token)
  val credentials = Credentials("Bearer", "QWxsIEFjY2VzcyEhIQo=")
  val req = Get("/dev/projects").setAuthorization(credentials)

  Basic Authentication

  There are subclasses defined for Basic authentication: BasicChallenge and BasicCredentials.

  import scamper.Implicits.stringToUri
  import scamper.RequestMethod.Registry.Get
  import scamper.ResponseStatus.Registry.Unauthorized
  import scamper.auth.{ Authorization, BasicChallenge, BasicCredentials, WwwAuthenticate }
  
  // Provide realm and optional parameters
  val challenge = BasicChallenge("admin", "title" -> "Admin Console")
  val res = Unauthorized().setWwwAuthenticate(challenge)
  
  // Provide user and password
  val credentials = BasicCredentials("sa", "l3tm31n")
  val req = Get("/admin/users").setAuthorization(credentials)

  In addition, there are methods for Basic authentication defined in the header classes.

  import scamper.Implicits.stringToUri
  import scamper.RequestMethod.Registry.Get
  import scamper.ResponseStatus.Registry.Unauthorized
  import scamper.auth.{ Authorization, WwwAuthenticate }
  
  // Provide realm and optional parameters
  val res = Unauthorized().setBasic("admin", "title" -> "Admin Console")
  
  // Access basic auth in response
  printf(s"Realm: %s%n", res.basic.realm)
  printf(s"Title: %s%n", res.basic.params("title"))
  
  // Provide user and password
  val req = Get("/admin/users").setBasic("sa", "l3tm3m1n")
  
  // Access basic auth in request
  printf(s"User: %s%n", req.basic.user)
  printf(s"Password: %s%n", req.basic.password)

  Bearer Authentication

  There are subclasses defined for Bearer authentication: BearerChallenge and BearerCredentials. In addition, there are Bearer-specific methods available in the header classes.

  import scamper.Implicits.stringToUri
  import scamper.RequestMethod.Registry.Get
  import scamper.ResponseStatus.Registry.Unauthorized
  import scamper.auth.{ Authorization, WwwAuthenticate }
  
  // Provide challenge parameters
  val res = Unauthorized().setBearer(
    "scope" -> "user profile",
    "error" -> "invalid_token",
    "error_description" -> "Expired access token"
  )
  
  // Print optional realm parameter
  res.bearer.realm.foreach(println)
  
  // Print scope from space-delimited parameter
  val scope: Seq[String] = res.bearer.scope
  scope.foreach(println)
  
  // Print error parameters
  res.bearer.error.foreach(println)
  res.bearer.errorDescription.foreach(println)
  res.bearer.errorUri.foreach(println)
  
  // Test for error conditions
  println(res.bearer.isInvalidToken)
  println(res.bearer.isInvalidRequest)
  println(res.bearer.isInsufficientScope)
  
  // Create request with Bearer token
  val req = Get("/users").setBearer("R290IDUgb24gaXQhCg==")
  
  // Access bearer auth in request
  printf("Token: %s%n", req.bearer.token)

  Definition Classes

  scamper

• AuthType
• AuthenticationInfo
• Authorization
• BasicChallenge
• BasicCredentials
• BearerChallenge
• BearerCredentials
• Challenge
• Credentials
• ProxyAuthenticate
• ProxyAuthenticationInfo
• ProxyAuthorization
• WwwAuthenticate

scamper.auth

AuthType 