Discussion :

[nicorama]

Bonjour,
Je vous propose un (long) tutoriel pour utiliser efficacement REST et Ajax en utilisant un serveur Java et ma bibliothèque Robusta Web Library.

http://nicolas-zozol.developpez.com/.../rest/robusta/

Robusta devrait également s'intégrer dans toute application web, même si elle n'utilise ni Rest, ni Ajax.

Bonne lecture
Nicolas

[ghoudmon]

Bonjour,

Ton tutoriel est intéressant. Personnellement j'utilise directement Restlet avec son extension JAX-RS et Spring.

J'ai une seule critique (qui vaut souvent pour les exemples JAX-RS) : il manque une illustration de l'utilisation des "Provider". Concrètement, dans l'exemple "registerUser", au lieu de prendre en paramètre une chaîne et de retourner un object Response, c'est de travailler directement avec les objecs du domaine :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

User registerUser(User pUser) { ... }

et le provider de lecture

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
@Provider
@Consumes(MediaType.APPLICATION_XML)
public class SimpleXMLMessageBodyReader implements MessageBodyReader<Object> {
 public boolean isReadable(final Class<?> pType, final Type pGenericType, final Annotation[] pAnnotations, final MediaType pMediaType) {
    // si type est User et si media es XML
...
 }

public Object readFrom(final Class<Object> pType, final Type pGenericType, final Annotation[] pAnnotations, final MediaType pMediaType,
      final MultivaluedMap<String, String> pHeaders, final InputStream pInputStream) throws IOException {
  // lecture du XML en USer
  User user = new User();
  ...
  return user;
}
}

L'avantage est de faire une ressource REST utilisable pour plusieurs types MIME et de déléguer la sérialisation/désérialisation à des objets dédiés.

Mais encore une fois, bravo pour ce tutoriel.

[nicorama]

J'ai une seule critique (qui vaut souvent pour les exemples JAX-RS) : il manque une illustration de l'utilisation des "Provider". Concrètement, dans l'exemple "registerUser", au lieu de prendre en paramètre une chaîne et de retourner un object Response, c'est de travailler directement avec les objecs du domaine :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

User registerUser(User pUser) { ... }

(...)
L'avantage est de faire une ressource REST utilisable pour plusieurs types MIME et de déléguer la sérialisation/désérialisation à des objets dédiés.

Je n'avais que partiellement lu les Providers, et pas utilisé. Cela ira très bien avec l'interface RestManager qui inclue les methodes getXml() et decodeXml(String xml), permettant ainsi une sérialisation/désérialisation personalisée.
Comme le tuto est déjà trop long, j'avais prévu d'en parler séparemment...d'ici décembre . J'aurais le temps de me faire la main sur les Providers d'ici là.

Avant de passer en 1.0, il sera peut-être temps de renommer RestManager en ResourceSerializer, un truc du genre

Mais encore une fois, bravo pour ce tutoriel.

Thanx

[nicorama]

Un peu de travail plus tard : l'interface Resource contient la méthode getRepresentation() au lieu de getXml(), ce qui est évidemment plus logique.

L'interface RepresentationManager (au lieu de RestManager) s'occupe de la serialisation/deserialisation en XML et peut évidemment être étendue pour les autres JSON.

Des exemples avec les Provider un peu plus tard