java 根据类型映射java,
00-1010字符串缓冲区、内存、数组和指针变量参数概述
00-1010JNA提供了JAVA类型和native类型的映射关系,但这种映射关系只是一种粗略的映射。在实际应用中我们还有很多需要注意的地方。本文将详细解释使用类型映射可能出现的问题。让我们看一看。
00-1010首先是字符串的映射。JAVA中的String实际上对应两种原生类型:const char*和const wchar_t*。默认情况下,字符串将被转换为char*。
是char ANSI的数据类型,而wchar_t是Unicode字符的数据类型,也称为宽字符。
如果要将JAVA unicode字符转换成char数组,就需要一些编码操作。如果设置了jna.encoding,将使用设置的编码方法进行编码。默认情况下,编码方法是“UTF8”。
如果是WString,Unicode值可以直接复制到WString中,不需要任何编码。
我们来看一个简单的例子3360。
char * return string argument(char * arg){ return arg;} wchar _ t * returnWStringArgument(wchar _ t * arg){ return arg;}上面的本机代码可以映射为:
String returnStringArgument参数(字符串s);WString return WString argument(WString s);让我们看一个不同的例子。假设本机方法的定义是这样的:
int getString(char* buffer,int bufsize);int getUnicodeString(wchar _ t * buffer,int bufsize);我们定义了两个方法,它们的参数是char*和wchar_t*。
让我们看看如何在JAVA中定义方法的映射:
//映射A:int getString(byte[] buf,int bufsize);//Mapping b : int getUnicodeString(char[]buf,int bufsize);以下是具体用法:
byte[] buf=新字节[256];int len=getString(buf,buf . length);string normal cstring=native . tostring(buf);String embedded nuls=new String(buf,0,len);可能有同学会问,既然JAVA里的String可以转换成char*,为什么这里还要用byte数组呢?
这是因为getString方法需要修改传递的char数组的内容,但是因为String是不可变的,所以这里不能直接使用String,需要使用byte数组。
然后我们使用Native.toString(byte[])将字节数组转换成JAVA字符串。
看另一个返回值:
//示例A:返回一个C string directly const char * getString();//Example B:返回宽字符C字符串directly const wchar _ t * getString();一般来说,如果native方法直接返回string,我们可以使用String进行映射:
//映射string getString();//映射BWString getString();如果原生代码为String分配内存空间,那么我们最好使用JNA中的指针作为返回值,这样就可以在未来的某个时间点释放被占用的空间,如下图:
指针getString();
00-1010什么时候需要使用缓冲区和内存?
正常情况下
如果是基础数据的数组作为参数传到函数中的话,可以在JAVA中直接使用基础类的数组来替代。但是如果native方法在方法返回之后,还需要访问数组的话(保存了指向数组的指针),这种情况下使用基础类的数组就不太合适了,这种情况下,我们需要用到ByteBuffers或者Memory。
我们知道JAVA中的数组是带有长度的,但是对于native方法来说,返回的数组实际上是一个指向数组的指针,我们并不能知道返回数组的长度,所以如果native方法返回的是数组指针的话,JAVA代码中用数组来进行映射就是不合适的。这种情况下,需要用到Pointer.
Pointer表示的是一个指针,先看一下Pointer的例子,首先是native代码:
void* returnPointerArgument(void *arg) { return arg;}void* returnPointerArrayElement(void* args[], int which) { return args[which];}
接下来是JAVA的映射:
Pointer returnPointerArgument(Pointer p);Pointer returnPointerArrayElement(Pointer[] args, int which);
除了基本的Pointer之外,你还可以自定义带类型的Pointer,也就是PointerType. 只需要继承PointerType即可,如下所示:
public static class TestPointerType extends PointerType { public TestPointerType() { } public TestPointerType(Pointer p) { super(p); } }TestPointerType returnPointerArrayElement(TestPointerType[] args, int which);
再看一下字符串数组:
char* returnStringArrayElement(char* args[], int which) { return args[which];}wchar_t* returnWideStringArrayElement(wchar_t* args[], int which) { return args[which];}
对应的JAVA映射如下:
String returnStringArrayElement(String[] args, int which);WString returnWideStringArrayElement(WString[] args, int which);
对应Buffer来说,JAVA NIO中提供了很多类型的buffer,比如ByteBuffer,ShortBuffer,IntBuffer,LongBuffer,FloatBuffer和DoubleBuffer等。这里以ByteBuffer为例,来看一下具体的使用.
首先看下native代码:
int32_t fillInt8Buffer(int8_t *buf, int len, char value) { int i; for (i=0;i < len;i++) { buf[i] = value; } return len;}
这里将buff进行填充,很明显后续还需要使用到这个buffer,所以这里使用数组是不合适的,我们可以选择使用ByteBuffer:
int fillInt8Buffer(ByteBuffer buf, int len, byte value);
然后看下具体怎么使用:
TestLibrary lib = Native.load("testlib", TestLibrary.class); ByteBuffer buf = ByteBuffer.allocate(1024).order(ByteOrder.nativeOrder()); final byte MAGIC = (byte)0xED; lib.fillInt8Buffer(buf, 1024, MAGIC); for (int i=0;i < buf.capacity();i++) { assertEquals("Bad value at index " + i, MAGIC, buf.get(i)); }
可变参数
对于native和JAVA本身来说,都是支持可变参数的,我们举个例子,在native方法中:
int32_t addVarArgs(const char *fmt, ...) { va_list ap; int32_t sum = 0; va_start(ap, fmt); while (*fmt) { switch (*fmt++) { case d: sum += va_arg(ap, int32_t); break; case l: sum += (int) va_arg(ap, int64_t); break; case s: // short (promoted to int when passed through ...) case c: // byte/char (promoted to int when passed through ...) sum += (int) va_arg(ap, int); break; case f: // float (promoted to ‘double when passed through ‘...) case g: // double sum += (int) va_arg(ap, double); break; default: break; } } va_end(ap); return sum;}
对应的JAVA方法映射如下:
public int addVarArgs(String fmt, Number... args);
相应的调用代码如下:
int arg1 = 1;int arg2 = 2;assertEquals("32-bit integer varargs not added correctly", arg1 + arg2, lib.addVarArgs("dd", arg1, arg2));
总结
本文介绍了在使用JNA方法映射中应该注意的一些细节和具体的使用问题。
本文的代码:https://github.com/ddean2009/learn-java-base-9-to-20.git
到此这篇关于java高级用法中的JNA类型映射应该注意的问题小结的文章就介绍到这了,更多相关javaJNA类型映射内容请搜索盛行IT以前的文章或继续浏览下面的相关文章希望大家以后多多支持盛行IT!
郑重声明:本文由网友发布,不代表盛行IT的观点,版权归原作者所有,仅为传播更多信息之目的,如有侵权请联系,我们将第一时间修改或删除,多谢。