java高级用法之:无所不能的java,本地方法调用实况

 2023-01-16
原文作者:程序那些事 原文地址:https://juejin.cn/post/7072347286960881701

简介

相信每个程序员都有一个成为C++大师的梦想,毕竟C++程序员处于程序员鄙视链的顶端,他可以俯视任何其他语言的程序员。

但事实情况是,无数的程序员从小白到放弃,鉴于C++的难度,最后都投入了java的怀抱。JAVA以他宽广的胸怀接纳了一众无法登顶C++的程序员。

开个玩笑,C和C++的优势在于和系统底层的交互和其运行的速度和效率,JAVA的优势在与广泛的应用框架,可以快速搭建所需的应用程序。两者各有所长。

框架的好处就是降低了程序开发的难度,让应用程序可以快速批量复制。

大家知道,JVM底层是使用C和C++来编写的,而JAVA字节码适合JVM进行交互的,所以直观上看来,JAVA是可以和底层的C++代码进行交互的。那么如何交互呢?会不会很复杂?

今天本文带大家一一揭晓。

JDK的本地方法

所谓本地方法就是调用操作系统或者其他底层库的方法。这些方法属于系统的外部接口,用于程序和操作系统之间进行交互。大家想一下,JDK中有哪些本地的方法呢?

第一个想到的应该就是文件操作,因为文件操作肯定需要依赖与系统底层提供的IO接口。我们先具体来看一下File的delete方法的实现:

        public boolean delete() {
            @SuppressWarnings("removal")
            SecurityManager security = System.getSecurityManager();
            if (security != null) {
                security.checkDelete(path);
            }
            if (isInvalid()) {
                return false;
            }
            return fs.delete(this);
        }

File的delete方法首先调用SecurityManager来进行权限判断,看是否可以删除。如果可以删除则继续调用FileSystem的delete方法。

我们继续查看FileSystem的delete方法:

    public abstract boolean delete(File f);

可以看到FileSystem中的delete方法是一个抽象方法,需要具体的实现。

而这个实现是和平台有关系的,如果你是linux或者mac系统,那么它的实现类是UnixFileSystem,它的delete方法如下:

        public boolean delete(File f) {
            if (useCanonCaches) {
                cache.clear();
            }
            if (useCanonPrefixCache) {
                javaHomePrefixCache.clear();
            }
            return delete0(f);
        }
        private native boolean delete0(File f);

可以看到,delete方法最终会调用delete0方法,而这个方法是一个native方法,表示该方法需要调用系统本地的方法。

JDK提供了一个JAVA调用本地系统方法的实现,叫做JNI,全称是Java Native Interface,它是从JAVA1.1中引入的一项技术。它允许Java代码和其他语言写的代码进行交互。

为了验证JNI的可行性,我们接下来自己实现一个native的方法,并在java中调用,看看是否能够成功。

自定义native方法

在JAVA中定义native方法很简单,我们只需要在方法描述前面加上native关键字即可,这个方法并不需要任何实现。举个具体的例子如下:

    public class JNIUsage {
    
        public native void printMsg();
    
        public static void main(String[] args) {
            //加载C文件
            System.loadLibrary("JNIUsage");
            JNIUsage jniUsage = new JNIUsage();
            jniUsage.printMsg();
        }
    }

上面的例子中,我们定义了一个native的printMsg,然后在main中首先加载包含该实现的Library文件,之后就可以像正常的JAVA方法一样进行调用。

那么这么实现这个native方法呢?

不管熟悉还是不熟悉C++的朋友应该都听过头文件的概念,一般来说我们在头文件中定义好要实现的方法,然后在具体的内容文件中对头文件中定义的方法进行实现。

所以头文件中需要包含这个printMsg的方法,生成头文件可以使用javah命令。

首先进入到JNIUsage源文件的根目录,运行下面的命令:

    javah -classpath . -jni com.flydean.JNIUsage

该命令会在项目源代码的根目录中生成一个com_flydean_JNIUsage.h文件。打开看看,具体的内容如下:

    /* DO NOT EDIT THIS FILE - it is machine generated */
    #include <jni.h>
    /* Header for class com_flydean_JNIUsage */
    
    #ifndef _Included_com_flydean_JNIUsage
    #define _Included_com_flydean_JNIUsage
    #ifdef __cplusplus
    extern "C" {
    #endif
    /*
     * Class:     com_flydean_JNIUsage
     * Method:    printMsg
     * Signature: ()V
     */
    JNIEXPORT void JNICALL Java_com_flydean_JNIUsage_printMsg
      (JNIEnv *, jobject);
    
    #ifdef __cplusplus
    }
    #endif
    #endif

简单点讲,该head文件中定义了一个需要实现的Java_com_flydean_JNIUsage_printMsg方法。

接下来,我们需要对这个头文件进行实现。

这里我们使用JetBrain公司的Clion开发工具,首先创建一个c++的项目:

202212302150412341.png

注意,这个项目的type需要是shared类型。

然后将com_flydean_JNIUsage.h文件拷贝到项目的根目录下。

这时候是编译不了的,你会发现很多依赖包的错误,我们还需要将JDK home目录中include目录下的jni.h文件,和jni_md.h文件(如果是windows平台该文件在win32目录下,如果是mac平台,该文件在darwin目录下),拷贝到项目的根目录下。

这样编译的错误就不见了。

最后我们修改默认的library.cpp文件,引入com_flydean_JNIUsage.h并实现其中的方法如下所示:

    #include "com_flydean_JNIUsage.h"
    
    #include <iostream>
    
    JNIEXPORT void JNICALL Java_com_flydean_JNIUsage_printMsg
            (JNIEnv *, jobject){
        printf("this is www.flydean.com!");
    }

目前为止,项目的代码结构应该如下图所示:

202212302150418562.png

接着build-->Build 'JNIUsage', 生成libJNIUsage.dylib文件:

    ====================[ Build | JNIUsage | Debug ]================================
    /Applications/CLion.app/Contents/bin/cmake/mac/bin/cmake --build /Users/flydean/data/git/cplus/JNIUsage/cmake-build-debug --target JNIUsage
    [2/2] Linking CXX shared library libJNIUsage.dylib
    
    Build finished

有了libJNIUsage.dylib,我们还需要将其加入JAVA项目中的path中:

202212302150426143.png

选择java-jni的module,在依赖中选择JARs or Directories, 选择刚刚的libJNIUsage.dylib 目录。

保存之后,就可以运行JAVA代码了,结果如下:

    /Library/Java/JavaVirtualMachines/jdk-17.0.1.jdk/Contents/Home/bin/java -Djava.library.path=/Users/flydean/data/git/cplus/JNIUsage/cmake-build-debug -Dfile.encoding=UTF-8 -classpath /Users/flydean/data/git/learn-java-base-9-to-20/java-jni/target/classes: com.flydean.JNIUsage
    
    this is www.flydean.com!

或者你可以在命令行中将libJNIUsage.dylib加入到java运行的classpath中即可。

总结

以上就是一个简单的使用JAVA调用native方法的例子。大家可以看到,步骤还是挺复杂的,那么有没有其他更加简单的方法,让JAVA来调用native方法呢?有的,这就是JNA,我们会在后续的文章中深入进行介绍。

本文的代码可以参考github.com/ddean2009/l…

本文已收录于 www.flydean.com/01-jni-over…

最通俗的解读,最深刻的干货,最简洁的教程,众多你不知道的小技巧等你来发现!

欢迎关注我的公众号:「程序那些事」,懂技术,更懂你!