io.pkts.framer

Class EthernetFramer

java.lang.Object

io.pkts.framer.EthernetFramer

All Implemented Interfaces:

Framer<PCapPacket,MACPacket>

public class EthernetFramer
extends Object
implements Framer<PCapPacket,MACPacket>

Simple framer for framing Ethernet frames

Author:

jonas@jonasborjesson.com

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	EthernetFramer.EtherType

Constructor Summary

Constructors

Constructor and Description
EthernetFramer()

Method Summary

Modifier and Type	Method and Description
boolean	accept(Buffer data) Check whether the supplied data could be framed into a frame of this type.
MACPacket	frame(PCapPacket parent, Buffer buffer) Ask the framer to frame the buffer into a packet.
static EthernetFramer.EtherType	getEtherType(byte b1, byte b2)
static EthernetFramer.EtherType	getEtherTypeSafe(byte b1, byte b2)
Protocol	getProtocol()

Methods inherited from class java.lang.Object

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

Constructor Detail

EthernetFramer

public EthernetFramer()

Method Detail

getProtocol

public Protocol getProtocol()

Specified by:

getProtocol in interface Framer<PCapPacket,MACPacket>

Returns:

the protocol this framer is capable of framing

frame

public MACPacket frame(PCapPacket parent,
                       Buffer buffer)
                throws IOException,
                       FramingException

Ask the framer to frame the buffer into a packet. Note that the Packet has not been parsed, just framed.

Specified by:

frame in interface Framer<PCapPacket,MACPacket>

Parameters:

parent - the parent frame or null if the frame doesn't have one.

buffer - the buffer containing all the raw data

Returns:

a new frame

Throws:

IOException - in case something goes wrong when reading data from the buffer

FramingException - in case the data in buffer can't be parsed by the framer

getEtherType

public static EthernetFramer.EtherType getEtherType(byte b1,
                                                    byte b2)
                                             throws UnknownEtherType

Throws:

UnknownEtherType

getEtherTypeSafe

public static EthernetFramer.EtherType getEtherTypeSafe(byte b1,
                                                        byte b2)

accept

public boolean accept(Buffer data)

Description copied from interface: Framer

Check whether the supplied data could be framed into a frame of this type. Typically, a Framer will read a few bytes in an effort to figure out if the incoming data may be something it recognizes. E.g., a HTTP Framer could check if the first bytes match "GET", "POST", "PUT" and "DELETE" if if so assume that the payload indeed is HTTP and therefore return true. Of course, you may never really know until you actually have parsed the entire body but this method should return quick and if turns out that the data isn't what it thought, throw an exception and the framework will take care of it.

Specified by:

accept in interface Framer<PCapPacket,MACPacket>

Parameters:

data - the data to check whether it could be a frame of this type

Returns:

true if the data indeed could be of this framer type, false if not