Tubular en Java, o sea mi vida no vale nada

Por cierto proyecto que querían usar Tubular, me pidieron ayuda para usarlo con JAVA. Aunque Tubular soporta OData, al parecer en el proyecto no era posible tener servicios OData, solo unos servicios REST en Spring.

Me di a la tarea de ayudarlos y comenzar a programar en JAVA, cosa que no hacía en varios años, y la verdad que recuerdo porque dejo de hacerlo. JAVA es feo. Tarde un rato haciendo esas cosas locas como manejar el POM, configurar el JPA, hacer que Hibernate no se matara y sobre todo que el horrible Eclipse no se colgara cada 5 minutos.

La vida en Visual Studio me volvio más holgazan quizás, o Eclipse es tan horrible que deberían quemarlo con fuego. Aún así logre mi cometido, y deje un ejemplo funcional conectado a MySQL para presentar Tubular. Un éxito. Por si estan interesados en el código (que no forma parte del proyecto) esta en mi cuenta de GitHub como tubular-spring-hibernate.

Documentando Directivas de AngularJS

Me encontraba en la necesidad de documentar el código de Tubular para que sea visible todos los atributos y hermosos controles que tenemos. Apenas estaba pensando que quizás solo haría un montón de documentos planos y que Pikachu guiara mi camino de dolor a la salvación. Pero me dije, si AngularJS tiene documentación no tan mal, seguramente algo estan haciendo.

Llegue al documento de AngularJS en Github titulado Writing-AngularJS-Documentation que explican, nada claro, como realizar la documentación por medio. Para realizar la documentación necesitas comenzar con escribir en tu código todo lo que necesitas explicar usando ngDoc que es un sabor extendido de jsDoc. Es lo mismo pero solo con unos campos adicionales especificos para AngularJS.

Ya con tus archivos JS llenos de comentarios relevantes y detalles que casi nadie lee. Es momento que comience lo bueno, pues hay que montar un paquete llamado Dgeni (nota: por favor instala el Dgeni-packages porque Dgeni por si mismo hace nada) y comenzar a escribir un Javascript que debera procesar los comentarios jsDoc.

Dgeni soporta muchas formas de exportar el contenido, y en los paquetes trae soporte para nunjunks que es una especie de template engine, no tan cool, que puedes usar para generar unos lindos HTML con todo. La verdad que al principio configurar dgeni es un poco raro, por eso mejor les dejo el siguiente ejemplo que use para comenzar https://github.com/petebacondarwin/dgeni-angular. El archivo "dgeni-conf.js" es donde sucede gran parte de la magía.

Finalmente ya puedes mover tu monton de archivos HTML con links internos, o como yo que los bote para usar un método de AngularJS acoplado a un controller que hice. El resultado se puede ver ya en línea: Tubular Documentation. Falta terminar de detallar, pero ya tenemos API DOC!

Novedades Tubular

El desarrollo de Tubular continua  y ahora ya tenemos un nuevo y elegante generador usando la plataforma de Yeoman, que funciona con NodeJS. Las tareas que se pueden hacer con el generator-tubular son:

• Iniciar un nuevo proyecto Tubular (con AngularJS y Bootstrap) que puede usar tanto Bower como un CDN para cargar las librerías.
• Crear vistas de ejemplo o desde un archivo JSON.
• Generar una vista de Grid directamente a tu proyecto actual usando un OData, con opciones para personalizar (similares a las del generador en línea).
• Generar una vista de Form, igual con un servicio OData.

Faltan detalles, pero está luciendo bastante bien. Ya no me da tanto "flojera" programar con NodeJS, no es tan feo después de todo.

Tubular 0.9.6 con generadores de código

La nueva versión de Tubular ya esta aquí con algunos cambios y mejoras sobre todo en los formularios. Pero lo mejor esta en los nuevos generadores de código tanto para Grids como Forms, que permiten generar a partir de un JSON (arreglo u objeto) o un servicio OData.

El generador interpretara el modelo para presentar un fácil diseñador de columnas o campos con opciones para extender el código AngularJS final. Y lo mejor de todo es que con un simple click se puede mandar al servicio de Plunker todos los archivos necesarios para generar un proyecto.

El generador de código para Grids se encuentra en http://unosquare.github.io/tubular/#/Generator y para Forms en http://unosquare.github.io/tubular/#/FormGenerator. De hecho también actualice la documentación y mejore un poco el diseño del sitio web.

La nueva versión ya esta en Nuget y quizás en unas horas en JsDelivr.