freenet.client

Class OnionFECCodec

java.lang.Object

freenet.client.FECCodec

freenet.client.OnionFECCodec

public class OnionFECCodec
extends FECCodec

Field Summary

Fields inherited from class freenet.client.FECCodec

MAX_TOTAL_BLOCKS_PER_SEGMENT, MIN_MEMORY_ALLOCATION

Constructor Summary

Constructors

Constructor and Description
OnionFECCodec()

Method Summary

Modifier and Type	Method and Description
void	decode(byte[][] dataBlocks, byte[][] checkBlocks, boolean[] dataBlocksPresent, boolean[] checkBlocksPresent, int blockLength) Execute a FEC decode.
void	encode(byte[][] dataBlocks, byte[][] checkBlocks, boolean[] checkBlocksPresent, int blockLength) Execute a FEC encode.
int	getCheckBlocks(int dataBlocks, InsertContext.CompatibilityMode compatibilityMode) Get the recommended number of check blocks per segment for a given number of data blocks for a given compatibility mode.
long	maxMemoryOverheadDecode(int dataBlocks, int checkBlocks) Maximum memory usage with the given number of data blocks and check blocks, not including the blocks themselves.
long	maxMemoryOverheadEncode(int dataBlocks, int checkBlocks) Maximum memory usage with the given number of data blocks and check blocks, not including the blocks themselves.

Methods inherited from class freenet.client.FECCodec

getInstance

Methods inherited from class java.lang.Object

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

Constructor Detail

OnionFECCodec

public OnionFECCodec()

Method Detail

decode

public void decode(byte[][] dataBlocks,
                   byte[][] checkBlocks,
                   boolean[] dataBlocksPresent,
                   boolean[] checkBlocksPresent,
                   int blockLength)

Description copied from class: FECCodec

Execute a FEC decode. On exiting the function we will have all the data blocks.

Specified by:

decode in class FECCodec

Parameters:

dataBlocks - The byte[]'s for storing the data blocks. Must all be non-null. Which have valid contents is indicated by dataBlocksPresent. When exit this function, they will be filled with the data blocks in the correct order.

checkBlocks - The byte[]'s for storing the check blocks. Which have valid contents is indicated by checkBlocksPresent.

dataBlocksPresent - Indicates which data blocks were present before decoding. (Will not be changed by this function).

checkBlocksPresent - Indicates which check blocks are present before decoding. (Will not be changed by this function).

blockLength - The length of any and all blocks. Padding must be handled by the caller if it is necessary.

encode

public void encode(byte[][] dataBlocks,
                   byte[][] checkBlocks,
                   boolean[] checkBlocksPresent,
                   int blockLength)

Description copied from class: FECCodec

Execute a FEC encode. On entering, we must have all the data blocks. On exiting, we will have all the check blocks as well.

Specified by:

encode in class FECCodec

Parameters:

dataBlocks - All the data blocks, which all have valid contents.

checkBlocks - The byte[]'s for storing the encoded check blocks. Must all be non-null.

checkBlocksPresent - Indicates which check blocks have already been encoded.

maxMemoryOverheadDecode

public long maxMemoryOverheadDecode(int dataBlocks,
                                    int checkBlocks)

Description copied from class: FECCodec

Maximum memory usage with the given number of data blocks and check blocks, not including the blocks themselves.

Specified by:

maxMemoryOverheadDecode in class FECCodec

maxMemoryOverheadEncode

public long maxMemoryOverheadEncode(int dataBlocks,
                                    int checkBlocks)

Description copied from class: FECCodec

Maximum memory usage with the given number of data blocks and check blocks, not including the blocks themselves.

Specified by:

maxMemoryOverheadEncode in class FECCodec

getCheckBlocks

public int getCheckBlocks(int dataBlocks,
                          InsertContext.CompatibilityMode compatibilityMode)

Description copied from class: FECCodec

Get the recommended number of check blocks per segment for a given number of data blocks for a given compatibility mode.

Specified by:

getCheckBlocks in class FECCodec

Parameters:

dataBlocks - The number of data blocks per segment.

compatibilityMode - The compatibility mode (so we can exactly mimic the behaviour of older builds when reinserting files).