He creado una pequeña página con información sobre el documento, la tabla de contenidos y el capítulo de introducción para que todo el mundo sepa qué puede esperar de este libro, tutorial o como queramos llamarlo.

Espero que este documento sea la referencia que pretendía que fuera para todos aquellos que queráis introduciros un poco en el desarrollo de compiladores y máquinas virtuales, y para aquellos que queráis aprender cómo y en qué medida os pueden ayudar herramientas como ANTLR durante el proceso de desarrollo.

Ni que decir tiene que si tenéis propuestas, modificaciones, ampliaciones o habéis encontrado algún error en el texto o los ejemplos no dudéis en contactar conmigo a través de la dirección de correo electrónico que aparece en la información de contacto.

Para quién no lo sepa Google Code aglutina todos los recursos relacionados con el desarrollo de software que pone Google a nuestra disposición. Entre estos recursos podemos encontrar documentación y ejemplos de todas las API de los servicios web de Google, información sobre los programas de desarrollo creados como iniciativa de esta compañía, como por ejemplo el Summer of Code, o el acceso al fantástico servicio de hosting para proyectos open source de Google.

A todo esto añado a partir de hoy la sección Google Code University (o Google Code for Educators), que no es más que un repositorio de información sobre distintas tecnologías y disciplinas de desarrollo como AJAX, sistemas distribuidos, seguridad web o lenguajes de propósito general como Java, C++ o Phyton. En este sitio podemos encontrar tutoriales, presentaciones, ejemplos, e incluso videos de presentaciones en directo.

En definitiva, un recurso interesante al que al menos merece la pena echar un vistazo.

Omea es un gestor de información que pretende aglutinar en una única aplicación el máximo de fuentes de información posibles, incluyendo email, contactos, documentos, grupos de noticias, feeds RSS, favoritos web (bookmarks), tareas o mensajería instantanea.

La noticia que nos interesa está en que Omea es un producto desarrollado íntegramente en .NET, por lo que su código puede ser una buena fuente de información para todos los desarrolladores de esta plataforma.

Para más información podéis acceder a la web que han habilitado con toda la información para acceder a los fuentes y las características del proyecto.

En cuanto al contenido del borrador, en la primera parte se tratan las nuevas características de C# 3.0, como los métodos de extensión (extension methods), variables con asignación implícita de tipos (implicitly-typed local variables), propiedades automáticas (automatic properties), inicializadores de objetos y colecciones (object and collection initializers), tipos anónimos (anonymous types) o expresiones lambda (lambda expressions). En la segunda parte se ocupan de LINQ, desde sus características básicas hasta construcciones avanzadas. Todo ello, en la misma línea de otros libros anteriores, con ejercicios intercalados entre los temas y resueltos al final del libro.

Para quién no conozca a Bruce Eckel, tan sólo decir que es también el autor de los libros Thinking in Java y Thinking in C++ (descargables también de forma gratuita desde sus webs), para mí verdaderas obras maestras de estos temas, por lo que recomiendo echar también un vistazo a este nuevo libro.

Lo primero que haremos será crear el proyecto en Visual Studio o cualquier otro IDE de desarrollo .NET y añadir a las referencias del proyecto el proveedor ADO.NET 2.0 para SQLite (en el artículo anterior comentamos dónde podíamos conseguir este proveedor). La librería DLL a añadir como referencia, y que habrá que distribuir con nuestra aplicación, será la denominada System.Data.SQLite.DLL que encontraremos dentro del fichero ZIP que descargamos. Una vez referenciado el proveedor para ADO.NET de SQLite ya podemos comenzar a escribir el código de nuestra aplicación. Para ello, deberemos añadir la directiva using correspondiente a la librería que acabamos de añadir:

A partir de este momento el código necesario para acceder y gestionar nuestra base de datos SQLite será completamente análogo al ya tradicional que utilizamos para el acceso a cualquier otro tipo de bases de datos, salvo que los nombres de las clases comenzarán con el prefijo "SQLite". Así, por ejemplo, tendremos a nuestra disposición las siguientes clases:

SQLiteConnection
SQLiteTransaction
SQLiteCommand
SQLiteParameter
SQLiteDataReader
...

Conexión con la base de datos

La conexión con la base de datos se realizará mediante la clase SQLiteConnection. Para el caso de SQLite, el único parámetro obligatorio de la cadena de conexión será el nombre del fichero de datos:

Otros parámetros que pueden especificarse dentro de la cadena de conexión son la contraseña en caso de existir, el timeout por defecto para las operaciones sobre la base de datos, etc. Para ver todos los parámetros que podemos especificar en la conexión con la base de datos SQLite puede consultarse la ayuda proporcionada con el proveedor ADO.NET en el fichero SQLite.NET.chm

Consulta de datos

Para realizar una consulta parametrizada sobre la base de datos haremos uso de las clases SQLiteCommand, SQLiteParameter y SQLiteDataReader. Veamos cómo quedaría un método sencillo de consulta sobre una tabla especificando un parámetro de búsqueda:

Inserción de datos

La ejecución de una operación INSERT simple será análoga a la consulta descrita en el apartado anterior, salvo que el método de ejecución será ahora ExecuteNonQuery() ya que no se devolverá ningún valor:

Si en nuestra tabla existe un campo autonumérico y queremos recuperar su valor después de ejecutar la operación de INSERT, tendremos que modificar la instrucción ejecutada para añadir al final una llamada a la función last_insert_rowid() de SQLite y cambiar el método de ejecución por ExecuteScalar() para recuperar el valor devuelto:

Transacciones en SQLite

Tal y como aconsejan en la ayuda del propio proveedor de ADO.NET para SQLite, en caso de ejecutar varias operaciones sobre una base de datos es recomendable hacerlas dentro de una misma transacción, algo que aumentará muchísimo el rendimiento de la base de datos y por tanto reducirá considerablemente el tiempo necesario para ejecutar las operaciones. Para comenzar una transacción bastará con llamar al método BeginTransaction() del objeto SQLiteConnection una vez creada la conexión, y para finalizar la transacción haciendo COMMIT o ROLLBACK de todas las operaciones llamaremos a los métodos Commit() o Rollback() respectivamente:

Espero que este pequeño tutorial de SQLite sobre .NET les sea de ayuda.

¿Qué es SQLite?

SQLite es, como indican en un artículo de su propia web oficial, una base de datos de código libre con las siguientes características distintivas:

• No necesita configuración, ni tras la instalación inicial ni para el posterior mantenimiento.
• No utiliza servidor. Se puede utilizar embebida dentro de otra aplicación o gestionar los ficheros de datos a través de una pequeña aplicación de consola descargable desde su web.
• Utiliza un sólo fichero para almacenar los datos. Una base de datos de SQLite se compone de un único fichero que puede almacenarse en cualquier ruta de la máquina.
• Los ficheros de datos son multiplataforma. Una base de datos creada en una máquina y sistema operativo concreto puede copiarse y utilizarse bajo cualquier otra plataforma.
• Es muy compacta. La librería que se integra con otras aplicaciones ocupa unos 200 KBytes.
• Utiliza tipado dinámico (Manifest Typing). SQLite permite almacenar cualquier valor de cualquier tipo en cualquier registro de una tabla de la base de datos, independientemente del tipo declarado al crear la tabla.
• Utiliza registros de longitud variable. Cada dato almacenado en la base de datos ocupará su tamaño real y no el reservado según su tipo.

A estas características me gustaría añadir un par más que me parecen interesantes:

• Proporciona un muy buen rendimiento, muy por encima de bases de datos como Access.
• Se integra muy fácilmente con aplicaciones .NET ya que existe su proveedor ADO.NET 2.0, también de código libre.

¿Qué necesitamos descargar?

Para gestionar y utilizar bases de datos SQLite tan sólo deberemos descargar la aplicación de gestión en modo consola que nos servirá para crear el fichero de base de datos y crear todas las entidades necesarias (tablas, índices...), y el proveedor ADO.NET para su utilización desde nuestra aplicación .NET.

1. Página de descarga de SQLite.
2. Página de descarga de SQLite for ADO.NET 2.0.

La base de datos se creará mediante la aplicación de consola "sqlite3.exe" pasándole como parámetro el nombre deseado para nuestra base de datos:

c:\> sqlite3 basedatos.db
SQLite version 3.5.6
Enter ".help" for instructions
sqlite>

Una vez iniciada la aplicación se podrán ejecutar todas las sentencias SQL necesarias para crear las tablas que queramos que formen parte de nuestra base de datos.

Los tipos de datos declarados al crear una tabla serán meramente informativos y no impedirán que posteriormente se inserte cualquier valor de cualquier tipo en estos campos, siempre con las siguientes matizaciones:

• Si en un campo TEXT se inserta un valor numérico este valor se convertirá a texto antes de ser almacenado.
• Si en un campo NUMERIC se inserta un valor de tipo texto éste se intentará convertir a un valor numérico entero o real antes de su almacenamiento y si no es posible la conversión se almacenará directamente como texto.
• Los campos de tipo INTEGER se comportan de igual forma que NUMERIC salvo que si se inserta un valor real sin decimales o un valor textual que pueda convertirse a éste último se almacenará como entero.
• Los campos de tipo REAL se comportan de igual forma que NUMERIC salvo que se almacenará el dato siempre como valor de tipo real.
• Los campos INTEGER PRIMARY KEY servirán para crear un campo autonumérico o autoincremental (el campo se autoincrementa al realizar inserciones en la tabla con este campo nulo).

En el siguiente artículo veremos cómo utilizar la base de datos creada desde una aplicación desarrollada en .NET

Sin embargo, cuando necesitamos un mayor rendimiento de nuestra base de datos, ya sea en velocidad, concurrencia o cualquier otro factor que se nos ocurra, MS Access empieza a no ser tan buena solución a nuestro problema.

Éste era el caso en uno de los últimos proyectos en los que he estado involucrado. Nuestra aplicación necesitaba realizar en un tiempo aceptable varios cientos de miles [quizá por encima del millón] de inserciones en nuestra base de datos, de forma que el tiempo de ejecución no se demorara por encima de unos ciertos límites establecidos. Tras unas pruebas iniciales Access demostró no estar a la altura de las circunstacias sobrepasando muy por encima los tiempos que habíamos estimado.

Había que buscar soluciones, o dicho de otra forma, teníamos que encontrar otra base de datos que nos ofreciera un mayor rendimiento en el contexto de nuestra aplicación. Las alternativas planteadas inicialmente eras las clásicas MySQL y PostgreSQL. A pesar de ser buenas soluciones y cumplir nuestros requisitos, por cuestiones de distribución necesitábamos que la instalación de nuestra aplicación fuera lo más pequeña, rápida y directa posible, y cualquiera de estas dos soluciones implicaba la instalación y configuración de un servidor de base de datos, además de la propia aplicación en sí.

Las otras dos alternativas fueron SQLite y Firebird. Tras un pequeño análisis de ambas soluciones, el resultado quedó en empate técnico, siempre en relación a nuestras necesidades específicas. Ambas bases de datos ofrecen al menos un modo de funcionamiento en el que no se depende de ningún servidor por lo que tan sólo hay que distribuir el ficheros de datos (Firebird también puede utilizarse en modo cliente-servidor de forma análoga a MySQL), se pueden integrar fácilmente con aplicaciones desarrolladas en C# (realmente en cualquier lenguaje .NET) ya que existen para ambos proveedores de ADO.NET, las librerías necesarias para su uso dentro de nuestra aplicación son bastante livianas, y cumplen sin problemas nuestros requisitos de rendimiento (en nuestras pruebas particulares con SQLite el tiempo de ejecución se reducía en más del 75% en relación a MS Access).

En los dos próximos artículos publicaré como podemos utilizar estas bases de datos desde nuestras aplicaciones desarrolladas en .NET

En breve intentaré hacer un repaso general de todo el contenido publicado para tratar de homogeneizar un poco el texto y publicaré el prometido documento descargable en PDF.

Saludos.

Ya tan sólo queda por publicar el apartado dedicado a la máquina virtual, que espero poder sacar a la luz en unos días.

Una vez publicado todo el material tengo también previsto reunirlo todo en un sólo documento descargable para todos los que queráis disponer de él de forma offline.

Saludos. 

Espero que os sea de utilidad.

• Cambio de licencia. A partir de esta versión la librería se distribuye bajo licencia LGPL.
• Nueva clase RtfDocument, RtfColorTable, RtfFontTable y RtfTextFormat. Pretenden facilitar la creación de documentos RTF desde cero, añadiendo fácilmente fragmentos de texto e imágenes. En esta versión preliminar se ofrece sólo un soporte básico para realizar estas funciones.
  
• Clase RtfTree:
• Nueva propiedad MergeSpecialCharacters. Activando esta propiedad, si se encuentra un caracter especial (\') éste se convertirá a un nodo de tipo texto y se intentará combinar con los nodos tipo texto adyacentes, de forma que se obtenga un único nodo.
• Nueva propiedad Text. Devuelve el texto plano del documento.
  
• Nuevo método GetEncoding(). Devuelve la codificación utilizada en el documento.
• Clase RtfTreeNode:
• Nueva propiedad Tree. Devuelve una referencia al árbol propietario del nodo.
• Nuevo método ToString(). Devuelve una representación textual del nodo.
• Nuevo método InsertChild(). Inserta un nuevo nodo en cualquier posición de la lista de nodos hijos.
• Se sustituyen los métodos SelectXXXByType() por sobrecargas de SelectXXX().
• Nuevos métodos SelectSibling() (+3 sobrecargas). Seleccionan nodos hermanos.
• Clase RtfNodeCollection:
• Nuevo método Insert(). Inserta un nuevo nodo en cualquier posición de la colección.
• Nuevo método RemoveRange(). Elimina un conjunto de nodos contiguos de la colección.
  
• Clase InfoGroup:
• Nuevo método ToString(). Decuelve una representación textual del nodo.
• Bugs corregidos:
• Los nodos de tipo Group y Root no se inicializaban con ninún texto.
• En ocasiones la propiedad RtfTreeNode.Rtf no devolvía la última llave '}'.
• No se trataban correctamente los caracteres especiales '\', '{' y '}' como parte del texto.
• Cuando se añade un nuevo nodo con AppendChild() o InsertChild() no se actualizaban las propiedades Root y Tree de forma recursiva.

Como siempre la nueva versión puede ser descargada desde la página principal del proyecto.

Espero comentarios sobre la nueva versión. 

Trataré de completar este artículo con más información sobre ANTLR cuando escriba el resto de artículos del tutorial.

Por ahora están escritos los apartados de introducción, proceso general de desarrollo, especificaciones del lenguaje y análisis léxico y sintáctico. Éste último se encuentra aún en proceso, pero considero interesante ir publicando los avances a medida que voy escribiendo.

Espero que les sea de utilidad.

• Construcción de analizadores léxicos.
• Construcción de analizadores sintácticos.
• Mecanismos de construcción y recorrido de árboles de sintaxis abstracta (AST).
• Mecanismos de tratamiento de plantillas.
• Mecanismos de detección y recuperación de errores.

Como ventajas adicionales que diferencian a ANTLR de otras herramientas similares podemos citar la posibilidad de generar el código de salida en diferentes lenguajes como Java, C, C++, C# o Python, y el hecho de disponer de un entorno de desarrollo propio llamado ANTLRWorks que nos permitirá construir de una forma bastante amigable las gramáticas de entrada a la herramienta, proporcionando representaciones gráficas de las expresiones y árboles generados, e incluyendo un intérprete y depurador propio.

Como recursos para empezar a conocer esta herramienta recomiendo los siguientes:

Web principal de ANTLR
Web principal de ANTLRWorks
Wiki de documentación (Docs, Tutoriales, Ejemplos...)
Libro: The Definitive ANTLR Reference - Building Domain-Specific Languages

A medida de avancemos en la construcción de nuestro sistema de scripts trataré de ir comentando muchas de las posibilidades que ofrece ANTLR para el desarrollo de cada módulo, publicando ejemplos y por supuesto los fuentes completos del sistema.

Dado que existe aún poca documentación sobre ANTLR 3, y mucho menos en español, voy a publicar aquí a modo de ejemplo todos los pasos necesarios para construir el sistema propuesto. Espero que este material pueda resultar útil para aquellos que se propongan desarrollar un sistema similar. El nuestro estará escrito completamente en C# y estará formado por los siguientes módulos:

• Un compilador que transformará el código script a un lenguaje intermedio.
• Un ensamblador que generará el fichero binario ejecutable a partir del código intermedio.
• Una máquina virtual capaz de ejecutar el fichero generado por el ensamblador.

ANTLR será usado para construir el compilador, que estará formado a su vez por los analizadores léxico y sintáctico, un analizador semántico para la generación y comprobación de tipos, y un generador de código a partir del árbol de sintáxis abstracta (AST) construido durante las fases anteriores. Por su parte, tanto el ensamblador como la máquina virtual se escribirán sin utilizar ninguna herramienta de apoyo, dado que son relativamente sencillos de implementar.

Pretendo escribir todo esto en varias entregas y el planning en principio será el siguiente:

1. Introducción a ANTLR 3.
2. Especificación del lenguaje FKScript.
3. Construcción de los analizadores léxico y sintáctico.
4. Contrucción del analizador semántico.
5. Especificación del lenguaje FKIL.
6. Construcción del generador de código.
7. Implementación del ensamblador.
8. Implementación de la máquina virtual.

Espero poder publicar los primeros artículos la semana proxima.

Aún falta por implementar completamente alguna funcionalidad de la librería original, como por ejemplo los nodos especiales para el tratamiento de imágenes, pero aún así puede resultar ya muy útil para el trabajo con texto.

He preparado una página para publicar comentarios y descargas sobre esta librería, que podéis visitar pulsando aquí [CRtfTree].

Como ya sabéis, JRtfTree es una traducción al lenguaje Java de la librería NRtfTree.

He cambiado la versión a 0.1.1 tan sólo para reflejar el cambio de licencia, ahora se distribuye bajo licencia GPL, por lo que su estado continúa siendo el mismo que cuando la publiqué por primera vez, es decir, que a día de hoy está implementada toda la funcionalidad incluida con la versión 0.2 de NRtfTree, excluyendo las clases de nodos especiales para el tratamiento de imágenes y objetos.

Espero, a partir de ahora, poder dedicar un poco más de atención a este proyecto para tratar de alinearlo con la versión actual de NRtfTree.

Como siempre, podéis acceder a la sección dedicada a JRtfTree a través de la página de proyectos.

El libro en cuestión se titula .NET Book Zero - What the C or C++ Programmer Needs to Know about C# and the .NET Framework y trata, como él mismo indica en el primer capítulo, sobre todos aquellos temas generales que debe conocer cualquier persona para comenzar a programar en .NET con C#, tomando como referencia conocimientos previos en C/C++.

Por tanto, si el inglés no os supone un problema, creo que es un buen documento de referencia para dar los primeros pasos en esta plataforma.

La página desde la que podéis descargar el libro en formato PDF es la siguiente: http://www.charlespetzold.com/dotnet/

Empecemos por Java. Casi sin dar tiempo a digerir los rumores hechos realidad de la liberación de Java como open source bajo licencia GPL (o casi, porque en realidad se trata de una modificación de ésta para evitar su caracter vírico, en esta noticia lo explican muy bien), llegó el lanzamiento de Java SE 6, que trae consigo características interesantes como el soporte para scripting (lista oficial de novedades). Por otro lado, aunque muy relacionado con el mundo java, se ha liberado la versión 1.7.0 de Ant, herramienta indispensable para muchos de nosotros.

Por su parte, .NET no se queda atrás en novedades. Mientras siguen anunciándose a bombo y platillo las bondades del .NET Framework 3.0 (si alguien llega tarde a esto puede consultar la web oficial o, por ejemplo, el blog de David Hayden, donde se pueden encontrar muchos artículos interesantes sobre esta tecnología), empezaron a aparecer nuevas versiones de muchas de sus herramientas y tecnologías derivadas. Entre ellas encontramos ASP.NET AJAX 1.0 RC, una extensión de ASP.NET para aprovechar las ventajas que proporciona Ajax, la primera CTP de WPF/E, una tecnología que pretender competir con Flash y que presenta de una forma bastante completa el genial Scott Guthrie en su blog (también se agradece la traducción que hace Miguel Angel Ramos de la noticia principal). ¿Conseguirá Microsoft dinamitar una tecnología tan asentada como Flash? El tiempo lo dirá. En este tiempo también han aparecido por ejemplo la CTP de diciembre de Enterprise Library 3.0 o la nueva CTP de SandCastle, una nueva herramienta para generar documentación a partir del código fuente comentado, al estilo del ya abandonado NDoc.

En cuanto a herramientas de desarrollo también tenemos noticias. Por el lado de Java continúa la lucha (y que siga así ya que ira en beneficio de los desarrolladores) entre las dos plataformas libres mayoritarias, Eclipse y NetBeans. Ambos se dirigen hacia una nueva versión final y las novedades no dejan de aparecer a un lado y a otro. Eclipse avanza hacia su versión 3.3, de la que ya ha aparecido la Milestone 4. Por su parte, NetBeans continúa a buen ritmo el desarrollo de su versión 6, de la que ya se puede descargar la Milestone 5. En Microsoft también están de enhorabuena con el reciente lanzamiento del Visual Studio 2005 SP1 (descargas para las versiones Express y para la Standard/Professional), que incorpora algunas novedades y corrige muchos errores de la primera versión.

En definitiva, que tanto Java como .NET ha venido cargados de novedades este último mes y espero poder ir dedicando más tiempo algunas de ellas, y a alguna más que me he dejado deliberadamente en el tintero, porque son realmente interesantes.

El único cambio relevante ha sido la correción de un bug un tanto feo en el método SaveRtf(), que hacía que no se guardaran correctamente algunos documentos que contuvieran caracteres especiales.

El resto de cambios no tienen relación alguna con la funcionalidad y consisten únicamente en adecuar la documentación a la nueva dirección web.

Adicionalmente, he reestructurado las descargas, para dividirlas en tres ficheros: fuentes (librería+demo), binarios (dll+demo) y documentación (formato CHM).

El primero y más importante, aunque el menos visible, ha sido la reestructuración interna de la página. Ya era hora de dejar de usar tablas para la maquetación de la web. En estos tiempos que corren es algo que queda bastante feo y que va contra todos los estandares de diseño y accesibilidad. Niños, no lo hagáis en casa. Aún tengo pendiente hacer que la web pase completamente algunos validadores, pero bueno, el primer pasito ya está dado. De paso, le he dado un "lavado de cara" general y he cambiado un poco el estilo anterior, aunque la estructura principal la sigo manteniendo.

Una novedad algo más visible es el cambio de dominio. Por fin dejo Brinkster y me paso a un dominio y alojamiento propios. Por tanto, ya tenemos una dirección más fácil de recordar y la web ganará algo en velocidad y estabilidad. No estoy diciendo que Brinkster sea un mal hosting, de hecho, lo recomiendo a todo el que quiera hacer sus pinitos en .NET, sobre todo teniendo en cuenta que ofrece un plan de alojamiento gratuito con soporte para ASP.NET, añadiendo una publicidad casi imperceptible y sin ningún límite de tiempo. Eso sí, no se puede tener todo gratis, por ejemplo no tiene soporte para ASP.NET 2.0 ni se pueden usar el global.asax o el web.config

Más cambios. He eliminado la sección de artículos, la tenía muy olvidada, he reestructurado la sección de enlaces, que espero llenar de links en breve, y he decidido utilizar un control especial para colorear automáticamente el código que inserte en la noticias del blog (intentaré dedicar a este control una noticia del blog dentro de poco porque me parece muy interesante). Con todo esto espero dar un aspecto un poco más homogeneo a la web, que la tenía muy descuidada en este sentido.

Por último, y como buenas intenciones para este año, a ver si esta vez sí lo consigo, espero actualizar muchísimo más a menudo el blog, al menos con las noticias que se vayan conociendo sobre .NET y Java, que últimamente son bastantes.

En este articulo repasaré la segunda de las opciones a la hora de enfrentarse a una tarea de este tipo, que como ya dijimos, consiste en utilizar alguna de las APIs específicas desarrolladas con este objetivo. Las dos APIs más conocidas son las de Jakarta POI y JExcelApi. Tras evaluar ambas sólo puedo llegar a la conclusión de que son muy parecidas, aunque existen algunas diferencias que resumiré más abajo.

Jakarta POI

POI es una api java que nos permitirá leer, escribir y modificar documentos excel con suma facilidad, aunque como bien indican en su web oficial, la funcionalidad de escritura es la más madura. Con esta API podremos manipular fácilmente muchas de las entidades existentes en un documento excel: libros, hojas, filas, celdas, fórmulas, etc. Sin embargo, a la hora de considerar esta herramienta también deberemos tener en cuenta algunas limitaciones, como el no soportar la creación de gráficas, celdas con varios formatos, macros o tablas dinámicas, aunque sí podremos modificar o leer documentos que contengan estos elementos sin riesgo a perderlos.

Veamos un ejemplo de lo sencillo que resulta crear y escribir en un documento excel:

Por cuestiones de espacio, sólo muestro en el artículo este pequeño fragmento de código. Sin embargo, podéis consultar un pequeño programa de demostración completo que he escrito para mostrar lo fácil que resulta leer y escribir documentos excel con esta API.

En cuanto a la documentación disponible, he decir que a parte de la inevitable documentación javadoc, la API viene acompañada de una guía rápida con muchos ejemplos sencillos que cubren gran parte de la funcionalidad de la misma. Esta guía, aunque no demasiado extensa, es más que suficiente para aprender a utilizar rápido muchas de las características disponibles.

Como puntos "negativos" puedo mencionar que toda la documentación se encuentra en inglés (como no podía ser de otra forma) y que el proyecto parece haber estado "muerto" bastante tiempo, aunque parece que el desarrollo se ha retomado hace poco, ya que existe una versión DEV de junio de 2006. La última versión estable de la librería es la 2.5.1, de agosto de 2004.

Referencias:

1. Web Oficial Jakarta POI [Inglés]
2. Web Oficial Jakarta POI [Español]
3. Artículo sobre POI en JavaWorld.com [Inglés]
4. Artículo sobre POI en OnJava.com [Inglés]

JExcelApi

Al igual que POI, JExcelApi es una API destinada a facilitar la lectura, escritura y modificación de documentos excel desde aplicaciones java. Los objetos y métodos disponibles son muy similares a los que hemos visto para POI, siendo súmamente sencillo manipular libros, hojas y celdas de un documento excel. En el fragmento siguiente se muestra como realizar las mismas acciones del ejemplo anterior (crear un libro y escribir varias celdas con distintos tipos de datos), pero esta vez usando JExcelApi:

Igualmente, se proporciona un ejemplo completo (análogo al mostrado para POI) de cómo leer y escribir un documento excel con JExcelApi.

JExcelApi también viene acompañado de una documentación muy completa en formato javadoc y de un pequeño tutorial con varios ejemplos de cómo realizar las acciones típicas sobre un documento. Esta API tiene también actualmente algunas limitaciones, como por ejemplo no permitirse la creación de gráficas o macros. Por suerte, como ocurría con POI, sí podremos al menos leer o modificar documentos que ya contengan estos elementos sin perderlos durante el proceso.

Este proyecto sí se encuentra actualmente activo y en desarrollo, siendo la última versión estable de la librería, la 2.6.2, de octubre de 2006.

Por último, como curiosidad, mencionar que existe un proyecto para portar a la plataforma .NET esta API java. Dicho proyecto recibe el nombre de NExcel y actualmente existe una versión alpha de febrero de 2005.

Referencias:

1. Web Oficial del proyecto en SourceForge [Inglés]
2. Web original de la API [Inglés]
3. Web de NExcel (versión en .NETde la API) [Inglés]]]>domingo, 05 de noviembre de 2006http://www.sgoliver.net/noticia.aspx?idn=65http://www.sgoliver.net/noticia.aspx?idn=64He decidido crear un proyecto en SourceForge para organizar y centralizar el desarrollo mi librería NRtfTree. Ya están montados y funcionando todos los recursos básicos: el tracker de descargas con los fuentes y los ejecutables (pronto la documentación de la API), los foros de soporte y dudas y el servidor de control de versiones Subversion. Para quien le interese dejo aquí los enlaces al proyecto de SourceForge y a la web personal de la librería:

   Proyecto: http://sourceforge.net/projects/nrtftree/
   Web: http://nrtftree.sourceforge.net/

   Un saludo a todos.

   ]]>lunes, 25 de septiembre de 2006http://www.sgoliver.net/noticia.aspx?idn=64http://www.sgoliver.net/noticia.aspx?idn=63En los últimos días, trabajando en un proyecto personal, he tenido que enfrentarme a la tarea de generar documentos de Microsoft Excel desde una aplicación escrita en Java. Viniendo del mundo .NET, y las facilidades que da esta plataforma para realizar este tipo de tareas, no estimé demasiado complejo hacer esto mismo en Java. Sin embargo, cuando llegó el momento de buscar información sobre el tema me llevé la desagradable sorpresa de que no existen muchas posibilidades, aunque sí suficientes, para solucionar el problema.

   Después de estudiar las principales alternativas podemos limitar las opciones a tres estrategias básicas:

   1. Gestionar el documento Excel como una base de datos a través de ODBC.
   2. Utilizar una API específica para crear y modificar un documento Excel desde cero.
   3. Utilizar una API específica para generar un documento Excel a partir de una plantilla previamente preparada.

   La primera de las opciones es sumamente simple y directa utilizando los recursos que ofrece el propio SDK de JAVA y las fuentes de datos ODBC de Windows. Para las otras dos alternativas existen cuatro APIs de Java que describiré en los próximos artículos. De cualquier forma, estos artículos no pretenden ser una guía exhaustiva para el uso de estas herramientas, sino sólo un punto de inicio desde donde poder empezar a recavar información sobre la alternativa que más se adapte a nuestras necesidades.

   Uso de ODBC para la gestión de documentos Excel

   Esta primera opción representa una alternativa poco conocida para la gestión de documentos Excel, pero que puede ser muy útil para el tratamiento de estos documentos desde cualquier tipo de aplicación, y más concretamente en nuestro caso desde aplicaciones Java. Este método consiste en acceder al documento Excel a través del controlador ODBC proporcionado por Windows para este tipo de ficheros, utilizando el documento de la misma forma que si se tratase de una base de datos tradicional y usando el lenguaje SQL para la manipulación de los datos.

   Aunque existen numerosas limitaciones, como por ejemplo el no poder utilizar la sentencias DELETE o depender de un formato específico del documento, aún puede ser muy útil en la creación desde cero de documentos o en el análisis de los mismos mediante SQL.

   Como ejemplo, voy a mostrar cómo se crearía una nueva hoja dentro de un documento Excel ya existente y cómo se añadirían nuevos datos a la misma. Para ello, en primer lugar será necesario crear un nuevo origen de datos ODBC que apunte al documento Excel a modificar.

   Esto se puede hacer a través de la opción “Origenes de datos (ODBC)” situada normalmente en el panel de control de Windows, dentro del grupo de "Herramientas Administrativas".

   Dentro de la pestaña "DSN de Sistema" pulsamos "Agregar..." para añadir un nuevo origen de datos, seleccionamos el controlador "Microsoft Excel Driver (*.xls)" y pulsamos finalizar. Esto nos llevará al cuadro de diálogo "Configuración de ODBC Microsoft Excel" donde únicamente tendremos que seleccionar el fichero Excel que queramos utilizar como base de datos y dar un nombre al origen de datos, que después usaremos para abrir la conexión desde la aplicación java.

   Una vez creado el origen de datos, la conexión con éste desde nuestra aplicación Java y la manipulación mediante comandos SQL se realiza de la forma tradicional, utilizando la API de acceso a datos proporcianada por Java (JDBC) y haciendo uso del puente JDBC-ODBC como driver de acceso.

   A continuación se muestra el código completo de un pequeño ejemplo donde creamos una nueva base de datos, añadimos un par de registros y mostramos cómo se realiza una consulta sencilla a la base de datos creada.

   [code=Java]import java.sql.*; public class Principal public static void main(String[] args) try { //Registro del driver Class.forName("sun.jdbc.odbc.JdbcOdbcDriver"); //Apertura de la conexión Connection con = DriverManager.getConnection("jdbc:odbc:PRUEBAEXCEL"); //Creación de la sentencia SQL Statement stmt = con.createStatement(); //Creación de la hoja stmt.execute("CREATE TABLE articulos " + "(id NUMBER, nombre TEXT, precio NUMBER)"); //Inserción de dos nuevas filas stmt.execute("INSERT INTO articulos (id,nombre,precio) " + "VALUES (1,'Articulo1',12.52)"); stmt.execute("INSERT INTO articulos (id,nombre,precio) " + "VALUES (2,'Articulo2',15.63)"); //Consulta al documento ResultSet rs = stmt.executeQuery("SELECT nombre FROM articulos " + "WHERE id = 2"); while(rs.next()) { System.out.println("Nombre artículo: " + rs.getString(1)); } //Cierre de recursos stmt.close(); con.close(); } catch(ClassNotFoundException e) { e.printStackTrace(); } catch(SQLException e) { e.printStackTrace(); } } }[/code]

   Si ejecutamos este ejemplo podremos ver cómo en el libro Excel configurado como origen de datos se ha creado una nueva hoja llamada "articulos" con tres columnas, cuya cabecera se corresponde con los nombres de los campos que componen la base de datos creada y las restantes filas contienen los datos de los dos registros insertados. Además, como salida del programa se obtendrá el siguiente mensaje: "Nombre artículo: Artículo2".

   

   Con esto puede comprobarse como al utilizar un documento Excel como base de datos a través del controlador ODBC, las bases de datos se corresponden con libros Excel, las tablas con hojas dentro del libro y los campos de una tabla con las distintas columnas de la hoja, donde la primera fila contiene los nombres de cada campo y las filas siguientes los datos de cada registro.

   Como se extrae de este ejemplo, la utilización de ODBC para el acceso a documentos Excel es muy sencillo. Sin embargo, como ya se ha comentado al principio, existen una serie de limitaciones que hacen que no pueda considerarse totalmente válida esta opción para cubrir todas nuestras necesidades. Como muestra, podemos enumerar las siguientes limitaciones:

   • Debido a que dependemos de orígenes de datos ODBC, esta opción sólo es válida para sistemas operativos Windows.
   • No se pueden utilizar todas las sentencias SQL para la manipulación de los documentos. Así por ejemplo, no es posible eliminar filas de una hoja con la sentencia DELETE o modificar la estructura de la hoja una vez creada con sentencias ALTER TABLE.
   • A través de ODBC sólo es posible actuar sobre los datos del documento, pero no podremos establecer niguna opción de formato.

   Y hasta aquí el primer articulo de la serie que voy a dedicar al tratamiento de documentos Excel desde aplicaciones Java. En el próximo post veremos las dos APIs más populares que nos permiten crear y modificar documentos Excel completos, actuando sobre los datos y sobre el formato de los mismos.

   Referencias:

   1. Microsoft ODBC Desktop Database Drivers [Inglés]
   2. Excel ODBC Driver and Text ODBC Driver Notes [Inglés] [Español]
   3. Artículos en JavaWorld: [1] Its Excel-lent - [2] The Java-Excel solution revisited
   ]]>domingo, 09 de abril de 2006http://www.sgoliver.net/noticia.aspx?idn=63