Hacer una llamada a un método de una DLL utilizando Jawin

Java no dispone de una librería propia para el acceso a las DLL (Dinamyc Linking Library). Para ello, utilizaremos Jawin, una librería que nos permite poder trabajar con los métodos de una librería. Java dispone del JNI (Java Native Interface), que es un framework que permite a java interactuar con otros programas escritos en otros lenguajes. Podemos utilizar JNI para interaccionar con los métodos de la DLL, pero es bastante complicado de utilizar. En éste artículo, veremos lo sencillo que es utilizar la librería de Jawin. Para mi ejemplo, he creado una pequeña DLL con delphi, donde hay un método que suma dos enteros y devuelve el resultado. Primero, necesitamos descargar la última versión de la librería Jawin. En éste enlace, podemos descargar la última versión: jawin 2.0-alpha1. Una vez descargada, la descomprimimos y la dejamos en la C:\, luego veremos el porqué.

Primero, crearé la DLL de delphi. Aquí os dejo el código fuente:

library Project1;

uses
  SysUtils,
  Classes;

{$R *.res}

function AddIntegers(_a, _b: integer): integer; stdcall;
begin
  Result := _a + _b;
end;

exports
   AddIntegers;

begin
end.

Como podéis comprobar, es realmente sencillo generar una DLL, simplemente hay que marcar que métodos queremos exportar y listo!.

Para poder visualizar los métodos de las DLL, yo utilizo 2 herramientas muy buenas: DLL Export Viewer y Dependency Walker. Las 2 son gratuitas, y permiten visualizar los métodos que tenemos dentro de la DLL.

En el caso de mi dll, aquí os dejo el pantallazo de la visualización con las 2 aplicaciones:

Luego, para la implementación en Java, crearé un proyecto con Eclipse y añadiré allí las librerías necesarias para la aplicación.

El proyecto tiene el siguiente aspecto:

He añadido las librerías jawin.jar y jawin-stubs.jar a mi proyecto. Si vamos a la C:\jawin-2.0-alpha1 encontraremos los ficheros y las librerías necesárias. Además tenemos que tener en cuenta la librería jawin.dll, que luego os diré como hay que utilizarla.

Ahora, el código fuente del ejemplo:

package test;

import org.jawin.COMException;
import org.jawin.FuncPtr;
import org.jawin.ReturnFlags;

public class AddNumbers {
    public static void main(String[] args) throws Exception {
        FuncPtr addNum = null;

        try {
            addNum = new FuncPtr("Project1.dll", "AddIntegers");

            Integer g = addNum.invoke_I(3, 5, ReturnFlags.CHECK_HRESULT);
            System.out.println("Suma = " + g);
        } catch (COMException e) {
            e.printStackTrace();
            throw e;
        } finally {
            if (addNum != null) {
                try {
                    addNum.close();
                } catch (COMException e) {
                    e.printStackTrace();
                    throw e;
                }
            }
        }
    }
}

Como podéis ver, hago la llamada a mi dll, y espero el resultado de la suma de los valores. Como resultado tendriamos que ver que la aplicación devuelve lo siguiente:

Loading jawin from hardcoded path C:\jawin-2.0-alpha1\bin\jawin.dll
Suma = 8

Antes de ejecutar el programa, tenemos que vincular la dll de jawin con nuestra aplicación, y ésto hay que hacerlo de la siguiente manera:

Cuando hacemos Run Configurations, tenemos que introducir la siguiente línea en los argumentos de la maquina virtual:

-Dorg.jawin.hardlib=C:\jawin-2.0-alpha1\bin\jawin.dll

De esta manera le estamos diciendo a la aplicación dónde tiene la dll del jawin. Como podéis ver, es bastante sencillo de utilizar, y podemos encontrar un montón de ejemplos dentro de la librería. La otra batalla importante que hay con esta librería es con el tema del los Strings, ya que los métodos que tiene, devuelven matrices de bytes, y tenemos que parametrizar la salida mediante la longitud del String. Buscaré un ejemplo un poco interesante y lo publicaré.
Espero que os sirva de ayuda!.

• Enlaces de interés:

Error con la JNI.