JSON, réflexion et annotations

Exercice 1 - JSON Encoder

import static java.util.Objects.requireNonNull;
    
public record Person(String firstName, String lastName) {
  public Person {
    requireNonNull(firstName);
    requireNonNull(lastName);
  }
}
    

package fr.umlv.json;   
   
public class JSONPrinter {
  public static String toJSON(Person person) {
    return """
      {
        "firstName": "%s",
        "lastName": "%s"
      }
      """.formatted(person.firstName(), person.lastName());
  }
  
  public static void main(String[] args) {
    var person = new Person("John", "Doe");
    System.out.println(toJSON(person));
  }
}
    

import static java.util.Objects.requireNonNull;
     
public record Alien(int age, String planet) {
  public Alien {
    if (age < 0) {
      throw new IllegalArgumentException("negative age");
    }
    requireNonNull(planet);
  }
}
    

public class JSONPrinter {
  ...
  public static String toJSON(Alien alien) {
    return """
      {
        "age": %s,
        "planet": "%s"
      }
      """.formatted(alien.age(), alien.planet());
  } 
  
  public static void main(String[] args) {
    ...
    var alien = new Alien(100, "Saturn");
    System.out.println(toJSON(alien));
  }
}
    

1. Écrire la méthode toJSON qui prend en paramètre un java.lang.Record, utilise la réflexion pour accéder à l'ensemble des composants d'un record (java.lang.Class.getRecordComponent), sélectionne les accesseurs, puis affiche les couples nom du composant, valeur associée.
   Puis vérifier que les tests marqués "Q1" passent.
   
   Note : il est recommandé d'écrire la méthode en utilisant un Stream.
   Note 2 : il faut faire attention à gérer correctement les exceptions lors de l'invocation de méthode (surtout InvocationTargetException).

         ...
       } catch (InvocationTargetException e) {
         var cause = e.getCause();
         if (cause instanceof RuntimeException exception) {
           throw exception;
         }
         if (cause instanceof Error error) {
           throw error;
         }
         throw new UndeclaredThrowableException(e);
       }
       

   
   Note 3 : il y a une petite subtilité avec les guillemets. Dans le format JSON, les chaînes de caractères apparaissent entre "". Nous vous offrons la méthode suivante pour gérer cela :

       private static String escape(Object o) {
           return o instanceof String ? "\"" + o + "\"": "" + o;
       }
       

2. En fait, on peut avoir des noms de clé d'objet JSON qui ne sont pas des noms valides en Java, par exemple "book-title", pour cela on se propose d'utiliser un annotation pour indiquer quel doit être le nom de clé utilisé pour générer le JSON.
   Déclarez l'annotation JSONProperty visible à l'exécution et permettant d'annoter des méthodes, puis modifiez le code de toJSON pour n'utiliser que les propriétés issues de méthodes marquées par l'annotation JSONProperty.
   Puis vérifier que les tests marqués "Q2" passent (et uniquement ceux-là pour l'instant).
3. En fait, on veut aussi gérer le fait que l'annotation peut ne pas être présente et aussi le fait que si l'annotation est présente mais sans valeur spécifié alors le nom du composant est utilisé avec les '_' réécrit en '-'.
   Modifier le code dans JSONPrinter et la déclaration de l'annotation en conséquence.
   Pour tester, vérifier que tous les tests jusqu'à ceux marqués "Q3" passent.
   Rappel : la valeur par défaut d'un attribut d'une annotation ne peut pas être null.
4. En fait, l'appel à getRecordComponents est lent; regardez la signature de cette méthode et expliquez pourquoi...
   
5. Nous allons donc limiter les appels à getRecordComponents en stockant le résultat de getRecordComponents dans un cache pour éviter de faire l'appel à chaque fois qu'on utilise toJSON.
   Utilisez la classe java.lang.ClassValue pour mettre en cache le résultat d'un appel à getRecordComponents pour une classe donnée.
6. En fait, on peut mettre en cache plus d'informations que juste les méthodes, on peut aussi pré-calculer le nom des propriétés pour éviter d'accéder aux annotations à chaque appel.
   Écrire le code qui pré-calcule le maximum de choses pour que l'appel à toJSON soit le plus efficace possible.
   Indication : quelle est la lettre grecque entre kappa et mu?