From ea9f8419c94a908ade8ca2dd517c3c07e911db0b Mon Sep 17 00:00:00 2001
From: Manfred Riem <mriem@manorrock.com>
Date: Wed, 9 Oct 2024 16:57:22 -0500
Subject: [PATCH] Fixes #4043 - Update Piranha Servlet - Create a Pages
 application guide (#4044)

---
 test/servlet/pages/.gitignore                 |   1 +
 test/servlet/pages/README.md                  |   6 +
 test/servlet/pages/pom.xml                    | 122 ++++++++++++++++++
 .../pages/src/main/webapp/hellopages.jsp      |  12 ++
 .../pages/src/test/java/hello/HelloIT.java    |  28 ++++
 test/servlet/pom.xml                          |   1 +
 6 files changed, 170 insertions(+)
 create mode 100644 test/servlet/pages/.gitignore
 create mode 100644 test/servlet/pages/README.md
 create mode 100644 test/servlet/pages/pom.xml
 create mode 100644 test/servlet/pages/src/main/webapp/hellopages.jsp
 create mode 100644 test/servlet/pages/src/test/java/hello/HelloIT.java

diff --git a/test/servlet/pages/.gitignore b/test/servlet/pages/.gitignore
new file mode 100644
index 000000000..2f7896d1d
--- /dev/null
+++ b/test/servlet/pages/.gitignore
@@ -0,0 +1 @@
+target/
diff --git a/test/servlet/pages/README.md b/test/servlet/pages/README.md
new file mode 100644
index 000000000..91eab9102
--- /dev/null
+++ b/test/servlet/pages/README.md
@@ -0,0 +1,6 @@
+
+# Create a Jakarta Pages application on Piranha Servlet
+
+See [Create a Jakarta Pages application on Piranha Servlet](https://piranha.cloud/servlet/guides/pages) 
+for the step by step guide. This repository contains the resulting project for
+your reference.
diff --git a/test/servlet/pages/pom.xml b/test/servlet/pages/pom.xml
new file mode 100644
index 000000000..b861a05a4
--- /dev/null
+++ b/test/servlet/pages/pom.xml
@@ -0,0 +1,122 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<project
+    xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <!--
+
+    WARNING - Do not remove the versions in the properties section as this
+    particular project is used as a basis for the guide content at 
+    docs/src/site/markdown/servlet/create_a_jakarta_pages_application.md.
+  
+    When updating the guide do the following:
+
+    1. Drop the parent part below
+    2. Change the name of the project to read 'Create a Jakara Pages application'
+    3. Change the piranha.version to the latest released version of Piranha
+
+    -->
+    <parent>
+        <groupId>cloud.piranha.test.servlet</groupId>
+        <artifactId>project</artifactId>
+        <version>24.10.0-SNAPSHOT</version>
+    </parent>
+    <groupId>cloud.piranha.test.servlet</groupId>
+    <artifactId>pages</artifactId>
+    <version>24.10.0-SNAPSHOT</version>
+    <packaging>war</packaging>
+    <name>Piranha - Test - Servlet - Jakarta Pages application</name>
+    <properties>
+        <!-- dependencies -->
+        <junit.version>5.10.2</junit.version>
+        <piranha.version>24.4.0</piranha.version>
+        <!-- other -->
+        <java.version>21</java.version>
+        <piranha.distribution>servlet</piranha.distribution>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        <!-- plugins -->
+        <maven-compiler-plugin.version>3.13.0</maven-compiler-plugin.version>
+        <maven-failsafe-plugin.version>3.2.5</maven-failsafe-plugin.version>
+        <maven-war-plugin.version>3.4.0</maven-war-plugin.version>
+    </properties>
+    <dependencies>
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter-api</artifactId>
+            <version>${junit.version}</version>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter-engine</artifactId>
+            <version>${junit.version}</version>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter-params</artifactId>
+            <version>${junit.version}</version>
+            <scope>test</scope>
+        </dependency>
+    </dependencies>
+    <build>
+        <finalName>pages</finalName>
+        <plugins>
+            <plugin>
+                <groupId>cloud.piranha.maven.plugins</groupId>
+                <artifactId>piranha-maven-plugin</artifactId>
+                <version>${piranha.version}</version>
+                <executions>
+                    <execution>
+                        <id>pre-integration-test</id>
+                        <phase>pre-integration-test</phase>
+                        <goals>
+                            <goal>start</goal>
+                        </goals>
+                    </execution>
+                    <execution>
+                        <id>post-integration-test</id>
+                        <phase>post-integration-test</phase>
+                        <goals>
+                            <goal>stop</goal>
+                        </goals>
+                    </execution>
+                </executions>
+                <configuration>
+                    <distribution>servlet</distribution>
+                </configuration>
+            </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-compiler-plugin</artifactId>
+                <version>${maven-compiler-plugin.version}</version>
+                <configuration>
+                    <release>${java.version}</release>
+                </configuration>
+            </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-failsafe-plugin</artifactId>
+                <version>${maven-failsafe-plugin.version}</version>
+                <executions>
+                    <execution>
+                        <goals>
+                            <goal>integration-test</goal>
+                            <goal>verify</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-war-plugin</artifactId>
+                <version>${maven-war-plugin.version}</version>
+                <configuration>
+                    <failOnMissingWebXml>false</failOnMissingWebXml>
+                </configuration>
+            </plugin>
+        </plugins>
+    </build>
+</project>
diff --git a/test/servlet/pages/src/main/webapp/hellopages.jsp b/test/servlet/pages/src/main/webapp/hellopages.jsp
new file mode 100644
index 000000000..a5b8c26a1
--- /dev/null
+++ b/test/servlet/pages/src/main/webapp/hellopages.jsp
@@ -0,0 +1,12 @@
+<%@page contentType="text/html" pageEncoding="UTF-8"%>
+
+<!DOCTYPE html>
+
+<html>
+    <head>
+        <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+    </head>
+    <body>
+        <h1>Hello from Jakarta Pages!</h1>
+    </body>
+</html>
diff --git a/test/servlet/pages/src/test/java/hello/HelloIT.java b/test/servlet/pages/src/test/java/hello/HelloIT.java
new file mode 100644
index 000000000..2eb000593
--- /dev/null
+++ b/test/servlet/pages/src/test/java/hello/HelloIT.java
@@ -0,0 +1,28 @@
+package hello;
+
+import java.net.URI;
+import java.net.http.HttpClient;
+import static java.net.http.HttpClient.Redirect.ALWAYS;
+import java.net.http.HttpRequest;
+import java.net.http.HttpResponse;
+import java.net.http.HttpResponse.BodyHandlers;
+import java.time.Duration;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import org.junit.jupiter.api.Test;
+
+public class HelloIT {
+
+    @Test
+    public void testHelloPagesJsp() throws Exception {
+        HttpClient client = HttpClient
+                .newBuilder()
+                .connectTimeout(Duration.ofSeconds(60))
+                .followRedirects(ALWAYS)
+                .build();
+        HttpRequest request = HttpRequest
+                .newBuilder(new URI("http://localhost:8080/pages/hellopages.jsp"))
+                .build();
+        HttpResponse<String> response = client.send(request, BodyHandlers.ofString());
+        assertTrue(response.body().contains("Hello from Jakarta Pages!"));
+    }
+}
diff --git a/test/servlet/pom.xml b/test/servlet/pom.xml
index 73191fca3..d5967d881 100644
--- a/test/servlet/pom.xml
+++ b/test/servlet/pom.xml
@@ -34,5 +34,6 @@
         <module>faces</module>
         <module>hello</module>
         <module>helloworld</module>
+        <module>pages</module>
     </modules>
 </project>