Preparé un ejemplo donde se puede apreciar algunas de las capacidades de esta librería:

• Rendering de texto
• Rendering de imagenes
• Rendering de enlaces a sitios web (links) sobre texto e imagenes

Demás está recomendarles que revisen la documentación sobre esta librería. Particularmente, cada vez que la utilizo, termino descubriendo, al menos, una funcionalidad desconocida para mi. El ASDoc viene incluido en el archivo de descarga, junto con un par de códigos de ejemplo en Flash y Air.

El código fuente está algo comentado pero, como siempre, las dudas son oídas con gusto.

Juan Manrique.

EjemploPDFRia212
Código

Sobre AlivePDF y la clase FileReference

13 razones para que los programadores Java aprendan Adobe Flex y BlazeDS

Este artículo bosqueja las 13 razones por las que los programadores Java deberían aprender Flex y BlazeDS. Habla sobre por qué Flex con BlazeDS es una de las mejores opciones para el desarrollo de Rich Internet Applications (RIA), desde sitios web altamente interactivos hasta aplicaciones empresariales basadas en Java. Más importante aún, muestra el alto retorno de inversión que ofrece esta combinación, tanto para los desarrolladores como para las empresas.

Para bosquejar las 13 razones por las que los programadores Java deberían aprender BlazeDS, uso un dispensador de refrescos ficticio para mostrar cómo convertir un programa Java existente en una RIA. A través  del ejemplo, explico las diferentes en que puedes usar BlazeDS,  bien sea con tus aplicaciones Java ya existentes como con aplicaciones nuevas.

Razón 1: Es de código abierto

El núcleo  del kit de desarrollo (SDK) de Flex es un framework código abierto para desarrollar y mantener aplicaciones RIA que tengan la misma apariencia independientemente del navegador y sistema operativo donde se ejecuten. Flex es liberado bajo la licencia “Mozilla Public License”. Las aplicaciones Flex compiladas corren sobre la plataforma propietaria Adobe Flash.

BlazeDS es una tecnología código abierto para conectar Flex a Java mediante invocación de métodos remotos y mensajería. Esta tecnología corre sobre servidores de aplicaciones Java como un servlet, permitiéndote así usarla en cualquier aplicación web común hecha en Java. BlazeDS es licenciado bajo la licencia “GNU Lesser General Public License” (LGPL). Paralelamente al lanzamiento de BlazeDS, Adobe publicó la especificación del “ActionScript Message Format” (AMF), lo que permite que BlazeDS y Java puedan comunicarse con clientes Flex usando un formato binario de serialización de objetos bastante compacto.

Razón 2: Tiene gran apoyo de la comunidad

Flex posee una comunidad sumamente activa, con muchos proyectos aportados por la comunidad. Flex.org, un sitio web con noticias de la comunidad de desarrolladores, recibe contribuciones casi a diario, y el grupo de usuario Flex de Yahoo! Posee más de 11.000 miembros.

Por ejemplo, el proyecto FlexLib hospedado en Google Code ha aportado una  gran cantidad de componentes de interfaz de usuario (UI) de código abierto. Los proyectos Swiz y Mate han aportado frameworks  para apoyar el manejo de eventos en las aplicaciones. Y finalmente, Gorilla Logic ha aportado Flex Monkey para pruebas automatizadas de interfaces de usuario.

Razón 3: Puedes tener un trabajo por seis meses más

Según James Ward, un evangelizador Flex de Adobe, aún existe una gran demanda de desarrolladores Flex con experiencia. Aprender Flex te ofrece un conocimiento mercadeable que te pondrá por delante de la competencia.

Razón 4: Retorno de inversión empresarial más alto

En general, desarrollar aplicaciones web empresariales ha sido notoriamente difícil. Flex y BlazeDS no solo proporcionan herramientas de mayor capacidad, sino que, además, facilitan el desarrollo. El aumento en la productividad del desarrollador permite a las organizaciones entrar más rápido al mercado. Además, Flex y Flash brindan una experiencia de usuario más atractiva, lo que podría incrementar tanto el número de visitas a los sitios web como la tasa de persuasión.

Un ejemplo ideal de esto es la cadena de librerías Borders, quienes recientemente presentaron un nuevo sitio web con un “Estante Mágico”. Este sitio posee una interfaz hecha en Flash que simula la experiencia de hojear libros. Borders constató que esto incrementó enormemente la tasa de persuasión: “los clientes que usan esta interfaz hecha en Flash (que permite a los visitantes ver las portadas de libros, DVDs y CDs) son persuadidos a comprar en un 62% más que aquellos que no la usan”.

Razón 5: Flex fue el primer lenguaje diseñado para crear interfaces de usuario

La mayoría de los lenguajes incorporan soporte para la creación de interfaces de usuario como algo secundario. Esto es particularmente notable en Java con el framework Swing. Como resultado de esto, cosas simples en Swing, como manejar datos, puede resultar engorroso usando modelos de datos específicos de Swing. El mayor problema con Swing es que tienes que conocer bastante bien su API para ser productivo.

Flex es exactamente lo contrario: fue diseñado desde el principio para construir interfaces de usuario web. Como le gusta a Brice Eckel decir, Flex es el primer lenguaje específicamente para desarrollar interfaces de usuario. Por lo tanto, es mucho más fácil crear interfaces de usuario con Flex que con otras tecnologías como JavaServer Pages (JSP), JavaServer Faces (JFS) y Swing. El enlace de datos con controles, el manejo de eventos, el diseño de componentes y las técnicas comunes de desarrollo de interfaces de usuario están incluidos en el lenguaje, lo que te permite ser productivo aun cuando conociendo muy poco sobre el lenguaje.

Razón 6: Posee un modelo de programación similar a Java

Es posible desarrollar con las herramientas existentes usadas para desarrollar en Java. Igualmente, puedes desarrollar aplicaciones Flex con la consola de comandos gratuita incluida en el SDK, con la herramienta Adobe Flex Builder (un plug in para el IDE Eclipse) o, más recientemente, con IntelliJ IDEA 8.

Flex proporciona un ambiente con estado de sesión en el que los datos son cargados desde el cliente. El modelo de programación se asemeja más al desarrollo de una aplicación de escritorio en lugar de programación HTML, lo que hace sentir familiarizado en la programación a todo aquel que haya programado con Java Swing.

La programación en Flex es una combinación de MXML, un lenguaje de etiquetas para interfaces de usuario similar a Extensible Markup Language (XML), y Adobe ActionScript, un lenguaje de scripting orientado a objetos. Esta combinación hace que programar en Flex sea similar a programar en Java porque es posible usar los conceptos conocidos de programación orientada a objetos.

Una manera ideal de configurar tu ambiente de desarrollo es construir tu aplicación Flex justo en tu carpeta de despliegue de aplicaciones web. De esta forma, no necesitas desplegar de nuevo tu aplicación luego de cada compilación: un simple refrescamiento del navegador reflejará los cambios realizados. Como resultado, desarrollar en Flex y BlazeDS es bastante productivo.

Razón 7: BlazeDS corre sobre cualquier servidor de aplicaciones Java

 Existen múltiples versiones de BlazeDS disponibles, incluyendo una versión lista para usar configurada con  una versión de Apache Tomcat incluida. Para este articulo, utilizo la distribución compilada que viene como un archivo web (WAR), para mostrar cómo puedes desplegar BlazeDS en cualquier servidor de aplicaciones. Otra posibilidad es extraer los archivos Java (JAR) y usarlos en tu proyecto. Visita el portal wiki de BlazeDS para obtener más información sobre las distintas formas de instalar BlazeDS.

Este ejemplo usa BlazeDS con un proyecto existente, un dispensador de bebidas sencillo. Solo necesitas agregar los archivos Java (JAR) a tu proyecto y así podrás usar BlazeDS desde la aplicación, lo que te permite desplegarlo en cualquier lugar donde puedas desplegar la aplicación.

Para agregar BlazeDS a tu proyecto, completa los siguientes pasos:

1. Extraer el contenido del archivo blazeds.war. Comando de consola: > jar xvf blazeds.war.
2. Copia los archivos JAR de la carpeta WEB-INF/lib descomprimida en la carpeta lib de tu proyecto. Comando de consola: > cp –R WEB-INF/lib /sodaSample.

Razón 8: Puedes usarlo con aplicaciones Java ya existentes

Para el ejemplo del dispensador de soda, asume que quieres publicar tu servicio de soda existente para que las aplicaciones Flex remotas puedan conectarse a él. Los pasos básicos para configurar BlazeDS en una aplicación existente son:

1. Edita los archivos de configuración de BlazeDS en la carpeta WEB-INF/flex.
2. Define un MessageBrokerServlet y un listener de sesión en el archivo web.xml de la aplicación.

Luego de configurar BlazeDS, necesitas agregar tu servicio de soda al archivo de configuración de remoting del BlazeDS remoting-config.xml, el cual permite que el servicio de soda pueda ser invocado desde una aplicación cliente Flex. Para agregar tu servicio, defines un destino y uno o más canales para transportar los datos. El canal AMF básico está definido en el archivo services.xml. Usa esta definición para identificar tu destino en el archivo remoting-config.xml:

Al definir endpoints en el archivo de configuración de remoting, podrás invocar cualquier servicio Java desde una aplicación cliente Flex.

Para transferir tu estructura de datos como objeto Java a tu aplicación Flex, declara una equivalencia de datos entre los dos en la clase ActiosScript:

Estas sentencias le indican a Flex  que cuando el resultado proveniente de una invocación a un servicio remoto retorne tu clase Java SodaModel, lo mapee a tu clase Flex SodaModel. La aplicación Flex cliente en el ejemplo muestra como invocar este servicio Java. La invocación devuelve un objeto SodaModel, con los datos de tu orden:

Flex devuelve los resultados de la invocación en la variable genérica result, la cual deberás mapear y almacenar en tu clase SodaModel. No entraré en detalles sobre este punto pero te  recomiendo indicarle al compilador la ruta del archivo services-config.xml de esta forma:

-locale en_US -services=/nsource/sodaSample/web/WEB-INF/flex/services-config.xml -context-root /

De no hacerlo, tu aplicación cliente Flex no será capaz de encontrar los servicios Java. Del mismo modo, tú también podrás enviar objetos hacia el servidor. Por ejemplo, podrás enviar de vuelta al cliente la clase SodaModel vacía.

Razón 9: Puedes heredar de BlazeDS y hacerle modificaciones en Java

Supongamos que deseas agregar un registro de actividades especiales cada vez que el servicio de soda es invocado. Puedes heredar del adaptador estándar Java para agregar esta funcionalidad.

Primero, crea una clase Java que herede del JavaAdapter:

Luego, sobrecarga el método invoke():

public Object invoke(Message message) {
        RemotingMessage remotingMessage = (RemotingMessage) message;
        String operation = remotingMessage.getOperation();
        String destination = remotingMessage.getDestination();

        Logger.info("calling " + operation + " on destination " + destination);
        Object data = super.invoke(message);
        return data;
}

En este método puedes ver  la operación entrante y el destination de la invocación. Puedes usar este simple conector para otras cosas, como por ejemplo medir el tiempo se toman las llamadas al servidor.

Razon 10: Puedes invocar BlazeDS desde HTML y JSP

Esta invocación puedes hacerla de distintas formas, como a través del Browser Manager y flashVars. Las flashVars pueden ser configuradas en la página HTML para luego ser leídas por la aplicación Flex.

Por ejemplo, supongamos que deseas enviar desde la pagina HTML tu nombre y el tipo de refresco que quieres ordenar. Podrías asignar las variables de esta forma:

<object id='SodaSample' classid='clsid:D27CDB6E-AE6D-11cf-96B8-444553540000' codebase='http://fpdownload.macromedia.com/get/flashplayer/current/swflash.cab' height='100%' width='100%'>
        <param name='src' value='SodaSample.swf'/>
        <param name='flashVars' value='username=ryan&type=coke'/>
        <embed name='mySwf' src='SodaSample.swf'
pluginspage='http://www.adobe.com/go/getflashplayer' height='100%' width='100%'
flashVars='username=ryan&type=coke'/>
</object>

Luego, en tu aplicación Flex, puedes leer estas variables buscándolas en las propiedades de la aplicación:

var username:String;

if (Application.application.parameters.hasOwnProperty("username")) {

        username = Application.application.parameters.username;

}

 
Razón 11: La transferencia de datos en Flex y BlazeDS supera a otras soluciones basadas en Ajax

Por defecto, todas las invocaciones a procedimientos remotos (RPC) emplean el protocolo binario AMF. Siendo un estándar abierto, AMF es extremadamente rápido. James Ward construyó un ejemplo donde se hace una comparación de AMF con otras soluciones tecnológicas para hacer remoting. Aunque las otras soluciones AJAX, como Dojo, dan la pelea con un par de cientos de registros, Flex y BlazeDS pueden fácilmente manejar miles de registros. Chequea el artículo census de James Ward en el que realiza un benchmark de carga de datos de varias tecnologías RIA.

Razón 12: Puedes invocar BlazeDS directamente desde clientes Java

La última versión de BlazeDS incluye una clase AMF en Java que puedes usar para que un cliente Java haga invocaciones al servidor de BlazeDS. Poder invocar BlazeDS de esta forma resulta sumamente útil para realizar pruebas unitarias y de carga de datos.

Razon 13: Se integra con Spring

Adobe y Spring se han unido para brindar una integración más cercana entre ambos frameworks, y la primera versión del componente de integración Spring-BlazeDS, del framework Spring, luce promisoria. Al permitir que un bean Spring pueda convertirse en un servicio remoto, se evita tener que duplicar los archivos de configuración. Para mayor información, visita el portal del proyecto.

Conclusión

Siendo BlazeDS un framework código abierto y basado en Java, es una opción ideal para nuevos proyectos de servidor Java, así como para proyectos ya existentes. Por la comunicación remota de alto desempeño y mapping de objetos entre Flex y Java, las tecnologías Flex y BlazeDS  son una opción ideal para el desarrollo RIA. Los desarrolladores Java que se inicien en Flex y BlazeDS sentirán que el proceso de desarrollo es altamente productivo y fácil de aprender.

La combinación Flex-BlazeDS es también una opción ideal para aplicaciones empresariales Java de gran escala. En un proyecto pasado, mi equipo desarrolló una aplicación que contenía más de 50 pantallas y transfería regularmente varios cientos de registros de datos entre el servidor y el cliente. Este tipo de aplicación habría sido casi imposible de desarrollar usando la tecnología AJAX tradicional.  Con Flex y BlazeDS, pudimos presentar una versión inicial en menos de un año. Imagina lo que este dúo dinámico puede hacer por tus proyectos de desarrollo de aplicaciones.

Nota: Deberías lograr una base de estas tecnologías. Hay disponible una buena cantidad de tutoriales para ayudar en tu iniciación con BlazeDS, incluyendo “Building Web and Desktop Applications with BlazeDS and AMF” y “BlazeDS 30-minute test drive”.

Artículo original de Ryan Knight. Traducido por Juan Manrique.

Una característica interesante de esta librería es que el procesamiento del archivo PDF se hace en el mismo cliente Flex. Sin embargo, viendo el código del ejemplo mencionado me di cuenta de que al momento de guardar el archivo a disco, se hace una invocación a un script PHP en algún servidor remoto que, supongo, genera el archivo PDF y lo reenvía al cliente Flex para que sea descargado. Esto me pareció algo inconveniente, pues todo el procesamiento del archivo PDF se hace en el cliente Flex, pero no se accede a disco desde Flex al momento de guardarlo. Me pregunte entonces si sería posible acceder a disco desde el cliente Flex para poder crear y guardar un documento PDF sin hacer uso de ninguna tecnología de servidor. Lo que encontré fue que Flash Player 10  incluye una clase especial para la carga y descarga de archivos hacia y desde un servidor, respectivamente: la clase FileReference. Esta clase logra acceder a disco abriendo un cuadro de dialogo “Guardar como” del sistema operativo. Así que si se desea manejar archivos PDF exclusivamente en el cliente Flex, me parece adecuado hacer uso de esta clase para guardar a disco el archivo PDF sin hacer uso de ningún servicio remoto.

Comentando una línea y agregando solo tres más al ejemplo original, fue posible crear y guardar a disco un archivo PDF mediante la librería AlivePDF y la clase FileReference. La librería AlivePDF posee un método save() mediante el cual es posible generar el documento PDF. Este método tiene dos constructores en los cuales se indica si la generación del documento será de manera remota (en un servidor) o de manera local (en el cliente Flex). Como es de esperarse, comenté la línea donde se invoca a este método de manera remota en el ejemplo original y agregué la invocación al mismo método pero de manera local. Las dos siguientes líneas son triviales cuando se hace uso de la librería FileReference.

Espero que les guste el ejemplito. Se aceptan comentarios y dudas.

Juan Manrique.

DrawingDemoRIA212
Codigo