关闭

Android NDK 开发(二)JNI 传递参数和返回值

标签: javac语言jniandroid ndkandroid
5382人阅读 评论(0) 收藏 举报
分类:

前言

我们在使用 JNI 时最常问到的是 JAVA 和 C/C++之间如何传递数据,以及数据类型之间如何 互相映射。我们从整数等基本类型和数组、字符串等普通的对象类型开始讲述。至于如何传递任意对象,将在后面会更新。

原文链接请标明:
http://blog.csdn.net/u011974987/article/details/52743495
本文出自:【stromxu的博客】


正文

JNI简介及调用流程这篇文章,我们再来实现一个非静态的native方法。

Java端:

public class JniTest {

    //静态的
    public native static String getStringFromC();

    //非静态的
    public native String getString2FromC(int i);

    public static void main(String[] args) {
        String text = getStringFromC();
        System.out.println(text);

        JniTest t = new JniTest();
        text = t.getString2FromC(6);
        System.out.println(text);

    }

    //加载动态库
    static{ 
        System.loadLibrary("jni_study");
    }

}

在native层实现 getString2FromC 非静态方法;

JNIEXPORT jstring JNICALL Java_com_study_jni_JniTest_getString2FromC
(JNIEnv *env, jobject jobj, jint num){
    return (*env)->NewStringUTF(env,"C String2");
}

由此看出,每个native函数,都至少有两个参数(JNIEnv*,jclass或者jobject)

  • 当native方法为静态方法时:
    jclass 代表native方法所属类的class对象(JniTest.class)
  • 当native方法为非静态方法时:
    jobject 代表native方法所属的对象

1.Java基本数据类型传递

用过Java的人都知道,Java中的基本类型包括boolean,byte,char,short,int,long,float,double这样几种,如果你用这几种类型做native方法的参数,当你通过javah -jni生成.h文件的时候,只要看一下生成的.h文件,就会一清二楚,这些类型分别对应的类型是jboolean,jbyte,jchar,jshort,jint,jlong,jfloat,jdouble 。这几种类型几乎都可以当成对应的C++类型来用。

Java基本数据类型与JNI数据类型的映射关系如下:

JNI的基本数据类型

对应的java引用数据类型:

struct _jobject;

typedef struct _jobject *jobject;
typedef jobject jclass;
typedef jobject jthrowable;
typedef jobject jstring;
typedef jobject jarray;
typedef jarray jbooleanArray;
typedef jarray jbyteArray;
typedef jarray jcharArray;
typedef jarray jshortArray;
typedef jarray jintArray;
typedef jarray jlongArray;
typedef jarray jfloatArray;
typedef jarray jdoubleArray;
typedef jarray jobjectArray;

关系图:

这里写图片描述

最终都是jobject 的结构体指针类型。


2.String参数的传递

Java的String和C++的string是不能对等起来的,所以处理起来比较麻烦。先看一个例子

class Prompt {

// native method that prints a prompt and reads a line
private native String getLine(String prompt);

public static void main(String args[]) {
Prompt p = new Prompt();
String input = p.getLine("Type a line: ");

System.out.println("User typed: " + input);
}

static {
System.loadLibrary("Prompt");
}
}

在这个例子中,我们要实现一个native方法,String getLine(String prompt);读入一个String参数,返回一个String值。通过执行javah -jni得到的头文件是这样的。

#include <jni.h>
#ifndef _Included_Prompt
#define _Included_Prompt
#ifdef __cplusplus
extern "C" {
#endif
JNIEXPORT jstring JNICALL Java_Prompt_getLine(JNIEnv *env, jobject this, jstring prompt);
#ifdef __cplusplus
}
#endif
#endif

jstring是JNI中对应于String的类型,但是和基本类型不同的是,jstring不能直接当作C++的string用。如果你用

cout << prompt << endl;

编译器肯定会扔给你一个错误信息的。
其实要处理jstring有很多种方式,这里只讲一种我认为最简单的方式,看下面这个例子:

#include "Prompt.h"
#include <iostream>

JNIEXPORT jstring JNICALL Java_Prompt_getLine(JNIEnv *env, jobject obj, jstring prompt)
{
const char* str;
str = env->GetStringUTFChars(prompt, false);
if(str == NULL) {
return NULL; 
}

std::cout << str << std::endl;

//释放资源
env->ReleaseStringUTFChars(prompt, str);

// 返回一个字符串
char* tmpstr = "return string succeeded";
jstring rtstr = env->NewStringUTF(tmpstr);
return rtstr;
}

在上面的列子代码中,作为参数的prompt不能直接被C++程序使用,先做了如下转换

str = env->GetStringUTFChars(prompt, false);

将jstring类型变成一个char*类型。
返回的时候,要生成一个jstring类型的对象,也必须通过如下方式,

jstring rtstr = env->NewStringUTF(tmpstr);

这里用到的GetStringUTFCharsNewStringUTF都是JNI提供的处理String类型的函数。


3.数组类型的传递

和String一样,JNI为Java基本类型的数组提供了j*Array类型,比如int[]对应的就是jintArray。来看一个传递int数组的例子。

java端主要代码:

    public native void giveArray(int[] array);

    int[] array = {9,100,10,37,5,10};
        //排序
    t.giveArray(array);

    for (int i : array) {
        System.out.println(i);
    }

C实现主要代码:

int compare(int *a,int *b){
    return (*a) - (*b);
}

//传入
JNIEXPORT void JNICALL Java_com_study_jni_JniTest_giveArray
(JNIEnv *env, jobject jobj, jintArray arr){
    //jintArray -> jint指针 -> c int 数组
    jint *elems = (*env)->GetIntArrayElements(env, arr, NULL);
    //printf("%#x,%#x\n", &elems, &arr);

    //数组的长度
    int len = (*env)->GetArrayLength(env, arr);
    //排序
    qsort(elems, len, sizeof(jint), compare);   

    //同步
    //mode
    //0, Java数组进行更新,并且释放C/C++数组
    //JNI_ABORT, Java数组不进行更新,但是释放C/C++数组
    //JNI_COMMIT,Java数组进行更新,不释放C/C++数组(函数执行完,数组还是会释放)

    (*env)->ReleaseIntArrayElements(env, arr, elems, JNI_COMMIT);
}

这个代码中的GetIntArrayElementsReleaseIntArrayElements函数就是JNI提供用于处理int数组的函数。

如果用arr[i]的方式去访问jintArray类型,不用问肯定会出错。
JNI还提供了另一对函数GetIntArrayRegionReleaseIntArrayRegion访问int数组,不在这里做介绍,至于其他的类型数组,方法类似。


4.返回数组

在JNI中,二维数组和String数组都被视为object数组,因为数组和String被视为object。最后一个示例说明如何在本地代码中创建一个字符串数组并将它返回给 Java 调用者。

java端的代码:

    int[] array2 = t.getArray(10);
    System.out.println("------------");
    for (int i : array2) {
        System.out.println(i);
    }

函数实现:

//返回数组
JNIEXPORT jintArray JNICALL Java_com_study_jni_JniTest_getArray(JNIEnv *env, jobject jobj, jint len){
    //创建一个指定大小的数组
    jintArray jint_arr = (*env)->NewIntArray(env, len);
    jint *elems = (*env)->GetIntArrayElements(env, jint_arr, NULL); 
    int i = 0;
    for (; i < len; i++){
        elems[i] = i;
    }

    //同步
    (*env)->ReleaseIntArrayElements(env, jint_arr, elems, 0);   

    return jint_arr;
}

jintArray jint_arr ;因为要返回值,所以需要创建一个指定大小jintArray对象。根据jintArray对象拿到jint 指针。然后,赋值,同步,这样通过参数返回就可以了。
下一篇将会介绍C 访问Java 属性和方法。

本文由博主辛苦整理下来的笔记;
希望大家能够指点或提出宝贵意见,共同学习,谢谢!
转载请注明出处:http://blog.csdn.net/u011974987/article/details/52743495
欢迎关注我的社交网站~
个人博客:xuhaoblog.com
新浪微博:http://weibo.com/xuxiho
github:https://github.com/git-xuhao

1
1
查看评论

JNI字符串参数传递与返回值

在编程的时候我们不仅需要使用无参的函数,有参数的函数也是必须的。 这次我编写一个函数用来传递String类型参数,并输出该函数的返回值。 编写java类: [java] view plaincopy class St...
  • tanningzhong
  • tanningzhong
  • 2015-09-12 10:52
  • 1127

JNI编程中如何传递参数和返回值。

本篇将介绍在JNI编程中如何传递参数和返回值。 首先要强调的是,native方法不但可以传递Java的基本类型做参数,还可以传递更复杂的类型,比如String,数组,甚至自定义的类。这一切都可以在jni.h中找到答案。 1. Java基本类型的传递 用过Java的人都知道,Java...
  • henry121212
  • henry121212
  • 2012-04-20 18:46
  • 19971

JNI中参数的传递与操作

JNI的所有的本地方法的第一个参数都是指向JNIEnv结构的。这个结构是用来调用JNI函数的。第二个参数jclass/jobject的意义,要看方法是不是静态的(static)或者实例(Instance)的。前者,jclass代表一个类对象的引用,而后者是被调用的方法所属对象的引用。 从第三个参数开...
  • hetangbian
  • hetangbian
  • 2016-12-05 14:38
  • 2464

[JNI]开发之旅(8)传递参数给JNI函数

本节将介绍在JNI编程中如何传递参数和返回值。首先要强调的是,native方法不但可以传递Java的基本类型做参数,还可以传递更复杂的类型,比如String,数组,甚至自定义的类。jni.h中定义了很多接口供我们操作。其实在前面章节的例子中,我们已经使用到很多java传递参数给jni的例子,只是没有...
  • tsdfk1455
  • tsdfk1455
  • 2017-01-01 00:34
  • 1194

Android使用JNI实现Java与C之间传递数据

介绍Java如何将数据传递给C和C回调Java的方法。  java传递数据给C,在C代码中进行处理数据,处理完数据后返回给java。C的回调是Java传递数据给C,C需要用到Java中的某个方法,就需要调用java的方法。 Android中使用JNI七个步骤: 1.创建一个androi...
  • furongkang
  • furongkang
  • 2011-10-10 01:46
  • 40396

jni参数详解

从Java 1.1开始,Java Native Interface     (JNI)标准成为java平台的一部分,它允许Java代码和其他语言写的代码进行交互。JNI一开始是为了本地已编译语言,尤其是C和C++而设计的, 但是它并不妨碍你使用其他语言,只...
  • xxbs2003
  • xxbs2003
  • 2013-08-13 17:13
  • 2103

JNI编程之如何传递参数(一)——String参数的传递

String参数的传递 Java的String和C++的string是不能对等起来的,所以处理起来比较麻烦。先看一个例子, class Prompt { // native method that prints a prompt and reads a line private na...
  • wangkr111
  • wangkr111
  • 2012-08-19 16:11
  • 35392

Java JNI由浅入深(包括:Java和C++互传ArrayList泛型对象参数)

         我们知道Java是一个运行在虚拟机里面的高级的编程语言,如果要调用系统的动态链接库的话,就要先声明native修饰的方法(类似接口里面的方法),再由C/C++程序来实现(类似实现接口里的方法)。这样Java调用这些native方法就...
  • u_xtian
  • u_xtian
  • 2010-11-25 09:57
  • 18719

JNI demo手把手 && JNINativeMethod的参数解析 && JNI使用中的报错

(1)JNI工程建立         在Android目录下任意创建一个目录jnidemo,并在该目录下创建三个文件:Android.mk,用于编译JNI工程的makefile文件;jnidemo.cpp,JNI代码文件;onlo...
  • zhandoushi1982
  • zhandoushi1982
  • 2014-01-04 11:26
  • 5171

android jni类型和参数签名

jni中的签名参数是一个很麻烦的东西,稍不注意,应用就gg了。 格式是: (参数1类型标示;参数2类型标示;...参数n类型标示)返回值类型标示。 表1-1是常见的类型标示: 表1-1 类型标示示意表 类型标示 Java类型 类型标示 Java类型 ...
  • fwt336
  • fwt336
  • 2017-03-02 16:58
  • 458
    个人资料
    • 访问:258329次
    • 积分:3291
    • 等级:
    • 排名:第12259名
    • 原创:76篇
    • 转载:5篇
    • 译文:2篇
    • 评论:87条
    个人网站
    博客专栏