net.java.otr4j.session

Class OtrFragmenter

java.lang.Object

net.java.otr4j.session.OtrFragmenter

public class OtrFragmenter
extends Object

OTR fragmenter. TODO It may be better to separate the v2 and v3 implementations into specialized classes.

Author:

Danny van Heumen

Constructor Summary

Constructors

Constructor and Description
OtrFragmenter(Session session, OtrEngineHost host) Constructor.

Method Summary

Modifier and Type	Method and Description
String[]	fragment(String message) Fragment the given message into pieces as specified by the FragmenterInstructions instance.
OtrEngineHost	getHost() Get instructions for fragmentation behaviour.
int	numberOfFragments(String message) Calculate the number of fragments that are required for the message to be sent fragmented completely.

Methods inherited from class java.lang.Object

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

Constructor Detail

OtrFragmenter

public OtrFragmenter(Session session,
                     OtrEngineHost host)

Constructor.

Parameters:

session - session instance (cannot be null)

host - OTR engine host calling upon OTR session

Method Detail

getHost

public OtrEngineHost getHost()

Get instructions for fragmentation behaviour.

Returns:

returns instructions

numberOfFragments

public int numberOfFragments(String message)
                      throws IOException

Calculate the number of fragments that are required for the message to be sent fragmented completely.

Parameters:

message - the original message

Returns:

returns the number of fragments required

Throws:

IOException - throws an IOException in case fragment size is too small to store any content or when the provided policy does not support fragmentation, for example if only OTRv1 is allowed.

fragment

public String[] fragment(String message)
                  throws IOException

Fragment the given message into pieces as specified by the FragmenterInstructions instance.

Parameters:

message - the original message

Returns:

returns an array of message fragments. The array will contain at least 1 message fragment, or more if fragmentation is necessary.

Throws:

IOException - throws an IOException if the fragment size is too small or if the maximum number of fragments is exceeded.