快捷導(dǎo)航

java高級用法之JNA中的Function

更新時間：2022年04月18日 16:16:25 作者：程序那些事

這篇文章主要介紹了java高級用法之JNA中的Function，JAVA中的映射在JNA中就是一個function。通過或者function對象，我們可以實現(xiàn)一些非常強大的功能，下面一起進入文章看看具體內(nèi)容吧

簡介

在JNA中，為了和native的function進行映射，我們可以有兩種mapping方式，第一種是interface mapping，第二種是direct mapping。雖然兩種方式不同，但是在具體的方法映射中，我們都需要在JAVA中定義一個和native方法進行映射的方法。

而這個JAVA中的映射在JNA中就是一個function。通過或者function對象，我們可以實現(xiàn)一些非常強大的功能，一起看看吧。

function的定義

先來看下JNA中Function的定義：

public class Function extends Pointer

可以看到Function實際上是一個Pointer，指向的是native function的指針。

那么怎么得到一個Function的實例呢？

我們知道JNA的流程是先進行Library的映射，然后再對Library中的Function進行映射。所以很自然的我們應(yīng)該可以從Library中得到Function。

我們看一下根據(jù)Library name得到function實例的方法定義：

public static Function getFunction(String libraryName, String functionName, int callFlags, String encoding) {
        return NativeLibrary.getInstance(libraryName).getFunction(functionName, callFlags, encoding);
    }

這個方法可以接受4個參數(shù)，前面兩個參數(shù)大家應(yīng)該很熟悉了，第三個參數(shù)是callFlags,表示的是函數(shù)調(diào)用的flags，F(xiàn)unction定義了三個callFlags：

    public static final int C_CONVENTION = 0;

    public static final int ALT_CONVENTION = 0x3F;

    public static final int THROW_LAST_ERROR = 0x40;

其中C_CONVENTION表示的是C語言類型的方法調(diào)用。

ALT_CONVENTION表示的其他的調(diào)用方式。

THROW_LAST_ERROR表示如果native函數(shù)的返回值是非零值的時候，將會拋出一個LastErrorException。

最后一個參數(shù)是encoding，表示的是字符串的編碼方式，實際上指的是 Java unicode和native (const char*) strings 的轉(zhuǎn)換方式。

除了根據(jù)Library name獲取Function之外，JNA還提供了根據(jù)Pointer來獲取Function的方法。

    public static Function getFunction(Pointer p, int callFlags, String encoding) {
        return new Function(p, callFlags, encoding);
    }

這里的Pointer指的是一個執(zhí)行native方法的指針，因為Function本身就是繼承自Pointer。所以跟Pointer來創(chuàng)建Function的本質(zhì)就是在Pointer的基礎(chǔ)上添加了一些Function特有的屬性。

有了Function的定義，更為重要的是如何通過Function來調(diào)用對應(yīng)的方法。跟反射很類似，F(xiàn)unction中也有一個invoke方法，通過調(diào)用invoke，我們就可以執(zhí)行對應(yīng)的Function的功能。

Function中的invoke方法有兩種，一種是通用的返回對象Object，一種是帶有返回值的invoke方法，比如invokeString,invokePointer,invokeInt等。

Function的實際應(yīng)用

Function的實際使用和JAVA中的反射有點類似，其工作流程是首先獲得要加載的NativeLibrary，然后從該NativeLibrary中找到要調(diào)用的Function，最后invoke該Function的某些方法。

C語言中的printf應(yīng)該是大家最熟悉的native方法了。我們看一下如何使用Function來調(diào)用這個方法吧：

可以看到調(diào)用的流程非常簡潔。如果是用interface Mapping或者direct Mapping的形式，我們還需要自定義一個interface或者class，并且在其中定義一個相應(yīng)的java方法映射。但是如果使用Function的話，這些都不需要了。我們直接可以從NativeLibrary中拿到對應(yīng)的函數(shù)，并最終調(diào)用其中的方法。

C語言中的printf的原型如下：

# include <stdio.h>
int printf(const char *format, ...);

printf帶有返回值的，如果要輸出這個返回值，則可以調(diào)用Function中的invokeInt命令。

我們再來看一個有返回值的調(diào)用例子：

NativeLibrary lib = NativeLibrary.getInstance(Platform.C_LIBRARY_NAME);
        Function f = lib.getFunction("printf");
        Object[] args = new Object[Function.MAX_NARGS+1];
        // Make sure we don't break 'printf'
        args[0] = getName();
        try {
            f.invokeInt(args);
            fail("Arguments should be limited to " + Function.MAX_NARGS);
        } catch(UnsupportedOperationException e) {
            // expected
        }