JAVA JNA调用C接口的三种实现方式

更新时间：2026年05月06日 15:46:05 作者：jwolf2

文章主要介绍了使用JNA（Java Native Access）调用C库的方法,包括继承Library接口、直接使用`NativeLibrary`实例和使用头文件实现接口等方式,并详细描述了在Linux环境下使用JNA调用C库的具体操作步骤,还涉及到了一些遇到的问题的解决方法

1. 准备一个共享库文件

test.c

#include <stdio.h>
int test(char *input){
    printf("input:%s\n",input);
    return 0;
}

libtest.so

[root@node-126 ~]# gcc -fPIC -shared -o libtest.so test.c 
[root@node-126 ~]# ls /root/
anaconda-ks.cfg  libtest.so  node-v6.10.2-linux-x64.tar.xz  original-ks.cfg  spring3  test  test.c

可以看到有test方法

[root@node-126 ~]# nm -D libtest.so 
0000000000201038 B __bss_start
                 w __cxa_finalize
0000000000201038 D _edata
0000000000201040 B _end
0000000000000600 T _fini
                 w __gmon_start__
00000000000004c0 T _init
                 w _ITM_deregisterTMCloneTable
                 w _ITM_registerTMCloneTable
                 U printf
00000000000005d5 T test

2. JNA方式1—继承Library接口

建个普通maven项目

       <dependency>
            <groupId>net.java.dev.jna</groupId>
            <artifactId>jna</artifactId>
            <version>5.5.0</version>
        </dependency>

package jna;
import com.sun.jna.Library;
import com.sun.jna.Native;
/**
 * 接口继承
 *
 * @author majun
 * @version 1.0
 * @since 2023-08-22 22:27
 */
public interface MyClibrary extends Library {
    MyClibrary INSTANTCE = Native.load("/root/libtest.so", MyClibrary.class);
    int test(String input);
}

测试

import jna.MyClibrary;

/**
 * TODO
 *
 * @author majun
 * @version 1.0
 * @since 2023-03-31 7:44
 */
public class Main {
    public static void main(String[] args) {
        int test = MyClibrary.INSTANTCE.test("extend Library");
        System.out.println(test);
    }
}

使用Linux上的Java运行

3. JNA方式2—直接NativeLibrary.getInstance

import com.sun.jna.Function;
import com.sun.jna.NativeLibrary;

/**
 * TODO
 *
 * @author majun
 * @version 1.0
 * @since 2023-03-31 7:44
 */
public class Main {
    public static void main(String[] args) {
        NativeLibrary instance = NativeLibrary.getInstance("/root/libtest.so");
        Function func = instance.getFunction("test");
        Object res = func.invoke(Integer.class, new Object[]{"NativeLibrary.getInstance"});
        System.out.println( res);
    }
}

4. JNA方式3—Native方法

mkdir -p /root/jna && cd /root/jna 新建MyNative.java

package jna;
import java.io.IOException;

public class MyNative {
     native int  test(String input) throws IOException;
}

编译并生成头文件（这里java17没找到javah命令，改用java8的，但注意javac ,javah要使用同一个Java版本的）

 /usr/local/jdk1.8.0_111/bin/javac  MyNative.java
 /usr/local/jdk1.8.0_111/bin/javah -classpath /root/ -jni   jna.MyNative

linux直接编辑实现头文件中的接口：

#include <stdio.h>
#include <jni.h>
#include "jna_MyNative.h"
jint  Java_jna_MyNative_test(JNIEnv *jniEnv, jobject clazz, jstring input){
    printf("input:%s\n",(char *)input);
    return 0;
}

编译时注意引入jdk头文件包下的jni.h等

gcc -fPIC -shared -I/usr/lib/jvm/jdk-17-oracle-x64/include -I/usr/lib/jvm/jdk-17-oracle-x64/include/linux -o libtest.so test.c

使用Clion实现头文件的接口：新建C项目，引入jna_MyNative.h，并实现其中的方法

注意：

1.使用远程toolchain,cmake编译安装运行，注意cmake版本可能导致include_directories(SYSTEM "/usr/lib/jvm/jdk-17-oracle-x64/include") 同步Linux上jdk的头文件失败，本地无法找到符号，但可以正常运行。

2.jniEnv必须Java调用才会有值。

cmake_minimum_required(VERSION 2.8)
project(untitled1)

set(CMAKE_CXX_STANDARD 17)
include_directories(SYSTEM "/usr/lib/jvm/jdk-17-oracle-x64/include")
include_directories(SYSTEM "/usr/lib/jvm/jdk-17-oracle-x64/include/linux")

add_executable(testexe main.cpp)
add_library(test SHARED main.cpp jna_MyNative.h)
target_link_libraries(test -I/usr/lib/jvm/jdk-17-oracle-x64/include -I/usr/lib/jvm/jdk-17-oracle-x64/linux)
install(TARGETS test LIBRARY DESTINATION /usr/lib)

Java调用测试

import jna.MyNative;

import java.io.IOException;

/**
 * TODO
 *
 * @author majun
 * @version 1.0
 * @since 2023-08-23 23:44
 */
public class Main {
    public static void main(String[] args) throws IOException {
        System.load("/root/jna/libtest.so");
        //System.loadLibrary("test");// 自动拼接成libtest.so，默认从/usr/lib,/usr/lib64等路径找
        MyNative myNative = new MyNative();
        int test = myNative.test("native");
        System.out.println(test);
    }
}

姿势3实现的C接口，Java依旧可以使用姿势1，2的方式来调用，注意函数名为Java_jna_MyNative_test

[root@node-126 lib]# nm -D /usr/lib/libtest.so 
0000000000201070 B __bss_start
                 U __cxa_allocate_exception
                 w __cxa_finalize
                 U __cxa_free_exception
                 U __cxa_throw
0000000000201070 D _edata
0000000000201078 B _end
0000000000000b4c T _fini
                 w __gmon_start__
                 U __gxx_personality_v0
0000000000000860 T _init
                 w _ITM_deregisterTMCloneTable
                 w _ITM_registerTMCloneTable
0000000000000a15 T Java_jna_MyNative_test
                 w _Jv_RegisterClasses
0000000000000ac8 T main
                 U printf
                 U _Unwind_Resume
0000000000000b18 W _ZN7JNIEnv_8ThrowNewEP7_jclassPKc
0000000000000aea W _ZN7JNIEnv_9FindClassEPKc
                 U _ZTIi

总结

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。

您可能感兴趣的文章:

深入分析Java中字符串拼接的三种方式
在Java开发中,字符串拼接是一个非常常见的操作,本文将通过实际的性能测试,深入分析 + 运算符、StringBuilder 和 String.join() 三种字符串拼接方式的性能差异,帮助开发者在不同场景下做出正确的选择
2026-05-05
使用Spring Initializr方式如何快速构建Spring Boot项目
Spring lnitializr是一个Web应用,它提供了一个基本的项目结构,能够帮助我们快速构建一个基础的Spring Boot项目,本文分步骤讲解如何使用Spring Initializr方式构建Spring Boot项目,感兴趣的朋友跟随小编一起看看吧
2023-08-08
Java中的抽象类和接口你了解吗
这篇文章主要为大家详细介绍了Java中的抽象类和接口，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下，希望能够给你带来帮助
2022-02-02
Java 在游戏中探索数组二维数组
数组和二维数组感觉用王者荣耀的装备栏来举例解释，应该更易懂一些。从基础开始讲，后续会讲到JAVA高级，中间会穿插面试题和项目实战，希望能给大家带来帮助
2022-03-03
Java事故排查过程详细讲解
Java线上问题排查是一个复杂但重要的过程,涉及多个方面,这篇文章主要介绍了Java事故排查过程的相关资料,文中通过代码介绍的非常详细,需要的朋友可以参考下
2025-10-10
java 转发和重定向区别及实例代码
这篇文章主要介绍了java 转发和重定向区别及实例代码的相关资料,需要的朋友可以参考下
2016-11-11
浅谈一下Java中的几种JVM级别的锁
这篇文章主要介绍了浅谈一下Java中的几种JVM级别的锁,当存在安全漏洞时，也必须有相应的防护措施。顺应这种趋势，虚拟"锁"被发明出来，以解决线程的安全问题。在这篇文章中，我们将研究多年来出现的 Java 中几种典型的 JVM 级锁,需要的朋友可以参考下
2023-08-08
Java事务的个人理解小结
数据库操作的事务习惯上就称为Java事务
2013-03-03
Java中间的接口用法详解
Java 程序员都知道要面向接口编程，那 Java 中的接口除了定义接口方法之外还能怎么用你知道吗，今天小编就来带大家看一下 Java 中间的接口还可以有哪些用法,需要的朋友可以参考下
2023-07-07
一篇文章带你入门java代理模式
这篇文章主要介绍了Java代理模式,结合实例形式详细分析了java基本数据类型、数据类型转换、算术运算符、逻辑运算符等相关原理与操作技巧,需要的朋友可以参考下
2021-08-08