Java通过JNI调用C++动态库的完整流程详解

 更新时间:2025年04月09日 09:17:10   作者:颇有几分姿色  
JNI(Java Native Interface),是实现Java/Kotlin与C/C++语言之间交互的桥梁,本文主要为大家介绍了Java通过JNI调用C++动态库的完整流程,需要的可以参考下

介绍使用 JNI 调用 C++ 编写的动态链接库的全过程。

示例环境

项目说明
JDK8
C++ 编译器Visual Studio 2019
Java 开发工具IntelliJ IDEA 2021.3
操作系统Windows 10

Java 项目结构概览

编写 Java 类

在 org.jni.nativejni 包下创建类 HelloWorldJni.java:

package org.jni.nativejni;

public class HelloWorldJni {

    static {
        // 加载 C++ 编译生成的 DLL
        System.load("E:/vsproject/HelloWorld/x64/Release/HelloWorld.dll");
    }

    // native 方法声明
    public native String sayHello(String str1, String str2);
    public native int add(int a, int b);

    public static void main(String[] args) {
        HelloWorldJni hw = new HelloWorldJni();
        System.out.println("拼接字符串:" + hw.sayHello("Hello", "World"));
        System.out.println("相加:" + hw.add(52, 23));
    }
}

生成 JNI 头文件

方法一:使用 javac -h(推荐方式,支持 JDK8+)

在项目根目录下执行命令:

javac -h src/main/jni src/main/java/org/jni/nativejni/HelloWorldJni.java

说明:

  • -h 参数用于指定生成头文件的目录。
  • 这个命令会编译 .java 文件然后生成 .class 文件,同时生成 JNI 头文件。

注意:这个命令会在源码目录中生成 .class 文件,建议在 target/classes 中操作,避免污染源码。

方法二:使用 javah(仅适用于 JDK8)

先使用 Maven 编译项目:

mvn clean install

然后执行:

javah -classpath target/classes -d src/main/jni org.jni.nativejni.HelloWorldJni

说明:

  • -classpath 指定 .class 文件的根路径。
  • -d 指定 JNI 头文件的输出目录。

实现 JNI 层与调用 DLL 方法

使用 Visual Studio 编译生成 DLL

1.创建一个新的 C++ DLL 项目,项目名称为 HelloWorld。

2.添加源文件:

  • HelloWorld.cpp:实现 DLL 的原始功能逻辑。
  • HelloWorldJNI.cpp:实现 JNI 桥接代码。

3.配置项目属性:

C/C++ → 常规 → 附加包含目录中添加:

  • JDK 的 include 目录
  • JDK 的 include/win32 目录

C++ 头文件:HelloWorld.h

#ifndef HELLO_WORLD_H
#define HELLO_WORLD_H

// 导出 HelloWorld 函数
extern "C" __declspec(dllexport) const char* HelloWorld(const char* str1, const char* str2);

// 导出 Add 函数
extern "C" __declspec(dllexport) int Add(int a, int b);

#endif // HELLO_WORLD_H#pragma once

C++ 实现:HelloWorld.cpp

// HelloWorld.cpp
#include "pch.h" // 如果 VS 生成了预编译头文件
#include "HelloWorld.h" // 引入头文件
#include <iostream>
#include <string>

extern "C" __declspec(dllexport) const char* HelloWorld(const char* str1, const char* str2) {
    static std::string result; // 使用静态变量存储返回值,确保返回的指针有效
    result = std::string(str1) + "," + std::string(str2);
    return result.c_str(); // 返回拼接后的 C 字符串
}

// 一个简单的加法函数
extern "C" __declspec(dllexport) int Add(int a, int b) {
    return a + b;
}

JNI 头文件:org_jni_nativejni_HelloWorldJni.h

由 javac -h 或 javah 自动生成,内容如下:

/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class org_jni_nativejni_HelloWorldJni */

#ifndef _Included_org_jni_nativejni_HelloWorldJni
#define _Included_org_jni_nativejni_HelloWorldJni
#ifdef __cplusplus
extern "C" {
#endif
/*
 * Class:     org_jni_nativejni_HelloWorldJni
 * Method:    sayHello
 * Signature: (Ljava/lang/String;Ljava/lang/String;)Ljava/lang/String;
 */
JNIEXPORT jstring JNICALL Java_org_jni_nativejni_HelloWorldJni_sayHello
  (JNIEnv *, jobject, jstring, jstring);

/*
 * Class:     org_jni_nativejni_HelloWorldJni
 * Method:    add
 * Signature: (II)I
 */
JNIEXPORT jint JNICALL Java_org_jni_nativejni_HelloWorldJni_add
  (JNIEnv *, jobject, jint, jint);

#ifdef __cplusplus
}
#endif
#endif

JNI 实现:HelloWorldJNI.cpp

#include "pch.h" // 如果 VS 生成了预编译头文件
#include "org_jni_nativejni_HelloWorldJni.h"  // 引入自动生成的 JNI 头文件
#include "HelloWorld.h"    // 引入自定义的头文件,调用已有的 DLL 接口

JNIEXPORT jstring JNICALL Java_org_jni_nativejni_HelloWorldJni_sayHello
(JNIEnv* env, jobject, jstring jStr1, jstring jStr2) {
    // 将 Java 字符串转换为 C 字符串
    const char* str1 = env->GetStringUTFChars(jStr1, nullptr);
    const char* str2 = env->GetStringUTFChars(jStr2, nullptr);

    // 调用 C++ 动态库函数
    const char* result = HelloWorld(str1, str2);

    // 释放 Java 字符串的本地内存
    env->ReleaseStringUTFChars(jStr1, str1);
    env->ReleaseStringUTFChars(jStr2, str2);

    // 将 C 字符串转换为 Java 字符串并返回
    return env->NewStringUTF(result);
}


JNIEXPORT jint JNICALL Java_org_jni_nativejni_HelloWorldJni_add
(JNIEnv*, jobject, jint a, jint b) {
    return Add(a, b); // 调用原始的 Add 函数
}

提示:这里为了演示方便,JNI 桥接代码和业务逻辑放在同一个项目中。实际开发时桥接层要单独封装,便于维护与复用。

Java 调用 DLL 测试

将编译生成的 HelloWorld.dll 放到系统环境变量中,这里这个库没什么其他依赖,都是系统 c 盘中有的,所以直接指到它生成的目录就可以使用了。

运行 Java 主类的输出结果:

拼接字符串:Hello,World
相加:75

总结

梳理一下 Java 调用 C++ DLL 的完整流程。主要包括:

  • 编写 Java 类并声明 native 方法
  • 使用 javac -h 或 javah 生成 JNI 头文件
  • 实现 JNI 桥接层,调用 DLL 中的 C++ 方法
  • 使用 Visual Studio 生成 DLL 文件
  • Java 运行时加载并调用本地方法,或者封装成接口给别人使用。

到此这篇关于Java通过JNI调用C++动态库的完整流程详解的文章就介绍到这了,更多相关Java JNI调用C++动态库内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • JavaGUI常用窗体组件与面板使用详解

    JavaGUI常用窗体组件与面板使用详解

    GUI即图形用户界面,它是基于图形的界面,windows就是一个图形用户界面的操作系统,而DOS是基于命令提示符的操作系统,GUI编程就是编出一个图形用户界面的软件,它使用图形的方式,以菜单、按钮、表示、图文框等标准界面元素组成的用户操作界面
    2023-03-03
  • SpringBoot启动流程SpringApplication准备阶段源码分析

    SpringBoot启动流程SpringApplication准备阶段源码分析

    这篇文章主要为大家介绍了SpringBoot启动流程SpringApplication准备阶段源码分析,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-04-04
  • Java中ArrayIndexOutOfBoundsException 异常报错的解决方案

    Java中ArrayIndexOutOfBoundsException 异常报错的解决方案

    本文主要介绍了Java中ArrayIndexOutOfBoundsException 异常报错的解决方案,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2023-06-06
  • java中流的使用

    java中流的使用

    本文主要介绍了java中流的使用以及分类。具有一定的参考价值,下面跟着小编一起来看下吧
    2017-01-01
  • java解析Excel的方法(xls、xlsx两种格式)

    java解析Excel的方法(xls、xlsx两种格式)

    这篇文章主要介绍了java解析Excel的方法(xls、xlsx两种格式),需要的朋友可以参考下
    2018-04-04
  • Java  队列 Queue 用法实例详解

    Java 队列 Queue 用法实例详解

    本文实例讲述了Java内置队列类Queue用法,分享给大家供大家参考
    2017-04-04
  • Java控制结构知识点详解

    Java控制结构知识点详解

    在本篇文章里小编给大家分享的是关于Java控制结构知识点详解,有需要的朋友们可以参考下。
    2019-10-10
  • Spring Boot 排除某个类加载注入IOC的操作

    Spring Boot 排除某个类加载注入IOC的操作

    这篇文章主要介绍了Spring Boot 排除某个类加载注入IOC的操作,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-08-08
  • SpringBoot如何获取src/main/resource路径下的文件

    SpringBoot如何获取src/main/resource路径下的文件

    这篇文章主要介绍了SpringBoot如何获取src/main/resource路径下的文件,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-12-12
  • Springboot2.6.x高版本与Swagger2版本冲突问题解决方法

    Springboot2.6.x高版本与Swagger2版本冲突问题解决方法

    Spring Boot 2.6.x版本引入依赖 springfox-boot-starter (Swagger 3.0) 后,启动容器会报错,本文就介绍一下Springboot2.6.x高版本与Swagger2版本冲突问题解决方法,感兴趣的可以了解一下
    2022-04-04

最新评论