Beheer: voeg express example toe

Deze is geschreven in JavaScript en gebruikt een
open source library voor het genereren van de
openAPI specificatie.

Het Bash scriptje is wat complex geworden, omdat
in dit geval de server in hetzelfde scriptje draait
als de rest van de logica. Bij Quarkus was dat in
1 keer te doen, maar hier kostte dat wat meer moeite.
Bij nieuwe examples moeten we hier mogelijk een
generieker scriptje van maken, maar voor nu kunnen
we het hier laten staan.

Author: TimvdLippe

.github/workflows/build.yml

@@ -38,8 +38,7 @@ jobs:
     runs-on: ubuntu-22.04
     strategy:
       matrix:
-        # Minimum supported and maximum available.
-        example: [ quarkus ]
+        example: [ express, quarkus ]
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-node@v4

examples/express/.gitignore

@@ -0,0 +1,2 @@
+node_modules/
+generated/

examples/express/README.md

@@ -0,0 +1,17 @@
+# Express example
+
+Dit project gebruikt Express: <https://expressjs.com/>, een JavaScript framework waarmee onder andere API's kunnen worden gebruikt.
+
+Om het project te bouwen en een `openapi.json` te genereren, run het volgende:
+
+```shell script
+npm ci
+node src/server.js
+# In een ander terminal tab, omdat de server nog draait
+curl --silent http://localhost:8080/openapi.json > generated/openapi.json
+```
+
+Dit download een `generated/openapi.json` op basis van de definities in [`src/server.js`](src/server.js).
+Daar kun je de verscheidene middleware calls bekijken die gebruikt worden om API's te documenteren.
+
+Met deze middleware calls voldoet het example aan alle regels van de API Design Rules.

examples/express/build-and-check-project.sh

@@ -0,0 +1,40 @@
+#!/bin/sh
+CURRENT_DIRECTORY=$(dirname "$0")
+
+cd $CURRENT_DIRECTORY
+
+# Installeer benodigde dependencies
+npm ci
+
+# Start the server as a background process
+node src/server.js &
+SERVER_PID=$!
+
+mkdir -p generated/
+rm generated/openapi.json 2> /dev/null
+
+# Haal de gegenereerde openapi.json op. Omdat de server nog
+# moet opstarten slapen we 100 ms tussen elke call, totdat we
+# een succesvolle response terug krijgen.
+CURL_EXIT_CODE=1
+while [ $CURL_EXIT_CODE -ne 0 ]
+do
+    sleep 0.1
+    # Check if the server is running. If it has crashed, we should
+    # stop checking and exit the script
+    ps --pid $SERVER_PID 1> /dev/null
+    PROCESS_EXISTS=$(echo $?)
+    if [ $PROCESS_EXISTS -ne 0 ]
+    then
+        echo "Server has crashed. See above terminal output for more information"
+        exit 1
+    fi
+    curl --silent http://localhost:8080/openapi.json > generated/openapi.json
+    CURL_EXIT_CODE=$(echo $?)
+done
+
+# Silently kill the server background process
+kill $SERVER_PID
+wait $SERVER_PID 2>/dev/null
+
+../run-spectral-linter.sh $(realpath generated/openapi.json)