Développer des services REST en Java Échanger des données au format JSON

Transcription

1 Terminologie, rappels 1. SOA ROA L'interface uniforme L'adressage Le sans état La connectivité ROCA Le côté serveur Le côté client JAXB WADL 16 Introduction à JSON 1. Présentation de JSON Règles d'écriture Les clés Les valeurs Les couples clé/valeur L'indentation Les commentaires Comparaison avec XML Visualisation et validation d'un JSON Le plugin JsonView Coloration syntaxique 23 1/10

2 2.1.2 Détection d'erreurs de syntaxe Le site JSONLint JSON et JavaScript JavaScript et l'objet La console JavaScript Sous Mozilla Firefox Sous Google Chrome Sous Internet Explorer Fonctions JavaScript utiles JSON.parse JSON.stringify JavaScript : du DOM vers JSON JavaScript et les erreurs de syntaxe JSON et Java, production et consommation La bibliothèque Jsonic JSON.encode et json.format JSON.decode et json.parse La bibliothèque Google Gson gson.tojson gson.fromjson 54 Introduction à REST 1. Présentation de REST Une programmation stateless ou stateful? REST vs RESTful Méthodes HTTP OPTIONS 60 2/10

3 4.2 HEAD et GET Partial GET Conditional GET POST Nouvelle ressource sans URL Nouvelle ressource avec une URL Pas de nouvelle ressource PUT et PATCH PUT PATCH LINK et UNLINK DELETE En-têtes HTTP Accept-Charset, Accept-Encoding et Transfer-Encoding Accept-Charset Accept-Encoding Transfer-Encoding Accept-Language et Content-Language Age Allow Authorization Content-Length et Content-MD Content-Length Content-MD Content-Location Accept et Content-Type Accept Content-Type Etag If-Match et If-None-Match If-Modified-Since et If-Unmodified-Since Content-Range, If-Range et Range Formats de sortie et leurs types MIME 74 3/10

4 7. Format des URL, URL logiques et physiques Liens vers les ressources Action sur l'ensemble des ressources d'un type Action sur une ressource donnée Action sur une ressource liée Format de retour Gestion des exceptions Codes HTTP d'erreurs Test d'une requête REST Sous Mozilla Firefox Sous Google Chrome 83 Production de JSON avec Java et REST 1. Du POJO au JSON grâce aux annotations JAX-RS Les bases Choix de la méthode HTTP Choix du chemin d'appel Choix du type de retour Choix du code HTTP de retour Implémentations de JAX-RS Jersey 104 4/10

5 2.1.1 Création d'un projet fonctionnant avec Jersey Transformation automatique d'un objet en JSON Les annotations Implémentation des services GET, POST, PUT et DELETE Génération du WADL Apache CXF Création du projet Création des services REST Génération du WADL Génération des JSON Création d'une annotation pour gérer une nouvelle méthode HTTP JBoss RESTEasy Création du projet Création du serveur Exemples Création des services REST Génération du WADL Classes concrètes et interfaces Sécurité avec JAX-RS Authentification Apache CXF et l'authentification basique Jersey et l'authentification basique JBoss RESTEasy et l'authentification basique Client Java Apache CXF Jersey JBoss RESTEasy Autorisations Apache CXF et Spring Security Jersey JBoss RESTEasy 187 5/10

6 Pour aller plus loin 1. D'autres façons d'aborder REST java.net.url Apache HttpComponents Spring Data REST Création d'un projet avec Apache Maven Configuration Java Création des objets du catalogue REST Création des services REST Génération du WADL Utilisation des services Play Framework Console Play Création d'une application Démarrage du serveur Développement sous Eclipse Compilation Débogage Ajout d'un service REST Mise en cache Apache Activation et désactivation d'un module Module expires Modules de cache Les en-têtes HTTP Valeurs transmises par le serveur Valeurs transmises par le client public, private, cache-extension max-age, no-cache, no-store, smax-age max-stale, min-fresh no-transform only-if-cached must-revalidate, proxy-revalidate 228 6/10

7 2.3 Java Installation et lancement de REDIS Utilisation de REDIS avec Play Exemples d'api REST Facebook Twitter Création d'une application Twitter Test des requêtes présentées dans la documentation Restlet Création d'un projet JEE Modification du fichier pom.xml Création du fichier web.xml Création du fichier applicationcontext.xml Création de la classe ApplicationMusicale Création d'un service Référencement de l'url d'appel Création de la classe du service Appel du service Création d'un client HATEOAS 259 Exceptions communes 1. Erreurs de bibliothèques et de dépendances Erreurs sous Apache CXF Erreurs de bibliothèques sous Jersey Erreurs de bibliothèques sous JBoss RESTEasy Erreurs de configuration et erreurs de code Erreurs sous Apache CXF 280 7/10

8 2.2 Erreurs sous Jersey Erreurs sous JBoss RESTEasy Bugs reconnus Bugs rencontrés sous Jersey Bugs rencontrés sous JBoss RESTEasy Autres types d'erreurs Erreurs de port 291 Références Web 1. Apache Apache CXF Apache HttpComponents Apache Maven Apache Tomcat CSS Cryptographie Google Chrome Eclipse Facebook 296 8/10

9 11. HTTP IANA Internet Explorer Java JavaScript Jersey JBoss JBoss RESTEasy JSON Maven Mozilla MySQL OAuth Opera Play Framework Redis 302 9/10

10 27. REST Restlet RFC ROA ROCA Safari Spring Twitter WebKit 304 Index /10