java高级用法之JNA类型映射应该注意的问题

　　简介
　　JNA提供JAVA类型和native类型的映射关系，但是这一种映射关系只是一个大概的映射，我们在实际的应用中还有很多需要注意的事项，本文将会为大家详细讲解在使用类型映射中可能会出现的问题。一起来看看吧。String
　　首先是String的映射，JAVA中的String实际上对应的是两种native类型：constchar和constwchart。默认情况下String会被转换成为char。
　　char是ANSI类型的数据类型，而wchart是Unicode字符的数据类型，也叫做宽字符。
　　如果JAVA的unicodecharacters要转换成为char数组，那么需要进行一些编码操作，如果设置了jna。encoding，那么就会使用设置好的编码方式来进行编码。默认情况下编码方式是UTF8。
　　如果是WString，那么Unicodevalues可以直接拷贝到WString中，而不需要进行任何编码。
　　先看一个简单的例子：charreturnStringArgument（chararg）｛returnarg；｝wchartreturnWStringArgument（wchartarg）｛returnarg；｝
　　上面的native代码可以映射为：StringreturnStringArgument（Strings）；WStringreturnWStringArgument（WStrings）；
　　再来看一个不同的例子，假如native方法的定义是这样的：intgetString（charbuffer，intbufsize）；intgetUnicodeString（wchartbuffer，intbufsize）；
　　我们定义了两个方法，方法的参数分别是char和wchart。
　　接下来看一下怎么在JAVA中定义方法的映射：MappingA：intgetString（byte〔〕buf，intbufsize）；MappingB：intgetUnicodeString（char〔〕buf，intbufsize）；
　　下面是具体的使用：byte〔〕bufnewbyte〔256〕；intlengetString（buf，buf。length）；StringnormalCStringNative。toString（buf）；StringembeddedNULsnewString（buf，0，len）；
　　可能有同学会问了，既然JAVA中的String可以转换成为char，为什么这里需要使用byte数组呢？
　　这是因为getString方法需要对传入的char数组中的内容进行修改，但是因为String是不可变的，所以这里是不能直接使用String的，我们需要使用byte数组。
　　接着我们使用Native。toString（byte〔〕）将byte数组转换成为JAVA字符串。
　　再看一个返回值的情况：ExampleA：ReturnsaCstringdirectlyconstchargetString（）；ExampleB：ReturnsawidecharacterCstringdirectlyconstwchartgetString（）；
　　一般情况下，如果是native方法直接返回string，我们可以使用String进行映射：MappingAStringgetString（）；MappingBWStringgetString（）；
　　如果nativecode为String分配了内存空间，那么我们最好使用JNA中的Pointer作为返回值，这样我们可以在未来某些时候，释放所占用的空间，如下所示：PointergetString（）；Buffers，Memory，数组和Pointer
　　什么时候需要用到Buffers和Memory呢？
　　一般情况下如果是基础数据的数组作为参数传到函数中的话，可以在JAVA中直接使用基础类的数组来替代。但是如果native方法在方法返回之后，还需要访问数组的话（保存了指向数组的指针），这种情况下使用基础类的数组就不太合适了，这种情况下，我们需要用到ByteBuffers或者Memory。
　　我们知道JAVA中的数组是带有长度的，但是对于native方法来说，返回的数组实际上是一个指向数组的指针，我们并不能知道返回数组的长度，所以如果native方法返回的是数组指针的话，JAVA代码中用数组来进行映射就是不合适的。这种情况下，需要用到Pointer。
　　Pointer表示的是一个指针，先看一下Pointer的例子，首先是native代码：voidreturnPointerArgument（voidarg）｛returnarg；｝voidreturnPointerArrayElement（voidargs〔〕，intwhich）｛returnargs〔which〕；｝
　　接下来是JAVA的映射：PointerreturnPointerArgument（Pointerp）；PointerreturnPointerArrayElement（Pointer〔〕args，intwhich）；
　　除了基本的Pointer之外，你还可以自定义带类型的Pointer，也就是PointerType。只需要继承PointerType即可，如下所示：publicstaticclassTestPointerTypeextendsPointerType｛publicTestPointerType（）｛｝publicTestPointerType（Pointerp）｛super（p）；｝｝TestPointerTypereturnPointerArrayElement（TestPointerType〔〕args，intwhich）；
　　再看一下字符串数组：charreturnStringArrayElement（charargs〔〕，intwhich）｛returnargs〔which〕；｝wchartreturnWideStringArrayElement（wchartargs〔〕，intwhich）｛returnargs〔which〕；｝
　　对应的JAVA映射如下：StringreturnStringArrayElement（String〔〕args，intwhich）；WStringreturnWideStringArrayElement（WString〔〕args，intwhich）；
　　对应Buffer来说，JAVANIO中提供了很多类型的buffer，比如ByteBuffer，ShortBuffer，IntBuffer，LongBuffer，FloatBuffer和DoubleBuffer等。这里以ByteBuffer为例，来看一下具体的使用。
　　首先看下native代码：int32tfillInt8Buffer（int8tbuf，intlen，charvalue）｛inti；for（i0；ilen；i）｛buf〔i〕value；｝returnlen；｝
　　这里将buff进行填充，很明显后续还需要使用到这个buffer，所以这里使用数组是不合适的，我们可以选择使用ByteBuffer：intfillInt8Buffer（ByteBufferbuf，intlen，bytevalue）；
　　然后看下具体怎么使用：TestLibrarylibNative。load（testlib，TestLibrary。class）；ByteBufferbufByteBuffer。allocate（1024）。order（ByteOrder。nativeOrder（））；finalbyteMAGIC（byte）0xED；lib。fillInt8Buffer（buf，1024，MAGIC）；for（inti0；ibuf。capacity（）；i）｛assertEquals（Badvalueatindexi，MAGIC，buf。get（i））；｝可变参数
　　对于native和JAVA本身来说，都是支持可变参数的，我们举个例子，在native方法中：int32taddVarArgs（constcharfmt，。。。）｛valistap；int32tsum0；vastart（ap，fmt）；while（fmt）｛switch（fmt）｛cased：sumvaarg（ap，int32t）；break；casel：sum（int）vaarg（ap，int64t）；break；cases：short（promotedtointwhenpassedthrough。。。）casec：bytechar（promotedtointwhenpassedthrough。。。）sum（int）vaarg（ap，int）；break；casef：float（promotedto‘double’whenpassedthrough‘。。。’）caseg：doublesum（int）vaarg（ap，double）；break；default：break；｝｝vaend（ap）；returnsum；｝
　　对应的JAVA方法映射如下：publicintaddVarArgs（Stringfmt，Number。。。args）；
　　相应的调用代码如下：intarg11；intarg22；assertEquals（32bitintegervarargsnotaddedcorrectly，arg1arg2，lib。addVarArgs（dd，arg1，arg2））；总结
　　本文介绍了在使用JNA方法映射中应该注意的一些细节和具体的使用问题。
　　本文的代码：https：github。comddean2009learnjavabase9to20。git本文已收录于http：www。flydean。com05jnatypemappingdetailsmd
　　最通俗的解读，最深刻的干货，最简洁的教程，众多你不知道的小技巧等你来发现！
　　欢迎关注我的公众号：程序那些事，懂技术，更懂你！