net.named_data.jndn.util

Class ExponentialReExpress

java.lang.Object

net.named_data.jndn.util.ExponentialReExpress

All Implemented Interfaces:

OnTimeout

public class ExponentialReExpress
extends Object
implements OnTimeout

An ExponentialReExpress uses an internal onTimeout to express the interest again with double the interestLifetime. See ExponentialReExpress.makeOnTimeout.

Method Summary

Modifier and Type	Method and Description
static OnTimeout	makeOnTimeout(Face face, OnData onData, OnTimeout onTimeout) Return an OnTimeout object to use in expressInterest for onTimeout which will express the interest again with double the interestLifetime.
static OnTimeout	makeOnTimeout(Face face, OnData onData, OnTimeout onTimeout, double maxInterestLifetime) Return an OnTimeout object to use in expressInterest for onTimeout which will express the interest again with double the interestLifetime.
void	onTimeout(Interest interest) If the interest times out according to the interest lifetime, onTimeout is called.

Methods inherited from class java.lang.Object

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

Method Detail

makeOnTimeout

public static OnTimeout makeOnTimeout(Face face,
                                      OnData onData,
                                      OnTimeout onTimeout,
                                      double maxInterestLifetime)

Return an OnTimeout object to use in expressInterest for onTimeout which will express the interest again with double the interestLifetime. If the interesLifetime goes over maxInterestLifetime (see below), then call the provided onTimeout. If a Data packet is received, this calls the provided onData.

Parameters:

face - This calls face.expressInterest.

onData - When a matching data packet is received, this calls onData.onData(interest, data) where interest is the interest given to expressInterest and data is the received Data object. This is normally the same onData you initially passed to expressInterest. NOTE: The library will log any exceptions thrown by this callback, but for better error handling the callback should catch and properly handle any exceptions.

onTimeout - If the interesLifetime goes over maxInterestLifetime, this calls onTimeout.onTimeout(interest). However, if onTimeout is null, this does not use it. NOTE: The library will log any exceptions thrown by this callback, but for better error handling the callback should catch and properly handle any exceptions.

maxInterestLifetime - The maximum lifetime in milliseconds for re-expressed interests.

Returns:

The OnTimeout object to pass to expressInterest.

makeOnTimeout

public static OnTimeout makeOnTimeout(Face face,
                                      OnData onData,
                                      OnTimeout onTimeout)

Return an OnTimeout object to use in expressInterest for onTimeout which will express the interest again with double the interestLifetime. If the interesLifetime goes over 16000 milliseconds, then call the provided onTimeout. If a Data packet is received, this calls the provided onData.

Parameters:

face - This calls face.expressInterest.

onData - When a matching data packet is received, this calls onData.onData(interest, data) where interest is the interest given to expressInterest and data is the received Data object. This is normally the same onData you initially passed to expressInterest. NOTE: The library will log any exceptions thrown by this callback, but for better error handling the callback should catch and properly handle any exceptions.

onTimeout - If the interesLifetime goes over 16000 milliseconds, this calls onTimeout.onTimeout(interest). However, if onTimeout is null, this does not use it. NOTE: The library will log any exceptions thrown by this callback, but for better error handling the callback should catch and properly handle any exceptions.

Returns:

The OnTimeout object to pass to expressInterest.

onTimeout

public void onTimeout(Interest interest)

Description copied from interface: OnTimeout

If the interest times out according to the interest lifetime, onTimeout is called.

Specified by:

onTimeout in interface OnTimeout

Parameters:

interest - The interest given to expressInterest.