pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<!--
  POM = Project Object Model
  This file describes the project and tells Maven:
  - what the project is
  - how to build it
  - which dependencies it needs
-->

<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">

  <!-- Maven model version (almost always 4.0.0) -->
  <modelVersion>4.0.0</modelVersion>

  <!-- Project coordinates (unique identifier) -->
  <!-- groupId : usually organization or package base -->
  <!-- artifactId : project name -->
  <!-- version : project version -->
  <groupId>fr.univtln.bruno.demos.docker</groupId>
  <artifactId>hello-world</artifactId>
  <version>0.1.0-SNAPSHOT</version>

  <!-- Human-readable project information -->
  <name>Hello World</name>
  <description>
    Application Java "Hello World" utilisée pour démontrer Maven et Docker
  </description>
  <url>https://github.com/ebpro/notebook-containers-intro-sample-java-helloworld</url>

  <!--
    Properties:
    - Central place to define versions and configuration values
    - Avoids repeating version numbers everywhere
  -->
  <properties>

    <!-- Encoding used for source files and reports -->
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>

    <!-- Java version used to compile the project -->
    <java.version>21</java.version>

    <!-- Fully qualified name of the main class -->
    <main.class>fr.univtln.bruno.demos.docker.App</main.class>

    <!-- Dependency versions -->
    <junit.version>6.0.2</junit.version>
    <slf4j.version>2.0.17</slf4j.version>
    <logback.version>1.5.25</logback.version>

    <!-- Maven plugin versions -->
    <maven.compiler.version>3.14.1</maven.compiler.version>
    <maven.surefire.version>3.5.4</maven.surefire.version>
    <maven.jar.version>3.5.0</maven.jar.version>
    <maven.dependency.version>3.9.0</maven.dependency.version>
    <versions.maven.version>2.21.0</versions.maven.version>
    <native.image.plugin.version>0.11.4</native.image.plugin.version>
    <maven.jlink.version>3.2.0</maven.jlink.version>

    <!-- Maven Enforcer plugin version -->
    <maven.enforcer.version>3.6.2</maven.enforcer.version>

    <maven.clean.version>3.5.0</maven.clean.version>
    <maven.install.version>3.1.4</maven.install.version>
    <maven.site.version>3.21.0</maven.site.version>
    <maven.resources.version>3.4.0</maven.resources.version>
    <maven.deploy.version>3.1.4</maven.deploy.version>

    <!-- Ensures reproducible builds (same timestamps) -->
    <project.build.outputTimestamp>2024-06-01T00:00:00Z</project.build.outputTimestamp>
  </properties>

  <!--
    Dependencies:
    External libraries required by the project
  -->
  <dependencies>

    <!-- JUnit 5: unit testing framework (only used for tests) -->
    <dependency>
      <groupId>org.junit.jupiter</groupId>
      <artifactId>junit-jupiter</artifactId>
      <version>${junit.version}</version>
      <scope>test</scope>
    </dependency>

    <!-- SLF4J: logging API (used in the code) -->
    <dependency>
      <groupId>org.slf4j</groupId>
      <artifactId>slf4j-api</artifactId>
      <version>${slf4j.version}</version>
    </dependency>

    <!-- Logback: logging implementation (used at runtime) -->
    <dependency>
      <groupId>ch.qos.logback</groupId>
      <artifactId>logback-classic</artifactId>
      <version>${logback.version}</version>
      <scope>runtime</scope>
    </dependency>

  </dependencies>

  <!--
    Build configuration:
    Defines how the project is compiled, tested, and packaged
  -->
  <build>
    <pluginManagement>
      <plugins>
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-clean-plugin</artifactId>
          <version>${maven.clean.version}</version>
        </plugin>
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-install-plugin</artifactId>
          <version>${maven.install.version}</version>
        </plugin>
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-site-plugin</artifactId>
          <version>${maven.site.version}</version>
        </plugin>
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-resources-plugin</artifactId>
          <version>${maven.resources.version}</version>
        </plugin>
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-deploy-plugin</artifactId>
          <version>${maven.deploy.version}</version>
        </plugin>
      </plugins>
    </pluginManagement>
    <plugins>

      <!-- Java compilation plugin -->
      <plugin>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>${maven.compiler.version}</version>
        <configuration>
          <!-- Compile using Java 21 -->
          <release>${java.version}</release>
          <!-- Keep method parameter names (useful for reflection) -->
          <parameters>true</parameters>
        </configuration>
      </plugin>

      <!-- Runs unit tests -->
      <plugin>
        <artifactId>maven-surefire-plugin</artifactId>
        <version>${maven.surefire.version}</version>
      </plugin>

      <!-- Plugin to check and update dependency versions -->
      <plugin>
        <groupId>org.codehaus.mojo</groupId>
        <artifactId>versions-maven-plugin</artifactId>
        <version>${versions.maven.version}</version>
        <configuration>
          <!-- Custom rules for allowed versions -->
          <rulesUri>https://bruno.univ-tln.fr/rules.xml</rulesUri>
        </configuration>
      </plugin>

      <!-- Maven Enforcer: enforce best-practice rules early in the build -->
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-enforcer-plugin</artifactId>
        <version>${maven.enforcer.version}</version>
        <executions>
          <execution>
            <id>enforce</id>
            <goals>
              <goal>enforce</goal>
            </goals>
            <configuration>
              <rules>
                <!-- Require a minimum Maven version -->
                <requireMavenVersion>
                  <version>[3.6.3,)</version>
                </requireMavenVersion>

                <!-- Ensure the build uses the expected Java version -->
                <requireJavaVersion>
                  <version>[21,)</version>
                </requireJavaVersion>

                <!-- Catch dependency convergence issues -->
                <dependencyConvergence />

                <!-- Enforce upper-bound dependency versions to avoid conflicts -->
                <requireUpperBoundDeps />

                <!-- Ensure plugins declare versions -->
                <requirePluginVersions />
              </rules>
              <fail>true</fail>
            </configuration>
          </execution>
        </executions>
      </plugin>

    </plugins>
  </build>

  <!--
    Profiles:
    Optional build configurations activated with -P
  -->
  <profiles>

    <!-- Production profile: creates a runnable JAR with dependencies -->
    <profile>
      <id>prod</id>
      <build>
        <plugins>

          <!-- Copies runtime dependencies into target/libs -->
          <plugin>
            <artifactId>maven-dependency-plugin</artifactId>
            <version>${maven.dependency.version}</version>
            <executions>
              <execution>
                <id>copy-dependencies</id>
                <phase>package</phase>
                <goals>
                  <goal>copy-dependencies</goal>
                </goals>
                <configuration>
                  <outputDirectory>${project.build.directory}/libs</outputDirectory>
                  <includeScope>runtime</includeScope>
                </configuration>
              </execution>
            </executions>
          </plugin>

          <!-- Builds a JAR with a Main-Class and classpath -->
          <plugin>
            <artifactId>maven-jar-plugin</artifactId>
            <version>${maven.jar.version}</version>
            <configuration>
              <archive>
                <manifest>
                  <!-- Entry point of the application -->
                  <mainClass>${main.class}</mainClass>
                  <!-- Adds classpath to the manifest -->
                  <addClasspath>true</addClasspath>
                  <classpathPrefix>libs/</classpathPrefix>
                </manifest>
              </archive>
            </configuration>
          </plugin>

        </plugins>
      </build>
    </profile>

   <!-- Profil jlink -->
    <profile>
      <id>jlink</id>

      <build>
        <plugins>

          <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-jlink-plugin</artifactId>
            <version>${maven.jlink.version}</version>

            <executions>
              <execution>
                <id>jlink</id>
                <goals>
                  <goal>jlink</goal>
                </goals>
              </execution>
            </executions>

            <configuration>

              <classifier>runtime-image</classifier>

              <addModules>ALL-MODULE-PATH,java.naming</addModules>

              <launcher>hello=fr.univtln.bruno.demos.docker/fr.univtln.bruno.demos.docker.App</launcher>

              <!-- Optional but recommended -->
              <compress>2</compress>
              <stripDebug>true</stripDebug>
              <noHeaderFiles>true</noHeaderFiles>
              <noManPages>true</noManPages>

            </configuration>
          </plugin>

        </plugins>
      </build>
    </profile>

    <!-- Native profile: builds a GraalVM native executable -->
    <profile>
      <id>native</id>
      <build>
        <plugins>

          <plugin>
            <groupId>org.graalvm.buildtools</groupId>
            <artifactId>native-maven-plugin</artifactId>
            <version>${native.image.plugin.version}</version>
            <extensions>true</extensions>
            <executions>
              <execution>
                <id>build-native</id>
                <phase>package</phase>
                <goals>
                  <goal>compile-no-fork</goal>
                </goals>
              </execution>
            </executions>

            <!-- Native image configuration -->
            <configuration>
              <imageName>app</imageName>
              <mainClass>${main.class}</mainClass>
              <buildArgs>
                <!-- No JVM fallback -->
                <buildArg>--no-fallback</buildArg>
                <!-- Static binary -->
                <buildArg>--static</buildArg>
                <!-- Use musl libc (Docker-friendly) -->
                <buildArg>--libc=musl</buildArg>
                <!-- Initialize logging libraries at build time -->
                <buildArg>
                  --initialize-at-build-time=org.slf4j,ch.qos.logback
                </buildArg>
              </buildArgs>
            </configuration>

          </plugin>
        </plugins>
      </build>
    </profile>

  </profiles>

</project>