org.saltyrtc.chunkedDc

Class Unchunker

java.lang.Object

org.saltyrtc.chunkedDc.Unchunker

public class Unchunker
extends java.lang.Object

An Unchunker instance merges multiple chunks into a single ByteBuffer. It keeps track of IDs, so only one Unchunker instance is necessary to receive multiple messages.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	Unchunker.MessageListener Interface for message listeners.

Constructor Summary

Constructors

Constructor and Description
Unchunker()

Method Summary

Modifier and Type	Method and Description
void	add(java.nio.ByteBuffer buf) Add a chunk.
int	gc(long maxAge) Run garbage collection, remove incomplete messages that haven't been updated for more than the specified number of milliseconds.
void	onMessage(Unchunker.MessageListener listener) Register an onMessage listener.

Methods inherited from class java.lang.Object

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

Constructor Detail

Unchunker

public Unchunker()

Method Detail

onMessage

public void onMessage(Unchunker.MessageListener listener)

Register an onMessage listener.

add

public void add(java.nio.ByteBuffer buf)

Add a chunk.

Parameters:

buf - ByteBuffer containing chunk with 9 byte header.

Throws:

java.lang.IllegalArgumentException - if message is smaller than the header length

gc

public int gc(long maxAge)

Run garbage collection, remove incomplete messages that haven't been updated for more than the specified number of milliseconds. If you want to make sure that invalid chunks don't fill up memory, call this method regularly.

Parameters:

maxAge - Remove incomplete messages that haven't been updated for more than the specified number of milliseconds.

Returns:

the number of removed chunks.