+doc #20466 example snippet for akka http java dsl: ParameterDirectives (#20823)

akka-docs/rst/java/code/docs/http/javadsl/server/directives/ParameterDirectivesExamplesTest.java

@@ -0,0 +1,121 @@
+/*
+ * Copyright (C) 2016-2016 Lightbend Inc. <http://www.lightbend.com>
+ */
+package docs.http.javadsl.server.directives;
+
+import akka.http.javadsl.model.HttpRequest;
+import akka.http.javadsl.model.StatusCodes;
+import akka.http.javadsl.server.Route;
+import akka.http.javadsl.testkit.JUnitRouteTest;
+import org.junit.Test;
+
+import java.util.Map.Entry;
+import java.util.function.Function;
+import java.util.stream.Collectors;
+
+public class ParameterDirectivesExamplesTest extends JUnitRouteTest {
+
+  @Test
+  public void testParameter() {
+    //#parameter
+    final Route route = parameter("color", color ->
+      complete("The color is '" + color + "'")
+    );
+
+    // tests:
+    testRoute(route).run(HttpRequest.GET("/?color=blue"))
+      .assertEntity("The color is 'blue'");
+
+    testRoute(route).run(HttpRequest.GET("/"))
+      .assertStatusCode(StatusCodes.NOT_FOUND)
+      .assertEntity("Request is missing required query parameter 'color'");
+    //#parameter
+  }
+
+  @Test
+  public void testParameters() {
+    //#parameters
+    final Route route = parameter("color", color ->
+      parameter("backgroundColor", backgroundColor ->
+        complete("The color is '" + color
+                   + "' and the background is '" + backgroundColor + "'")
+      )
+    );
+
+    // tests:
+    testRoute(route).run(HttpRequest.GET("/?color=blue&backgroundColor=red"))
+      .assertEntity("The color is 'blue' and the background is 'red'");
+
+    testRoute(route).run(HttpRequest.GET("/?color=blue"))
+      .assertStatusCode(StatusCodes.NOT_FOUND)
+      .assertEntity("Request is missing required query parameter 'backgroundColor'");
+    //#parameters
+  }
+
+  @Test
+  public void testParameterMap() {
+    //#parameterMap
+    final Function<Entry, String> paramString =
+      entry -> entry.getKey() + " = '" + entry.getValue() + "'";
+
+    final Route route = parameterMap(params -> {
+      final String pString = params.entrySet()
+        .stream()
+        .map(paramString::apply)
+        .collect(Collectors.joining(", "));
+      return complete("The parameters are " + pString);
+    });
+
+    // tests:
+    testRoute(route).run(HttpRequest.GET("/?color=blue&count=42"))
+      .assertEntity("The parameters are color = 'blue', count = '42'");
+
+    testRoute(route).run(HttpRequest.GET("/?x=1&x=2"))
+      .assertEntity("The parameters are x = '2'");
+    //#parameterMap
+  }
+
+  @Test
+  public void testParameterMultiMap() {
+    //#parameterMultiMap
+    final Route route = parameterMultiMap(params -> {
+      final String pString = params.entrySet()
+        .stream()
+        .map(e -> e.getKey() + " -> " + e.getValue().size())
+        .collect(Collectors.joining(", "));
+      return complete("There are parameters " + pString);
+    });
+
+    // tests:
+    testRoute(route).run(HttpRequest.GET("/?color=blue&count=42"))
+      .assertEntity("There are parameters color -> 1, count -> 1");
+
+    testRoute(route).run(HttpRequest.GET("/?x=23&x=42"))
+      .assertEntity("There are parameters x -> 2");
+    //#parameterMultiMap
+  }
+
+  @Test
+  public void testParameterSeq() {
+    //#parameterSeq
+    final Function<Entry, String> paramString =
+      entry -> entry.getKey() + " = '" + entry.getValue() + "'";
+
+    final Route route = parameterList(params -> {
+      final String pString = params.stream()
+        .map(paramString::apply)
+        .collect(Collectors.joining(", "));
+
+      return complete("The parameters are " + pString);
+    });
+
+    // tests:
+    testRoute(route).run(HttpRequest.GET("/?color=blue&count=42"))
+      .assertEntity("The parameters are color = 'blue', count = '42'");
+
+    testRoute(route).run(HttpRequest.GET("/?x=1&x=2"))
+      .assertEntity("The parameters are x = '1', x = '2'");
+    //#parameterSeq
+  }
+
+}