net.openhft.chronicle.queue.impl.single

Class SingleChronicleQueue

java.lang.Object

net.openhft.chronicle.queue.impl.single.SingleChronicleQueue

All Implemented Interfaces:

Closeable, AutoCloseable, ChronicleQueue, RollingChronicleQueue

public class SingleChronicleQueue
extends Object
implements RollingChronicleQueue

Field Summary

Fields

Modifier and Type	Field and Description
protected ThreadLocal<ExcerptAppender>	excerptAppenderThreadLocal
protected int	sourceId
static String	SUFFIX

Fields inherited from interface net.openhft.chronicle.queue.ChronicleQueue

TEST_BLOCK_SIZE

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	SingleChronicleQueue(SingleChronicleQueueBuilder builder)

Method Summary

Modifier and Type	Method and Description
long	blockSize()
long	bufferCapacity()
boolean	buffered()
void	clear() Remove all the entries in the queue.
void	close()
ExcerptAppender	createAppender() An Appender can be used to writeBytes new excerpts sequentially to the upper.
ExcerptTailer	createTailer()
int	cycle()
String	dump() Dump a Queue in YAML format.
void	dump(Writer writer, long fromIndex, long toIndex) Dump a range of entries to a Writer
long	epoch()
net.openhft.chronicle.core.threads.EventLoop	eventLoop()
File	file()
int	firstCycle()
long	firstIndex()
int	indexCount()
int	indexSpacing()
int	lastCycle()
protected ExcerptAppender	newAppender()
long	nextIndexToWrite()
java.util.function.Consumer<net.openhft.chronicle.bytes.BytesRingBufferStats>	onRingBufferStats()
StoreRecoveryFactory	recoverySupplier()
void	release(WireStore store)
RollCycle	rollcycle()
RollCycle	rollCycle()
int	sourceId()
WireStore	storeForCycle(int cycle, long epoch, boolean createIfAbsent)
String	toString()
net.openhft.chronicle.wire.WireType	wireType()

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.openhft.chronicle.queue.ChronicleQueue

dump

Methods inherited from interface net.openhft.chronicle.core.io.Closeable

closeQuietly, isClosed, notifyClosing

Field Detail

SUFFIX

public static final String SUFFIX

See Also:

Constant Field Values

excerptAppenderThreadLocal

protected final ThreadLocal<ExcerptAppender> excerptAppenderThreadLocal

sourceId

protected final int sourceId

Constructor Detail

SingleChronicleQueue

protected SingleChronicleQueue(@NotNull
                               SingleChronicleQueueBuilder builder)

Method Detail

sourceId

public int sourceId()

Specified by:

sourceId in interface ChronicleQueue

rollcycle

public RollCycle rollcycle()

Specified by:

rollcycle in interface ChronicleQueue

clear

public void clear()

Description copied from interface: ChronicleQueue

Remove all the entries in the queue.

Specified by:

clear in interface ChronicleQueue

file

@NotNull
public File file()

Specified by:

file in interface ChronicleQueue

Returns:

the base path where ChronicleQueue stores its data.

dump

public String dump()

Description copied from interface: ChronicleQueue

Dump a Queue in YAML format.

Specified by:

dump in interface ChronicleQueue

Returns:

the contents of the Queue as YAML.

dump

public void dump(Writer writer,
                 long fromIndex,
                 long toIndex)

Description copied from interface: ChronicleQueue

Dump a range of entries to a Writer

Specified by:

dump in interface ChronicleQueue

Parameters:

writer - to write to

fromIndex - first index to include

toIndex - last index to include.

indexCount

public int indexCount()

Specified by:

indexCount in interface ChronicleQueue

indexSpacing

public int indexSpacing()

Specified by:

indexSpacing in interface ChronicleQueue

epoch

public long epoch()

Specified by:

epoch in interface RollingChronicleQueue

rollCycle

@NotNull
public RollCycle rollCycle()

Specified by:

rollCycle in interface RollingChronicleQueue

recoverySupplier

public StoreRecoveryFactory recoverySupplier()

Specified by:

recoverySupplier in interface RollingChronicleQueue

buffered

public boolean buffered()

Returns:

if we uses a ring buffer to buffer the appends, the Excerpts are written to the Chronicle Queue using a background thread

eventLoop

@Nullable
public net.openhft.chronicle.core.threads.EventLoop eventLoop()

newAppender

protected ExcerptAppender newAppender()

createAppender

@NotNull
public ExcerptAppender createAppender()

Description copied from interface: ChronicleQueue

An Appender can be used to writeBytes new excerpts sequentially to the upper.

Specified by:

createAppender in interface ChronicleQueue

Returns:

A thread local Appender for writing new entries to the end.

createTailer

@NotNull
public ExcerptTailer createTailer()

Specified by:

createTailer in interface ChronicleQueue

Returns:

a new ExcerptTailer to read sequentially.

storeForCycle

@Nullable
public final WireStore storeForCycle(int cycle,
                                               long epoch,
                                               boolean createIfAbsent)

Specified by:

storeForCycle in interface RollingChronicleQueue

Parameters:

cycle - the cycle

epoch - an epoch offset as the number of number of milliseconds since January 1, 1970, 00:00:00 GMT

createIfAbsent - create missing stores if true, or return null if missing

Returns:

the WireStore associated with this cycle, or null if !createIfAbsent is false and absent

close

public void close()

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

release

public final void release(@NotNull
                          WireStore store)

Specified by:

release in interface RollingChronicleQueue

Parameters:

store - the store to release

cycle

public final int cycle()

Specified by:

cycle in interface RollingChronicleQueue

Returns:

the current cycle

firstIndex

public long firstIndex()

Specified by:

firstIndex in interface ChronicleQueue

Returns:

the lowest valid index available, or Long.MAX_VALUE if none are found

firstCycle

public int firstCycle()

Specified by:

firstCycle in interface RollingChronicleQueue

Returns:

the first cycle number found, or Integer.MAX_VALUE is none found.

nextIndexToWrite

public long nextIndexToWrite()

Specified by:

nextIndexToWrite in interface ChronicleQueue

Returns:

the index of next index to be written if roll doesn't occur. Or Long.MIN_VALUE if none available. The lowest 40bits of the index refers to the sequence number with the cycle, giving a maximum of 1099511627776 excerpt per cycle. Each cycle has its own file. Each file holds its own index. You can discard the old files ( if they are no longer used ). The other highest 24 bits
 of the index are used for the cycle number (this equates to the filename), giving a maximum
 of 16777216 cycles ( aka files )

lastCycle

public int lastCycle()

Specified by:

lastCycle in interface RollingChronicleQueue

Returns:

the lastCycle available or Integer.MIN_VALUE if none is found.

onRingBufferStats

public java.util.function.Consumer<net.openhft.chronicle.bytes.BytesRingBufferStats> onRingBufferStats()

blockSize

public long blockSize()

wireType

@NotNull
public net.openhft.chronicle.wire.WireType wireType()

Specified by:

wireType in interface ChronicleQueue

Returns:

the type of wire used, for example WireTypes.TEXT or WireTypes.BINARY

bufferCapacity

public long bufferCapacity()

toString

public String toString()

Overrides:

toString in class Object