net.named_data.jndn.in_memory_storage

Class InMemoryStorageRetaining

java.lang.Object

net.named_data.jndn.in_memory_storage.InMemoryStorageRetaining

public class InMemoryStorageRetaining
extends Object

InMemoryStorageRetaining provides an application cache with in-memory storage, of which no eviction policy will be employed. Entries will only be evicted by explicit application control. Note: In ndn-cxx, this class is called InMemoryStoragePersistent, but "persistent" misleadingly sounds like persistent on-disk storage.

Constructor Summary

Constructors

Constructor and Description
InMemoryStorageRetaining()

Method Summary

Modifier and Type	Method and Description
Data	find(Interest interest) Find the best match Data for an Interest.
HashMap	getCache_() Get the the storage cache, which should only be used for testing.
void	insert(Data data) Insert a Data packet.
void	remove(Name prefix) Remove matching entries by prefix.
int	size() Get the number of packets stored in the in-memory storage.

Methods inherited from class java.lang.Object

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

Constructor Detail

InMemoryStorageRetaining

public InMemoryStorageRetaining()

Method Detail

insert

public void insert(Data data)
            throws EncodingException

Insert a Data packet. If a Data packet with the same name, including the implicit digest, already exists, replace it.

Parameters:

data - The packet to insert, which is copied.

Throws:

EncodingException - for error encoding the Data packet to get the implicit digest.

find

public Data find(Interest interest)

Find the best match Data for an Interest.

Parameters:

interest - The Interest with the Name of the Data packet to find.

Returns:

The best match if any, otherwise null. You should not modify the returned object. If you need to modify it then you must make a copy.

remove

public final void remove(Name prefix)

Remove matching entries by prefix.

Parameters:

prefix - The prefix Name of the entries to remove.

size

public int size()

Get the number of packets stored in the in-memory storage.

Returns:

The number of packets.

getCache_

public final HashMap getCache_()

Get the the storage cache, which should only be used for testing.

Returns:

The storage cache.