TP3 - Mobilité des canaux - Contrôle réparti du flot d'exécution

Canaux (décrits par une méthode HTTP et un chemin, accompagnés de leurs arguments) :

• POST@bibliotheque(livre, canalDeRetour) : ajout d'un livre à la bibliothèque
• GET@bibliotheque/id(canalDeRetour) : accès à la sous-ressource livre d'identifiant id
• GET@bibliotheque/id/titre(canalDeRetour) : titre du livre d'identifiant id
• GET@bibliotheque(livre, canalDeRetour) : recherche du livre livre renvoyant un canal pointant vers le livre ou une erreur
• GET@bibliotheque/catalogue(canalDeRetour) : catalogue de la bibliothèque défini par une liste de canaux pointant vers les livres

Etat du serveur :

• Compteur(id) : compteur servant à identifier les livres
• Catalogue(liste) : liste des canaux pointant vers un livre
• Base(id, livre) : base de données contenant des couples (identifiant, livre)

On décrit un livre par un n-uplet (titre, …). On note :: le constructeur infixe de liste : (element :: liste).

POST@bibliotheque(livre, ar) & Compteur(id) & Catalogue(liste)
-> 
ar(bibliotheque/id) & Base(id, livre) & Catalogue((bibliotheque/id) :: liste) & Compteur(id+1) 

// Cas d'un livre présent dans la base
GET@bibliotheque/id(ar) & Base(id, livre) -> ar(livre) & Base(id, livre)
// Cas d'un livre absent de la base
GET@bibliotheque/id(ar) & (Base(id, _) inactive) -> ar(ABSENT) 

// Cas d'un livre présent dans la base
GET@bibliotheque/id/titre(ar) & Base(id, (titreLivre, _)) 
  -> ar(titreLivre) & Base(id, (titreLivre, _))
// Cas d'un livre absent de la base
GET@bibliotheque/id/titre(ar) & (Base(id, _) inactive) -> ar(ABSENT)

// Cas d'un livre présent dans la base
GET@bibliotheque(livre, ar) & Base(id, livre) -> ar(bibliotheque/id) & Base(id, livre)
// Cas d'un livre absent de la base
GET@bibliotheque(livre, ar) & (Base(_, livre) inactive) -> ar(ABSENT)

GET@bibliotheque/catalogue(ar) & Catalogue(liste) -> ar(liste) & Catalogue(liste)

Le modèle Objet, fourni, contient trois interfaces principales, ainsi que leur implémentation :

• Bibliothèque, correspondant à la ressource principale,
• Livre, décrivant le type de données représentant les livres de la bibliothèque,
• LivreRessource, extension de l'interface Livre, correspondant aux sous-ressources de la bibliothèque.

La bibliothèque contient les opérations d'ajout, de recherche et de production du catalogue. Le livre est simplement décrit par un titre. Le livre ressource contient en plus une représentation du livre.

Pour représenter les hyperliens, deux classes génériques sont fournies :

• Hyperlien<T> : hyperlien vers une ressource de type T,
• Hyperliens<T> : liste d'hyperliens vers des ressources de type T.

Le type T ne sert qu'au typage.

TODO Créer un nouveau projet, de type Dynamic Web Projet. Ajouter la bibliothèque CXF Runtime si elle n'est pas présente.

TODO Importer l'archive tp3_bibliotheque_serveur.zip à partir de la racine. Deux paquets sont importés :

• modele : le modèle objet,
• infrastructure : du code lié à JAXB ou JAX-RS.

TODO

• Créer un nouveau projet Java en y incluant la bibliothèque de CXF (Runtime).
• Y importer à la racine l'archive tp3_bibliotheque_client.zip. Deux paquets sont importés :
  • modele : le modèle objet et les classes clientes,
  • infrastructure : du code lié à JAXB ou JAX-RS.

(Les erreurs sont normales.)

Grâce à la mobilité des canaux représentés par les hyperliens, il est possible d'implémenter une bibliothèque par une fédération de bibliothèques existantes.

TODO

• Réaliser une copie du projet correspondant au serveur.
• Réaliser une nouvelle implémentation FederationBibliotheques de l'interface Bibliotheque, en remplacement de l'implémentation ImplemBibliotheque.
  • La classe contient un attribut supplémentaire, une liste de proxys vers des bibliothèques distantes. Pour initialiser les proxys, définir à partir du code développé dans les classes de test une fonction prenant en argument l'adresse de la bibliothèque.
  • On utilisera deux bibliothèques aux adresses suivantes : http://localhost:8080/Bibliotheque1 et http://localhost:8080/Bibliotheque2.
  • Implémenter la méthode chercher de manière à réaliser une recherche non seulement locale mais aussi distante dans les bibliothèques agrégées.
  • Implémenter la méthode repertorier de manière à répertorier les livres locaux et ceux distants.
• Modifier le fichier de configuration restful-beans.xml de manière à utiliser cette nouvelle ressource.
• Configurer le serveur pour déployer trois bibliothèques (double-click sur le serveur Tomcat, puis onglet "Modules", puis "Add Web Module").
  • Première bibliothèque : premier projet, chemin /Bibliotheque1
  • Seconde bibliothèque : premier projet, chemin /Bibliotheque2
  • Troisième bibliothèque : second projet (fédération), chemin /Federation
• Définir une nouvelle classe de test dans le projet client.

    public class ClientFederation {
      private static final String ADRESSE1 = "http://localhost:8080/Bibliotheque1";
      private static final String ADRESSE2 = "http://localhost:8080/Bibliotheque2";
      private static final String ADRESSEF = "http://localhost:8080/Federation";
      private static Bibliotheque proxyBibliotheque(String adresse){
        List<Object> filtres = new LinkedList<Object>();
        filtres.add(new AdapterReponsesCreatedPOST());
        return JAXRSClientFactory.create(adresse, Bibliotheque.class, filtres);
      }
      public static void main(String[] args) {
        System.out.println("*** 1. Ajouter des livres ***");
  
        Bibliotheque bib1 = proxyBibliotheque(ADRESSE1);
        Livre l1 = new ImplemLivre("Restful Java with JAX-RS");
        Livre l2 = new ImplemLivre("Restful Java with JAX-RS 2.0");
        bib1.ajouter(l1);
        bib1.ajouter(l2);
  
        Bibliotheque bib2 = proxyBibliotheque(ADRESSE2);
        Livre l3 = new ImplemLivre("Restful Web Services Cookbook");
        bib2.ajouter(l3);
  
        Bibliotheque bibF = proxyBibliotheque(ADRESSEF);
        Livre l4 = new ImplemLivre("SOA");
        bibF.ajouter(l4);
  
        System.out.println("*** 2. Répertorier tous les livres ***");
        System.out.println("Catalogue : " + bibF.repertorier()); 
  
        System.out.println("*** 3. Chercher un livre ***");
        Livre l0 = new ImplemLivre("Absent");
        try {
          System.out.println("R1 - SOA - uri : " + bibF.chercher(l4)); 
        } catch (WebApplicationException e) {
          System.out.println("R1 - exception - "
                          + Outils.messageErreur(e.getResponse()));
        }
        try {
          System.out.println("R2 - Cookbook - uri : " + bibF.chercher(l3)); 
        } catch (WebApplicationException e) {
          System.out.println("R2 - exception - "
                  + Outils.messageErreur(e.getResponse()));
        }
        try {
          System.out.println("R3 - JAX-RS - uri : " + bibF.chercher(l2)); 
        } catch (WebApplicationException e) {
          System.out.println("R3 - exception - "
                  + Outils.messageErreur(e.getResponse()));
        }
        try {
          System.out.println("R4 - JAX-RS - uri : " + bibF.chercher(l1)); 
        } catch (WebApplicationException e) {
          System.out.println("R4 - exception - "
                  + Outils.messageErreur(e.getResponse()));
        }
        try {
          System.out.println("R5 - Absent - uri : " + bibF.chercher(l0)); 
        } catch (WebApplicationException e) {
          System.out.println("R5 - Absent - exception - "
                  + Outils.messageErreur(e.getResponse()));
        }
        System.exit(0);
    }
  }
  

Avec une recherche qui est à la fois locale et distante, le temps d'exécution peut devenir important, en raison de la latence du réseau.

TODO Proposer une solution à ce problème et la décrire en quelques lignes.

• Réponse :