Bygge tilpasset kode med Java API for XML Binding (JAXB) - dummies

Du kan bygge tilpasset kode med JAXB - Java API for XML-binding . Med JAXB tar du et XML-dokument, og du lager en Java-klassefil som er perfekt for behandling av dokumentet. Når dine behov endres og klassen ikke lenger gjør det du vil at den skal gjøre, skaffer du bare en ny underklasse.

Når du skriver SAX eller DOM-kode, oppretter du et XML-behandlingsprogram. Programmet ditt leser et dokument, og bruker dokumentet til å gjøre nyttig arbeid - starter med noe ufarlig som offentlig tomgangstillegg eller knutepunkt. getNodeName (). Uansett, gjør programmet ditt ingen forutsetninger om hva som er inne i dokumentet. Dokumentet har et rotelement, noen barnelementer, og det er alt. Eventuelle spesielle forutsetninger du gjør om dette dokumentet, begrenser faktisk bruken av koden.

Allsidig kode versus tilpasset kode

Vurder koden i oppføringer 1 og 2. Oppføring 1, skanner fem noder i et dokumenttre. De fem noder må ordnes på en bestemt måte, ellers krasjer programmet. (Oppføringen vil ha en kommentar og en rotnode, med minst to barn rett under rotnoden.)

Liste 1: Viser noen noder

import org. W3C. dom. node;

import org. W3C. dom. NamedNodeMap;

klasse MyTreeTraverser

{

MyTreeTraverser (Node node)

{

System. ute. println (node. getNodeName ());

node = node. getFirstChild ();

System. ute. println (node. getNodeName ());

node = node. getNextSibling ();

System. ute. println (node. getNodeName ());

node = node. getFirstChild ();

System. ute. println (node. getNodeName ());

node = node. getNextSibling ();

System. ute. println (node. getNodeName ());

}

Oppføring 2: Å krysse DOM-treet

import org. W3C. dom. node;

import org. W3C. dom. NamedNodeMap;

klasse MyTreeTraverser

{

Node node;

MyTreeTraverser (Node node)

{

dette. node = node;

display ();

displayValue ();

hvis (node. GetNodeType () == Knutep. ELEMENT_NODE)

displayAttributes ();

System. ute. println ();

displayChildren ();

}

void displayName ()

{

System. ute. skriv ut ("Navn:");

System. ute. println (node. getNodeName ());

}

void displayValue ()

{

String nodeValue = node. getNodeValue ();

hvis (nodeValue! = Null)

nodeValue = nodeValue. trim ();

System. ute. skriv ut ("verdi:");

System. ute. println (nodevalue);

}

void displayAttributes ()

{

NamedNodeMap attribs = node. getAttributes ();

for (int i = 0; i

{

System. ute. println ();

System. ute. skriv ut ("Attributt:");

System. ute. print (attribs. item (i). getNodeName ());

System. ute. skriv ut ("=");

System. ute. println (attribs. item (i). getNodeValue ());

}

void displayChildren ()

{

Node barn = node. getFirstChild ();

mens (barn! = Null)

{

ny MyTreeTraverser (barn);

barn = barn. getNextSibling ();

}

Koden i liste 2 er mye mer generell. Denne koden kontrollerer dokumentstrukturen når den kjører. Når koden finner en barneknude, skanner den barnet og ser etter barnebarn. Hvis det ikke er noen barnebarn, ser koden etter brødre og søstre. Koden kan håndtere et hvilket som helst dokumenttreet - enten det har en node eller tusen noder.

Listing 2 er således mer allsidig enn Listing 1. Men denne allsidigheten kommer med ulemper - inkludert muligheten for svært høye kostnader. Koden i Liste 2 må analysere hele XML-dokumentet - og deretter vise en representasjon av dokumentets tre i datamaskinens minne. Hvis dokumentet er veldig stort, er representasjonen stor: Minne blir oppblåst med alle de midlertidige dataene, og koden i liste 2 bremser til en gjennomsøking.

Fordelene med tilpasning

Tenk deg at du prøver å kjøre til Faneuil Hall i Boston, Massachusetts. Det spiller ingen rolle hvor du starter fra; turen vil alltid være forvirrende og vanskelig. Uansett må du planlegge ruten din. Du kan gå seg vill i nærliggende Revere eller Cambridge eller i sentrum av Boston. Avhengig av ressursene dine, har du to alternativer:

Du kan stoppe ved en bensinstasjon og kjøpe et kart. Hvis du gjør det, kan du aldri komme til Faneuil Hall. Tross alt må du finne hvor du er på kartet, se etter alternative ruter, velg en rute, og deretter (himmelen hjelper deg), prøv å følge ruten uten å gå seg vill igjen.
Du kan fortelle det dyre, snakkede GPS-systemet du vil komme til Faneuil Hall. Systemet vil plotte en tilpasset rute og veilede deg, sving av sving, fra det uhyggelige stedet du befinner deg i den optimale ruten som fører derfra til Faneuil Hall. Ruten er så tilpasset at GPS-stemmen sier (for eksempel), "Det er ingen tegn på dette veikrysset, men sving til venstre uansett. "Senere sier stemmen" Det er to tegn på dette skjæringspunktet, og tegnene står i motsetning til hverandre. Men sving til høyre uansett. "

Bruk av papirkartet tar mer arbeid (mer tid, krefter, fingerferdighet og tålmodighet) enn å bruke den snakkende GPS-en. Hvorfor? Fordi papirarket ikke er tilpasset dine spesifikke behov; I virkeligheten står det: "Her er hele Boston hovedstadsområde. Faneuil Hall er der inne et sted. Du finne ut hva du skal gjøre neste. "

Et tilpasset system er (som du kanskje regner med) lettere å bruke enn det som ikke er skreddersydd for din umiddelbare situasjon. XML-behandlingskoden til Listing 2 gjør dermed et stort ressursgulpende DOM-tre i datamaskinens minneplass ("Her er treet - du finne ut hva du skal gjøre neste …") fordi koden er ikke ' t tilpasset.Koden fungerer for ethvert gammelt dokument - ikke bare det du har ved hånden - og gobbles alltid ressurser for å gjøre det.

Essensen av JAXB

Tanken bak JAXB er å lage skreddersydd klasse for å møte dine nåværende behov. Du tar beskrivelsen av et XML-dokument, kjører det gjennom et spesielt program kalt en skjema kompiler , og får en helt ny klasse kalt generert klasse . Denne genererte klassen er strømlinjeformet for å fungere med bestemte XML-dokumenter.

For eksempel, hvis XML-dokumentene dine har elementer som heter Total, kan den genererte klassen ha setTotal og getTotal-metoder. Hvis et dokuments element har et fullName-attributt, kan den genererte klassen ha setFullName og getFullName-metoder. (Se Figur 1.)

Forbindelsen mellom en del av et XML-dokument og en del av en Java-klasse kalles en binding . Med alle disse bindingene representerer en forekomst av klassen et enkelt XML-dokument.