使用 StdCallFunctionMapper 重命名 JNA 中的 DLL 函数

Question

我尝试在 Windows 中将 JNA 与 DLL 一起使用，到目前为止，我能够成功调用名为 c_aa_find_devices() 的函数。 但所有函数都以 c_aa 开头，我想将其重命名为 find_devices()。

据我所知，执行此操作的方法是使用 StdCallFunctionMapper 但我找不到如何在示例中使用它的文档（即如何按名称或序号将 DLL 函数映射到包装的 Java 库接口中的所需名称） 。 关于文档在哪里有什么建议吗？

Answer 1

使用函数映射器的完整工作示例。

import com.sun.jna.Library;
import com.sun.jna.Native;
import com.sun.jna.NativeLibrary;
import com.sun.jna.win32.StdCallFunctionMapper;

import java.io.File;
import java.lang.reflect.Method;
import java.util.HashMap;
import java.util.Map;

public class JnaTest {


    static {
    Map options = new HashMap();
        options.
                put(
                        Library.OPTION_FUNCTION_MAPPER,
                        new StdCallFunctionMapper() {
                            HashMap<String, String> map = new HashMap() {
                                {
                                    put("testMethod", "testMethod@0");
                                }
                            };
                            @Override
                            public String getFunctionName(NativeLibrary library, Method method) {
                                String methodName = method.getName();
                                return map.get(methodName);

                            }
                        }
                );

        File LIB_FILE = new File("test.dll");
        Native.register(NativeLibrary.getInstance(LIB_FILE.getAbsolutePath(), options));

    }

    private static native int testMethod();

    public static void main(String[] args) {
        testMethod(); // call the native method in the loaded dll with the function name testMethod@0
    }


}

Answer 2

使用 StdCallMapper 效果不佳 - 它应该映射奇怪的 Windows std lib 名称，这些名称嵌入了作为名称一部分嵌入的参数的总字节长度。 因为它仅针对 std lib 完成（只是猜测，但 99% 你的函数不是这样的）。

如果您的 dll 在所有函数上使用一些通用前缀，您只需使用类似以下内容：

class Mapper implements FunctionMapper{
    public String getFunctionName(NativeLibrary library, Method method) {
       return GenieConnector.FUNCTION_PREFIX + method.getName();
    }
}

其中 GenieConnector.FUNCTION_PREFIX 是该通用前缀。 请记住，我实现了 FunctionMapper，而不是扩展了 StdCallMapper

Answer 3

根据文档，您需要在对 loadLibrary 的原始调用中提供一个 FunctionMapper 来转换名称。 但是，您还需要保留标准调用映射，因此请尝试以下操作：

Map options = new HashMap();

options.
    put(
        Library.OPTION_FUNCTION_MAPPER, 
        new StdCallFunctionWrapper() {
            public String getFunctionName(NativeLibrary library, Method method) {
                if (method.getName().equals("findDevices") 
                    method.setName("c_aa_find_devices");
                // do any others
                return super.getFunctionName(library, method);
            }
        }
    );

Native.loadLibrary(..., ..., options);

Answer 4

所有 JNA 文档均位于 主网页，JavaDoc 概述，以及 JavaDocs 本身。

上面的示例是正确的想法，因为您需要调整通用 StdCallFunctionMapper 返回的函数名称（假设您使用的是 stdcall 调用约定）。 但是，Method.setName() 不存在，如果存在，您也不会想调用它。 您需要获取字符串结果，并将其中的 Java 函数名称替换为目标本机名称，例如，

name = super.getFunctionName();
name = name.replace("find_devices", "c_aa_find_devices");

更一般地，您可以简单地在返回的名称上添加“c_aa_”前缀（或在任何前导下划线之后），因为stdcall 装饰位于名称末尾。