org.pcap4j.packet.factory

Class StaticUnknownPacketFactory

java.lang.Object

org.pcap4j.packet.factory.StaticUnknownPacketFactory

All Implemented Interfaces:

PacketFactory<Packet,NamedNumber<?,?>>

public final class StaticUnknownPacketFactory
extends java.lang.Object
implements PacketFactory<Packet,NamedNumber<?,?>>

Since:

pcap4j 0.9.14

Author:

Kaito Yamada

Method Summary

Modifier and Type	Method and Description
static StaticUnknownPacketFactory	getInstance()
Packet	newInstance(byte[] rawData, int offset, int length, NamedNumber<?,?>... numbers) A factory method to build a packet or a packet field.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getInstance

public static StaticUnknownPacketFactory getInstance()

Returns:

the singleton instance of StaticUnknownPacketFactory.

newInstance

public Packet newInstance(byte[] rawData,
                          int offset,
                          int length,
                          NamedNumber<?,?>... numbers)

Description copied from interface: PacketFactory

A factory method to build a packet or a packet field. The numbers are used as hints during the build. If no number is given, this method usually return an object which just wraps the specified part of the rawData without dissection. If one or more numbers are given, this method attempts to find a concrete class corresponding to the number for each of them in the order given. The class this method first find will be instantiated and returned. If no class is found, this method behaves in the same way as no number was given. This method doesn't throw IllegalRawDataException. Instead, if an IllegalRawDataException occurred during a packet dissection, this instantiates IllegalRawDataPacket (if T is Packet) or IllegalRawDataHolder (if T is not Packet) and returns it.

Specified by:

newInstance in interface PacketFactory<Packet,NamedNumber<?,?>>

Parameters:

rawData - a byte array including data this method will use for building a T instance.

offset - offset of the data in the rawData.

length - length of the data. The object to be returned is not required to use or represent entire data. It means this length is not required to be exactly same as the returning object's length, but is required to be not smaller than it.

numbers - NamedNumber instances this method will refer to in order to decide which concrete class to instantiate during building a T instance.

Returns:

a new packet or packet field object.