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
static String	SUFFIX

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.
long	epoch()
net.openhft.chronicle.core.threads.EventLoop	eventLoop()
int	firstCycle()
long	firstIndex()
int	indexCount()
int	indexSpacing()
int	lastCycle()
long	lastIndex()
protected ExcerptAppender	newAppender()
java.util.function.Consumer<net.openhft.chronicle.bytes.BytesRingBufferStats>	onRingBufferStats()
File	path()
void	release(WireStore store)
RollCycle	rollCycle()
WireStore	storeForCycle(long cycle, long epoch)
net.openhft.chronicle.wire.WireType	wireType()

Methods inherited from class java.lang.Object

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

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

closeQuietly, notifyClosing

Field Detail

SUFFIX

public static final String SUFFIX

See Also:

Constant Field Values

excerptAppenderThreadLocal

protected final ThreadLocal<ExcerptAppender> excerptAppenderThreadLocal

Constructor Detail

SingleChronicleQueue

protected SingleChronicleQueue(@NotNull
                               SingleChronicleQueueBuilder builder)

Method Detail

clear

public void clear()

Description copied from interface: ChronicleQueue

Remove all the entries in the queue.

Specified by:

clear in interface ChronicleQueue

path

@NotNull
public File path()

Specified by:

path 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.

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

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

@NotNull
public final WireStore storeForCycle(long cycle,
                                              long epoch)

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

Returns:

the WireStore associated with this cycle

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.

lastIndex

public long lastIndex()

Specified by:

lastIndex in interface ChronicleQueue

Returns:

the index one more than the highest valid index immediately available. 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()