Add missing tutorial tests (#2694)

christiangoerdes · web-flow · commit 35234ad820c8 · 2026-01-26T17:57:54.000+01:00
* add missing tutorial tests

* add tutorial tests for transformation and orchestration
diff --git a/distribution/src/test/java/com/predic8/membrane/tutorials/advanced/ChooseTutorialTest.java b/distribution/src/test/java/com/predic8/membrane/tutorials/advanced/ChooseTutorialTest.java
@@ -0,0 +1,51 @@
+package com.predic8.membrane.tutorials.advanced;
+
+import org.junit.jupiter.api.Test;
+
+import static io.restassured.RestAssured.given;
+
+public class ChooseTutorialTest extends AbstractAdvancedTutorialTest {
+
+    @Override
+    protected String getTutorialYaml() {
+        return "65-Choose.yaml";
+    }
+
+
+    @Test
+    void withoutHeader_returns400() {
+        // @formatter:off
+        given()
+        .when()
+            .get("http://localhost:2000/")
+        .then()
+            .statusCode(400);
+        // @formatter:on
+    }
+
+    @Test
+    void withXFoo_returns200() {
+        // @formatter:off
+        given()
+            .header("X-Foo", "1")
+        .when()
+            .get("http://localhost:2000/")
+        .then()
+            .statusCode(200);
+        // @formatter:on
+    }
+
+    @Test
+    void withXBar_returns300_andConnectionClosed() {
+        // @formatter:off
+        given()
+            .header("X-Bar", "1")
+        .when()
+            .get("http://localhost:2000/")
+        .then()
+            .statusCode(300)
+            .header("Connection", "close");
+        // @formatter:on
+    }
+
+}
diff --git a/distribution/src/test/java/com/predic8/membrane/tutorials/advanced/IfElseTutorialTest.java b/distribution/src/test/java/com/predic8/membrane/tutorials/advanced/IfElseTutorialTest.java
@@ -0,0 +1,37 @@
+package com.predic8.membrane.tutorials.advanced;
+
+import org.junit.jupiter.api.Test;
+
+import static io.restassured.RestAssured.given;
+
+public class IfElseTutorialTest extends AbstractAdvancedTutorialTest {
+
+    @Override
+    protected String getTutorialYaml() {
+        return "61-If-Else.yaml";
+    }
+
+    @Test
+    void withoutHeader_returns400() {
+        // @formatter:off
+        given()
+        .when()
+            .get("http://localhost:2000/")
+        .then()
+            .statusCode(400);
+        // @formatter:on
+    }
+
+    @Test
+    void withHeader_returns200() {
+        // @formatter:off
+        given()
+            .header("X-Foo", "1")
+        .when()
+            .get("http://localhost:2000/")
+        .then()
+            .statusCode(200);
+        // @formatter:on
+    }
+
+}
diff --git a/distribution/src/test/java/com/predic8/membrane/tutorials/advanced/RemovingHttpHeadersTutorialTest.java b/distribution/src/test/java/com/predic8/membrane/tutorials/advanced/RemovingHttpHeadersTutorialTest.java
@@ -0,0 +1,71 @@
+package com.predic8.membrane.tutorials.advanced;
+
+import org.junit.jupiter.api.Test;
+
+import java.io.ByteArrayOutputStream;
+import java.io.PrintStream;
+
+import static io.restassured.RestAssured.given;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+public class RemovingHttpHeadersTutorialTest extends AbstractAdvancedTutorialTest {
+
+    @Override
+    protected String getTutorialYaml() {
+        return "80-Removing-HTTP-Headers.yaml";
+    }
+
+    @Test
+    void logsBeforeAndAfterHeaders() {
+        synchronized (System.out) {
+            ByteArrayOutputStream out = new ByteArrayOutputStream();
+            PrintStream original = System.out;
+            System.setOut(new PrintStream(out));
+
+            try {
+                // @formatter:off
+                given()
+                    .header("X-Foo", "1")
+                    .header("X-bar", "2")
+                .when()
+                    .get("http://localhost:2000")
+                .then()
+                    .statusCode(200);
+                // @formatter:on
+            } finally {
+                System.setOut(original);
+            }
+
+            String console = out.toString();
+
+            int beforeIdx = lastIndexOfIgnoreCase(console, "Before:");
+            int afterIdx  = lastIndexOfIgnoreCase(console, "After:");
+            assertTrue(beforeIdx >= 0, "Missing 'Before:' log.");
+            assertTrue(afterIdx > beforeIdx, "Missing 'After:' log or wrong order.");
+
+            String before = console.substring(beforeIdx, afterIdx);
+            String after  = console.substring(afterIdx);
+
+            assertTrue(containsIgnoreCase(before, "X-Foo: 1"));
+            assertTrue(containsIgnoreCase(before, "X-bar: 2"));
+
+            assertTrue(containsIgnoreCase(after, "Host:"));
+            assertTrue(containsIgnoreCase(after, "Accept:"));
+            assertTrue(containsIgnoreCase(after, "X-Foo: 1"));
+
+            assertFalse(containsIgnoreCase(after, "X-bar:"));
+            assertFalse(containsIgnoreCase(after, "User-Agent:"));
+            assertFalse(containsIgnoreCase(after, "X-Forwarded-"));
+        }
+    }
+
+    private static boolean containsIgnoreCase(String haystack, String needle) {
+        return haystack.toLowerCase().contains(needle.toLowerCase());
+    }
+
+    private static int lastIndexOfIgnoreCase(String haystack, String needle) {
+        return haystack.toLowerCase().lastIndexOf(needle.toLowerCase());
+    }
+
+}
diff --git a/distribution/src/test/java/com/predic8/membrane/tutorials/orchestration/AbstractOrchestrationTutorialTest.java b/distribution/src/test/java/com/predic8/membrane/tutorials/orchestration/AbstractOrchestrationTutorialTest.java
@@ -0,0 +1,12 @@
+package com.predic8.membrane.tutorials.orchestration;
+
+import com.predic8.membrane.tutorials.AbstractMembraneTutorialTest;
+
+public abstract class AbstractOrchestrationTutorialTest extends AbstractMembraneTutorialTest {
+
+    @Override
+    protected String getTutorialDir() {
+        return "orchestration";
+    }
+
+}
diff --git a/distribution/src/test/java/com/predic8/membrane/tutorials/orchestration/OrchestrationTutorialTest.java b/distribution/src/test/java/com/predic8/membrane/tutorials/orchestration/OrchestrationTutorialTest.java
@@ -0,0 +1,36 @@
+package com.predic8.membrane.tutorials.orchestration;
+
+import org.junit.jupiter.api.Test;
+
+import static io.restassured.RestAssured.given;
+import static org.hamcrest.Matchers.equalTo;
+
+public class OrchestrationTutorialTest extends AbstractOrchestrationTutorialTest {
+
+    @Override
+    protected String getTutorialYaml() {
+        return "10-Orchestration.yaml";
+    }
+
+    @Test
+    void books_areReturnedById() {
+        // @formatter:off
+        given()
+        .when()
+            .get("http://localhost:2000/books/{id}", "OL29474405M")
+        .then()
+            .statusCode(200)
+            .body("title", equalTo("So Long, and Thanks for All the Fish"))
+            .body("author", equalTo("Douglas Adams"));
+
+        given()
+        .when()
+            .get("http://localhost:2000/books/{id}", "OL26333978M")
+        .then()
+            .statusCode(200)
+            .body("title", equalTo("Foucault's pendulum"))
+            .body("author", equalTo("Umberto Eco"));
+        // @formatter:on
+    }
+
+}
diff --git a/distribution/src/test/java/com/predic8/membrane/tutorials/transformation/AbstractTransformationTutorialTest.java b/distribution/src/test/java/com/predic8/membrane/tutorials/transformation/AbstractTransformationTutorialTest.java
@@ -0,0 +1,12 @@
+package com.predic8.membrane.tutorials.transformation;
+
+import com.predic8.membrane.tutorials.AbstractMembraneTutorialTest;
+
+public abstract class AbstractTransformationTutorialTest extends AbstractMembraneTutorialTest {
+
+    @Override
+    protected String getTutorialDir() {
+        return "transformation";
+    }
+
+}
diff --git a/distribution/src/test/java/com/predic8/membrane/tutorials/transformation/GetToPostTutorialTest.java b/distribution/src/test/java/com/predic8/membrane/tutorials/transformation/GetToPostTutorialTest.java
@@ -0,0 +1,50 @@
+package com.predic8.membrane.tutorials.transformation;
+
+import org.junit.jupiter.api.Test;
+
+import static io.restassured.RestAssured.given;
+import static io.restassured.RestAssured.withArgs;
+import static org.hamcrest.Matchers.*;
+
+public class GetToPostTutorialTest extends AbstractTransformationTutorialTest {
+
+    @Override
+    protected String getTutorialYaml() {
+        return "20-GET-to-POST.yaml";
+    }
+
+    @Test
+    void addedProductIsPresentInUpstreamList() {
+        var added =
+                // @formatter:off
+                given()
+                    .queryParam("name", "Lemon")
+                    .queryParam("price", "0.30")
+                .when()
+                    .get("http://localhost:2000/add")
+                .then()
+                    .statusCode(201)
+                    .body("id", notNullValue())
+                    .body("name", equalTo("Lemon"))
+                    .body("price", equalTo(0.3F))
+                    .body("self_link", startsWith("/shop/v2/products/"))
+                    .extract()
+                    .jsonPath();
+                // @formatter:on
+
+        int id = added.getInt("id");
+
+        // @formatter:off
+        given()
+            .relaxedHTTPSValidation()
+            .queryParam("limit", 1000)
+        .when()
+            .get("https://api.predic8.de/shop/v2/products")
+        .then()
+            .statusCode(200)
+            .body("products.find { it.id == %s }.name", withArgs(id), equalTo("Lemon"))
+            .body("products.find { it.id == %s }.self_link", withArgs(id), equalTo("/shop/v2/products/" + id));
+        // @formatter:on
+    }
+
+}
diff --git a/distribution/src/test/java/com/predic8/membrane/tutorials/transformation/PostToGetTutorialTest.java b/distribution/src/test/java/com/predic8/membrane/tutorials/transformation/PostToGetTutorialTest.java
@@ -0,0 +1,49 @@
+package com.predic8.membrane.tutorials.transformation;
+
+import org.junit.jupiter.api.Test;
+
+import java.util.List;
+
+import static io.restassured.RestAssured.given;
+import static org.hamcrest.Matchers.*;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+public class PostToGetTutorialTest extends AbstractTransformationTutorialTest {
+
+    @Override
+    protected String getTutorialYaml() {
+        return "10-POST-to-GET.yaml";
+    }
+
+    @Test
+    void verifyProductListIsSortedAfterPost() {
+        var res =
+                // @formatter:off
+                given()
+                    .contentType("application/json")
+                    .body("""
+                      {"limit":100,"sort":"name"}"""
+                    )
+                .when()
+                    .post("http://localhost:2000/shop/v2/products")
+                .then()
+                    .statusCode(200)
+                    .body("meta", notNullValue())
+                    .body("meta.count", greaterThan(0))
+                    .body("products", notNullValue())
+                    .body("products.size()", greaterThan(0))
+                    .body("products[0].name", not(empty()))
+                    .body("products[0].self_link", startsWith("/shop/v2/products/"))
+                    .extract();
+                // @formatter:on
+
+        List<String> names = res.jsonPath().getList("products.name", String.class);
+
+        for (int i = 1; i < names.size(); i++) {
+            String prev = names.get(i - 1);
+            String cur  = names.get(i);
+            if (prev == null || cur == null) continue;
+            assertTrue(prev.compareToIgnoreCase(cur) <= 0);
+        }
+    }
+}
diff --git a/distribution/src/test/java/com/predic8/membrane/tutorials/transformation/TemplateJsonFromMapTutorialTest.java b/distribution/src/test/java/com/predic8/membrane/tutorials/transformation/TemplateJsonFromMapTutorialTest.java
@@ -0,0 +1,33 @@
+package com.predic8.membrane.tutorials.transformation;
+
+import org.junit.jupiter.api.Test;
+
+import static io.restassured.RestAssured.given;
+import static org.hamcrest.Matchers.*;
+
+public class TemplateJsonFromMapTutorialTest extends AbstractTransformationTutorialTest {
+
+    @Override
+    protected String getTutorialYaml() {
+        return "30-Template-JSON-from-MAP.yaml";
+    }
+
+    @Test
+    void responseMap() {
+        // @formatter:off
+        given()
+        .when()
+            .get("http://localhost:2000")
+        .then()
+            .statusCode(200)
+            .contentType(containsString("application/json"))
+            .body("Host", not(empty()))
+            .body("Accept", notNullValue())
+            .body("User-Agent", not(empty()))
+            .body("X-Forwarded-For", not(empty()))
+            .body("X-Forwarded-Proto", anyOf(equalTo("http"), equalTo("https")))
+            .body("X-Forwarded-Host", not(empty()));
+        // @formatter:on
+    }
+
+}
diff --git a/distribution/tutorials/advanced/61-If-Else.yaml b/distribution/tutorials/advanced/61-If-Else.yaml
@@ -3,8 +3,8 @@
 # Tutorial: If Else
 #
 # Try:
-#   1.) curl localhost:2000
-#   2.) curl -H "X-Foo: 1" localhost:2000
+#   1.) curl -v localhost:2000
+#   2.) curl -v -H "X-Foo: 1" localhost:2000
 #
 api:
   port: 2000
diff --git a/distribution/tutorials/advanced/65-Choose.yaml b/distribution/tutorials/advanced/65-Choose.yaml
@@ -3,9 +3,9 @@
 # Tutorial: Choose
 #
 # Try:
-#   1.) curl localhost:2000
-#   2.) curl -H "X-Foo: 1" localhost:2000
-#   3.) curl -H "X-Bar: 1" localhost:2000
+#   1.) curl -v localhost:2000
+#   2.) curl -v -H "X-Foo: 1" localhost:2000
+#   3.) curl -v -H "X-Bar: 1" localhost:2000
 #
 api:
   port: 2000

Original file line number	Diff line number	Diff line change
`@@ -3,8 +3,8 @@`
`3`	`3`	`# Tutorial: If Else`
`4`	`4`	`#`
`5`	`5`	`# Try:`
`6`		`-# 1.) curl localhost:2000`
`7`		`-# 2.) curl -H "X-Foo: 1" localhost:2000`
	`6`	`+# 1.) curl -v localhost:2000`
	`7`	`+# 2.) curl -v -H "X-Foo: 1" localhost:2000`
`8`	`8`	`#`
`9`	`9`	`api:`
`10`	`10`	`port: 2000`