Jpcap使用指南

1.    获取网络接口列表

要想从网络中捕获数据包，第一件必须要做的事就是获取本机的网络接口列表。

Jpcap提供了方法JpcapCaptor.getDeviceList()完成这个任务，该方法返回一组NetworkInterface对象。

NetworkInterface接口对象包含了对应网络接口的一些信息，例如：名称、描述、IP以及MAC地址以及数据链路层名称和描述。

import jpcap.JpcapCaptor;
import jpcap.NetworkInterface;
import jpcap.NetworkInterfaceAddress;

public class TCPCollection {
	public static void main(String[] args){
		NetworkInterface[] devices = JpcapCaptor.getDeviceList();//获取网络接口列表
		for(int i = 0; i < devices.length; i++){
			//名称、描述
			System.out.println(i + "：" + devices[i].name + "(" + devices[i].description + ")");
			//数据链路层名称、描述
			System.out.println("datalink：" + devices[i].datalink_name + "(" + devices[i].datalink_description + ")");
			//MAC地址
			System.out.print(" MAC address：");
			for(byte b: devices[i].mac_address){
				System.out.print(Integer.toHexString(b & 0xff) + ":");
			}
			System.out.println();
			//IP地址、子网掩码、广播地址
			for(NetworkInterfaceAddress a : devices[i].addresses){
				System.out.println(" address: " + a.address + "|" + a.subnet + "|" + a.broadcast);
			}
		}
	}	
}

2.    打开网络接口

一旦有了网络接口列表就可以从选定用于捕获数据包的网络接口，可以使用方法JpcapCaptor.openDevice()来打开网络接口。

public static void main(String[] args){
	NetworkInterface[] devices = JpcapCaptor.getDeviceList();//获取网络接口列表
	int index = 0;
	try {
		JpcapCaptor captor = JpcapCaptor.openDevice(devices[index], 65535, false, 20);
	} catch (IOException e) {
		e.printStackTrace();
		System.out.println("抓取数据包时出现异常!!!");
	}
}	

调用JpcapCaptor.openDevice()方法必须指定下列参数：

3.    从网络接口捕获数据包

一旦获得了JpcapCaptor实例就可以用来捕获来自网络接口的数据包。

使用JpcapCaptor实例来捕获数据包主要有两种方法：回调（callback）以及逐个捕获（one-by-one）。

回调方法

实现的细节：

首先定义一个实现PacketReceiver接口的类。PacketReceiver接口中定义了receivePacket()方法，只需实现receivePacket()这个方法。

class PacketPrinter implements PacketReceiver {
	//this method is called every time Jpcap captures a packet
	public void receivePacket(Packet packet){
		System.out.print(packet);
	}
}

然后可以使用回调的方法调用JpcapCaptor.processPacket()或JpcapCaptor.loopPacket()方法开始数据包的捕获。

processPacket()或loopPacket()方法可以指定捕获的数据包的数量。-1表示无限地捕获数据包。

JpcapCaptor captor = JpcapCaptor.openDevice(devices[index], 65535, false, 20);
captor.processPacket(2, new PacketPrinter());
captor.close();

两种回调方法：processPacket()和loopPacket()非常相似。通常建议使用processPacket()，因为它支持超时以及非阻塞模式，而loopPacket()并不支持。

逐个捕获

使用回调方法稍微有点复杂，因为并不知道Jpcap什么时候调用回调方法。如果不使用回调方法，可以调用JpcapCaptor.getPacket()方法来捕获数据包。

getPacket()只是简单返回一个捕获的数据包，可以多次使用getPacket()方法捕获连续的数据包。

            JpcapCaptor captor = JpcapCaptor.openDevice(devices[index], 65535, false, 20);
			for(int i=0; i<10; i++){
				System.out.println(i + ":" + captor.getPacket());
			}
			captor.close();

4.    设置捕获过滤器

在Jpcap中可以设置过滤器使得Jpcap不捕获不需要的数据包。例如：如果仅仅只需捕获TCP/IPv4数据包，就可以设置过滤器，其方法如下例所示：

			JpcapCaptor captor = JpcapCaptor.openDevice(devices[index], 65535, false, 20);
			captor.setFilter("ip and tcp", true);

过滤器表达式“ip and tcp”表示“只保留IPv4并且TCP数据包，并将其交付给应用”。过滤器的设置可以减少所需要处理的数据包并且提高应用的性能。

5.    将捕获的数据包存挡

可以将捕获的数据包写入一个二进制文件，事后使用Jpcap或支持tcpdump格式文件的其它应用程序进行查询。

存储捕获的数据包首先需要使用JpcapWriter.openDumpFile()打开一个文件，参数分别是用来捕获数据包的一个JpcapCaptor实例以及String文件名。

			JpcapCaptor captor = JpcapCaptor.openDevice(devices[index], 65535, false, 20);
			JpcapWriter writer = JpcapWriter.openDumpFile(captor, "yourfilename");

一旦通过openDumpFile()方法获得一个JpcapWriter的实例，就可以使用JpcapWriter.writePacket()存储捕获的数据包。

将所有要存储的数据都存储之后，必须使用JpcapWriter.close()方法关闭打开的文件。

			for(int i=0; i<10; i++){
				Packet packet = captor.getPacket();
				writer.writePacket(packet);
			}
			writer.close();

6.    读入文件中的数据包

在Jpcap中，可以使用JpcapCaptor.openFile()方法打开一个由JpcapWriter存储的文件，并从中读入数据包。

类似于JpcapCaptor.openDevice()方法，JpcapCaptor.openFile()方法将返回一个JpcapCaptor类的实例，因此可以使用“从网络接口捕获数据包”中描述的方式来从文件中读取数据包。

7.    通过网络接口发送数据包

发送一个数据包首先需要调用JacapSender.openDevice()或JacapSender.getJpcapSenderInstance()方法。

一旦获得一个JpcapSender实例，就可以将Packet类实例传递给JpcapSender.sendPacket()方法。

来自为知笔记(Wiz)