4.3 - Binding

VOLUNTARI

El Binding és una tècnica que consisteix en generar (i vincular) automàticament classes de Java amb formats específics d’emmagatzematge, que en el cas que ens interessa seran documents XML.

D'aquesta manera, cada etiqueta o atribut de XML es correspondrà amb una propietat d'una determinada classe. Això s'anomena mapar, perquè és fer una espècie de mapa per a indicar que una etiqueta (o atribut) es correspon a una propietat de la classe. Per a poder fer la aquesta correspondència o mapatge de forma correcta entre les classes de Java i el document XML, farà falta una miqueta d'ajuda o aclaracions, perquè com ja hem vist la mateixa informació es pot guardar de més d'una manera en XML (utilitzant o no atributs, ...).

En Java existeixen diverses biblioteques per gestionar el binding, com per exemple JAXB, JiBX, XMLBinding, etc. Des de la versió 6.0 s’ha incorporat en el JDK estàndard JAXB (Java Architecture for XML Binding), una potent biblioteca.

JAXB utilitza Anotacions per aconseguir la informació extra necessària per mapar el binding. Les Anotacions són unes classes de Java molt especials. Serveixen per associar informació i funcionalitat als objectes sense interferir en l’estructura del model de dades. Abans d'aparéixer les Anotacions era necessari fer servir l’herència per poder afegir funcionalitat a una classe sense haver de codificar-la, però ho complicava molt.

Si, per contra, fem servir Anotacions, els objectes disposaran d’informació o de funcionalitat extra sense que el model de dades quede modificat, ja que les Anotacions no són visibles des dels objectes. Les Anotacions poden associar-se a un paquet, a una classe, a un atribut o fins i tot a un paràmetre. Aquestes classes especials es declaren en el codi de l’aplicació posant el símbol @ davant del nom de l’Anotació. Quan el compilador de Java detecta una Anotació crea una instància i la injecta dins l’element afectat (paquet, classe, mètode, atribut, etc.). Això fa que aquestes no apareguen com a atributs o mètodes propis de l’objecte, i per això diem que no interacciona amb el model de dades, però les aplicacions que ho necessiten poden obtenir la instància injectada i fer-la servir.

Nosaltres en aquest curs, únicament aspirarem a veure com realment a partir d'un esquema XML que valida una sèrie de documents XML, podem generar còmodament les classes en Java, que permetrien guardar objectes d'aquestes classes. Una vegada construïdes les classes es podria utilitzar JAXB per a transferir informació dels fitxers XML (vàlids per a l'esquema) cap als objectes o a l'inrevès.

La generació de les classes és extremadament senzilla a partir d'una determinada versió d'Eclipse. Com hem comentat la llibreria JAXB està present des de la versió 6.0 del JDK SE (Standard Edition). Però per a la generació còmoda ens fan falta eines (tools) proporcionades en la JDK EE 7.0 (Enterprise Edition). Si tenim aquesta plataforma podrem utilitzar la versió 2.2 de JAXB.

Nota

Lamentablement, a partir de la versió de Java JDK EE 8.0 comença a estar en desús el JAXB (deprecated), i a la versió 11 ja no està implementat. Per tant, per a poder provar el que va a continuació és preferible que utilitzeu una versió antiga de Java (Java 7 o Java 8). Si no la teniu instal·lada, no valdrà la pena que feu aquest exemple. Per això aquesta pregunta és voluntària.

Evidentment, es pot aconseguir que funcione en Java 11, a pesar que no està implementat JAXB, però és a costa d'assenyalar que agafe configuracions anteriors, o important tots els jar necessaris, baixant-los prèviament. No valdrà la pena, perquè no l'utilitzarem

Ens recolzarem en un exemple utilitzat l'any passat. El següent esquema (.xsd) valida documents com el de l'oferta de vehicles, vist en apartats anteriors. Podeu guardar-lo amb el nom cotxes.xsd

<?xml version="1.0" encoding="UTF-8"?>

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">

<xs:simpleType name="Combust">

<xs:restriction base="xs:string">

<xs:enumeration value="gasolina"/>

<xs:enumeration value="diesel"/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="Matr">

<xs:restriction base="xs:string">

<xs:pattern value="[0-9]{4}[A-Z]{3}"/>

</xs:restriction>

</xs:simpleType>

<xs:element name="oferta">

<xs:complexType>

<xs:sequence>

<xs:element name="vehiculo" maxOccurs="unbounded" >

<xs:complexType>

<xs:sequence>

<xs:element name="marca" type="xs:string"/>

<xs:element name="modelo" >

<xs:complexType>

<xs:simpleContent>

<xs:extension base="xs:string">

<xs:attribute name="color" type="xs:string" />

</xs:extension>

</xs:simpleContent>

</xs:complexType>

</xs:element>

<xs:element name="motor" >

<xs:complexType>

<xs:simpleContent>

<xs:extension base="xs:string">

<xs:attribute name="combustible" type="Combust" />

</xs:extension>

</xs:simpleContent>

</xs:complexType>

</xs:element>

<xs:element name="matricula" type="Matr"/>

<xs:element name="kilometros" type="xs:integer"/>

<xs:element name="precio_inicial" type="xs:integer"/>

<xs:element name="precio_oferta" type="xs:integer"/>

<xs:element name="extra" maxOccurs="unbounded" >

<xs:complexType>

<xs:simpleContent>

<xs:extension base="xs:string">

<xs:attribute name="valor" type="xs:integer" />

</xs:extension>

</xs:simpleContent>

</xs:complexType>

</xs:element>

<xs:element name="foto" maxOccurs="unbounded" type="xs:string"/>

</xs:sequence>

</xs:complexType>

</xs:element>

</xs:sequence>

</xs:complexType>

</xs:element>

</xs:schema>

Per exemple, el següent document XML cotxes.xml (el vist en els apartats anteriors) és vàlid segons l'anterior esquema.

<?xml version="1.0" encoding="UTF-8"?>

<modelo color="gris">focus</modelo>

<motor combustible="gasolina">duratorc 1.4</motor>

<precio_inicial>12000</precio_inicial>

<precio_oferta>10000</precio_oferta>

<extra valor="250">pintura metalizada</extra>

<extra valor="300">llantas</extra>

</vehiculo>

<modelo color="gris">focus</modelo>

<motor combustible="diesel">duratorc 2.0</motor>

<precio_inicial>10000</precio_inicial>

<precio_oferta>9000</precio_oferta>

<extra valor="250">pintura metalizada</extra>

<extra valor="200">spoiler trasero</extra>

<extra valor="500">climatizador</extra>

</vehiculo>

</oferta>

Però per a generar les classes el que ens fa falta és el de l'esquema, cotxes.xsd. Si l'incorporem a un projecte JAXB serà molt fàcil de generar les classes

En el següent vídeo es veu aquesta generació de les classes a partir de l'esquema. No cal que ho feu si no voleu, perquè es mostra a nivell únicament il·lustratiu de com es generen les classes, però no ho utilitzarem després

En el vídeo anterior no ha hagut cap problema, per tenir instal·lat per defecte un JDK de Java antic.

Com s'ha comentat més amunt, si tenim unJDK posterior, com podria ser el JDK 11, segurament tindrem problemes. La raó és perquè a partir de Java 11 ja no s'incorporen les classes de JAXB. Quan anem a generar les classes a partir de l'esquema XML (el fitxer .xsd), donarà l'error que no troba les classes JAXB. Podem solucionar-lo de 3 maneres:

Baixar les classes necessàries. Té l'inconvenient que són moltes, encara que totes són fàcils de trobar.
Hi ha documentcaió per Internet que podem configurar les dependències del projecte de manera que vaja a buscar les llibreries de JAXB en versions anteriors.
I per últim, utilitzar un JDK que encara incorpore aquestes llibreries. L'haurem de tenir instal·lat a l'ordinador.

El següent vídeo mostra com es pot solucionar utilitzant aquesta última possibilitat. Torne a recordar que és voluntari, i si no teniu instal·lat el JDK 8 o anterior, no val la pena que ho feu.

« Anterior | Següent »

Llicenciat sota la Llicència Creative Commons Reconeixement NoComercial CompartirIgual 2.5