Bienvenue sur les Services Web Restful Tutorial de Java. REST est l’acronyme de REpresentational State Transfer. REST est un style architectural pour le développement d’applications accessibles sur le réseau. Le style architectural REST a été mis en lumière par Roy Fielding dans sa thèse de doctorat en 2000.
Restful Web Services
Restful Web Services est une architecture client-serveur sans état où les services web sont des ressources et peuvent être identifiés par leurs URI.,
Les applications clientes REST peuvent utiliser les méthodes HTTP GET/POST pour appeler les services web Restful. REST ne spécifie aucun protocole spécifique à utiliser, mais dans presque tous les cas, il est utilisé sur HTTP/HTTPS. Par rapport aux services web SOAP, ceux-ci sont légers et ne suivent aucune norme. Nous pouvons utiliser XML, JSON, texte ou tout autre type de données pour la demande et la réponse.
Java RESTful Web Services API
Java API pour les services web RESTful (JAX-RS) est L’API Java pour la création de services web REST., JAX-RS utilise des annotations pour simplifier le développement et le déploiement de services web. JAX-RS fait partie de JDK, vous n’avez donc pas besoin d’inclure quoi que ce soit pour utiliser ses annotations.
Annotations Restful Web Services
certaines des annotations JAX-RS importantes sont:
-
@Path: utilisé pour spécifier le chemin relatif de la classe et des méthodes. Nous pouvons obtenir L’URI d’un service Web en analysant la valeur D’annotation de chemin., -
@GET,@PUT,@POST,@DELETEet@HEAD: utilisé pour spécifier le type de demande de HTTP pour une méthode. -
@Produces,@Consumes: permet de préciser la demande et les types de réponses. -
@PathParam: utilisé pour lier le paramètre de méthode à la valeur du chemin en l’analysant.
Services Web Restful et du SAVON
- SOAP est un protocole alors que le REPOS est un style architectural.,
- le serveur SOAP et les applications clientes sont étroitement couplés et se lient au contrat WSDL alors qu’il n’y a pas de contrat dans les services web REST et le client.
- La courbe D’apprentissage est facile pour REST par rapport aux services web SOAP.
- Les types de demande et de réponse REST web services peuvent être XML, JSON, text, etc. alors que SOAP ne fonctionne qu’avec XML.
- JAX-RS est L’API Java pour les services web REST tandis que JAX-WS est L’API Java pour les services web SOAP.
implémentations de L’API REST
Il existe deux implémentations majeures de L’API JAX-RS.,
- Maillot: Maillot est l’implémentation de référence fournie par le Soleil. Pour utiliser Jersey comme implémentation JAX-RS, tout ce dont nous avons besoin pour configurer son servlet dans le web.xml et ajouter les dépendances requises. Notez que L’API JAX-RS fait partie de JDK et non De Jersey, nous devons donc ajouter ses jars de dépendance dans notre application.
- RESTEasy: RESTEasy est le projet JBoss qui fournit L’implémentation JAX-RS.
Java Restful Web Services Tutorial
voyons comment il est facile de créer un service Web Restful en utilisant Jersey, puis RESTEasy., Nous exposerons les méthodes suivantes sur HTTP et utiliserons L’extension Chrome Postman pour les tester.,d>
Maillot de Services Web Restful
Créer un projet web dynamique et la convertir Maven pour obtenir le squelette de votre projet de services web., L’image ci-dessous montre la structure du projet final.
regardons le Maillot dépendances que nous avons dans le pom.fichier xml.
Nous ne sommes pas tenus d’ajouter des dépendances jersey-client, mais si vous écrivez un programme java pour appeler un service web REST à l’aide de Jersey, il est requis.
examinons maintenant le descripteur de déploiement pour apprendre à configurer Jersey pour créer notre application web.
C’est tout ce qui est nécessaire pour greffer Jersey dans notre application web, dans notre code java, nous utiliserons des annotations JAX-RS., Notez la valeur du paramètre init com.sun.jersey.config.property.packages pour fournir un package qui sera analysé pour les ressources et les méthodes du service web.
Rest exemple de classes de modèle
tout d’abord, nous allons créer deux beans modèle – Person pour nos données d’application etResponse pour envoyer la réponse aux systèmes clients. Puisque nous enverrons une réponse XML, les beans doivent être annotés avec @XmlRootElement, nous avons donc cette classe.,
REST Web Services Tutorial services
basé sur notre structure URI, voici l’interface de service et son code d’implémentation.
test des services web Restful
c’est tout. Notre service web est prêt, il suffit de l’exporter en tant que fichier WAR et de le placer dans le répertoire Tomcat webapps ou de le déployer dans tout autre conteneur de votre choix.
Voici quelques-uns des tests effectués à l’aide de Postman chrome extension pour ce service web. Notez que nous devons fournir des valeurs Accept et Content-Type en tant que « application / xml » dans l’en-tête de la demande, comme indiqué dans l’image ci-dessous.,
- getDummy
- ajouter
- get
- getAll
- supprimer
C’est tout pour la création de services web à l’aide de Maillot de JAX-RS de mise en œuvre. Comme vous pouvez le voir, la plupart du code utilise des annotations JAX-RS et Jersey est branché via le descripteur de déploiement et les dépendances.,
RESTEasy RESTful Web Services Example
Nous utiliserons toute la logique métier développée dans le projet Jersey, mais plutôt que d’apporter des modifications au même projet, j’ai créé un nouveau projet. Créez un projet web dynamique et convertissez-le en projet Maven. Copiez ensuite toutes les classes java-Person, Response, PersonService et PersonServiceImpl. Voici le projet final après que nous ayons terminé avec tous les changements.
Ajouter ci-dessous les RESTEasy dépendances dans le pom.fichier xml.
ci-Dessous le web.fichier xml où nous configurons le servlet Resteasy.,
Notez le init-param où fournissentMyApp classe comme valeur, ici nous étendonsjavax.ws.rs.core.Application classe comme indiqué ci-dessous.
RESTEasy Web Services Test
C’est tout. Notre service web est prêt avec L’implémentation de RESTEasy JAX-RS. Vous trouverez ci-dessous quelques-unes des sorties du test D’extension Postman chrome.,
- getDummy
- ajouter
- obtenir
c’est tout pour le tutoriel des services web Restful, Je j’espère que vous avez appris les annotations JAX-RS et compris les avantages d’avoir une API standard qui nous a aidés à réutiliser le code et à passer de Jersey à RESTEasy si facilement.
