martes, septiembre 24, 2013

Developing a jGnash plugin

jGnash is a personal financial software, available as Free Libre Open Source Software (FLOSS). I've been using it since some years, and i can say that is a great software. It has many functionalities, PDF reports and charts, to register and control your incomes and expenses. It just lack of some analysis reports, so i decided to build my own.

It's possible to create plug-ins for jGnash. So you can add a new functionality or a new report, without recompile the whole software. There's a folder in jGnash installation directory called "plugins", in this folder you can add a JAR file containing the new plug-in and next time you start jGnash, it will load your plug-in.

Requirements to build a new plug-in

For build a new plug-in you will need Java programing knowledge, and some specifics thing depending on the kind of functionalities that you are trying to extend. For building new graph charts or reports, I will suggest experience related to: Java Swing, JFreeChart, DynamicJasper and JasperReports. There is not good documentation about packages and source code of jGnash, but you can download the source code and will find is not hard to read, also you will find help on email lists.

According to jGnash help menu, these are the external libraries they use, so could be good also know a little bit about them: args4j, db4o, JasperReports, DynamicJasper, JFreeChart, JGoodies Animation, JGoodies Forms, JGoodies Looks, Apache MINA, XStream and SwingX.

I like Eclipse IDE, so I will use it, but any Java IDE should be good.

Of course, you must have installed jGnash, to link the jars files to your new plugin project.

Architecture

jGnash provides a plug-in system that is easy to understand. The jgnash2.jar provides a interface called: jgnash.plugin.Plugin and a abstract class called: jgnash.plugin.AbstractEnabledAction, to create a new plugin, inside the new plugin jar, just implement the Plugin interface and extend the AbstractEnabledAction.


Also it will be needed to write a couple of lines inside the jar MANIFEST file.

Steps to create a basic plugin

1- Start a new Java Project, this is a normal Java project in Eclipse IDE.

2-In the Java Build Path of the project (Right click on the project, Properties, Java Build Path, Libraries) add the External Jar: jgnash2.jar from your jGnash installation path.


3- Inside the project, create a new file called: MANIFEST.MF

This file must contain something similar to this:

Manifest-Version: 1.0
Plugin-Activator: myplugin.mypackage.MyPlugin
Plugin-Version: 1.0

Where "Plugin-Activator:" points to the class that implements the jgnash.plugin.Plugin interface.

4- Create the Plugin implementation class, that indicate, which menus will be added to the user interface and which actions will be executed. This is a simple example:

package myplugin.mypackage;

import javax.swing.JMenuItem;
import javax.swing.JPanel;

import jgnash.plugin.Plugin;

public class MyPlugin implements Plugin{

    @Override
    public JMenuItem[] getMenuItems() {
        JMenuItem menuItem = new JMenuItem();

        menuItem.putClientProperty(Plugin.PRECEDINGMENUIDREF, "new-command");
        menuItem.setAction(new MyAction());

        return new JMenuItem[] { menuItem };
    }

    @Override
    public String getName() {
        return "My Plugin";
    }

    @Override
    public JPanel getOptionsPanel() {
        return null;
    }

    @Override
    public void start() {
    }

    @Override
    public void stop() {  
    }
}

The line menuItem.putClientProperty(Plugin.PRECEDINGMENUIDREF, "new-command"); will tell to jGnash where to add the new menuItem, the preceding code, indicate before New Command menuItem. Other places you can choose are listed in the source code of jGnash, check this file:

/jgnash2/jgnash-resources/src/main/resources/jgnash/resource/main-frame-actions.xml

Another important line is: menuItem.setAction(new MyAction()); it says, when user clicks this menuItem execute the code inside MyAction class, that we must create later.

5- Implementing AbstractEnabledAction.

package myplugin.mypackage;

import java.awt.event.ActionEvent;

import javax.swing.Action;
import javax.swing.JOptionPane;

import jgnash.ui.actions.AbstractEnabledAction;

public class MyAction extends AbstractEnabledAction {

    public MyAction(){
        putValue(NAME, "Title");
        putValue(Action.SHORT_DESCRIPTION, "Description");
    }
  
    @Override
    public void actionPerformed(ActionEvent e) {
        JOptionPane.showMessageDialog(null, "Hello World");
    }
}

It's important to set the "NAME" and "Action.SHORT_DESCRIPTION" values, they will be shown as the title and tool tip text of the menuItem.

The actionPerformed method will be executed when the menuItem is clicked by the user, in this example will show a simple dialog window saying "Hello World".

6- Creating the jar file. In Eclipse, right click over your project, select Export, and then Jar File.


After that, follow the instructions, and take care when "Jar Manifest Specification" windows appear, select the option: "Use existing manifest from workspace", and choose the "MANIFEST.MF" file that we have created before.


7- Copy the generated jar file inside "plugins" folder of jGnash, run jGnash and you will see the message "Hello World" when you click the new menu "Title" inside "File" menu.



Thanks to jGnash developers for this great software. My hope is that lots of jGnash plug-ins come alive to make it a better software for all.

martes, agosto 06, 2013

Mi Aplicación Java en la Nube con Google App Engine


Fuente developers.google.com
Google App Engine (GAE) es en resumen la plataforma para publicar aplicaciones Web en la nube de Google, basada en el modelo PaaS (Plataforma como Servicio).

Google permite utilizar, sin costo, su SDK de desarrollo,  desplegar aplicaciones Java, Python, PHP o Go y utilizar repositorios de escritura y acceso a datos escalables (Big Data) basado tanto en NoSQL (llamado Datastore en GAE) como en SQL (BigQuery en GAE). El SDK se integra completamente con el IDE de desarrollo Eclipse, desde el cual se puede publicar directamente al servidor lo que se desarrolla.

"Una aplicación de una cuenta gratuita dispone de hasta 1 GB de espacio y admite hasta cinco millones de vistas mensuales." developers.google.com

Aplicación Tipo Cambio NIO

Mi Primera Aplicación Java en la Nube con Google App Engine, llamada Tipo Cambio NIO, está publicada en http://denisjtorresg.appspot.com

Se trata de una simple aplicación que permite a los usuarios conocer de forma simple y consolidada los tipos de cambio del Córdoba respecto al Dólar y el Euro. Permitiendo consultar esta información en diferentes formatos como: RSS, ATOM, JSON, HTML, y por medio de Chat (XMPP).

Básicamente lo que la aplicación hace es leer regularmente la información pública de los tipos de cambio del Córdoba respecto al Dólar y el Euro de los siguientes sitios web públicos: Banco Central de Nicaragua y de los bancos privados: BAC Nicaragua, BANPRO - Grupo Promerica, BDF - Banco de Finanzas, Citibank de Nicaragua, LAFISE Nicaragua y ProCredit Nicaragua.

Luego esta información puede ser consultada de diferentes maneras, tanto por: usuarios usando una navegador Web o su chat de Gmail, y por aplicaciones que puedan leer servicios Web basados en JSON, RSS o ATOM.


Para hacer uso del servicio ofrecido por medio de chat, agregar a GoogleTalk o al chat de Gmail la siguiente dirección: denisjtorresg@appspot.com y luego escribir la palabra "ayuda" (sin comillas).



Para consultar los datos del día desde el navegador web o consumir mediante HTTP desde una aplicación se pueden usar las siguientes URLs:

Consulta RSS con datos de hoy:
http://denisjtorresg.appspot.com/tcnio?f=hoy&s=RSS

Consulta ATOM con datos de hoy:
http://denisjtorresg.appspot.com/tcnio?f=hoy&s=ATOM

Consulta JSON con datos de hoy:
http://denisjtorresg.appspot.com/tcnio?f=hoy&s=JSON

Consulta HTML con datos de hoy:
http://denisjtorresg.appspot.com/tcnio?f=hoy&s=HTML

Se puede  sustituir el parámetro "f" por una fecha en formato aaaa-mm-dd.

Este servicio se ofrece sin garantía. Los resultados suministrados provienen de las páginas web públicas de las entidades enumeradas. 


domingo, junio 23, 2013

Servicio Web para Consultar el Tipo de Cambio del Córdoba Respecto al Dólar (cliente Java)

WSLD Servicio Web Tipo Cambio BCN
El Banco Central de Nicaragua ha publicado en Internet un servicio web SOAP para consultar las tasas de cambio del Córdoba respecto al Dólar. Según he podido experimentar han publicado las tasas de cambio a partir del 1ro de Enero del 2012.

El siguiente sitio web detalla algunos aspectos, tanto técnicos, como de condiciones de uso del servicio web:

http://www.bcn.gob.ni/tc/

El BCN ha hecho público ejemplos de cómo consumir el servicio web en plataformas .NET (con VisualBasic) y en PHP. Dado que falta un ejemplo para todos los que usamos Java, estoy liberando bajo licencia de dominio público, un archivo .jar para que pueda ser agregado en proyectos libres o comerciales.

Descargar archivo .jar (Java) para consultar servicio web de tipo de cambio.

Descargar código fuente y documentación del proyecto para el IDE Eclipse.

Ejecución del demo:

java -jar tcBCN.jar



Ejemplo de uso en un programa propio:



package info.denisjtorresg.tcbcn;

import java.util.Date;
import java.util.Map;
import java.util.Map.Entry;

public class Prueba {

public static void main(String[] args) {
       
// Tipo de cambio del día
        System.out.println(TipoCambioBCNSimple.getTipoCambio());
       
// Tipo de cambio en la fecha indicada (año, mes, día)
        System.out.println(TipoCambioBCNSimple.getTipoCambio(2013,6,21));

System.out.println(TipoCambioBCNSimple.getTipoCambio(2012,1,1));
       
// Tipos de cambio del mes indicado
Map tcRango = TipoCambioBCNSimple.getTipoCambio(2013, 2);
        

for(Entry elemento: tcRango.entrySet()){
  Date fecha = elemento.getKey();
  Double tc = elemento.getValue();
           
  System.out.println(fecha + " => " + tc); 

}
}
}
 

El archivo jar suministra una clase de utilería simple llamada TipoCambioBCNSimple ubicada en el paquete: info.denisjtorresg.tcbcn. No requiere de ningún API o jar extra, funciona con Java SE 6 o superior.

Esta clase contiene el método estático getTipoCambio el cual está sobrecargado para recibir distintos tipos de parámetros que especifiquen la fecha o rango de fechas para las cuales se desea conocer el tipo de cambio.

La documentación completa de la clase de utilería TipoCambioBCNSimple se puede ver en:

http://sites.google.com/site/denisjtorresg/TipoCambioBCNSimple.html

Espero que sea de utilidad para el que la necesite.

Otros artículos similares:
Validar números de cédulas de Nicaragua con Java

jueves, mayo 09, 2013

El camino mas corto en un grafo no dirigido

En la actualidad los expertos indican que las bases de datos relacionales (modelo usado desde los años 80) están llegando a ciertos límites y nuevas tendencias están emergiendo, como las bases de datos NoSQL, producto de las necesidades de la Web, grandes volúmenes de datos (Big-Data), la computación en la nube, computación en paralelo (MapReduce), inteligencia de negocios (BI), machine learning muy útil en la minería de datos, entre otros.

Producto de un par de cursos interesantes en Coursera: Web Intelligence and Big Data e Introduction to Data Science he encontrado que muchas de las nuevas tendencias están basadas en teorías relativamente viejas, que parecían no tener un futuro muy marcado, ni amplio uso (al menos desde mi punto de vista personal tomando como base los trabajos y los proyectos en los que me ha tocado participar).

Una de estas teorías que tuve la oportunidad de conocer a nivel básico en la universidad, fue la teoría de grafos, la cual ahora se usa en las nuevas tendencias de bases de datos orientadas a grafos.

Al leer sobre este asunto, recordé que en la universidad realicé un proyecto relacionado con grafos, en conjunto con Marconi Poveda y Alam Romero para la clase de Matemáticas Discretas, razón por la cual me di a la tarea de desempolvar los archivos personales para compartir el programa y su código fuente, si le es útil a alguien allí está el link de descarga.


"GRAFOS 1.0  es un programa desarrollado en el lenguaje de programación Visual Basic 6.0; cuyo objetivo es resolver el problema de encontrar los caminos de menor peso entre todos los pares de vértices de un grafo no dirigido.

Presentado como proyecto de la clase de Matemáticas Discretas impartida por el profesor Ing. Marvin Castañeda en la Universidad Nacional de Ingeniería (UNI) de Managua, Nicaragua, y llevado a cabo por alumnos de segundo año de la carrera de Ingeniería en Computación durante el mes de Diciembre del 2002."





martes, enero 08, 2013

Cursos gratis "everywhere"!!!

Los cursos en línea y gratis sobre diversos temas abundan en Internet. Estos cursos aprovechan diferentes medios provistos por Internet como: blog, wikis y elementos multimedia como: podcast o vídeos, entre otros.

Hasta no mucho existían únicamente artículos simples que aclaraban dudas puntuales sobre un determinado tema, pero ahora están creciendo espacios con cursos muy formales, creados, organizados y administrados por empresas (que promueven el conocimiento de sus productos), comunidades (entusiastas de diversos temas) o hasta incluso por universidades (que desean compartir el conocimiento).

Las personas con deseos de conocimientos informáticos somos las más beneficiadas, ya que este tipo de materiales son los que más abundan.

A continuación comparto una pequeña lista de sitios Web en los cuales de forma gratuita se pueden aprender de diversos temas, la misma la he recopilado de conversaciones en diferentes listas de correo.

Open Knowledge Scrum: cursos gratis de Scrum (metodología de desarrollo de software), Métricas Agiles y Gestión Visual Kanban.
http://www.scrummanager.net/oks/

Aprende a programar interactivamente: ideal para estudiantes iniciales de programación. Además hay cursos interactivos de HTML, CSS,  JavaScript, jQuery, Python, Ruby.
http://www.codecademy.com

Coursera: un conjunto de universidades de alta calidad y categoría comparten en línea y de forma gratuita diferentes cursos, no sólo informáticos, sino también sobre matemáticas, física, humanidades, entre otros.
https://www.coursera.org/

Además de cursos variados y similares en:

http://www.udacity.com/

https://www.khanacademy.org/

Para complementar los cursos o para extender la investigación probablemente sea necesario conseguir un libro: http://www.flazx.us/

Y si no se sabe inglés estaremos renunciando a buena parte de los espacios mencionados anteriormente, por lo que un reforzamiento del inglés es muy recomendado: http://www.englishclub.com/

Y también están los cursos gratis de Microsoft: http://www.microsoftvirtualacademy.com/ 

Otros enlaces Interesantes:

Biblioteca Digital Mundial (de la UNESCO):
http://www.wdl.org/

UOC OpenCourseWare de la Universitat Oberta de Catalunya
http://ocw.uoc.edu/informatica-tecnologia-y-multimedia/

[Nuevo] Un amigo me ha compartido este otro sitio de cursos de universidades iberoamericanas Miríada X:

http://miriadax.net/


[Nuevo 2]  Google Developers Academy

https://developers.google.com/academy/

[Nuevo 3]
Entorno de formación abierta de la UNED
https://unedcoma.es/

Proyecto Telescopio Universidad Galileo
http://telescopio.galileo.edu/


Walker, una película grabada a pocos metros de mi casa

Tenía tres años en 1987, y recuerdo que en esa fecha estuvieron grabando una película cerca a mi casa. Cortaban la energía eléctrica y encendían grandes faros de luz justo a escasos 50 metros de mi casa, hay varias escenas de la película Walker que se hicieron en la calle Arsenal y en la calle El Enredo en Granada, para aquella fecha habían muchas más casas viejas lo que les permitió tener un escenario bastante real conforme la historia que se contaba en la película.

¿Recuerdan al jefe de vuelo en Apollo 13? El actor Ed Harris, ese mismo hizo el papel de William Walker.

La película no tuvo mucho éxito internacional, pero si recuerdo el montón de gente y vehículos que estaban en la calle para hacer esa película.

¿Reconocen estos lugares de Granada? Todas son imágenes en la película:

Edificio Frente a la Casa de los Tres Mundos o Casa de los Leones - Plaza de la Independencia

Plaza junto a la Catedral y el Parque Central, inicio de la Calle La Calzada (Escena de Quema de Granada)

Final de la calle Arsenal, a la izquierda como a 100 metros mi casa :)

Calle El Enredo, entre las calles Arsenal y Libertad, al fondo el volcán Mombacho

Coche tradicional de Granada en una escena de la película

Plaza Central, al fondo la Catedral (de color blanco)

Plaza Central vista hacia Palacio Episcopal y actual edificio de compañía Claro

William Walker a caballo frente al convento/iglesia de San Francisco

Plaza Central de Granada, junto a Catedral, el Parque Central y el Palacio Episcopal

Antiguo Hospital San Juan de Dios (Hospital Viejo)

¿Y estos otros lugares de Nicaragua les son familiares?

Toma de la Laguna de Apoyo

Palacio Nacional en Managua


Créditos finales


domingo, enero 06, 2013

Ayúdame a respaldar los archivos de mi computadora

- "Ayúdame a respaldar y organizar los archivos de mi computadora...", contesté: si claro, nos conectamos en red, pasamos los archivos a mi computadora y los quemo en un DVD!

Y luego me enseñaron este Escritorio:

Y habían muchos más archivos en Mis Documentos. La meta era remover los archivos repetidos y organizar luego un poco las carpetas.

Primero copié los archivos usando Samba hacia mi computadora, para escanearlos con el antivirus libre ClamAV.

Luego para encontrar los archivos repetidos, encontré una utilidad muy buena en Linux llamada FSlinit - http://www.pixelbeat.org/fslint/

FSlinit está disponible por defecto en Ubuntu, es muy fácil de instalar desde el gestor de paquetes.


Una vez instalado, el programa se puede ejecutar desde el menú Aplicaciones > Herramientas del Sistema > FSlint.

FSlint permite encontrar archivos repetidos o duplicados sin importar su ruta, nombre, fecha de creación o modificación. Al inicio pensé que FSlint funciona como si obtuviera un hash (digamos MD5 o SHA1) del contenido de cada archivo y luego los compara.

Para ponerlo a funcionar, se pulsa el botón Añadir, lo cual permite indicar la o las rutas que examinará el FSlint en busca de archivos repetidos.

Lo que más me impresionó la primera vez que lo usé, fue la velocidad con la que entrega los resultados, supongo que realmente no revisa los archivos, ni calcula hashes sobre los mismos, sino más bien, toma la información que necesita directamente de las tablas de datos del sistema de archivos lo cual lo convierte en un software muy eficiente.



En la parte central de su pantalla muestra la lista de archivos duplicados, su nombre y ubicación. En la parte inferior derecha está el botón Eliminar para borrar el o los archivos seleccionados.

Si  no se desea ir revisando uno por uno los archivos repetidos, se puede usar el botón Seleccionar todos los archivos más nuevos, los más viejos o los primeros de la lista y luego pulsar borrar.

La lista se limpia automáticamente a medida que los archivos duplicados son removidos.