Leitfaden für 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. **  Komplexe Datentypen

Beim Umgang mit komplexen Datentypen, die in JAXB möglicherweise nicht direkt verfügbar sind, schreiben wir möglicherweise einen Adapter, um JAXB mitzuteilen, wie ein bestimmter Typ verwaltet wird.

Mit dem __XmlAdapter__ von JAXB können wir einen benutzerdefinierten Code definieren, um eine nicht zuzuordnende Klasse in etwas zu konvertieren, das JAXB verarbeiten kann. Die Annotation __ @ XmlJavaTypeAdapter__ verwendet einen Adapter, der die Klasse __XmlAdapter__ für benutzerdefiniertes Marshalling erweitert.

Lassen Sie uns einen Adapter erstellen, um beim Marshalling ein Datumsformat anzugeben:

[source,java,gutter:,true]

Wir verwenden das Datumsformat "__yyyy-MM-dd HH: mm: ss__", um __Date__ beim Marshalling in __String__ zu konvertieren und __ThreadLocal__, um unseren __DateFormat__-Thread sicher zu machen.

Wenden wir den __DateAdapter__ auf unser __Book__ an:

[source,java,gutter:,true]

Wenn wir den obigen Code ausführen, überprüfen wir möglicherweise das Ergebnis in __book.xml__, um sicherzustellen, dass wir unser Java-Objekt erfolgreich in XML konvertiert haben, und zwar mit dem neuen Datumsformat „__yyyy-MM-dd HH: mm: ss__“:

[source,xml,gutter:,true]

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

**

Dieses Plugin verwendet die Java-API für XML-Bindung (JAXB), Version 2, um Java-Klassen aus XML-Schemas (und optional Bindungsdateien) zu generieren oder ein XML-Schema aus einer kommentierten Java-Klasse zu erstellen.

Beachten Sie, dass es zwei grundlegende Ansätze für die Erstellung von Web-Services gibt, __Contract Last__ und __Contract First__. Weitere Informationen zu diesen Ansätzen erhalten Sie unter http://docs.spring.io/spring-ws/site/reference/html/why-contract-first.html[link].

====  **  7.1. Java-Klasse aus XSD generieren **

Das JAXB-2 Maven-Plugin verwendet das von JDK bereitgestellte Tool XJC, ein JAXB Binding-Compiler-Tool, das Java-Klassen aus XSD (XML-Schema-Definition) generiert.

Erstellen wir eine einfache __user.xsd__ -Datei und verwenden Sie das JAXB-2-Maven-Plugin, um Java-Klassen aus diesem XSD-Schema zu generieren:

[source,xml,gutter:,true]

Lassen Sie uns das JAXB-2 Maven Plugin konfigurieren:

[source,xml,gutter:,true]

Dieses Plugin sucht standardmäßig nach XSD-Dateien in __src/main/xsd__. Wir können die XSD-Suche konfigurieren, indem Sie den Konfigurationsabschnitt dieses Plugins in der Datei __pom.xml__ entsprechend ändern.

Standardmäßig werden diese Java-Klassen im Ordner __target/generated-resources/jaxb__ generiert. Wir können das Ausgabeverzeichnis ändern, indem Sie der Plug-In-Konfiguration ein __outputDirectory__ -Element hinzufügen. Wir können auch ein __clearOutputDir__ -Element mit dem Wert false hinzufügen, um zu verhindern, dass die Dateien in diesem Verzeichnis gelöscht werden.

Wir können auch eine globale JAXB-Bindung konfigurieren, die die Standardbindungsregeln überschreibt:

[source,xml,gutter:,true]

Das oben angegebene __global.xjb__ überschreibt den __dateTime__-Typ mit dem __java.util.Calendar__-Typ. Wenn wir das Projekt erstellen, werden Klassendateien im Ordner __src/main/java__ und im Paket __com.baeldung.jaxb.gen__ generiert.

====  **  7.2. XSD-Schema aus Java generieren **

Dasselbe Plugin verwendet das von JDK bereitgestellte Werkzeug __Schemagen__. Dies ist ein JAXB Binding-Compiler-Tool, das ein XSD-Schema aus Java-Klassen erstellen kann.

Damit eine Java-Klasse für einen XSD-Schemankandidaten in Frage kommt, muss die Klasse mit einer Annotation __ @ XmlType__ versehen werden.

Wir verwenden die Java-Klassendateien aus dem vorherigen Beispiel wieder. Lassen Sie uns das Plugin konfigurieren:

[source,xml,gutter:,true]

Standardmäßig durchsucht JAXB alle Ordner unter __src/main/java__ rekursiv nach kommentierten JAXB-Klassen. Wir können einen anderen __source__-Ordner für unsere mit Anmerkungen versehenen JAXB-Klassen angeben, indem Sie der Plug-In-Konfiguration ein __source__ -Element hinzufügen.

Wir können auch einen __transformSchemas__ registrieren, einen Postprozessor, der für die Benennung des XSD-Schemas verantwortlich ist. Es funktioniert, indem der __namespace__ mit dem Namespace des __ @ XmlType__ Ihrer Java-Klasse abgeglichen wird.

Beim Erstellen des Projekts wird eine __user-gen.xsd__ -Datei im Verzeichnis __src/main/resources__ erstellt.

===  **  8. **  **  Schlussfolgerung **

In diesem Artikel haben wir Einführungskonzepte zu JAXB behandelt. Einzelheiten finden Sie auf der http://www.oracle.com/technetwork/articles/javase/index-140168.html[JAXB-Startseite].

Den Quellcode für diesen Artikel finden Sie unter https://github.com/eugenp/tutorials/tree/master/jaxb