Ingenieria

iBATIS SQL Maps Tutorial

para SQL Maps Versión 2.0

Octubre, 2006

Traducción al Español de Kike Mota (kikemota@gmail.com)

Introduction
Este breve tutorial te dará un paseo por el uso típico de SQL Maps. Los detalles de cada uno de los temas tratados aquí los puedes encontrar en la guía de desarrollo con SQL Maps disponible en http://ibatis.apache.org.

Preparado para usar SQL Maps.El marco de trabajo SQL Maps es muy tolerante tanto con las malas implementaciones de los modelos de datos, como con las malas implementaciones de los modelos de objetos. A pesar de ello, es muy recomendable que uses las mejores practicas tanto cuando diseñes tu base de datos (normalización apropiada, etc.), como cuando diseñes tu modelo de objetos. Haciendo esto tendrás garantizado un mejorrendimiento y un diseño más claro. La forma mas fácil de empezar es analizando con qué estas trabajando. ¿Cuales son tus objetos de negocio?. ¿Cuales son tus tablas?. ¿Como se relacionan?. Para el primer ejemplo, considera el siguiente clase Person que sigue las convenciones típicas de los JavaBeans. Person.java
package examples.domain; //imports omitidos…. public class Person { private int id;private String firstName; private String lastName; private Date birthDate; private double weightInKilograms; private double heightInMeters; public int getId () { return id; } public void setId (int id) { this.id = id; } //…asumimos que aquí tendríamos otros métodos get y set.… }

¿Como se mapea esta clase Person a nuestra base de datos?. SQL Maps no te limita a la hora de establecer relaciones deltipo tabla-por-clase o multiples-tablas-por-clase o múltiples-clases-por-tabla. Existen muy pocas restricciones dado que dispones de toda la potencia que ofrece el SQL. Por ejemplo, usemos la siguiente tabla, que podría ser apropiada para una relación tabla-por-clase: Person.sql
CREATE TABLE PERSON( PER_ID NUMBER PER_FIRST_NAME VARCHAR PER_LAST_NAME VARCHAR PER_BIRTH_DATE DATETIME PER_WEIGHT_KGNUMBER PER_HEIGHT_M NUMBER PRIMARY KEY (PER_ID)) (5, 0) (40) (40) (4, 2) (4, 2) NOT NULL, NOT NULL, NOT NULL, , NOT NULL, NOT NULL,

2

El fichero de configuración de SQL Map
Una vez hemos visto las clases y las tablas con las que vamos a trabajar, la mejor manera de empezar a trabajar con SQL Maps es viendo el fichero de configuración. Este fichero actuará como el fichero maestro para laconfiguración de nuestra implementación basada en SQL Map. El fichero de configuración es un fichero XML. Dentro de el configuraremos ciertas propiedades, el DataSource JDBC y los mapeos SQL que utilizaremos en nuestra aplicación. Este fichero te ofrece un lugar central donde configurar tu DataSource. El marco de trabajo puede manejar varias implementaciones de DataSources , dentro de los que seincluyen iBATIS están SimpleDataSource, Jakarta DBCP (Commons), y cualquier DataSource que se pueda obtener a través de un contexto JNDI (p.e. Un DataSource configurado dentro de un servidor de aplicaciones). Todo esto se describe con mas detalle en la Guía del Desarrollador. La estructura es simple y para el ejemplo expuesto arriba, debe ser algo como esto:

El ejemplo continua en la siguientepágina…

3

SqlMapConfigExample.xml








4

SqlMapConfigExample.properties
# Este es un ejemplo de fichero de properties que simplifica la automatización de la configuración #del fichero de configuración de SQL Maps (ej. A través de Ant o de herramientas para la #integracióncontinua para diferentes entornos... etc.). #Estos valores pueden ser usados en cualquiervalor de propiedad en el fichero de arriba (ej. #“${driver}”. #El uso del fichero de propiedades es completamente opcional.

driver=oracle.jdbc.driver.OracleDriver url=jdbc:oracle:thin:@localhost:1521:oracle1 username=jsmith password=test

Los ficheros SQL Map
Ahora que tenemos configurado un DataSource y listo el fichero de configuración central, necesitaremos proporcionar al fichero de SQL...