public interface Chronicle extends Closeable
Using non-heap storage options Chronicle provides a processing environment where applications does not suffer from GarbageCollection. GarbageCollection (GC) may slow down your critical operations non-deterministically at any time.. In order to avoid non-determinism and escape from GC delays off-heap memory solutions are addressed. The main idea is to manage your memory manually so does not suffer from GC. Chronicle behaves like a management interface over off-heap memory so you can build your own solutions over it.
Chronicle uses RandomAccessFiles while managing memory and this choice brings lots of possibility. Random access files permit non-sequential, or random, access to a file's contents. To access a file randomly, you open the file, seek a particular location, and read from or write to that file. RandomAccessFiles can be seen as "large" C-type byte arrays that you can access any random index "directly" using pointers. File portions can be used as ByteBuffers if the portion is mapped into memory.
Chronicle
(now in the specific sense) is the
main interface for management and can be seen as the "Collection class" of the
Chronicle environment. You will reserve a portion of memory and then
put/fetch/update records using the Chronicle
interface.
Excerpt
is the main data container in a
Chronicle
, each Chronicle is composed of Excerpts.
Putting data to a chronicle means starting a new Excerpt, writing data into it and finishing
the Excerpt at the end.
While Excerpt
is a generic purpose container allowing
for remote access, it also has more specialized counterparts for sequential operations.
See ExcerptTailer
and ExcerptAppender
Modifier and Type | Method and Description |
---|---|
void |
clear() |
ExcerptAppender |
createAppender() |
Excerpt |
createExcerpt() |
ExcerptTailer |
createTailer() |
boolean |
isClosed() |
long |
lastIndex() |
long |
lastWrittenIndex() |
String |
name() |
long |
size() |
String name()
@NotNull Excerpt createExcerpt() throws IOException
IOException
@NotNull ExcerptTailer createTailer() throws IOException
IOException
@NotNull ExcerptAppender createAppender() throws IOException
IOException
long lastIndex()
long lastWrittenIndex()
long size()
void clear()
boolean isClosed()
Copyright © 2017. All rights reserved.