Guide de JAXB

@XmlRootElement(name = "book")
@XmlType(propOrder = { "id", "name", "date" })
public class Book {
    private Long id;
    private String name;
    private String author;
    private Date date;

    @XmlAttribute
    public void setId(Long id) {
        this.id = id;
    }

    @XmlElement(name = "title")
    public void setName(String name) {
        this.name = name;
    }

    @XmlTransient
    public void setAuthor(String author) {
        this.author = author;
    }

   //constructor, getters and setters
}

public void marshal() throws JAXBException, IOException {
    Book book = new Book();
    book.setId(1L);
    book.setName("Book1");
    book.setAuthor("Author1");
    book.setDate(new Date());

    JAXBContext context = JAXBContext.newInstance(Book.class);
    Marshaller mar= context.createMarshaller();
    mar.setProperty(Marshaller.JAXB__FORMATTED__OUTPUT, Boolean.TRUE);
    mar.marshal(book, new File("./book.xml"));
}

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<book id="1">
    <title>Book1</title>
    <date>2016-11-12T11:25:12.227+07:00</date>
</book>

public Book unmarshall() throws JAXBException, IOException {
    JAXBContext context = JAXBContext.newInstance(Book.class);
    return (Book) context.createUnmarshaller()
      .unmarshal(new FileReader("./book.xml"));
}

Book[id=1, name=Book1, author=null, date=Sat Nov 12 11:38:18 ICT 2016]----

===  **  6. **  Types de données complexes

Lors du traitement de types de données complexes qui peuvent ne pas être directement disponibles dans JAXB, nous pouvons écrire un adaptateur pour indiquer à JAXB comment gérer un type spécifique.

En utilisant __XmlAdapter__ de JAXB, nous pouvons définir un code personnalisé pour convertir une classe non mappable en quelque chose que JAXB peut gérer. L'annotation __ @ XmlJavaTypeAdapter__ utilise un adaptateur qui étend la classe __XmlAdapter__ pour le marshaling personnalisé.

Créons un adaptateur pour spécifier un format de date lors du marshaling:

[source,java,gutter:,true]

Nous utilisons un format de date "__yyyy-MM-jj HH: mm: ss__" pour convertir __Date__ en __String__ lors du marshalling et __ThreadLocal__ pour rendre notre __DateFormat__ thread-safe.

Appliquons le __DateAdapter__ à notre __Book__:

[source,java,gutter:,true]

Lorsque nous exécutons le code ci-dessus, nous pouvons vérifier le résultat dans __book.xml__ pour vérifier que nous avons converti avec succès notre objet Java en XML en utilisant le nouveau format de date "__yyyy-MM-jj HH: mm: ss__":

[source,xml,gutter:,true]

===  **  7. JAXB-2 Maven Plugin

**

Ce plugin utilise l’API Java pour la liaison XML (JAXB), version 2+, pour générer des classes Java à partir de XML Schemas (et éventuellement des fichiers de liaison) ou pour créer un schéma XML à partir d’une classe Java annotée.

Notez qu'il existe deux approches fondamentales pour la création de services Web, __Contract Last__ et Contract First__. Pour plus de détails sur ces approches, consultez le http://docs.spring.io/spring-ws/site/reference/html/why-contract-first.html[link]

====  **  7.1. Générer une classe Java à partir de XSD **

Le plug-in JAXB-2 Maven utilise l'outil XJC fourni par JDK, un outil de compilation JAXB Binding qui génère des classes Java à partir de XSD (XML Schema Definition).

Créons un fichier __user.xsd__ simple et utilisons le plug-in JAXB-2 Maven pour générer des classes Java à partir de ce schéma XSD:

[source,xml,gutter:,true]

Configurons le plugin JAXB-2 Maven:

[source,xml,gutter:,true]

Par défaut, ce plugin localise les fichiers XSD dans __src/main/xsd__. Nous pouvons configurer la recherche XSD en modifiant la section de configuration de ce plugin dans le __pom.xml__ en conséquence.

Par défaut, ces classes Java sont générées dans le dossier __target/driven-resources/jaxb__. Nous pouvons changer le répertoire de sortie en ajoutant un élément __outputDirectory__ à la configuration du plugin. Nous pouvons également ajouter un élément __clearOutputDir__ avec une valeur false pour empêcher l’effacement des fichiers de ce répertoire.

Nous pouvons également configurer une liaison globale JAXB qui remplace les règles de liaison par défaut:

[source,xml,gutter:,true]

La __global.xjb__ ci-dessus remplace le type __dateTime__ par le type __java.util.Calendar__. + Lorsque nous construisons le projet, il génère des fichiers de classe dans le dossier __src/main/java__ et le package __com.baeldung.jaxb.gen__.

====  **  7.2. Génération de schéma XSD à partir de Java **

Le même plugin utilise l'outil fourni par JDK, __Schemagen__. Il s’agit d’un outil de compilation JAXB Binding capable de générer un schéma XSD à partir de classes Java.

Pour qu'une classe Java soit éligible pour un schéma candidat XSD, elle doit être annotée avec une annotation __ @ XmlType__.

Nous réutilisons les fichiers de classe Java de l'exemple précédent. Configurons le plugin:

[source,xml,gutter:,true]

Par défaut, JAXB analyse tous les dossiers sous __src/main/java__ de manière récursive pour les classes JAXB annotées. Nous pouvons spécifier un dossier __source__ différent pour nos classes annotées JAXB en ajoutant un élément __source__ à la configuration du plug-in.

Nous pouvons également enregistrer un __transformSchemas__, un post-processeur responsable de nommer le schéma XSD. Cela fonctionne en faisant correspondre le __namespace__ avec le namespace du __ @ XmlType__ de votre classe Java.

Lorsque nous générons le projet, il génère un fichier __user-gen.xsd__ dans le répertoire __src/main/resources__.

===  **  8. **  **  Conclusion **

Dans cet article, nous avons abordé les concepts d'introduction à JAXB. Pour plus de détails, consultez la page d'accueil http://www.oracle.com/technetwork/articles/javase/index-140168.htmlJJAXB]

Nous pouvons trouver le code source de cet article sur https://github.com/eugenp/tutorials/tree/master/jaxb[GitHub].