java高級用法之JNA中的Structure
簡介
前面我們講到了JNA中JAVA代碼和native代碼的映射，雖然可以通過TypeMapper來將JAVA中的類型和native中的類型進行映射，但是native中的數(shù)據(jù)類型都是基礎類型，如果native中的數(shù)據(jù)類型是復雜的struct類型該如何進行映射呢？
不用怕，JNA提供了Structure類，來幫助我們進行這些映射處理。
native中的struct
什么時候會用到struct呢？一般情況下，當我們需要自定義一個數(shù)據(jù)類的時候，一般情況下，在JAVA中需要定義一個class(在JDK17中，可以使用更加簡單的record來進行替換)，但是為一個數(shù)據(jù)結構定義class顯然有些臃腫，所以在native語言中，有一些更簡單的數(shù)據(jù)結構叫做struct。
我們先看一個struct的定義:
typedef struct _Point {
int x, y;
} Point;
上面的代碼中，我們定義了一個Pointer的struct數(shù)據(jù)類下，在其中定義了int的x和y值表示Point的橫縱坐標。
struct的使用有兩種情況，一種是值傳遞，一種是引用傳遞。先來看下這兩種情況在native方法中是怎么使用的：
引用傳遞：
Point* translate(Point* pt, int dx, int dy);
值傳遞：
Point translate(Point pt, int dx, int dy);
Structure
那么對于native方法中的struct數(shù)據(jù)類型的使用方式，應該如何進行映射呢? JNA為我們提供了Structure類。
默認情況下如果Structure是作為參數(shù)或者返回值，那么映射的是struct*,如果表示的是Structure中的一個字段，那么映射的是struct。
當然你也可以強制使用Structure.ByReference 或者 Structure.ByValue 來表示是傳遞引用還是傳值。
我們看下上面的native的例子中，如果使用JNA的Structure來進行映射應該怎么實現(xiàn)：
指針映射：
class Point extends Structure { public int x, y; }
Point translate(Point pt, int x, int y);
...
Point pt = new Point();
Point result = translate(pt, 100, 100);
傳值映射：
class Point extends Structure {
public static class ByValue extends Point implements Structure.ByValue { }
public int x, y;
}
Point.ByValue translate(Point.ByValue pt, int x, int y);
...
Point.ByValue pt = new Point.ByValue();
Point result = translate(pt, 100, 100);
Structure內(nèi)部提供了兩個interface,分別是ByValue和ByReference:
public abstract class Structure {
public interface ByValue { }
public interface ByReference { }
要使用的話，需要繼承對應的interface。
特殊類型的Structure
除了上面我們提到的傳值或者傳引用的struct，還有其他更加復雜的struct用法。
結構體數(shù)組作為參數(shù)
首先來看一下結構體數(shù)組作為參數(shù)的情況：
void get_devices(struct Device[], int size);
對應結構體數(shù)組，可以直接使用JNA中對應的Structure數(shù)組來進行映射：
int size = ... Device[] devices = new Device[size]; lib.get_devices(devices, devices.length);
結構體數(shù)組作為返回值
如果native方法返回的是一個指向結構體的指針，其本質(zhì)上是一個結構體數(shù)組，我們應該怎么處理呢？
先看一下native方法的定義：
struct Display* get_displays(int* pcount); void free_displays(struct Display* displays);
get_displays方法返回的是一個指向結構體數(shù)組的指針，pcount是結構體的個數(shù)。
對應的JAVA代碼如下：
Display get_displays(IntByReference pcount); void free_displays(Display[] displays);
對于第一個方法來說，我們只返回了一個Display，但是可以通過Structure.toArray(int) 方法將其轉換成為結構體數(shù)組。傳入到第二個方法中，具體的調(diào)用方式如下：
IntByReference pcount = new IntByReference(); Display d = lib.get_displays(pcount); Display[] displays = (Display[])d.toArray(pcount.getValue()); ... lib.free_displays(displays);
結構體中的結構體
結構體中也可以嵌入結構體，先看下native方法的定義：
typedef struct _Point {
int x, y;
} Point;
typedef struct _Line {
Point start;
Point end;
} Line;
對應的JAVA代碼如下：
class Point extends Structure {
public int x, y;
}
class Line extends Structure {
public Point start;
public Point end;
}
如果是下面的結構體中的指向結構體的指針：
typedef struct _Line2 {
Point* p1;
Point* p2;
} Line2;
那么對應的代碼如下：
class Point extends Structure {
public static class ByReference extends Point implements Structure.ByReference { }
public int x, y;
}
class Line2 extends Structure {
public Point.ByReference p1;
public Point.ByReference p2;
}
或者直接使用Pointer作為Structure的屬性值：
class Line2 extends Structure {
public Pointer p1;
public Pointer p2;
}
Line2 line2;
Point p1, p2;
...
line2.p1 = p1.getPointer();
line2.p2 = p2.getPointer();
結構體中的數(shù)組
如果結構體中帶有固定大小的數(shù)組：
typedef struct _Buffer {
char buf1[32];
char buf2[1024];
} Buffer;
那么我們在JAVA中需要指定數(shù)據(jù)的大?。?/strong>
class Buffer extends Structure {
public byte[] buf1 = new byte[32];
public byte[] buf2 = new byte[1024];
}
如果結構體中是動態(tài)大小的數(shù)組:
typedef struct _Header {
int flags;
int buf_length;
char buffer[1];
} Header;
那么我們需要在JAVA的結構體中定義一個構造函數(shù)，傳入bufferSize的大小,并分配對應的內(nèi)存空間：
結構體中的可變字段
默認情況下結構體中的內(nèi)容和native memory的內(nèi)容是一致的。JNA會在函數(shù)調(diào)用之前將Structure的內(nèi)容寫入到native memory中，并且在函數(shù)調(diào)用之后，將 native memory中的內(nèi)容回寫到Structure中。
默認情況下是將結構體中的所有字段都進行寫入和寫出。但是在某些情況下，我們希望某些字段不進行自動更新。這個時候就可以使用volatile關鍵字，如下所示：
class Data extends com.sun.jna.Structure {
public volatile int refCount;
public int value;
}
...
Data data = new Data();
當然，你也可以強制使用Structure.writeField(String)來將字段信息寫入內(nèi)存中,或者使用Structure.read() 來更新整個結構體的信息或者使用data.readField(“refCount”)來更新具體字段信息。
結構體中的只讀字段
如果不想從JAVA代碼中對Structure的內(nèi)容進行修改，則可以將對應的字段標記為final。在這種情況下，雖然JAVA代碼不能直接對其進行修改，但是仍然可以調(diào)用read方法從native memory中讀取對應的內(nèi)容并覆蓋Structure中對應的值。
來看下JAVA中如何使用final字段：
class ReadOnly extends com.sun.jna.Structure {
public final int refCount;
{
// 初始化
refCount = -1;
// 從內(nèi)存中讀取數(shù)據(jù)
read();
}
}
注意所有的字段的初始化都應該在構造函數(shù)或者靜態(tài)方法塊中進行。
總結
結構體是native方法中經(jīng)常會使用到的一種數(shù)據(jù)類型，JNA中對其進行映射的方法是我們要掌握的。
到此這篇關于java高級用法之JNA中的Structure的文章就介紹到這了,更多相關java 中的Structure內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！
相關文章
SpringBoot整合Servlet和Filter和Listener組件詳解
這篇文章主要介紹了SpringBoot整合Servlet和Filter和Listener組件詳解,在整合某報表插件時就需要使用Servlet,Spring Boot中對于整合這些基本的Web組件也提供了很好的支持,需要的朋友可以參考下2024-01-01
這篇文章主要為大家介紹了java中的Reference和引用類型示例詳解,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進步,早日升職加薪2023-09-09
@AutoConfigurationPackage與@ComponentScan注解區(qū)別
這篇文章主要介紹了@AutoConfigurationPackage與@ComponentScan注解區(qū)別，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進步，早日升職加薪2023-06-06
本文介紹java使用poi讀取excel內(nèi)容的實例，大家參考使用吧2014-01-01
這篇文章主要為大家詳細介紹了java實現(xiàn)文件上傳功能，文中示例代碼介紹的非常詳細，具有一定的參考價值，感興趣的小伙伴們可以參考一下2020-12-12
Spring Boot主要作用就是簡化Spring應用的開發(fā)，開發(fā)者只需要通過少量代碼就可以創(chuàng)建一個Spring應用，而達到這一目的最核心的思想就是約定優(yōu)于配置。2021-05-05
java中對list分頁并顯示數(shù)據(jù)到頁面實例代碼
這篇文章主要介紹了java中對list分頁并顯示數(shù)據(jù)到頁面實例代碼，分享了相關代碼示例，小編覺得還是挺不錯的，具有一定借鑒價值，需要的朋友可以參考下2018-02-02
這篇文章主要介紹了java計算值所占的百分比，結果為100%問題，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教2022-11-11
這篇文章主要介紹了Java反射機制的深入理解，本文給大家介紹的非常詳細，對大家的學習或工作具有一定的參考借鑒價值，需要的朋友可以參考下2021-09-09
SpringBoot整合Prometheus如何實現(xiàn)資源監(jiān)控
本文介紹了如何使用Prometheus監(jiān)控SpringBoot應用,Prometheus是一個開源的監(jiān)控和告警工具,SpringBootActuator提供了監(jiān)控和管理SpringBoot應用的工具,通過添加依賴、配置Actuator和Prometheus,可以實現(xiàn)對SpringBoot應用的實時監(jiān)控2024-12-12