13.14. RESTEasy JAXB

Procédure 13.8. Créer un décorateur JAXB dans RESTEasy

1. Créer la classe de processeur

   1. Créer une classe qui implémente DecoratorProcessor<Target, Annotation>. La cible sera soit la classe de Marshaller ou Unmarshaller JAXB. L'annotation est créée dans la seconde étape.
   2. Annoter la classe par @DecorateTypes, et déclarer les types MIME que le décorateur doit décorer.
   3. Définir les propriétés ou les valeurs au sein de la fonction decorate.

   Exemple 13.22. Exemple de classe de processeur

   import org.jboss.resteasy.core.interception.DecoratorProcessor;
   import org.jboss.resteasy.annotations.DecorateTypes;
   
   import javax.xml.bind.Marshaller;
   import javax.xml.bind.PropertyException;
   import javax.ws.rs.core.MediaType;
   import javax.ws.rs.Produces;
   import java.lang.annotation.Annotation;
   
   @DecorateTypes({"text/*+xml", "application/*+xml"})
   public class PrettyProcessor implements DecoratorProcessor<Marshaller, Pretty>
   {
       public Marshaller decorate(Marshaller target, Pretty annotation,
   	  Class type, Annotation[] annotations, MediaType mediaType)
       {
   	target.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, Boolean.TRUE);
       }
   }
   

2. Créer une annotation

   1. Créer une interface personnalisée annotée par @Decorator.
   2. Déclarer le processeur ou la cible de l'annotation @Decorator. Le processeur est créé dans la première étape. La cible sera soit la classe Marshaller JAXB ou la classe Unmarshaller JAXB.

   Exemple 13.23. Exemple d'annotation

   import org.jboss.resteasy.annotations.Decorator;
   
   @Target({ElementType.TYPE, ElementType.METHOD, ElementType.PARAMETER, ElementType.FIELD})
   @Retention(RetentionPolicy.RUNTIME)
   @Decorator(processor = PrettyProcessor.class, target = Marshaller.class)
   public @interface Pretty {}
   

3. Ajouter l'annotation créée dans une fonction dans la seconde étape de façon à ce que l'entrée ou la sortie soit décorée quand elle sera mise en ordre.