Pourquoi utiliser JAX-RS / Jersey ?

Question

Désolé, cette question peut paraître stupide, mais après avoir développé certains de mes services RESTful en utilisant Jersey, je me suis posé la question suivante : si REST est juste une architecture, et non un protocole comme SOAP, pourquoi avons-nous besoin d'une spécification comme JAX-RS ?

En fait, j'ai cherché sur Google des questions comme "Quelle est la différence entre les servlets et les services RESTful sur HTTP" et pour résumer les réponses de la communauté, j'ai obtenu :

1. Le développement de services RESTful (sur Jersey) est une architecture qui utilise intrinsèquement les servlets.
2. Les outils conformes à JAX-RS, comme Jersey, facilitent le regroupement et le désassemblage des données XML/JSON, ce qui aide les développeurs.
3. REST nous aide à utiliser GET/POST/PUT/DELETE d'une manière bien plus efficace que les servlets normaux.

Selon ces réponses, je suppose que si j'écris une servlet qui utilise JAXB (pour traiter la sérialisation automatique), et que j'utilise efficacement GET/POST/PUT/DELETE dans mon code de servlet, je n'utilise pas un outil comme Jersey, et donc JAX-RS.

Je sais que je me trompe terriblement en passant cette déclaration, veuillez me corriger.

PS : Ce doute est apparu lorsque j'ai dû développer des services RESTful en PHP. Après avoir parcouru certains codes PHP RESTful, j'ai réalisé qu'il s'agissait simplement des mêmes vieux scripts PHP, avec quelques méthodes d'aide pour gérer XML/JSON.

Answer 1

Pourquoi utiliser JAX-RS / Jersey ?

Réponse courte

Parce qu'il facilite le développement de services RESTful.

Réponse longue

JAX-RS est une norme qui permet de créer facilement un service RESTful pouvant être déployé sur n'importe quel serveur d'application Java : GlassFish, WebLogic, WebSphere, JBoss, etc.

JAX-RS fait partie de Java EE, et lorsque JAX-RS est utilisé avec d'autres technologies Java EE, il devient encore plus facile de créer votre service RESTful :

• EJB - Un haricot de session est utilisé pour la mise en œuvre du service et gère également la sémantique des transactions.
• JAX-RS - Utilisé pour exposer le haricot de session comme un service RESTful.
• JPA - Utilisé pour faire persister les POJOs dans la base de données. Notez comment l'EntityManager est injecté dans le session bean.
• JAXB - Utilisé pour convertir le POJO en/depuis XML (dans GlassFish, il peut également être utilisé pour convertir le POJO en/depuis JSON). JAX-RS gère par défaut l'interaction avec l'implémentation JAXB.

Exemple de service JAX-RS

package org.example;

import java.util.List;

import javax.ejb.*;
import javax.persistence.*;
import javax.ws.rs.*;
import javax.ws.rs.core.MediaType;

@Stateless
@LocalBean
@Path("/customers")
public class CustomerService {

    @PersistenceContext(unitName="CustomerService",
                        type=PersistenceContextType.TRANSACTION)
    EntityManager entityManager;

    @POST
    @Consumes(MediaType.APPLICATION_XML)
    public void create(Customer customer) {
        entityManager.persist(customer);
    }

    @GET
    @Produces(MediaType.APPLICATION_XML)
    @Path("{id}")
    public Customer read(@PathParam("id") long id) {
        return entityManager.find(Customer.class, id);
    }

    @PUT
    @Consumes(MediaType.APPLICATION_XML)
    public void update(Customer customer) {
        entityManager.merge(customer);
    }

    @DELETE
    @Path("{id}")
    public void delete(@PathParam("id") long id) {
        Customer customer = read(id);
        if(null != customer) {
            entityManager.remove(customer);
        }
    }

    @GET
    @Produces(MediaType.APPLICATION_XML)
    @Path("findCustomersByCity/{city}")
    public List<Customer> findCustomersByCity(@PathParam("city") String city) {
        Query query = entityManager.createNamedQuery("findCustomersByCity");
        query.setParameter("city", city);
        return query.getResultList();
    }

}

Pour plus d'informations :

• http://blog.bdoughan.com/2010/08/creating-restful-web-service-part-45.html

Answer 2

REST est une architecture qui, par nature, utilise des servlets.

Non, ce n'est pas le cas. REST est un style d'architecture qui peut être mis en œuvre à l'aide de servlets, mais qui ne les utilise pas intrinsèquement et qui n'a rien à voir avec Java.

JAX-RS est une spécification JSR définissant une API Java pour les services Web RESTful.

Jersey est une implémentation spécifique de JAX-RS.

Quant à savoir s'il faut utiliser Jersey ou essayer de se conformer à la spécification JAX-RS, c'est à vous de voir. Si cela facilite votre travail, tant mieux ! Sinon, personne ne vous y oblige.