備注學院

 半年前網(wǎng)絡技術課的老師要我們做個ARP查詢，老師是教人用winsock的，可我一味鉆java，干著急，鉆進java世界到處查，終于找到這么一個東西。

然后做了一個ARP監(jiān)聽器，沒想到被老師看上了，說是國內(nèi)JPCAP研究的人不多，可以考慮寫一篇論文，老師給我推薦發(fā)表。

于是有了這么一篇東西。不過現(xiàn)在還不知道老師發(fā)哪個刊物去了。。。老師說，還沒回音。。

 注：由于字數(shù)限制，分成2部分發(fā)。

數(shù)據(jù)成員
NetworkInterfaceAddress[]	addresses     這個接口的網(wǎng)絡地址。設定為數(shù)組應該是考慮到有些設備同時連接多條線路，例如路由器。但我們的PC機的網(wǎng)卡一般只有一條線路，所以我們一般取addresses[0]就夠了。
java.lang.String	datalink_description.     數(shù)據(jù)鏈路層的描述。描述所在的局域網(wǎng)是什么網(wǎng)。例如，以太網(wǎng)（Ethernet）、無線LAN網(wǎng)（wireless LAN）、令牌環(huán)網(wǎng)(token ring)等等。
java.lang.String	datalink_name    該網(wǎng)絡設備所對應數(shù)據(jù)鏈路層的名稱。具體來說，例如Ethernet10M、100M、1000M等等。
java.lang.String	description    網(wǎng)卡是XXXX牌子XXXX型號之類的描述。例如我的網(wǎng)卡描述：Realtek RTL8169/8110 Family Gigabit Ethernet NIC
boolean	Loopback     標志這個設備是否loopback設備。
byte[]	mac_address    網(wǎng)卡的MAC地址，6個字節(jié)。
java.lang.String	Name     這個設備的名稱。例如我的網(wǎng)卡名稱：\Device\NPF_{3CE5FDA5-E15D-4F87-B217-255BCB351CD5}

數(shù)據(jù)成員
int	dropped_packets  拋棄的包的數(shù)目。
protected  int	ID     這個數(shù)據(jù)成員在官方文檔中并沒有做任何說明，查看JPCAP源代碼可以發(fā)現(xiàn)這個ID實際上在其JNI的C代碼部分傳進來的，這類本身并沒有做出定義，所以是供其內(nèi)部使用的。實際上在對JpcapCator實例的使用中也沒有辦法調(diào)用此數(shù)據(jù)成員。
protected static boolean[]	instanciatedFlag    同樣在官方文檔中沒有做任何說明，估計其為供內(nèi)部使用。
protected static int	MAX_NUMBER_OF_INSTANCE 同樣在官方文檔中沒有做任何說明，估計其為供內(nèi)部使用。
int	received_packets         收到的包的數(shù)目
方法成員
static NetworkInterface[]	getDeviceList()           返回一個網(wǎng)絡設備列表。
static JpcapCaptor	openDevice(NetworkInterface interface, int snaplen, boolean promisc, int to_ms)          創(chuàng)建一個與指定設備的連接并返回該連接。注意，以上兩個方法都是靜態(tài)方法。       Interface：要打開連接的設備的實例；       Snaplen：這個是比較容易搞混的一個參數(shù)。其實這個參數(shù)不是限制只能捕捉多少數(shù)據(jù)包，而是限制每一次收到一個數(shù)據(jù)包，只提取該數(shù)據(jù)包中前多少字節(jié)；       Promisc：設置是否混雜模式。處于混雜模式將接收所有數(shù)據(jù)包，若之后又調(diào)用了包過濾函數(shù)setFilter()將不起任何作用；       To_ms：這個參數(shù)主要用于processPacket()方法，指定超時的時間；
void	Close()           關閉調(diào)用該方法的設備的連接，相對于openDivece()打開連接。
JpcapSender	getJpcapSenderInstance()           該返回一個JpcapSender實例，JpcapSender類是專門用于控制設備的發(fā)送數(shù)據(jù)包的功能的類。
Packet	getPacket()           捕捉并返回一個數(shù)據(jù)包。這是JpcapCaptor實例中四種捕捉包的方法之一。
int	loopPacket(int count, PacketReceiver handler)           捕捉指定數(shù)目的數(shù)據(jù)包，并交由實現(xiàn)了PacketReceiver接口的類的實例處理，并返回捕捉到的數(shù)據(jù)包數(shù)目。如果count參數(shù)設為－1，那么無限循環(huán)地捕捉數(shù)據(jù)。       這個方法不受超時的影響。還記得openDivice()中的to_ms參數(shù)么？那個參數(shù)對這個方法沒有影響，如果沒有捕捉到指定數(shù)目數(shù)據(jù)包，那么這個方法將一直阻塞等待。 PacketReceiver中只有一個抽象方法void receive(Packet p)。
int	processPacket(int count, PacketReceiver handler)            跟loopPacket()功能一樣，唯一的區(qū)別是這個方法受超時的影響，超過指定時間自動返回捕捉到數(shù)據(jù)包的數(shù)目。
int	dispatchPacket(int count, PacketReceiver handler)         跟processPacket()功能一樣，區(qū)別是這個方法可以處于“non-blocking”模式工作，在這種模式下dispatchPacket()可能立即返回，即使沒有捕捉到任何數(shù)據(jù)包。
void	setFilter(java.lang.String condition, boolean optimize)           .condition：設定要提取的包的關鍵字。        Optimize：這個參數(shù)在說明文檔以及源代碼中都沒有說明，只是說這個參數(shù)如果為真，那么過濾器將處于優(yōu)化模式。
void	setNonBlockingMode(boolean nonblocking)      如果值為“true”，那么設定為“non-blocking”模式。
void	breakLoop()      當調(diào)用processPacket()和loopPacket()后，再調(diào)用這個方法可以強制讓processPacket()和loopPacket()停止。

方法成員
void	close()           強制關閉這個連接。
static JpcapSender	openRawSocket()      這個方法返回的JpcapSender實例發(fā)送數(shù)據(jù)包時將自動填寫數(shù)據(jù)鏈路層頭部分。
void	sendPacket(Packet packet)           JpcapSender最重要的功能，發(fā)送數(shù)據(jù)包。需要注意的是，如果調(diào)用這個方法的實例是由JpcapCaptor的getJpcapSenderInstance()得到的話，需要自己設定數(shù)據(jù)鏈路層的頭，而如果是由上面的openRawSocket()得到的話，那么無需也不能設置，數(shù)據(jù)鏈路層的頭部將由系統(tǒng)自動生成。