Feat/spring jasper example

.github/labeler.yml

@@ -10,6 +10,10 @@
   - changed-files:
       - any-glob-to-any-file: 'spring-keycloak-example/**/*'
 
+"project: spring-jasper-example":
+  - changed-files:
+      - any-glob-to-any-file: 'spring-jasper-example/**/*'
+
 "type: dependency-upgrade":
   - changed-files:
       - any-glob-to-any-file: "**/pom.xml"

.github/workflows/spring-jasper-example.yml

@@ -0,0 +1,68 @@
+name: spring-jasper-example CI Build
+
+on:
+  pull_request:
+    branches: [master]
+    paths:
+      - "spring-jasper-example/**"
+    types:
+      - opened
+      - synchronize
+      - reopened
+
+jobs:
+
+  integration-tests:
+    name: Run Unit & Integration Tests
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: spring-jasper-example
+    strategy:
+      matrix:
+        distribution: [ 'temurin' ]
+        java: [ '21' ]
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+
+      - name: Set up JDK ${{ matrix.java }}
+        uses: actions/setup-java@v4.7.1
+        with:
+          java-version: ${{ matrix.java }}
+          distribution: ${{ matrix.distribution }}
+          cache: 'maven'
+      - name: Build and analyze
+        run: ./mvnw clean verify
+
+  health-check:
+    name: Health Check on Services
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository and submodules
+        uses: actions/checkout@v5
+        with:
+          submodules: true
+
+      - name: Extract service names from docker compose
+        id: services
+        run: |
+          echo "services<<EOF" >> $GITHUB_OUTPUT
+          docker compose -f ./spring-jasper-example/compose.yaml config --services >> $GITHUB_OUTPUT
+          echo "EOF" >> $GITHUB_OUTPUT
+
+      - name: Start containers with Compose Action
+        uses: hoverkraft-tech/compose-action@v2.3.0
+        with:
+          compose-file: './spring-jasper-example/compose.yaml'
+          services: ${{ steps.services.outputs.services }}
+          up-flags: '--build'
+          down-flags: '--volumes'
+
+      - name: Wait for containers to initialize
+        run: sleep 10
+
+      - name: Check container health
+        run: |
+          ./.github/scripts/check-container-health.sh "${{ steps.services.outputs.services }}"

README.md

@@ -14,10 +14,11 @@ Each subdirectory in this repository represents a specific integration or featur
 
 Below you will find a summary table of each subproject. For more details, please refer to the individual README.md files.
 
-| Name                                          | Description                                                                                                   |
-|-----------------------------------------------|---------------------------------------------------------------------------------------------------------------|
-| [Spring Boot + Kafka](./spring-kafka-example) | Demonstrates a basic integration between Spring Boot and Apache Kafka.                                        |
-| [Spring Boot + Keycloak](./spring-keycloak-example) | Demonstrates a basic integration between Spring Boot and Keycloak.                                            |
+| Name                                                                      | Description                                                                       |
+|---------------------------------------------------------------------------|-----------------------------------------------------------------------------------|
+| [Spring Boot + Jasper](./spring-jasper-example)                           | Demonstrates a basic integration between Spring Boot and Jasper.                  |
+| [Spring Boot + Kafka](./spring-kafka-example)                             | Demonstrates a basic integration between Spring Boot and Apache Kafka.            |
+| [Spring Boot + Keycloak](./spring-keycloak-example)                       | Demonstrates a basic integration between Spring Boot and Keycloak.                |
 | [Spring Boot + Grafana + Prometheus](./spring-prometheus-grafana-example) | Demonstrates a basic integration between Spring Boot With Grafana and Prometheus. |
 
 ---

pom.xml

@@ -15,6 +15,7 @@
         <module>spring-kafka-example</module>
         <module>spring-prometheus-grafana-example</module>
         <module>spring-keycloak-example</module>
+        <module>spring-jasper-example</module>
     </modules>
 
 </project>

spring-jasper-example/.dockerignore

@@ -0,0 +1,62 @@
+# Include any files or directories that you don't want to be copied to your
+# container here (e.g., local build artifacts, temporary files, etc.).
+#
+# For more help, visit the .dockerignore file reference guide at
+# https://docs.docker.com/go/build-context-dockerignore/
+
+**/.DS_Store
+**/.classpath
+**/.dockerignore
+**/.env
+**/.factorypath
+**/.git
+**/.gitignore
+**/.idea
+**/.project
+**/.sts4-cache
+**/.settings
+**/.toolstarget
+**/.vs
+**/.vscode
+**/.next
+**/.cache
+**/*.dbmdl
+**/*.jfm
+**/charts
+**/docker-compose*
+**/compose.y*ml
+**/Dockerfile*
+**/secrets.dev.yaml
+**/values.dev.yaml
+**/vendor
+LICENSE
+README.md
+**/*.class
+**/*.iml
+**/*.ipr
+**/*.iws
+**/*.log
+**/.apt_generated
+**/.gradle
+**/.gradletasknamecache
+**/.nb-gradle
+**/.springBeans
+**/build
+**/dist
+**/gradle-app.setting
+**/nbbuild
+**/nbdist
+**/nbproject/private
+**/target
+*.ctxt
+.mtj.tmp
+.mvn/timing.properties
+buildNumber.properties
+dependency-reduced-pom.xml
+hs_err_pid*
+pom.xml.next
+pom.xml.releaseBackup
+pom.xml.tag
+pom.xml.versionsBackup
+release.properties
+replay_pid*

spring-jasper-example/.gitattributes

@@ -0,0 +1,2 @@
+/mvnw text eol=lf
+*.cmd text eol=crlf

spring-jasper-example/.github/workflows/maven.yml

@@ -0,0 +1,30 @@
+name: CI Build
+
+on:
+  push:
+    branches:
+      - "**"
+
+jobs:
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        distribution: [ 'temurin' ]
+        java: [ '21' ]
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Setup Java 21
+        uses: actions/setup-java@v4
+        with:
+          java-version: ${{ matrix.java }}
+          distribution: ${{ matrix.distribution }}
+          cache: 'maven'
+
+      - name: Grant execute permission for mvnw
+        run: chmod +x mvnw
+
+      - name: Build with Maven
+        run: ./mvnw clean verify

spring-jasper-example/.gitignore

@@ -0,0 +1,32 @@
+target/
+.mvn/wrapper/maven-wrapper.jar
+!**/src/main/**/target/
+!**/src/test/**/target/
+
+### STS ###
+.apt_generated
+.classpath
+.factorypath
+.project
+.settings
+.springBeans
+.sts4-cache
+
+### IntelliJ IDEA ###
+.idea
+*.iws
+*.iml
+*.ipr
+
+### NetBeans ###
+/nbproject/private/
+/nbbuild/
+/dist/
+/nbdist/
+/.nb-gradle/
+build/
+!**/src/main/**/build/
+!**/src/test/**/build/
+
+### VS Code ###
+.vscode/

spring-jasper-example/.mvn/wrapper/maven-wrapper.properties

@@ -0,0 +1,19 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+wrapperVersion=3.3.2
+distributionType=only-script
+distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.11/apache-maven-3.9.11-bin.zip

spring-jasper-example/Dockerfile

@@ -0,0 +1,47 @@
+FROM eclipse-temurin:21.0.8_9-jdk-jammy as deps
+
+WORKDIR /build
+
+COPY --chmod=0755 mvnw mvnw
+COPY .mvn/ .mvn/
+
+RUN --mount=type=bind,source=pom.xml,target=pom.xml \
+    --mount=type=cache,target=/root/.m2 ./mvnw dependency:go-offline -DskipTests
+
+FROM deps as package
+
+WORKDIR /build
+
+COPY ./src src/
+RUN --mount=type=bind,source=pom.xml,target=pom.xml \
+    --mount=type=cache,target=/root/.m2 \
+    ./mvnw package -DskipTests && \
+    mv target/$(./mvnw help:evaluate -Dexpression=project.artifactId -q -DforceStdout)-$(./mvnw help:evaluate -Dexpression=project.version -q -DforceStdout).jar target/app.jar
+
+FROM package as extract
+
+WORKDIR /build
+
+RUN java -Djarmode=layertools -jar target/app.jar extract --destination target/extracted
+
+FROM eclipse-temurin:21.0.8_9-jre-jammy AS final
+
+ARG UID=10001
+RUN adduser \
+    --disabled-password \
+    --gecos "" \
+    --home "/nonexistent" \
+    --shell "/sbin/nologin" \
+    --no-create-home \
+    --uid "${UID}" \
+    appuser
+USER appuser
+
+COPY --from=extract build/target/extracted/dependencies/ ./
+COPY --from=extract build/target/extracted/spring-boot-loader/ ./
+COPY --from=extract build/target/extracted/snapshot-dependencies/ ./
+COPY --from=extract build/target/extracted/application/ ./
+
+EXPOSE 8082
+
+ENTRYPOINT [ "java", "org.springframework.boot.loader.launch.JarLauncher" ]

spring-jasper-example/README.md

@@ -0,0 +1,24 @@
+# spring-jasper-example
+
+---
+
+## Overview
+
+Basic Java Spring (Java 21) project demonstrating report generation with JasperReports.  
+Includes loading `.jasper` templates, populating them with mock data, and exporting to PDF via a REST endpoint.
+
+---
+
+## Tech stack
+
+- Spring Boot
+- Java 21
+- JasperReports
+
+---
+
+## Profiles you can activate
+
+- **client-list-dev** – Used in Docker, in the future, it will use pre-compiled `.jasper` files instead of `.jrxml`. Activates the internal module that generates a simple client report.
+- **client-list-local** – Used locally, activates the internal module that generates a simple client report and use `.jrxml`.
+

spring-jasper-example/compose.yaml

@@ -0,0 +1,11 @@
+services:
+
+  app:
+    container_name: app
+    build:
+      context: .
+    ports:
+      - "8082:8082"
+    environment:
+      SPRING_PROFILES_ACTIVE: client-list-dev
+      SERVER_PORT: 8082