AbstractChronicleQueueBuilder (OpenHFT/Chronicle-Queue 5.16.11 API)

java.lang.Object
- net.openhft.chronicle.queue.impl.AbstractChronicleQueueBuilder<B,Q>

All Implemented Interfaces:

Cloneable, net.openhft.chronicle.core.io.Resettable, ChronicleQueueBuilder<B,Q>, net.openhft.chronicle.wire.Marshallable, net.openhft.chronicle.wire.ReadMarshallable, net.openhft.chronicle.wire.WriteMarshallable, net.openhft.chronicle.wire.WriteValue

Direct Known Subclasses:

SingleChronicleQueueBuilder
```
public abstract class AbstractChronicleQueueBuilder
extends Object
implements ChronicleQueueBuilder<B,Q>, net.openhft.chronicle.wire.Marshallable
```

Field Summary

Fields
Modifier and Type	Field and Description
`protected Long`	`blockSize`
`protected CycleCalculator`	`cycleCalculator`
`static String`	`DEFAULT_ROLL_CYCLE_PROPERTY`
`protected Long`	`epoch`
`protected net.openhft.chronicle.core.threads.EventLoop`	`eventLoop`
`protected File`	`path`
`BufferMode`	`readBufferMode`
`protected Boolean`	`readOnly`
`protected RollCycle`	`rollCycle`
`protected WireStoreFactory`	`storeFactory`
`protected net.openhft.chronicle.wire.WireType`	`wireType`
`BufferMode`	`writeBufferMode`

Fields inherited from interface net.openhft.chronicle.wire.WriteMarshallable
EMPTY

Fields inherited from interface net.openhft.chronicle.wire.ReadMarshallable
DISCARD

Constructor Summary

Constructors
Modifier Constructor and Description

protected AbstractChronicleQueueBuilder()

AbstractChronicleQueueBuilder(File path)

Constructors
Modifier	Constructor and Description
`protected`	`AbstractChronicleQueueBuilder()`
	`AbstractChronicleQueueBuilder(File path)`

Method Summary

All Methods Instance Methods Abstract Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`long`	`blockSize()`
`B`	`blockSize(int blockSize)` you should make sure that your largest message size is no larger than 1/4 of your block size
`B`	`blockSize(long blockSize)`
`long`	`bufferCapacity()`
`B`	`bufferCapacity(long bufferCapacity)`
`boolean`	`buffered()` Deprecated.
`B`	`buffered(boolean isBuffered)` Deprecated.
`B`	`clone()`
`CycleCalculator`	`cycleCalculator()`
`AbstractChronicleQueueBuilder`	`decryptSupplier(Supplier<Cipher> decryptSupplier)`
`boolean`	`enableRingBufferMonitoring()`
`B`	`enableRingBufferMonitoring(boolean enableRingBufferMonitoring)`
`AbstractChronicleQueueBuilder`	`encryptSupplier(Supplier<Cipher> encryptSupplier)`
`long`	`epoch()`
`B`	`epoch(long epoch)` sets epoch offset in milliseconds
`net.openhft.chronicle.core.threads.EventLoop`	`eventLoop()`
`B`	`eventLoop(net.openhft.chronicle.core.threads.EventLoop eventLoop)`
`protected org.slf4j.Logger`	`getLogger()`
`boolean`	`hasBlockSize()`
`boolean`	`hasPretouchIntervalMillis()`
`int`	`indexCount()`
`B`	`indexCount(int indexCount)`
`int`	`indexSpacing()`
`B`	`indexSpacing(int indexSpacing)`
`protected abstract void`	`initializeMetadata()`
`Consumer<net.openhft.chronicle.bytes.BytesRingBufferStats>`	`onRingBufferStats()`
`B`	`onRingBufferStats(Consumer<net.openhft.chronicle.bytes.BytesRingBufferStats> onRingBufferStats)` consumer will be called every second, also as there is data to report
`File`	`path()`
`B`	`path(File path)`
`Supplier<net.openhft.chronicle.threads.TimingPauser>`	`pauserSupplier()`
`B`	`pauserSupplier(Supplier<net.openhft.chronicle.threads.TimingPauser> pauser)`
`protected void`	`preBuild()`
`BufferMode`	`readBufferMode()`
`B`	`readBufferMode(BufferMode readBufferMode)`
`boolean`	`readOnly()`
`B`	`readOnly(boolean readOnly)`
`StoreRecoveryFactory`	`recoverySupplier()`
`B`	`recoverySupplier(StoreRecoveryFactory recoverySupplier)`
`RollCycle`	`rollCycle()`
`B`	`rollCycle(RollCycle rollCycle)`
`B`	`rollTime(LocalTime time, ZoneId zoneId)` Resets the rollTime for the queue cycle to a new time.
`int`	`sourceId()`
`B`	`sourceId(int sourceId)`
`StoreFileListener`	`storeFileListener()`
`B`	`storeFileListener(StoreFileListener storeFileListener)`
`boolean`	`strongAppenders()`
`B`	`strongAppenders(boolean strongAppenders)` Hold a strong reference to any appender instead of a weak one which prevents GC if the thread and queue exists.
`long`	`timeoutMS()`
`B`	`timeoutMS(long timeoutMS)`
`net.openhft.chronicle.core.time.TimeProvider`	`timeProvider()`
`B`	`timeProvider(net.openhft.chronicle.core.time.TimeProvider timeProvider)`
`net.openhft.chronicle.wire.WireType`	`wireType()`
`B`	`wireType(net.openhft.chronicle.wire.WireType wireType)`
`BufferMode`	`writeBufferMode()`
`B`	`writeBufferMode(BufferMode writeBufferMode)`

Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface net.openhft.chronicle.queue.ChronicleQueueBuilder
build, path, setAllNullFields, single, single, single, singleText, storeFactory, testBlockSize

Methods inherited from interface net.openhft.chronicle.wire.Marshallable
$equals, $fieldInfos, $hashCode, $toString, copyFrom, copyTo, deepCopy, fromFile, fromFile, fromFileAsMap, fromFileAsMap, fromHexString, fromString, fromString, fromString, getClassName, getField, mergeToMap, readMarshallable, reset, setField, streamFromFile, streamFromFile, writeMarshallable

Methods inherited from interface net.openhft.chronicle.wire.WriteMarshallable
writeValue

Methods inherited from interface net.openhft.chronicle.wire.ReadMarshallable
unexpectedField

- Field Detail
 - path
```
protected File path
```
 - blockSize
```
protected Long blockSize
```
 - DEFAULT_ROLL_CYCLE_PROPERTY
```
public static final String DEFAULT_ROLL_CYCLE_PROPERTY
```
 See Also:
 
 Constant Field Values
 - wireType
```
protected net.openhft.chronicle.wire.WireType wireType
```
 - rollCycle
```
protected RollCycle rollCycle
```
 - epoch
```
protected Long epoch
```
 - writeBufferMode
```
public BufferMode writeBufferMode
```
 - readBufferMode
```
public BufferMode readBufferMode
```
 - eventLoop
```
@Nullable
protected net.openhft.chronicle.core.threads.EventLoop eventLoop
```
 - cycleCalculator
```
protected CycleCalculator cycleCalculator
```
 - storeFactory
```
protected WireStoreFactory storeFactory
```
 - readOnly
```
protected Boolean readOnly
```
- Constructor Detail
 - AbstractChronicleQueueBuilder
```
protected AbstractChronicleQueueBuilder()
```
 - AbstractChronicleQueueBuilder
```
public AbstractChronicleQueueBuilder(File path)
```
- Method Detail
 - hasBlockSize
```
public boolean hasBlockSize()
```
 Specified by:
 
 hasBlockSize in interface ChronicleQueueBuilder
 
 Returns:
 
 true if the bockSize has been set, Hence is non null
 - getLogger
```
protected org.slf4j.Logger getLogger()
```
 - cycleCalculator
```
@NotNull
public CycleCalculator cycleCalculator()
```
 Specified by:
 
 cycleCalculator in interface ChronicleQueueBuilder
 - path
```
public B path(File path)
```
 Specified by:
 
 path in interface ChronicleQueueBuilder
 - rollTime
```
public B rollTime(@NotNull
 LocalTime time,
 ZoneId zoneId)
```
 Description copied from interface: ChronicleQueueBuilder
 
 Resets the rollTime for the queue cycle to a new time.
 E.g. builder.rollTime(LocalTime.of(21, 0), ZoneId.of("UTC")) will cause the queue to roll cycles at 21:00 UTC, rather than the default roll-time of midnight UTC.
 
 Specified by:
 
 rollTime in interface ChronicleQueueBuilder
 
 Parameters:
 
 time - the new value for the time of day when the cycle should roll
 
 zoneId - the time-zone against which to base the roll-time
 
 Returns:
 
 the builder
 - onRingBufferStats
```
@NotNull
public B onRingBufferStats(@NotNull
 Consumer<net.openhft.chronicle.bytes.BytesRingBufferStats> onRingBufferStats)
```
 consumer will be called every second, also as there is data to report
 
 Specified by:
 
 onRingBufferStats in interface ChronicleQueueBuilder
 
 Parameters:
 
 onRingBufferStats - a consumer of the BytesRingBufferStats
 
 Returns:
 
 this
 - onRingBufferStats
```
@NotNull
public Consumer<net.openhft.chronicle.bytes.BytesRingBufferStats> onRingBufferStats()
```
 Specified by:
 
 onRingBufferStats in interface ChronicleQueueBuilder
 - path
```
@NotNull
public File path()
```
 Specified by:
 
 path in interface ChronicleQueueBuilder
 - blockSize
```
public B blockSize(long blockSize)
```
 Specified by:
 
 blockSize in interface ChronicleQueueBuilder
 - blockSize
```
@NotNull
public B blockSize(int blockSize)
```
 Description copied from interface: ChronicleQueueBuilder
 
 you should make sure that your largest message size is no larger than 1/4 of your block size
 
 Specified by:
 
 blockSize in interface ChronicleQueueBuilder
 
 Parameters:
 
 blockSize - the size of the off heap memory mapping
 
 Returns:
 
 that
 - blockSize
```
public long blockSize()
```
 Specified by:
 
 blockSize in interface ChronicleQueueBuilder
 - wireType
```
@NotNull
public B wireType(@NotNull
 net.openhft.chronicle.wire.WireType wireType)
```
 Specified by:
 
 wireType in interface ChronicleQueueBuilder
 - wireType
```
@NotNull
public net.openhft.chronicle.wire.WireType wireType()
```
 Specified by:
 
 wireType in interface ChronicleQueueBuilder
 - rollCycle
```
@NotNull
public B rollCycle(@NotNull
 RollCycle rollCycle)
```
 Specified by:
 
 rollCycle in interface ChronicleQueueBuilder
 - bufferCapacity
```
public long bufferCapacity()
```
 Specified by:
 
 bufferCapacity in interface ChronicleQueueBuilder
 
 Returns:
 
 ringBufferCapacity in bytes
 - bufferCapacity
```
@NotNull
public B bufferCapacity(long bufferCapacity)
```
 Specified by:
 
 bufferCapacity in interface ChronicleQueueBuilder
 
 Parameters:
 
 bufferCapacity - sets the ring buffer capacity in bytes
 
 Returns:
 
 this
 - epoch
```
@NotNull
public B epoch(long epoch)
```
 sets epoch offset in milliseconds
 
 Specified by:
 
 epoch in interface ChronicleQueueBuilder
 
 Parameters:
 
 epoch - sets an epoch offset as the number of number of milliseconds since January 1, 1970, 00:00:00 GMT
 
 Returns:
 
 this
 - epoch
```
public long epoch()
```
 Specified by:
 
 epoch in interface ChronicleQueueBuilder
 
 Returns:
 
 epoch offset as the number of number of milliseconds since January 1, 1970, 00:00:00 GMT
 - rollCycle
```
@NotNull
public RollCycle rollCycle()
```
 Specified by:
 
 rollCycle in interface ChronicleQueueBuilder
 - buffered
```
@NotNull
 @Deprecated
public B buffered(boolean isBuffered)
```
 Deprecated.
 
 when set to true. uses a ring buffer to buffer appends, excerpts are written to the Chronicle Queue using a background thread
 
 Specified by:
 
 buffered in interface ChronicleQueueBuilder
 
 Parameters:
 
 isBuffered - true if the append is buffered
 
 Returns:
 
 this
 - buffered
```
@Deprecated
public boolean buffered()
```
 Deprecated.
 
 Specified by:
 
 buffered in interface ChronicleQueueBuilder
 
 Returns:
 
 if we uses a ring buffer to buffer the appends, the Excerpts are written to the Chronicle Queue using a background thread
 - writeBufferMode
```
@NotNull
public BufferMode writeBufferMode()
```
 Specified by:
 
 writeBufferMode in interface ChronicleQueueBuilder
 
 Returns:
 
 BufferMode to use for writes. Only None is available is the OSS
 - writeBufferMode
```
public B writeBufferMode(BufferMode writeBufferMode)
```
 Specified by:
 
 writeBufferMode in interface ChronicleQueueBuilder
 
 Parameters:
 
 writeBufferMode - to use for writes. Only None is available in OSS
 
 Returns:
 
 this
 - readBufferMode
```
public BufferMode readBufferMode()
```
 Specified by:
 
 readBufferMode in interface ChronicleQueueBuilder
 
 Returns:
 
 BufferMode to use for reads. Only None is available is the OSS
 - readBufferMode
```
public B readBufferMode(BufferMode readBufferMode)
```
 Specified by:
 
 readBufferMode in interface ChronicleQueueBuilder
 
 Parameters:
 
 readBufferMode - to use for read. Only None is available in OSS
 
 Returns:
 
 this
 - eventLoop
```
@NotNull
public net.openhft.chronicle.core.threads.EventLoop eventLoop()
```
 Specified by:
 
 eventLoop in interface ChronicleQueueBuilder
 
 Returns:
 
 a new event loop instance if none has been set, otherwise the eventLoop that was set
 - eventLoop
```
@NotNull
public B eventLoop(net.openhft.chronicle.core.threads.EventLoop eventLoop)
```
 Specified by:
 
 eventLoop in interface ChronicleQueueBuilder
 
 Parameters:
 
 eventLoop - to use when asynchronous buffering is used.
 
 Returns:
 
 this
 - enableRingBufferMonitoring
```
public boolean enableRingBufferMonitoring()
```
 Returns:
 
 if the ring buffer's monitoring capability is turned on. Not available in OSS
 - enableRingBufferMonitoring
```
public B enableRingBufferMonitoring(boolean enableRingBufferMonitoring)
```
 - indexCount
```
public B indexCount(int indexCount)
```
 Specified by:
 
 indexCount in interface ChronicleQueueBuilder
 - indexCount
```
public int indexCount()
```
 Specified by:
 
 indexCount in interface ChronicleQueueBuilder
 - indexSpacing
```
public B indexSpacing(int indexSpacing)
```
 Specified by:
 
 indexSpacing in interface ChronicleQueueBuilder
 - indexSpacing
```
public int indexSpacing()
```
 Specified by:
 
 indexSpacing in interface ChronicleQueueBuilder
 - timeProvider
```
public net.openhft.chronicle.core.time.TimeProvider timeProvider()
```
 - timeProvider
```
public B timeProvider(net.openhft.chronicle.core.time.TimeProvider timeProvider)
```
 - pauserSupplier
```
public Supplier<net.openhft.chronicle.threads.TimingPauser> pauserSupplier()
```
 - pauserSupplier
```
public B pauserSupplier(Supplier<net.openhft.chronicle.threads.TimingPauser> pauser)
```
 Specified by:
 
 pauserSupplier in interface ChronicleQueueBuilder
 - timeoutMS
```
public B timeoutMS(long timeoutMS)
```
 - timeoutMS
```
public long timeoutMS()
```
 - storeFileListener
```
public B storeFileListener(StoreFileListener storeFileListener)
```
 Specified by:
 
 storeFileListener in interface ChronicleQueueBuilder
 - storeFileListener
```
public StoreFileListener storeFileListener()
```
 Specified by:
 
 storeFileListener in interface ChronicleQueueBuilder
 - hasPretouchIntervalMillis
```
public boolean hasPretouchIntervalMillis()
```
 Specified by:
 
 hasPretouchIntervalMillis in interface ChronicleQueueBuilder
 - sourceId
```
public B sourceId(int sourceId)
```
 - sourceId
```
public int sourceId()
```
 - recoverySupplier
```
public StoreRecoveryFactory recoverySupplier()
```
 - recoverySupplier
```
public B recoverySupplier(StoreRecoveryFactory recoverySupplier)
```
 - readOnly
```
public boolean readOnly()
```
 Specified by:
 
 readOnly in interface ChronicleQueueBuilder
 - readOnly
```
public B readOnly(boolean readOnly)
```
 Specified by:
 
 readOnly in interface ChronicleQueueBuilder
 - encryptSupplier
```
@NotNull
public AbstractChronicleQueueBuilder encryptSupplier(Supplier<Cipher> encryptSupplier)
```
 - decryptSupplier
```
@NotNull
public AbstractChronicleQueueBuilder decryptSupplier(Supplier<Cipher> decryptSupplier)
```
 - preBuild
```
protected void preBuild()
```
 - initializeMetadata
```
protected abstract void initializeMetadata()
```
 - strongAppenders
```
public B strongAppenders(boolean strongAppenders)
```
 Description copied from interface: ChronicleQueueBuilder
 
 Hold a strong reference to any appender instead of a weak one which prevents GC if the thread and queue exists.
 
 Specified by:
 
 strongAppenders in interface ChronicleQueueBuilder
 
 Parameters:
 
 strongAppenders - use strong references if true, use weak references is false.
 
 Returns:
 
 this builder.
 - strongAppenders
```
public boolean strongAppenders()
```
 Specified by:
 
 strongAppenders in interface ChronicleQueueBuilder
 - clone
```
public B clone()
```
 Specified by:
 
 clone in interface ChronicleQueueBuilder
 
 Overrides:
 
 clone in class Object

Class AbstractChronicleQueueBuilder<B extends ChronicleQueueBuilder,Q extends ChronicleQueue>

Field Summary

Fields inherited from interface net.openhft.chronicle.wire.WriteMarshallable

Fields inherited from interface net.openhft.chronicle.wire.ReadMarshallable

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.openhft.chronicle.wire.Marshallable

Methods inherited from interface net.openhft.chronicle.wire.WriteMarshallable

Methods inherited from interface net.openhft.chronicle.wire.ReadMarshallable

Field Detail

path

blockSize

DEFAULT_ROLL_CYCLE_PROPERTY

wireType

rollCycle

epoch

writeBufferMode

readBufferMode

eventLoop

cycleCalculator

storeFactory

readOnly

Constructor Detail

AbstractChronicleQueueBuilder

AbstractChronicleQueueBuilder

Method Detail

hasBlockSize

getLogger

cycleCalculator

path

rollTime

onRingBufferStats

onRingBufferStats

path

blockSize

blockSize

blockSize

wireType

wireType

rollCycle

bufferCapacity

bufferCapacity

epoch

epoch

rollCycle

buffered

buffered

writeBufferMode

writeBufferMode

readBufferMode

readBufferMode

eventLoop

eventLoop

enableRingBufferMonitoring

enableRingBufferMonitoring

indexCount

indexCount

indexSpacing

indexSpacing

timeProvider

timeProvider

pauserSupplier

pauserSupplier

timeoutMS

timeoutMS

storeFileListener

storeFileListener

hasPretouchIntervalMillis

sourceId

sourceId

recoverySupplier

recoverySupplier

readOnly

readOnly

encryptSupplier

decryptSupplier

preBuild

initializeMetadata