+htc add popular ContentType instances for convenience

akka-docs-dev/rst/scala/code/docs/http/scaladsl/HttpServerExampleSpec.scala

@@ -12,7 +12,9 @@ import akka.http.scaladsl.model._
 import akka.stream.ActorMaterializer
 import akka.stream.scaladsl.{ Flow, Sink }
 import akka.stream.stage.{ Context, PushStage }
+import akka.testkit.TestActors
 import org.scalatest.{ Matchers, WordSpec }
+import scala.language.postfixOps
 
 import scala.concurrent.{ ExecutionContext, Future }
 
@@ -21,7 +23,9 @@ class HttpServerExampleSpec extends WordSpec with Matchers {
   // never actually called
   val log: LoggingAdapter = null
 
-  "binding-example" in {
+  def compileOnlySpec(body: => Unit) = ()
+
+  "binding-example" in compileOnlySpec {
     import akka.http.scaladsl.Http
     import akka.stream.ActorMaterializer
     import akka.stream.scaladsl._
@@ -39,7 +43,7 @@ class HttpServerExampleSpec extends WordSpec with Matchers {
       }).run()
   }
 
-  "binding-failure-high-level-example" in {
+  "binding-failure-high-level-example" in compileOnlySpec {
     import akka.http.scaladsl.Http
     import akka.http.scaladsl.server.Directives._
     import akka.stream.ActorMaterializer
@@ -68,7 +72,7 @@ class HttpServerExampleSpec extends WordSpec with Matchers {
   val handleConnections: Sink[Http.IncomingConnection, Future[Http.ServerBinding]] =
     Sink.ignore.mapMaterializedValue(_ => Future.failed(new Exception("")))
 
-  "binding-failure-handling" in {
+  "binding-failure-handling" in compileOnlySpec {
     implicit val system = ActorSystem()
     implicit val materializer = ActorMaterializer()
     implicit val ec = system.dispatcher
@@ -87,7 +91,11 @@ class HttpServerExampleSpec extends WordSpec with Matchers {
     }
   }
 
-  "incoming-connections-source-failure-handling" in {
+  object MyExampleMonitoringActor {
+    def props = TestActors.echoActorProps
+  }
+
+  "incoming-connections-source-failure-handling" in compileOnlySpec {
     implicit val system = ActorSystem()
     implicit val materializer = ActorMaterializer()
     implicit val ec = system.dispatcher
@@ -96,7 +104,7 @@ class HttpServerExampleSpec extends WordSpec with Matchers {
     val (host, port) = ("localhost", 8080)
     val serverSource = Http().bind(host, port)
 
-    val failureMonitor: ActorRef = ???
+    val failureMonitor: ActorRef = system.actorOf(MyExampleMonitoringActor.props)
 
     val reactToTopLevelFailures = Flow[IncomingConnection]
       .transform { () =>
@@ -117,7 +125,7 @@ class HttpServerExampleSpec extends WordSpec with Matchers {
       .run()
   }
 
-  "connection-stream-failure-handling" in {
+  "connection-stream-failure-handling" in compileOnlySpec {
     implicit val system = ActorSystem()
     implicit val materializer = ActorMaterializer()
     implicit val ec = system.dispatcher
@@ -151,7 +159,7 @@ class HttpServerExampleSpec extends WordSpec with Matchers {
       }
   }
 
-  "full-server-example" in {
+  "full-server-example" in compileOnlySpec {
     import akka.http.scaladsl.Http
     import akka.http.scaladsl.model.HttpMethods._
     import akka.http.scaladsl.model._
@@ -188,7 +196,7 @@ class HttpServerExampleSpec extends WordSpec with Matchers {
       }).run()
   }
 
-  "low-level-server-example" in {
+  "low-level-server-example" in compileOnlySpec {
     import akka.http.scaladsl.Http
     import akka.http.scaladsl.model.HttpMethods._
     import akka.http.scaladsl.model._
@@ -217,7 +225,7 @@ class HttpServerExampleSpec extends WordSpec with Matchers {
 
   // format: OFF
 
-  "high-level-server-example" in {
+  "high-level-server-example" in compileOnlySpec {
     import akka.http.scaladsl.Http
     import akka.http.scaladsl.marshallers.xml.ScalaXmlSupport._
     import akka.http.scaladsl.server.Directives._
@@ -247,7 +255,7 @@ class HttpServerExampleSpec extends WordSpec with Matchers {
     Http().bindAndHandle(route, "localhost", 8080)
   }
 
-  "minimal-routing-example" in {
+  "minimal-routing-example" in compileOnlySpec {
     import akka.http.scaladsl.Http
     import akka.http.scaladsl.marshallers.xml.ScalaXmlSupport._
     import akka.http.scaladsl.server.Directives._
@@ -277,12 +285,16 @@ class HttpServerExampleSpec extends WordSpec with Matchers {
     }
   }
 
-  "long-routing-example" in {
+  "long-routing-example" in compileOnlySpec {
+    //#long-routing-example
     import akka.actor.ActorRef
     import akka.http.scaladsl.coding.Deflate
     import akka.http.scaladsl.marshalling.ToResponseMarshaller
     import akka.http.scaladsl.model.StatusCodes.MovedPermanently
     import akka.http.scaladsl.server.Directives._
+    // TODO: these explicit imports are only needed in complex cases, like below; Also, not needed on Scala 2.11
+    import akka.http.scaladsl.server.directives.ParameterDirectives.ParamMagnet
+    import akka.http.scaladsl.server.directives.FormFieldDirectives.FieldMagnet
     import akka.http.scaladsl.unmarshalling.FromRequestUnmarshaller
     import akka.pattern.ask
     import akka.util.Timeout
@@ -294,13 +306,22 @@ class HttpServerExampleSpec extends WordSpec with Matchers {
     case class Order(email: String, amount: Money)
     case class Update(order: Order)
     case class OrderItem(i: Int, os: Option[String], s: String)
+
+    // marshalling would usually be derived automatically using libraries
     implicit val orderUM: FromRequestUnmarshaller[Order] = ???
-    implicit val orderM: ToResponseMarshaller[Seq[Order]] = ???
+    implicit val orderM: ToResponseMarshaller[Order] = ???
+    implicit val orderSeqM: ToResponseMarshaller[Seq[Order]] = ???
     implicit val timeout: Timeout = ??? // for actor asks
     implicit val ec: ExecutionContext = ???
     implicit val mat: ActorMaterializer = ???
     implicit val sys: ActorSystem = ???
 
+    // backend entry points
+    def myAuthenticator: Authenticator[User] = ???
+    def retrieveOrdersFromDB: Seq[Order] = ???
+    def myDbActor: ActorRef = ???
+    def processOrderRequest(id: Int, complete: Order => Unit): Unit = ???
+
     val route = {
       path("orders") {
         authenticateBasic(realm = "admin area", myAuthenticator) { user =>
@@ -373,11 +394,5 @@ class HttpServerExampleSpec extends WordSpec with Matchers {
         redirect("http://oldapi.example.com/" + pathRest, MovedPermanently)
       }
     }
-
-    // backend entry points
-    def myAuthenticator: Authenticator[User] = ???
-    def retrieveOrdersFromDB: Seq[Order] = ???
-    def myDbActor: ActorRef = ???
-    def processOrderRequest(id: Int, complete: Order => Unit): Unit = ???
   }
 }