=doc document java-side handlers

2015-07-10 19:11:08 +02:00 · 2015-07-10 19:11:08 +02:00 · 6d80945be2
commit 6d80945be2
parent f9b8125333
10 changed files with 332 additions and 1 deletions
--- a/akka-docs-dev/rst/java/code/docs/http/javadsl/HandlerExampleSpec.java
+++ b/akka-docs-dev/rst/java/code/docs/http/javadsl/HandlerExampleSpec.java
@ -0,0 +1,157 @@
+/*
+ * Copyright (C) 2009-2015 Typesafe Inc. <http://www.typesafe.com>
+ */
+
+package docs.http.javadsl;
+
+import akka.http.javadsl.model.HttpRequest;
+import akka.http.javadsl.server.*;
+import akka.http.javadsl.server.values.Parameters;
+import akka.http.javadsl.server.values.PathMatchers;
+import akka.http.javadsl.testkit.JUnitRouteTest;
+import akka.http.javadsl.testkit.TestRoute;
+import org.junit.Test;
+
+public class HandlerExampleSpec extends JUnitRouteTest {
+    @Test
+    public void testSimpleHandler() {
+        //#simple-handler-example-full
+        class TestHandler extends akka.http.javadsl.server.AllDirectives {
+            //#simple-handler
+            Handler handler = new Handler() {
+                @Override
+                public RouteResult handle(RequestContext ctx) {
+                    return ctx.complete("This was a " + ctx.request().method().value()  +
+                            " request to "+ctx.request().getUri());
+                }
+            };
+            //#simple-handler
+
+            Route createRoute() {
+                return route(
+                    get(
+                        handleWith(handler)
+                    ),
+                    post(
+                        path("abc").route(
+                            handleWith(handler)
+                        )
+                    )
+                );
+            }
+        }
+
+        // actual testing code
+        TestRoute r = testRoute(new TestHandler().createRoute());
+        r.run(HttpRequest.GET("/test"))
+            .assertStatusCode(200)
+            .assertEntity("This was a GET request to /test");
+
+        r.run(HttpRequest.POST("/test"))
+            .assertStatusCode(404);
+
+        r.run(HttpRequest.POST("/abc"))
+            .assertStatusCode(200)
+            .assertEntity("This was a POST request to /abc");
+        //#simple-handler-example-full
+    }
+
+    @Test
+    public void testCalculator() {
+        //#handler2-example-full
+        class TestHandler extends akka.http.javadsl.server.AllDirectives {
+            RequestVal<Integer> xParam = Parameters.intValue("x");
+            RequestVal<Integer> yParam = Parameters.intValue("y");
+
+            RequestVal<Integer> xSegment = PathMatchers.integerNumber();
+            RequestVal<Integer> ySegment = PathMatchers.integerNumber();
+
+            //#handler2
+            Handler2<Integer, Integer> multiply =
+                new Handler2<Integer, Integer>() {
+                    @Override
+                    public RouteResult handle(RequestContext ctx, Integer x, Integer y) {
+                        int result = x * y;
+                        return ctx.complete("x * y = " + result);
+                    }
+                };
+
+            Route multiplyXAndYParam = handleWith(xParam, yParam, multiply);
+            //#handler2
+
+            Route createRoute() {
+                return route(
+                    get(
+                        pathPrefix("calculator").route(
+                            path("multiply").route(
+                                multiplyXAndYParam
+                            ),
+                            path("path-multiply", xSegment, ySegment).route(
+                                handleWith(xSegment, ySegment, multiply)
+                            )
+                        )
+                    )
+                );
+            }
+        }
+
+        // actual testing code
+        TestRoute r = testRoute(new TestHandler().createRoute());
+        r.run(HttpRequest.GET("/calculator/multiply?x=12&y=42"))
+            .assertStatusCode(200)
+            .assertEntity("x * y = 504");
+
+        r.run(HttpRequest.GET("/calculator/path-multiply/23/5"))
+            .assertStatusCode(200)
+            .assertEntity("x * y = 115");
+        //#handler2-example-full
+    }
+
+    @Test
+    public void testCalculatorReflective() {
+        //#reflective-example-full
+        class TestHandler extends akka.http.javadsl.server.AllDirectives {
+            RequestVal<Integer> xParam = Parameters.intValue("x");
+            RequestVal<Integer> yParam = Parameters.intValue("y");
+
+            RequestVal<Integer> xSegment = PathMatchers.integerNumber();
+            RequestVal<Integer> ySegment = PathMatchers.integerNumber();
+
+
+            //#reflective
+            public RouteResult multiply(RequestContext ctx, Integer x, Integer y) {
+                int result = x * y;
+                return ctx.complete("x * y = " + result);
+            }
+
+            Route multiplyXAndYParam = handleWith(this, "multiply", xParam, yParam);
+            //#reflective
+
+            Route createRoute() {
+                return route(
+                    get(
+                        pathPrefix("calculator").route(
+                            path("multiply").route(
+                                multiplyXAndYParam
+                            ),
+                            path("path-multiply", xSegment, ySegment).route(
+                                handleWith(this, "multiply", xSegment, ySegment)
+                            )
+                        )
+                    )
+                );
+            }
+        }
+
+        // actual testing code
+        TestRoute r = testRoute(new TestHandler().createRoute());
+        r.run(HttpRequest.GET("/calculator/multiply?x=12&y=42"))
+            .assertStatusCode(200)
+            .assertEntity("x * y = 504");
+
+        r.run(HttpRequest.GET("/calculator/path-multiply/23/5"))
+            .assertStatusCode(200)
+            .assertEntity("x * y = 115");
+        //#reflective-example-full
+    }
+}