JOX Mapping entre JavaBeans y XML

E-mail:
Contraseña:

DESARROLLADO POR:

Carlos García Pérez

Creador de MobileTest, un complemento educativo para los profesores y sus alumnos.

Creador de Girillo, una forma alternativa de comunicarse.

Charla sobre desarrollo de aplicaciones en Android

Técnico especialista en informática de empresa (CEU)

Ingeniero Técnico en Informática de Sistemas (UPM) *

Puedes encontrarme en Autentia: Ofrecemos servicios de soporte a desarrollo, factoría y formación

Fecha de publicación del tutorial: 2007-02-23
4.128

Regístrate para votar

Share |

JOX Mapping entre JavaBeans y XML

Introducción

Una necesidad común en el desarrollo de aplicaciones informáticas es el mapeo (conversión) entre objetos y documentos XML.

Normalmente esta tarea se realiza para poder utilizar otras tecnologías que trabajan con documentos XML como XSLT o para intercambiar información entre clientes y servidores.

En mi experiencia como programador he notado que esta tarea en la gran mayoria de los casos se realiza manualmente desde el código fuente de la aplicación o apoyándose en tecnologías como DOM y SAX.

En este tutorial realizo una presentación de una de las muchas APIS que nos facilitan esta tarea.

¿Qué es JOX?

JOX es una librería OpenSource con licencia LGPL de clases Java que nos permite convertir JavaBeans en documentos XML y viceversa.

Puedes obtener la librería JOX así como una documentación más extensa desde aquí

¿Qué puedo hacer con JOX?

Crear JavaBeans desde InputStreams o Readers. (sockets, ficheros, buffers de memoria, etc)
Serializar JavaBeans con formato XML sobre OutputStream o Writers. (sockets, ficheros, buffers de memoria, etc)
Definición del tipo de mapping que deseamos mediante DTD. (Por ejemplo, que el elemento "firstname" de un xml se traduzca en la propiedad "nombre" de un JavaBean).

¿Ventajas del uso de JOX frente a otras librerías similares?

JOX es ideal para hacer mappings sencillos en donde no se quiere tener la sobrecarga (hablando en términos de Kilobytes) de otras librerías más potentes.

Por ejemplo, librerías como Apache Commons Digester son mucho más potentes y flexibles, pero tienen dependencias con otras librerías por lo que sobrecargan el proyecto y esto en determinadas circunstancias puede no ser deseable.

Algunos ejemplos

Bueno, como el camino se hace al andar, vamos a ver unos ejemplos autocomentados del uso de la librería.

package com.autentia.tutoriales;

import com.wutka.jox.*;
import com.wutka.dtd.*;
import java.io.*;

/**
 * Ejemplo del uso de la libreía JOX para el mapeo entre Beans y XML
 * @author Carlos Garcia. Autentia.
 * @see http://www.mobiletest.es  
 */
public class JOXExampleApp {

/**
	 * @return Devuelve el XML a partir del cual creamos los objectos
	 */
	public static String getXML() {
		StringBuffer xml = new StringBuffer(512);
		xml.append("<?xml version='1.0' standalone='yes'?>");
		xml.append("<Persona>");
		xml.append("<address><street>Honduras</street><number>30</number></address>");
		xml.append("<firstName>Joaquina</firstName>");
		xml.append("<lastNames>Pérez Guillén</lastNames>");
		xml.append("<weight>182</weight>");
		xml.append("</Persona>");
		return xml.toString();
	}

/**
	 * @return Devuelve el XML a partir del cual creamos el objeto
	 */
	public static String getDTD() {
		StringBuffer dtd = new StringBuffer(512);
		dtd.append("<!ELEMENT Persona (firstName, lastNames)>");
		dtd.append("<!ELEMENT firstName (#PCDATA)>");
		dtd.append("<!ELEMENT lastNames (#PCDATA)>");
		dtd.append("<!ATTLIST Persona  weight #REQUIRED>\n");
		return dtd.toString();
	}

/**
	 * Inicia el ejemplo
	 */
	public static void main(String[] args) throws Exception {
		// Ejemplo 1: Construimos un objeto a partir de una definición XML
		String xml = JOXExampleApp.getXML();
		JOXBeanReader reader = new JOXBeanReader(new StringReader(xml));
		Persona person = (Persona) reader.readObject(Persona.class);
		
		/**
		 * Imprimirá : 
		 * 
		 * Nombre: Joaquina 
		 * Apellidos: Pérez
		 * Peso: 182
		 * Calle: Honduras
		 * Número: 30
		 */
		
		System.out.println("Nombre: " + person.getFirstName());
		System.out.println("Apellidos: " + person.getLastNames());
		System.out.println("Peso: " + person.getWeight());
		System.out.println("Calle: " + person.getAddress().getStreet());
		System.out.println("Número: " + person.getAddress().getNumber());

// Ejemplo 2: Ahora pasamos de objeto a XML
		StringWriter writer = new StringWriter(1024);
		JOXBeanWriter joxOut = new JOXBeanWriter(writer);
		joxOut.writeObject("Persona", person);
		joxOut.close();

/*
		  Se imprimirá:
		    <?xml version="1.0" encoding="ISO-8859-1"?>
			<Persona>
				<address>
					<number>30</number>
					<street>Honduras</street>
				</address>
				<firstName>Joaquina</firstName>
				<lastNames>Pérez Guillén</lastNames>
				<weight>182</weight>
			</Persona>
		 */
				 
		System.out.println(writer.getBuffer().toString());
		writer.close();

// Ejemplo 3: Ahora pasamos de objeto a XML especificando el formato con
		// una DTD
		// El elemento Weight será un atributo de Persona
		writer = new StringWriter(1024);
		DTDParser parser = new DTDParser(new StringReader(getDTD()));
		DTD dtd = parser.parse();

joxOut = new JOXBeanWriter(dtd, writer);
		joxOut.writeObject("Persona", person);
		joxOut.close();

/*
		 Imprimirá: (Observe el atributo weight)
		  
		  <?xml version="1.0" encoding="ISO-8859-1"?>
		  <Persona weight="182">
		  	<firstName>Nombre como propiedad</firstName>
		  	<lastNames>Sanchez Luna</lastNames>
		  </Persona>
		 */
		
		System.out.println(writer.getBuffer().toString());
		writer.close();
	}
}

package com.autentia.tutoriales;

/**
 * Bean para el ejemplo.
 * @author Carlos García. Autentia
 * @see http://www.mobiletest.es   
 */
public class Persona {
	/**
	 * Nombre de la persona
	 */
	private String firstName;
	
	/**
	 * Apellidos de la persona
	 */
	private String lastNames;
	
	/**
	 * Peso en Kilogramos de la persona
	 */
	private int	weight;
	
	/**
	 * Dirección de la persona
	 */
	private Address address;
	
	/**
	 * Constructor por defecto
	 */
	public Persona(){}

/**
	 * @return Devuelve el nombre de la persona
	 */
	public String getFirstName() {
		return this.firstName;
	}

/**
	 * @return Devuelve los apellidos de la persona
	 */
	public String getLastNames() {
		return this.lastNames;
	}

/**
	 * @return Devuelve el peso de la persona en gramos
	 */
	public int getWeight() {
		return this.weight;
	}

/**
	 * Establece el nombre de la persona
	 * @param firstName Nombre
	 */
	public void setFirstName(String firstName) {
		this.firstName = firstName;
	}

/**
	 * Establece los apellidos de la persona
	 * @param lastNames Apellidos
	 */
	public void setLastNames(String lastNames) {
		this.lastNames = lastNames;
	}

/**
	 * Establece el peso de la persona
	 * @param weight Peso
	 */
	public void setWeight(int weight) {
		this.weight = weight;
	}

/**
	 * @return Devuelve la dirección de la persona
	 */
	public Address getAddress() {
		return address;
	}

/**
	 * Establece la dirección de la persona
	 * @param addr Dirección
	 */
	public void setAddress(Address addr) {
		this.address = addr;
	}
}

Bueno, espero que os haya sido de utilidad este tutorial.

En Autentia Real Business Solutions, nos gusta compartir el conocimiento. Aquí teneis un poquito más de nuestra aportación.

Si algún día necesitais ayuda con vuestros proyectos o necesitais formación, podéis encontrarnos en Autentia

Saludos,
Carlos García, creador de MobileTest

Anímate y coméntanos lo que pienses sobre este TUTORIAL:

Puedes opinar o comentar cualquier sugerencia que quieras comunicarnos sobre este tutorial; con tu ayuda, podemos ofrecerte un mejor servicio.

Catálogo de servicios Autentia

Últimas Noticias

Autentia patrocina un nuevo Coderetreat en Madrid junto con agilismo.es y Eden

Autentia patrocina el Agile Open Spain 2010

Disponibles gratis, para el iPhone, las cartas de Planning Poker tipo cómic de Autentia

XI Charla Autentia - Mule

Comic Flash sobre el Retorno a la Cordura en el Desarrollo Software

Histórico de NOTICIAS

Últimos Tutoriales

Últimos Tutoriales del Autor

Síguenos a través de:

Últimas ofertas de empleo

Fecha de publicación del tutorial: 2007-02-23
4.128

Introducción

¿Qué es JOX?

¿Qué puedo hacer con JOX?

¿Ventajas del uso de JOX frente a otras librerías similares?

Algunos ejemplos

» Registrate y accede a esta y otras ventajas «

Comentarios

Últimos Tutoriales

Últimos Tutoriales del Autor

Últimas ofertas de empleo

Fecha de publicación del tutorial: 2007-02-23 4.128

Introducción

¿Qué es JOX?

¿Qué puedo hacer con JOX?

¿Ventajas del uso de JOX frente a otras librerías similares?

Algunos ejemplos

Comentarios

Fecha de publicación del tutorial: 2007-02-23
4.128