+doc #19429 initial merge of docs-dev and docs

akka-docs/rst/scala/code/docs/http/scaladsl/server/CaseClassExtractionExamplesSpec.scala

@@ -0,0 +1,84 @@
+/*
+ * Copyright (C) 2009-2014 Typesafe Inc. <http://www.typesafe.com>
+ */
+
+package docs.http.scaladsl.server
+
+
+
+/*
+import org.scalatest.Inside
+import akka.http.scaladsl.server._
+
+class CaseClassExtractionExamplesSpec extends RoutingSpec with Inside {
+  // FIXME: investigate why it doesn't work without this import
+  import akka.http.scaladsl.server.directives.ParameterDirectives.ParamMagnet
+
+  // format: OFF
+
+  "example-1" in {
+    case class Color(red: Int, green: Int, blue: Int)
+
+    val route =
+      path("color") {
+        parameters('red.as[Int], 'green.as[Int], 'blue.as[Int]) { (red, green, blue) =>
+          val color = Color(red, green, blue)
+          // ... route working with the `color` instance
+          null // hide
+        }
+      }
+    Get("/color?red=1&green=2&blue=3") ~> route ~> check { responseAs[String] shouldEqual "Color(1,2,3)" } // hide
+  }
+
+  "example-2" in {
+    case class Color(red: Int, green: Int, blue: Int)
+
+    val route =
+      path("color") {
+        parameters('red.as[Int], 'green.as[Int], 'blue.as[Int]).as(Color) { color =>
+          // ... route working with the `color` instance
+          null // hide
+        }
+      }
+    Get("/color?red=1&green=2&blue=3") ~> route ~> check { responseAs[String] shouldEqual "Color(1,2,3)" } // hide
+  }
+
+  "example-3" in {
+    case class Color(name: String, red: Int, green: Int, blue: Int)
+
+    val route =
+      (path("color" / Segment) & parameters('r.as[Int], 'g.as[Int], 'b.as[Int]))
+        .as(Color) { color =>
+          // ... route working with the `color` instance
+          null // hide
+        }
+    Get("/color/abc?r=1&g=2&b=3") ~> route ~> check { responseAs[String] shouldEqual "Color(abc,1,2,3)" } // hide
+  }
+
+  //# example-4
+  case class Color(name: String, red: Int, green: Int, blue: Int) {
+    require(!name.isEmpty, "color name must not be empty")
+    require(0 <= red && red <= 255, "red color component must be between 0 and 255")
+    require(0 <= green && green <= 255, "green color component must be between 0 and 255")
+    require(0 <= blue && blue <= 255, "blue color component must be between 0 and 255")
+  }
+  //#
+
+  "example 4 test" in {
+    val route =
+      (path("color" / Segment) &
+        parameters('r.as[Int], 'g.as[Int], 'b.as[Int])).as(Color) { color =>
+        doSomethingWith(color) // route working with the Color instance
+      }
+    Get("/color/abc?r=1&g=2&b=3") ~> route ~> check {
+      responseAs[String] shouldEqual "Color(abc,1,2,3)"
+    }
+    Get("/color/abc?r=1&g=2&b=345") ~> route ~> check {
+      inside(rejection) {
+        case ValidationRejection("requirement failed: blue color component must be between 0 and 255", _) =>
+      }
+    }
+  }
+
+  def doSomethingWith(x: Any) = complete(x.toString)
+}*/