initial

.gitignore

+
+# Created by https://www.toptal.com/developers/gitignore/api/java,emacs,vim,eclipse,maven
+# Edit at https://www.toptal.com/developers/gitignore?templates=java,emacs,vim,eclipse,maven
+
+### Eclipse ###
+.metadata
+bin/
+tmp/
+*.tmp
+*.bak
+*.swp
+*~.nib
+local.properties
+.settings/
+.loadpath
+.recommenders
+
+# External tool builders
+.externalToolBuilders/
+
+# Locally stored "Eclipse launch configurations"
+*.launch
+
+# PyDev specific (Python IDE for Eclipse)
+*.pydevproject
+
+# CDT-specific (C/C++ Development Tooling)
+.cproject
+
+# CDT- autotools
+.autotools
+
+# Java annotation processor (APT)
+.factorypath
+
+# PDT-specific (PHP Development Tools)
+.buildpath
+
+# sbteclipse plugin
+.target
+
+# Tern plugin
+.tern-project
+
+# TeXlipse plugin
+.texlipse
+
+# STS (Spring Tool Suite)
+.springBeans
+
+# Code Recommenders
+.recommenders/
+
+# Annotation Processing
+.apt_generated/
+.apt_generated_test/
+
+# Scala IDE specific (Scala & Java development for Eclipse)
+.cache-main
+.scala_dependencies
+.worksheet
+
+# Uncomment this line if you wish to ignore the project description file.
+# Typically, this file would be tracked if it contains build/dependency configurations:
+#.project
+
+### Eclipse Patch ###
+# Spring Boot Tooling
+.sts4-cache/
+
+### Emacs ###
+# -*- mode: gitignore; -*-
+*~
+\#*\#
+/.emacs.desktop
+/.emacs.desktop.lock
+*.elc
+auto-save-list
+tramp
+.\#*
+
+# Org-mode
+.org-id-locations
+*_archive
+ltximg/**
+
+# flymake-mode
+*_flymake.*
+
+# eshell files
+/eshell/history
+/eshell/lastdir
+
+# elpa packages
+/elpa/
+
+# reftex files
+*.rel
+
+# AUCTeX auto folder
+/auto/
+
+# cask packages
+.cask/
+dist/
+
+# Flycheck
+flycheck_*.el
+
+# server auth directory
+/server/
+
+# projectiles files
+.projectile
+
+# directory configuration
+.dir-locals.el
+
+# network security
+/network-security.data
+
+
+### Java ###
+# Compiled class file
+*.class
+
+# Log file
+*.log
+
+# BlueJ files
+*.ctxt
+
+# Mobile Tools for Java (J2ME)
+.mtj.tmp/
+
+# Package Files #
+*.jar
+*.war
+*.nar
+*.ear
+*.zip
+*.tar.gz
+*.rar
+
+# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
+hs_err_pid*
+
+### Maven ###
+target/
+pom.xml.tag
+pom.xml.releaseBackup
+pom.xml.versionsBackup
+pom.xml.next
+release.properties
+dependency-reduced-pom.xml
+buildNumber.properties
+.mvn/timing.properties
+# https://github.com/takari/maven-wrapper#usage-without-binary-jar
+.mvn/wrapper/maven-wrapper.jar
+
+### Vim ###
+# Swap
+[._]*.s[a-v][a-z]
+!*.svg  # comment out if you don't need vector files
+[._]*.sw[a-p]
+[._]s[a-rt-v][a-z]
+[._]ss[a-gi-z]
+[._]sw[a-p]
+
+# Session
+Session.vim
+Sessionx.vim
+
+# Temporary
+.netrwhist
+# Auto-generated tag files
+tags
+# Persistent undo
+[._]*.un~
+
+# End of https://www.toptal.com/developers/gitignore/api/java,emacs,vim,eclipse,maven
+.classpath
+.project

README.md

+# Tutoriel REST - premier développement d'une ressource
+
+Pour ce premier TP REST, nous allons voir les principaux éléments du développement d'une ressource :
+
+  - POJO annoté
+  - Objets de transfert (Data Transfer Object - DTO)
+  - Gestion des représentations (JSON ou XML)
+  - Gestion du cache (ETag)
+  
+## Mise en place de l'environnement
+
+Le développement sera basé sur [https://eclipse-ee4j.github.io/jersey/](`Jersey`) qui fournit une implémentation de référence de JAX-RS. Vous trouverez dans la [https://eclipse-ee4j.github.io/jersey.github.io/documentation/latest3x/index.html](documentation) l'utilisation des annotation standards ainsi que les aspects spécifiques de la plate-forme.
+
+Le développement avec Jersey implique l'utilisation de `Maven` pour la gestion des phases de développement. Maven va télécharger les librairies nécessaires depuis un dépôt extérieur. Il faut donc le configurer pour passer par le proxy quand vous êtes en salle de TP.
+
+Dans le répertoire `~/.m2/` (a créer si nécessaire), créez le fichier 'settings.xml' avec le contenu suivant :
+
+~~~xml
+<settings>
+  <proxies>
+	<proxy>
+  	  <id>ulille-proxy</id>
+      <active>true</active>
+	  <protocol>http</protocol>
+	  <host>cache.univ-lille.fr</host>
+	  <port>3128</port>
+   	</proxy>
+	<proxy>
+	  <id>lille1-proxy-sec</id>
+	  <active>true</active>
+	  <protocol>https</protocol>
+	  <host>cache.univ-lille.fr</host>
+	  <port>3128</port>
+	</proxy>
+  </proxies>
+</settings>
+
+Le projet que vous avez récupéré contient le fichier de configuration `pom.xml`. Le projet est actuellement configuré pour utiliser java 11 :
+
+~~~xml
+<plugin>
+  <groupId>org.apache.maven.plugins</groupId>
+  <artifactId>maven-compiler-plugin</artifactId>
+  <version>3.8.1</version>
+  <inherited>true</inherited>
+  <configuration>
+    <release>11</release>
+  </configuration>
+</plugin>
+~~~
+
+## Le code récupéré
+L'arborescence de source contient les fichiers suivants :
+
+~~~
+src
+├── main
+│   └── java
+│       └── fr
+│           └── ulille
+│               └── iut
+│                   └── tva
+│                       ├── DebugMapper.java
+│                       ├── dto
+│                       ├── Main.java
+│                       ├── ressource
+│                       │   └── TvaRessource.java
+│                       └── service
+│                           ├── CalculTva.java
+│                           └── TauxTva.java
+└── test
+    └── java
+        └── fr
+            └── ulille
+                └── iut
+                    └── tva
+~~~

pom.xml

+<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/maven-v4_0_0.xsd">
+
+    <modelVersion>4.0.0</modelVersion>
+
+    <groupId>fr.ulille.iut</groupId>
+    <artifactId>jersey-tva</artifactId>
+    <packaging>jar</packaging>
+    <version>1.0-SNAPSHOT</version>
+    <name>jersey-tva</name>
+
+    <dependencyManagement>
+        <dependencies>
+            <dependency>
+                <groupId>org.glassfish.jersey</groupId>
+                <artifactId>jersey-bom</artifactId>
+                <version>${jersey.version}</version>
+                <type>pom</type>
+                <scope>import</scope>
+            </dependency>
+        </dependencies>
+    </dependencyManagement>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.glassfish.jersey.containers</groupId>
+            <artifactId>jersey-container-grizzly2-http</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.glassfish.jersey.inject</groupId>
+            <artifactId>jersey-hk2</artifactId>
+        </dependency>
+
+        <!-- uncomment this to get JSON support: -->
+         <dependency>
+            <groupId>org.glassfish.jersey.media</groupId>
+            <artifactId>jersey-media-json-binding</artifactId>
+        </dependency>
+        <!-- -->
+        <dependency>
+            <groupId>junit</groupId>
+            <artifactId>junit</artifactId>
+            <version>4.12</version>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+          <groupId>org.glassfish.jersey.test-framework.providers</groupId>
+          <artifactId>jersey-test-framework-provider-grizzly2</artifactId>
+          <version>${jersey.version}</version>
+        </dependency>
+        <dependency>
+          <groupId>jakarta.xml.bind</groupId>
+          <artifactId>jakarta.xml.bind-api</artifactId>
+          <version>3.0.0</version>
+        </dependency>
+        <dependency>
+          <groupId>com.sun.xml.bind</groupId>
+          <artifactId>jaxb-impl</artifactId>
+          <version>3.0.0</version>
+          <scope>runtime</scope>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-compiler-plugin</artifactId>
+                <version>3.8.1</version>
+                <inherited>true</inherited>
+                <configuration>
+                  <release>11</release>
+                </configuration>
+            </plugin>
+            <plugin>
+                <groupId>org.codehaus.mojo</groupId>
+                <artifactId>exec-maven-plugin</artifactId>
+                <version>1.2.1</version>
+                <executions>
+                    <execution>
+                        <goals>
+                            <goal>java</goal>
+                        </goals>
+                    </execution>
+                </executions>
+                <configuration>
+                    <mainClass>fr.ulille.iut.tva.Main</mainClass>
+                </configuration>
+            </plugin>
+            <plugin>
+              <groupId>org.apache.maven.plugins</groupId>
+              <artifactId>maven-shade-plugin</artifactId>
+              <version>${shade.version}</version>
+              <executions>
+                <execution>
+                  <phase>package</phase>
+                  <goals>
+                    <goal>shade</goal>
+                  </goals>
+                  <configuration>
+                    <transformers>
+                      <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
+                        <mainClass>fr.ulille.iut.tva.Main</mainClass>
+                      </transformer>
+                      <transformer implementation="org.apache.maven.plugins.shade.resource.ServicesResourceTransformer" />
+                    </transformers>
+                  </configuration>
+                </execution>
+              </executions>
+            </plugin>
+        </plugins>
+    </build>
+
+    <properties>
+        <jersey.version>3.0.0</jersey.version>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        <shade.version>3.2.4</shade.version>
+    </properties>
+</project>

src/main/java/fr/ulille/iut/tva/DebugMapper.java

+package fr.ulille.iut.tva;
+
+import jakarta.ws.rs.core.Response;
+import jakarta.ws.rs.ext.ExceptionMapper;
+
+public class DebugMapper implements ExceptionMapper<Throwable> {
+    public DebugMapper() {
+        System.out.println("###### Attention !! DebugMapper est actif !!!");
+    }
+
+    @Override
+    public Response toResponse(Throwable ex) {
+        ex.printStackTrace();
+        return Response.serverError()
+            .entity(ex.getMessage())
+            .build();
+    }
+}

src/main/java/fr/ulille/iut/tva/Main.java

+package fr.ulille.iut.tva;
+
+import org.glassfish.grizzly.http.server.HttpServer;
+import org.glassfish.jersey.grizzly2.httpserver.GrizzlyHttpServerFactory;
+import org.glassfish.jersey.logging.LoggingFeature;
+import org.glassfish.jersey.server.ResourceConfig;
+
+import java.io.IOException;
+import java.net.URI;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+
+/**
+ * Main class.
+ *
+ */
+public class Main {
+    // Base URI the Grizzly HTTP server will listen on
+    public static final String BASE_URI = "http://localhost:8080/myapp/";
+
+    /**
+     * Starts Grizzly HTTP server exposing JAX-RS resources defined in this application.
+     * @return Grizzly HTTP server.
+     */
+    public static HttpServer startServer() {
+        // create a resource config that scans for JAX-RS resources and providers
+        // in fr.ulille.iut.tva package
+        ResourceConfig rc = new ResourceConfig().packages("fr.ulille.iut.tva"); // <-- les paquetages dans lesquels Jersey cherche les ressources
+
+        // Vous pouvez activer les log des requêtes et réponses sur le serveur
+        // Pour cela avant de lancer le serveur, dans votre shell faites :
+        // export LOG_MESSAGES=true
+        String logging = System.getenv("LOG_MESSAGES");
+        if ( logging != null && logging.equalsIgnoreCase("true") ) {
+            rc.register(new LoggingFeature(Logger.getLogger(LoggingFeature.DEFAULT_LOGGER_NAME), Level.INFO,
+                                           LoggingFeature.Verbosity.PAYLOAD_ANY, 10000));
+        }
+
+        // Si vous avez une erreur interne au serveur (HTTP 500), vous pouvez faire afficher l'erreur côté serveur
+        // Attention, du coup toutes les erreurs seront renvoyées en 500, donc à désactiver quand vous avez compris le problème.
+        // Pour activer, avant de lancer le serveur, dans votre shell faites :
+        // export DEBUG_INTERNAL=true
+        String debug = System.getenv("DEBUG_INTERNAL");
+        if ( debug != null && debug.equalsIgnoreCase("true") ) {
+            rc.register(DebugMapper.class);
+        }
+
+        // create and start a new instance of grizzly http server
+        // exposing the Jersey application at BASE_URI
+        return GrizzlyHttpServerFactory.createHttpServer(URI.create(BASE_URI), rc);
+    }
+
+    /**
+     * Main method.
+     * @param args
+     * @throws IOException
+     */
+    public static void main(String[] args) throws IOException {
+        final HttpServer server = startServer();
+        System.out.println(String.format("Jersey app started with WADL available at "
+                + "%sapplication.wadl\nHit enter to stop it...", BASE_URI));
+        System.in.read();
+        server.shutdownNow();
+    }
+}
+

src/main/java/fr/ulille/iut/tva/ressource/TvaRessource.java

+package fr.ulille.iut.tva.ressource;
+
+import fr.ulille.iut.tva.service.CalculTva;
+import fr.ulille.iut.tva.service.TauxTva;
+
+/**
+ * TvaRessource
+ */
+public class TvaRessource {
+    private CalculTva calculTva = new CalculTva();
+
+}

src/main/java/fr/ulille/iut/tva/service/CalculTva.java

+package fr.ulille.iut.tva.service;
+
+/**
+ * Tva
+ */
+public class CalculTva {
+    public float calculerMontantTauxParDefaut(float somme) {
+        return somme * (1 + TauxTva.NORMAL.taux / 100);
+    }
+
+    public float calculerMontant(TauxTva taux, float somme) {
+        return somme * (1 + taux.taux / 100);
+    }
+
+    public float getTaux(TauxTva taux) {
+        return taux.taux;
+    }
+}

src/main/java/fr/ulille/iut/tva/service/TauxTva.java

+package fr.ulille.iut.tva.service;
+
+/**
+ * TauxTva
+ */
+public enum TauxTva {
+    NORMAL(20f), INTERMEDIAIRE(10f), REDUIT(5.5f), PARTICULIER(2.1f);
+
+    public final float taux;
+
+    private TauxTva(float taux) {
+        this.taux = taux;
+    }
+
+    public static TauxTva fromString(String label) {
+        return TauxTva.valueOf(label);
+    }
+
+}