com.hazelcast.spi.hotrestart

Interface RamStore

public interface RamStore

Specifies operations that the Hot Restart store will request from the RAM store. A RAM store is an abstraction over the regular Hazelcast in-memory store of the data which is additionally managed by a Hot Restart store.

Method Summary

Modifier and Type	Method and Description
void	accept(KeyHandle kh, byte[] value) Called during Hot Restart.
boolean	copyEntry(KeyHandle kh, int expectedSize, RecordDataSink bufs) Copies the key/value bytes into the corresponding byte buffers provided by the supplied RecordDataSink.
void	removeNullEntries(SetOfKeyHandle keyHandles) Called during Hot Restart.
KeyHandle	toKeyHandle(byte[] key) Called during Hot Restart.

Method Detail

copyEntry

boolean copyEntry(KeyHandle kh,
                  int expectedSize,
                  RecordDataSink bufs)
           throws HotRestartException

Copies the key/value bytes into the corresponding byte buffers provided by the supplied RecordDataSink. Before copying checks that the actual size of the record matches the value of the expectedSize parameter. If it doesn't match, the method returns false.

If this method returns true, then the data stored from 0 to position of the key and value buffers represents the key and value data of the record.

If this method returns false, the state of the byte buffers is unspecified.

The caller must ensure that the buffers returned from RecordDataSink initially have position == 0.

This method must not acquire any locks which may be held while calling any of the HotRestartStore's methods.

Parameters:

expectedSize - the expected size of the record (key + value).

Throws:

HotRestartException - if a record identified by the supplied key handle was not found

toKeyHandle

KeyHandle toKeyHandle(byte[] key)

Called during Hot Restart. Requests a handle object for the given key bytes.

Returns:

the key handle identifying the supplied key bytes.

accept

void accept(KeyHandle kh,
            byte[] value)

Called during Hot Restart. Allows the RAM store to re-establish a mapping from the supplied key to the supplied value.

removeNullEntries

void removeNullEntries(SetOfKeyHandle keyHandles)

Called during Hot Restart. Gives the RAM store a set of key handles which can be removed because they have null-values.