org.jlibrtp

Class PktBuffer

java.lang.Object

org.jlibrtp.PktBuffer

public class PktBuffer
extends java.lang.Object

A PktBuffer stores packets either for buffering purposes, or because they need to be assimilated to create a complete frame. This behavior can be controlled through rtpSession.pktBufBehavior() It optionally drops duplicate packets. Note that newest is the most recently received, i.e. highest timeStamp Next means new to old (from recently received to previously received)

Author:

Arne Kepp

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	PktBuffer(RTPSession rtpSession, Participant p, RtpPkt aPkt) Creates a new PktBuffer, a linked list of PktBufNode

Method Summary

Modifier and Type	Method and Description
protected int	addPkt(RtpPkt aPkt) Adds a packet, this happens in constant time if they arrive in order.
protected void	debugPrint() Prints out the packet buffer, oldest node first (on top).
protected int	getLength() Returns the length of the packetbuffer.
protected boolean	pktOnTime(long timeStamp, int seqNum) Checks whether a packet is not too late, i.e.
protected DataFrame	popOldestFrame() Checks the oldest frame, if there is one, sees whether it is complete.

Methods inherited from class java.lang.Object

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

Constructor Detail

PktBuffer

protected PktBuffer(RTPSession rtpSession,
                    Participant p,
                    RtpPkt aPkt)

Creates a new PktBuffer, a linked list of PktBufNode

Parameters:

rtpSession - the parent RTPSession

p - the participant to which this packetbuffer belongs.

aPkt - The first RTP packet, to be added to the buffer

Method Detail

addPkt

protected int addPkt(RtpPkt aPkt)

Adds a packet, this happens in constant time if they arrive in order. Optimized for the case where each pkt is a complete frame.

Parameters:

aPkt - the packet to be added to the buffer.

Returns:

integer, negative if operation failed (see code)

popOldestFrame

protected DataFrame popOldestFrame()

Checks the oldest frame, if there is one, sees whether it is complete.

Returns:

Returns null if there are no complete frames available.

getLength

protected int getLength()

Returns the length of the packetbuffer.

Returns:

number of frames (complete or not) in packetbuffer.

pktOnTime

protected boolean pktOnTime(long timeStamp,
                            int seqNum)

Checks whether a packet is not too late, i.e. the next packet has already been returned.

Parameters:

timeStamp - the RTP timestamp of the packet under consideration

seqNum - the sequence number of the packet under consideration

Returns:

true if newer packets have not been handed to the application

debugPrint

protected void debugPrint()

Prints out the packet buffer, oldest node first (on top).