Programacin de un lector de huella digital en Java. Parte 1.

Como ya lo he mencionado anteriormente, en la actualidad la seguridad en las transacciones electrnicas se ha vuelto una parte indispensable para los programadores de sistemas, la identificacin para el acceso a los registros y dems cuestiones relacionadas deben de ser tomadas en cuenta para poder validar que alguna persona est accediendo realmente a lo que debe acceder, es esencial hacer que (en medida de lo posible) nadie pueda hacerse pasar por alguien que no es al momento de identificarse en un sistema. Aqu es donde la biometra juega un papel sumamente interesante (ms informacin sobre la biometra en ste artculo) as que dedicar una serie de artculos a tratar de explicar cmo programar un lector de huella digital en Java utilizando algunas herramientas y API's que nos permitirn realizar todos los procedimientos sin ningn problema. Primeramente hablar de lo que necesitamos para poder empezar a programar un sistema completo de registro y verificacin de identidades por medio de la huella digital:

El JRE (Java Runtime Environment) ms reciente, al momento de la publicacin de este artculo es la 1.6.7. IDE de programacin NetBeans en su versin ms reciente, al momento de publicar este artculo es la 6.1. Cabe mencionar que el vnculo que indico contiene varias versiones, se puede descargar cualquiera que cuente con el Base IDE y Java SE. Un lector de huella digital de cualquiera de estos modelos. El API de programacin de lectores de huella digital de Griaule para Java. Un servidor de bases de datos en MySQL.

Una vez que tenemos todo lo anterior procedemos con la instalacin del API de programacin de Griaule (asumo que el NetBeans y el servidor MySQL ya estn instalados y funcionando sin problemas). Instalacin del API de programacin de Griaule:: Una vez que hemos descargado el API tendremos un archivo llamado Fingerprint_SDK_Java_2007_Installer.jar, para comenzar la instalacin se realiza lo siguiente:

1. Doble clic sobre el archivo, aparecer una ventana que nos pide elegir el idioma, selecciona el que desees. 2. Posteriormente aparece la pantalla de bienvenida y si se da clic en Siguiente aparecen los trminos de la licencia, los cuales se debe aceptar para poder continuar. 3. Una vez hecho lo anterior se selecciona la ruta donde se instalar, aqu se dejan los valores por defecto. 4. Despus de la ruta de instalacin se debe elegir los elementos que se instalarn, de igual manera se deja todo marcado y se da clic en Siguiente.

5. Posteriormente se instalan los elementos seleccionados, dejando al final la instalacin del controlador. NOTA: Es de suma importancia tomar en cuenta que antes de la instalacin del lector de huella digital, este se debe de tener desconectado y de preferencia desinstalar el software y controladores que venan con l de fbrica para evitar conflictos durante la actual instalacin. 6. Ahora aparece una pantalla para seleccionar el idioma de la instalacin del controlador, de igual manera se elige el que ms convenga. 7. Despus aparece la pantalla de bienvenida...

... aqu se da clic en Siguiente o Next. 8. Se aceptan los trminos de la licencia y se da clic en Siguiente un par de veces. 9. Posteriormente presionamos el botn de Instalar o Install para que se realice la instalacin de los controladores del lector. 10. Al terminar el proceso se da clic en el botn de Siguiente y posteriormente en Finalizar para terminar la instalacin del controlador. 11. Una vez hecho esto se sigue con la pantalla del proceso de instalacin general...

... y se da clic en Siguiente o Next. 12. Al final se da clic en el botn Done para culminar. Una vez terminada la instalacin del API se puede conectar el lector para terminar su instalacin. Conectar el lector de huella digital:: Ahora continuemos con lo siguiente: 1. 2. 3. 4. Se conecta el lector de huella digital. Aparece el Asistente para Nuevo Hardware de Windows. Se selecciona No por el momento y se da clic en Siguiente. Despus se elige Instalar automticamente el software recomendado y se da clic en siguiente. 5. Se espera a que termine la instalacin, el asistente debe de reconocerlo e instalar los controladores que previamente hemos agregado junto con el API. 6. Se da clic en Finalizar para terminar la instalacin. Preparacin de las libreras y archivos necesarios:: Una vez que se tiene todo lo anterior correctamente instalado y configurado se deben de preparar las libreras y los archivos colocndolos en los directorios que deben de estar, para ello se realiza lo siguiente: 1. Se abre la carpeta de las libreras del API, si se ha dejado por defecto aparecer en C:\Archivos de programa\Griaule\Fingerprint SDK Java 2007\bin 2. Se copia el archivo grfingerjava.jar hacia las carpetas C:\Archivos de programa\Java\ jdk*\jre\lib\ext (donde jdk* es la versin que tienes instalada, si tienes varias se puede colocar en todas) y en la carpeta C:\Archivos de programa\Java\ jre*\lib\ext (donde jre* es la versin ms reciente).

3. Se seleccionan y se copian todos los archivos .dll que se encuentran en la carpeta de las libreras del API y se pegan en C:\Windows\System32 Preparacin de la base de datos:: Ya realizados los pasos anteriores nicamente nos falta crear una base de datos que almacene los registros de las huellas, en este caso prepararemos dentro de dicha base una tabla sencilla que contenga nicamente 3 datos, un ID, el nombre de la persona y la huella registrada. Para efectos de este ejemplo usaremos una base de datos de nombre huellas y una tabla dentro de dicha base de nombre somhue que contendr los datos descritos a continuacin: 1. Nombre de campo: ID , tipo: INT (autoincrement) 2. Nombre de campo: huenombre , tipo: VARCHAR(100) 3. Nombre de campo: huehuella , tipo: BLOB Ya tenemos todo para comenzar a programar nuestra aplicacin de reconocimiento de huella digital pero eso lo dejaremos para la siguiente parte. Alguna duda o algo qu decir? Deja tu comentario. ****Actualizacin (08/08/2012)**** A peticin de todos les dejo la lista de todos los artculos de este tutorial.

Parte 1: http://monillo007.blogspot.com/2008/08/programacin-de-un-lector-dehuella.html Parte 2: http://monillo007.blogspot.com/2008/08/programacin-de-un-lector-dehuella_20.html Parte 3: http://monillo007.blogspot.com/2008/09/programacin-de-un-lector-dehuella.html Parte 4: http://monillo007.blogspot.com/2008/09/programacin-de-un-lector-dehuella_03.html Parte 5: http://monillo007.blogspot.com/2008/10/programacin-de-un-lector-dehuella.html

Ligas de descarga: JRE - http://www.java.com/en/download/manual.jsp Griaule - http://www.griaulebiometrics.com/page/en-us/downloads NetBeans - http://download.netbeans.org/netbeans/6.1/final/ MySQL - http://dev.mysql.com/downloads/mysql/5.1.html

Programacin de un lector de huella digital en Java. Parte 2.

Continuando con la programacin de un lector de huella digital en Java procederemos en este caso ya directamente con el cdigo, la entrega anterior se refiri meramente a la preparacin del entorno para el desarrollo, si no la has ledo te recomiendo verificarla, entenderla y realizarla primero antes de proceder con esto ya que de lo contrario no funcionar la aplicacin.

Comenzando con las indicaciones, haremos lo siguiente: 1. Creamos un proyecto en NetBeans con el nombre EjemploLectorHuellas. 2. Dentro del proyecto crear un paquete de nombre procedimientos y otro de nombre interfaz. 3. Dentro de procedimientos crear una clase (Java Class) llamada Util. 4. En la definicin de la clase util agregar implements IStatusEventListener, IImageEventListener, IFingerEventListener y sus correspondientes imports... import import import import com.griaule.grfingerjava.FingerprintImage; com.griaule.grfingerjava.IFingerEventListener; com.griaule.grfingerjava.IImageEventListener; com.griaule.grfingerjava.IStatusEventListener;

public class Util implements IStatusEventListener, IImageEventListener, IFingerEventListener{ . .

5. Al implementar dichas interfaces nos pedirn implementar todos sus mtodos abstractos, lo hacemos dando un clic en el foco que aparece del lado izquierdo y seleccionando "Implement all abstract methods" lo cual generar la implementacin de 5 mtodos (modifica el nombre de los argumentos para mejor referencia) :

public void onSensorPlug(String idSensor) // evento que se genera al conectar el lector de huella public void onSensorUnplug(String idSensor) // evento que se genera al desconectar el lector de huella public void onImageAcquired(String idSensor, FingerprintImage huellaDigital) // evento que se genera al obtener una imagen de la huella public void onFingerDown(String idSensor) // evento que se genera al colocar un dedo en el lector public void onFingerUp(String idSensor) genera al levantar el dedo del lector // evento que se

Cabe mencionar que no utilizaremos todos los eventos en este ejemplo pero se deben de implementar para que el compilador no marque errores ya que provienen de una interface. 6. Modificamos los mtodos onSensorPlug y onSensorUnplug para que queden de la siguiente manera: public void onSensorPlug(String idSensor) { try { GrFingerJava.startCapture(idSensor, this, this); } catch (GrFingerJavaException e) { e.printStackTrace(); } } public void onSensorUnplug(String idSensor) { try { GrFingerJava.stopCapture(idSensor); } catch (GrFingerJavaException e) { e.printStackTrace(); } } Lo anterior es para evitar problemas en la captura al momento de conectar y desconectar el lector, para que el compilador no marque errores debemos importar las clases GrFingerJava y GrFingerJavaException... import com.griaule.grfingerjava.GrFingerJava; import com.griaule.grfingerjava.GrFingerJavaException; Los dems mtodos que se implementaron deben de quedar vacos (por el momento). 7. Ahora creamos un mtodo esttico que nos permita establecer el directorio de las libreras del SDK /** * Establece el directorio donde se ubican las libreras nativas del SDK */ public static void setFingerprintSDKNativeDirectory(String directorio) { File directory = new File(directorio); try { GrFingerJava.setNativeLibrariesDirectory(directory); GrFingerJava.setLicenseDirectory(directory); } catch (GrFingerJavaException e) { e.printStackTrace(); } }

y el import de la clase File correspondiente: import java.io.File; 8. Posteriormente agregamos los siguientes objetos y variables inmediatamente despus de la definicin de la clase: /**Contexto utilizado para la captura, extraccin y coincidencia de huellas digitales */ private MatchingContext fingerprintSDK; /**Interfaz de usuario donde se muestra la imagen de la huella*/ private PantallaPrincipal ui; /** Indica si la plantilla o template debe ser extrada automticamente*/ private boolean autoExtract = true; /** Contiene localmente los datos de la huella capturada */ private ByteArrayInputStream fingerprintData; /**Contiene la longitud del dato de la huella*/ private int fingerprintDataLength; /** La imagen de la ltima huella digital capturada. */ private FingerprintImage fingerprint; /** La plantilla de la ltima imagen de huella capturada */ public Template template; ... con sus correspondientes imports ... import com.griaule.grfingerjava.MatchingContext; import interfaz.PantallaPrincipal; import java.io.ByteArrayInputStream; Nota: se debe agregar 'import interfaz.PantallaPrincipal;' an cuando no existe actualmente ya que se crear en los pasos siguientes. 9. Ahora crearemos la interfaz de usuario, para ello damos clic derecho en el paquete interfaz y seleccionamos New -> JFrame Form, le damos por nombre 'PantallaPrincipal'. 10. Agregamos dos paneles (Huella Digital y Acciones, como se muestra en la imagen) y 4 botones (Verificar, Identificar, Guardar y Salir) de manera que queden parecido a lo siguiente:

11. Nombramos los botones tal cual su etiqueta pero anteponiendo las letras btn, es decir btnVerificar, btnIdentificar y as sucesivamente, el panel de Huella Digital lo nombramos 'panelContenedor'. 12. Establecemos el panelContenedor con un BorderLayout dando un clic derecho sobre l -> Set Layout -> Border Layout

12. Ya que tenemos lo anterior nos vamos a la vista de cdigo y agregamos los siguientes objetos... //objeto usado para realizar todas las operaciones relacionadas al Fingerprint-SDK private Util procedimientosSDK; //Panel para mostrar la huella digital private JPanel fingerprintViewPanel = null; //Imagen de la huella actual private BufferedImage fingerprintImage = null; ... con sus correspondientes imports ... import java.awt.image.BufferedImage; import javax.swing.JPanel; import procedimientos.Util; ... los objetos deben ir dentro de la clase pero fuera de cualquier mtodo. 13. Nuevamente modificamos la clase Util agregando un constructor sobrecargado que

reciba un objeto de tipo PantallaPrincipal de la siguiente manera: public Util(PantallaPrincipal ui) { this.ui = ui; } 14. Por ltimo en la clase Util (por el momento) agregamos un mtodo que nos permita inicializar la captura de las huellas, deber de quedar as: /** * Inicializa el Fingerprint SDK y habilita la captura de huellas. */ public void inicializarCaptura() { try { fingerprintSDK = new MatchingContext(); //Inicializa la captura de huella digital. GrFingerJava.initializeCapture(this); } catch (Exception e) { //Si ocurre un error se cierra la aplicacin. e.printStackTrace(); System.exit(1); } } 15. Ahora trabajaremos con la clase PantallaPrincipal, lo que haremos es crear un mtodo para inicializar la forma, estableciendo el estilo visual y creando una instancia de la clase Util. Deber quedar de la siguiente manera: /** * Se establece el estilo visual de la aplicacin y se realiza la inicializacin de la clase * que contiene los procedimientos principales. **/ public void inicializar() { try { UIManager.setLookAndFeel(UIManager.getSystemLookAndFeelClas sName()); } catch (Exception e) { System.err.println("No se pudo aplicar el estilo visual"); } //Crea una instancia de Util this.procedimientosSDK = new Util(this); } ... y su import correspondiente:

import javax.swing.UIManager; 16. Agregamos una llamada al mtodo inicializar() dentro del constructor de la clase y antes del mtodo initComponents() de tal manera que quede as: /* Crea una nueva forma de PantallaPrincipal */ public PantallaPrincipal() { inicializar(); initComponents(); }

17. Ahora hacemos un mtodo para crear el contenedor de la imagen de la huella digital, en los comentarios se va explicando las funciones de cada lnea... /** * Crea el panel que contendr la imagen de la huella digital */ private JComponent crearPanelHuella() { //Crea un panel nuevo para mostrar la huella fingerprintViewPanel = new JPanel(){ //Se sobreescribe el mtodo paintComponent //para habilitar la muestra de la imagen de la huella public void paintComponent(Graphics g) { super.paintComponent(g); //Si hay una imagen para ser mostrada if (fingerprintImage!=null) { //Calcula el tamao y posicin de la imagen para ser pintada //el tamao es ajustado para que ocupe todo el tamao del panel Insets insets = getInsets(); int transX = insets.left; int transY = insets.top; int width = getWidth() getInsets().right - getInsets().left; int height = getHeight() getInsets().bottom - getInsets().top; //Se dibuja la imagen g.drawImage(fingerprintImage, transX, transY, width, height, null); } } };

//Se agrega un borde alrededor del panel fingerprintViewPanel.setBorder(new CompoundBorder ( new EmptyBorder (2,2,2,2), new BevelBorder(BevelBorder.LOWERED))); //si no hay existe el panel de la huella no devuelve nada... if(fingerprintViewPanel==null) { return null; }else{ // de lo contrario devuelve el panel mismo return fingerprintViewPanel; } } ... y se agregan los imports correspondientes para evitar errores ... import import import import import import java.awt.Graphics; java.awt.Insets; javax.swing.JComponent; javax.swing.border.BevelBorder; javax.swing.border.CompoundBorder; javax.swing.border.EmptyBorder;

18. Una vez hecho esto nos vamos a la vista de diseo de la clase PantallaPrincipal, sin seleccionar ningn elemento damos clic derecho sobre el JFrame y posteriormente seleccionamos Events -> Window -> WindowActivated ...

... lo cual nos llevar a la vista de cdigo de la clase, dentro del mtodo formWindowActivated, ah agregamos el cdigo de manera que quede de la siguiente forma: private void formWindowActivated(java.awt.event.WindowEvent evt) { this.panelContenedor.add(crearPanelHuella()); } 19. Ahora creamos el mtodo showImage que nos permitir mostrar la imagen capturada por el lector en el panel correspondiente. El mtodo debe quedar de la siguiente manera: /** * Mtodo utilizado para mostrar la imagen de la huella * en el panel correspondiente. */ public void showImage(BufferedImage image) { //Utiliza el imageProducer para crear una imagen de la huella digital fingerprintImage = image; //Se dibuja la nueva imagen repaint(); } 20. Una vez hecho esto vamos a la clase Util y agregamos el cdigo correspondiente al mtodo onImageAcquired que se ha creado al implementar las interfaces, el mtodo debe quedar as:

/** * Este mtodo es llamado cada vez que la imagen de una huella ha sido capturada. */ public void onImageAcquired(String idSensor, FingerprintImage huellaDigital) { //Almacena la imagen de la huella this.fingerprint=huellaDigital; //Muestra la imagen obtenida ui.showImage(huellaDigital); } 21. Ahora en el constructor de la clase PantallaPrincipal agregamos las siguientes 3 lneas: /*Inicializa la captura de huellas*/ procedimientosSDK.inicializarCaptura(); /*centra la ventana en la pantalla*/ setLocationRelativeTo(null); /*hace visible la ventana*/ setVisible(true); 22. Agregamos el evento ActionPerformed del botn 'Salir' dando clic derecho sobre l en vista de diseo y seleccionando Events -> Action -> ActionPerformed y dentro del cdigo generado agregamos el mtodo dispose(); 23. Para que nuestro programa pueda ejecutarse necesitamos mandarlo llamar desde la clase main, en este caso adems de llamar a la ventana se necesita establecer el directorio de las libreras, en conjunto, el mtodo main de la clase main debe quedar as: public static void main(String[] args) { String grFingerNativeDirectory = new File(".").getAbsolutePath(); Util.setFingerprintSDKNativeDirectory(grFingerNativeDirecto ry); PantallaPrincipal p = new PantallaPrincipal(); } Una vez hecho esto podemos correr la aplicacin con F6 y verificar que realmente funcione, si has realizado los pasos tal cual podrs, hasta este momento, activar el lector de huellas y obtener la lectura de la huella que se ha colocado en el lector, an nos falta especificar cmo verificar, identificar y guardar las huellas pero eso lo dejaremos para la prxima entrega.

Alguna duda o algo qu decir? Deja tu comentario. ****Actualizacin (08/08/2012)**** A peticin de todos les dejo la lista de todos los artculos de este tutorial.

Parte 1: http://monillo007.blogspot.com/2008/08/programacin-de-un-lector-dehuella.html Parte 2: http://monillo007.blogspot.com/2008/08/programacin-de-un-lector-dehuella_20.html Parte 3: http://monillo007.blogspot.com/2008/09/programacin-de-un-lector-dehuella.html Parte 4: http://monillo007.blogspot.com/2008/09/programacin-de-un-lector-dehuella_03.html Parte 5: http://monillo007.blogspot.com/2008/10/programacin-de-un-lector-dehuella.html

ENTRART http://monillo007.blogspot.com/2008/08/programacin-de-unlector-de-huella_20.html LINK http://monillo007.blogspot.com/2008/08/programacin-de-un-lector-de-huella.html