io.aeron.archive

Class Archive.Context

java.lang.Object

io.aeron.archive.Archive.Context

All Implemented Interfaces:

Cloneable

Enclosing class:

Archive

public static final class Archive.Context
extends Object
implements Cloneable

Overrides for the defaults and system properties.

The context will be owned by ArchiveConductor after a successful Archive.launch(Context) and closed via Archive.close().

Constructor Summary

Constructors

Constructor and Description
Context()

Method Summary

Modifier and Type	Method and Description
Aeron	aeron() Aeron client for communicating with the local Media Driver.
Archive.Context	aeron(Aeron aeron) Aeron client for communicating with the local Media Driver.
String	aeronDirectoryName() Get the top level Aeron directory used for communication between the Aeron client and Media Driver.
Archive.Context	aeronDirectoryName(String aeronDirectoryName) Set the top level Aeron directory used for communication between the Aeron client and Media Driver.
AeronArchive.Context	archiveClientContext() Get the AeronArchive.Context that should be used for communicating with a remote archive for replication.
Archive.Context	archiveClientContext(AeronArchive.Context archiveContext) Set the AeronArchive.Context that should be used for communicating with a remote archive for replication.
File	archiveDir() Get the directory in which the Archive will store recordings and the Catalog.
Archive.Context	archiveDir(File archiveDir) Set the the directory in which the Archive will store recordings and the Catalog.
FileChannel	archiveDirChannel() Get the FileChannel for the directory in which the Archive will store recordings and the Catalog.
String	archiveDirectoryName() Get the directory name to be used to store recordings and the Catalog.
Archive.Context	archiveDirectoryName(String archiveDirectoryName) Set the directory name to be used for the archive to store recordings and the Catalog.
ArchiveMarkFile	archiveMarkFile() The ArchiveMarkFile for the Archive.
Archive.Context	archiveMarkFile(ArchiveMarkFile archiveMarkFile) The ArchiveMarkFile for the Archive.
AuthenticatorSupplier	authenticatorSupplier() Get the AuthenticatorSupplier that should be used for the Archive.
Archive.Context	authenticatorSupplier(AuthenticatorSupplier authenticatorSupplier) Set the AuthenticatorSupplier that will be used for the Archive.
io.aeron.archive.Catalog	catalog() The Catalog describing the contents of the Archive.
Archive.Context	catalog(io.aeron.archive.Catalog catalog) The Catalog describing the contents of the Archive.
long	catalogCapacity() Capacity in bytes of the Catalog.
Archive.Context	catalogCapacity(long catalogCapacity) Capacity in bytes of the Catalog.
Archive.Context	catalogFileSyncLevel(int syncLevel) Set level at which the catalog file should be sync'ed to disk.
Archive.Context	clone() Perform a shallow copy of the object.
void	close() Close the context and free applicable resources.
void	conclude() Conclude the configuration parameters by resolving dependencies and null values to use defaults.
long	connectTimeoutNs() The timeout in nanoseconds to wait for connection to be established.
Archive.Context	connectTimeoutNs(long connectTimeoutNs) The timeout in nanoseconds to wait for connection to be established.
String	controlChannel() Get the channel URI on which the control request subscription will listen.
Archive.Context	controlChannel(String controlChannel) Set the channel URI on which the control request subscription will listen.
int	controlMtuLength() Get the MTU length for the control streams.
Archive.Context	controlMtuLength(int controlMtuLength) Set the MTU length for the control streams.
Counter	controlSessionsCounter() Get the counter used to track the number of active control sessions.
Archive.Context	controlSessionsCounter(Counter controlSessionsCounter) Set the counter used to track the number of active control sessions.
int	controlStreamId() Get the stream id on which the control request subscription will listen.
Archive.Context	controlStreamId(int controlStreamId) Set the stream id on which the control request subscription will listen.
int	controlTermBufferLength() Get the term buffer length for the control streams.
Archive.Context	controlTermBufferLength(int controlTermBufferLength) Set the term buffer length for the control streams.
boolean	controlTermBufferSparse() Should the control streams use sparse file term buffers.
Archive.Context	controlTermBufferSparse(boolean controlTermBufferSparse) Should the control streams use sparse file term buffers.
CountedErrorHandler	countedErrorHandler() The errorHandler() that will increment errorCounter() by default.
Archive.Context	countedErrorHandler(CountedErrorHandler countedErrorHandler) Non-default for context.
void	deleteArchiveDirectory() Deprecated.
boolean	deleteArchiveOnStart() Should an existing archive be deleted on start.
Archive.Context	deleteArchiveOnStart(boolean deleteArchiveOnStart) Should an existing archive be deleted on start.
void	deleteDirectory() Delete the archive directory if the archiveDir() value is not null.
EpochClock	epochClock() Get the EpochClock to used for tracking wall clock time.
Archive.Context	epochClock(EpochClock clock) Set the EpochClock to be used for tracking wall clock time.
int	errorBufferLength() The error buffer length in bytes.
Archive.Context	errorBufferLength(int errorBufferLength) Set the error buffer length in bytes to use.
AtomicCounter	errorCounter() Get the error counter that will record the number of errors observed.
Archive.Context	errorCounter(AtomicCounter errorCounter) Set the error counter that will record the number of errors observed.
ErrorHandler	errorHandler() Get the ErrorHandler to be used by the Archive.
Archive.Context	errorHandler(ErrorHandler errorHandler) Set the ErrorHandler to be used by the Archive.
int	fileIoMaxLength() Get the max length of a file IO operation.
Archive.Context	fileIoMaxLength(int fileIoMaxLength) Set the max length of a file IO operation.
Archive.Context	fileSyncLevel(int syncLevel) Set level at which files should be sync'ed to disk.
IdleStrategy	idleStrategy() Get a new IdleStrategy for idling the conductor or composite Agent.
Archive.Context	idleStrategySupplier(Supplier<IdleStrategy> idleStrategySupplier) Provides an IdleStrategy supplier for idling the conductor or composite Agent.
String	localControlChannel() Get the driver local channel URI on which the control request subscription will listen.
Archive.Context	localControlChannel(String controlChannel) Set the driver local channel URI on which the control request subscription will listen.
int	localControlStreamId() Get the local stream id on which the control request subscription will listen.
Archive.Context	localControlStreamId(int controlStreamId) Set the local stream id on which the control request subscription will listen.
long	maxCatalogEntries() Deprecated. This method was deprecated in favor of catalogCapacity() which returns capacity of the Catalog in bytes rathen than in number of entries.
Archive.Context	maxCatalogEntries(long maxCatalogEntries) Deprecated. This method was deprecated in favor of catalogCapacity(long) which works with bytes rather than number of entries.
int	maxConcurrentRecordings() Get the max number of concurrent recordings.
Archive.Context	maxConcurrentRecordings(int maxConcurrentRecordings) Set the max number of concurrent recordings.
int	maxConcurrentReplays() Get the max number of concurrent replays.
Archive.Context	maxConcurrentReplays(int maxConcurrentReplays) Set the max number of concurrent replays.
Archive.Context	mediaDriverAgentInvoker(AgentInvoker mediaDriverAgentInvoker) Set the AgentInvoker that should be used for the Media Driver if running in a lightweight mode.
boolean	ownsAeronClient() Does this context own the aeron() client and this takes responsibility for closing it?
Archive.Context	ownsAeronClient(boolean ownsAeronClient) Does this context own the aeron() client and this takes responsibility for closing it?
Checksum	recordChecksum() Get the Checksum for checksum computation during recording.
Archive.Context	recordChecksum(Checksum recordChecksum) Provides an explicit Checksum for checksum computation during recording.
IdleStrategy	recorderIdleStrategy() Get a new IdleStrategy for idling the recorder Agent.
Archive.Context	recorderIdleStrategySupplier(Supplier<IdleStrategy> idleStrategySupplier) Provides an IdleStrategy supplier for idling the recorder Agent.
String	recordingEventsChannel() Get the channel URI on which the recording events publication will publish.
Archive.Context	recordingEventsChannel(String recordingEventsChannel) Set the channel URI on which the recording events publication will publish.
boolean	recordingEventsEnabled() Should the recording events channel be enabled.
Archive.Context	recordingEventsEnabled(boolean recordingEventsEnabled) Set if the recording events channel should be enabled.
int	recordingEventsStreamId() Get the stream id on which the recording events publication will publish.
Archive.Context	recordingEventsStreamId(int recordingEventsStreamId) Set the stream id on which the recording events publication will publish.
Checksum	replayChecksum() Get the Checksum for checksum computation during replay.
Archive.Context	replayChecksum(Checksum replayChecksum) The Checksum for checksum computation during replay.
IdleStrategy	replayerIdleStrategy() Get a new IdleStrategy for idling the replayer Agent.
Archive.Context	replayerIdleStrategySupplier(Supplier<IdleStrategy> idleStrategySupplier) Provides an IdleStrategy supplier for idling the replayer Agent.
long	replayLingerTimeoutNs() The timeout in nanoseconds for a replay publication to linger after draining.
Archive.Context	replayLingerTimeoutNs(long replayLingerTimeoutNs) The timeout in nanoseconds for or a replay publication to linger after draining.
String	replicationChannel() Get the channel URI for replicating stream from another archive as replays.
Archive.Context	replicationChannel(String replicationChannel) The channel URI for replicating stream from another archive as replays.
Archive.Context	segmentFileLength(int segmentFileLength) Set the file length to be used for recording data segment files.
ThreadFactory	threadFactory() Get the thread factory used for creating threads in ArchiveThreadingMode.SHARED and ArchiveThreadingMode.DEDICATED threading modes.
Archive.Context	threadFactory(ThreadFactory threadFactory) Set the thread factory used for creating threads in ArchiveThreadingMode.SHARED and ArchiveThreadingMode.DEDICATED threading modes.
ArchiveThreadingMode	threadingMode() Get the archive threading mode.
Archive.Context	threadingMode(ArchiveThreadingMode threadingMode) Set the archive threading mode.

Methods inherited from class java.lang.Object

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

Constructor Detail

Context

public Context()

Method Detail

clone

public Archive.Context clone()

Perform a shallow copy of the object.

Overrides:

clone in class Object

Returns:

a shallow copy of the object.

conclude

public void conclude()

Conclude the configuration parameters by resolving dependencies and null values to use defaults.

deleteArchiveOnStart

public Archive.Context deleteArchiveOnStart(boolean deleteArchiveOnStart)

Should an existing archive be deleted on start. Useful only for testing.

Parameters:

deleteArchiveOnStart - true if an existing archive should be deleted on startup.

Returns:

this for a fluent API.

deleteArchiveOnStart

public boolean deleteArchiveOnStart()

Should an existing archive be deleted on start. Useful only for testing.

Returns:

true if an existing archive should be deleted on start up.

archiveDirectoryName

public Archive.Context archiveDirectoryName(String archiveDirectoryName)

Set the directory name to be used for the archive to store recordings and the Catalog. This name is used if archiveDir(File) is not set.

Parameters:

archiveDirectoryName - to store recordings and the Catalog.

Returns:

this for a fluent API.

See Also:

Archive.Configuration.ARCHIVE_DIR_PROP_NAME

archiveDirectoryName

public String archiveDirectoryName()

Get the directory name to be used to store recordings and the Catalog.

Returns:

the directory name to be used for the archive to store recordings and the Catalog.

archiveDir

public File archiveDir()

Get the directory in which the Archive will store recordings and the Catalog.

Returns:

the directory in which the Archive will store recordings and the Catalog.

archiveDir

public Archive.Context archiveDir(File archiveDir)

Set the the directory in which the Archive will store recordings and the Catalog.

Parameters:

archiveDir - the directory in which the Archive will store recordings and the Catalog.

Returns:

this for a fluent API.

archiveDirChannel

public FileChannel archiveDirChannel()

Get the FileChannel for the directory in which the Archive will store recordings and the Catalog. This can be used for sync'ing the directory.

Returns:

the directory in which the Archive will store recordings and the Catalog.

archiveClientContext

public Archive.Context archiveClientContext(AeronArchive.Context archiveContext)

Set the AeronArchive.Context that should be used for communicating with a remote archive for replication.

Parameters:

archiveContext - that should be used for communicating with a remote Archive.

Returns:

this for a fluent API.

archiveClientContext

public AeronArchive.Context archiveClientContext()

Get the AeronArchive.Context that should be used for communicating with a remote archive for replication.

Returns:

the AeronArchive.Context that should be used for communicating with a remote archive for replication.

controlChannel

public String controlChannel()

Get the channel URI on which the control request subscription will listen.

Returns:

the channel URI on which the control request subscription will listen.

See Also:

AeronArchive.Configuration.CONTROL_CHANNEL_PROP_NAME

controlChannel

public Archive.Context controlChannel(String controlChannel)

Set the channel URI on which the control request subscription will listen.

Parameters:

controlChannel - channel URI on which the control request subscription will listen.

Returns:

this for a fluent API.

See Also:

AeronArchive.Configuration.CONTROL_CHANNEL_PROP_NAME

controlStreamId

public int controlStreamId()

Get the stream id on which the control request subscription will listen.

Returns:

the stream id on which the control request subscription will listen.

See Also:

AeronArchive.Configuration.CONTROL_STREAM_ID_PROP_NAME

controlStreamId

public Archive.Context controlStreamId(int controlStreamId)

Set the stream id on which the control request subscription will listen.

Parameters:

controlStreamId - stream id on which the control request subscription will listen.

Returns:

this for a fluent API.

See Also:

AeronArchive.Configuration.CONTROL_STREAM_ID_PROP_NAME

localControlChannel

public String localControlChannel()

Get the driver local channel URI on which the control request subscription will listen.

Returns:

the channel URI on which the control request subscription will listen.

See Also:

AeronArchive.Configuration.LOCAL_CONTROL_CHANNEL_PROP_NAME

localControlChannel

public Archive.Context localControlChannel(String controlChannel)

Set the driver local channel URI on which the control request subscription will listen.

Parameters:

controlChannel - channel URI on which the control request subscription will listen.

Returns:

this for a fluent API.

See Also:

AeronArchive.Configuration.LOCAL_CONTROL_CHANNEL_PROP_NAME

localControlStreamId

public int localControlStreamId()

Get the local stream id on which the control request subscription will listen.

Returns:

the stream id on which the control request subscription will listen.

See Also:

AeronArchive.Configuration.LOCAL_CONTROL_STREAM_ID_PROP_NAME

controlTermBufferSparse

public Archive.Context controlTermBufferSparse(boolean controlTermBufferSparse)

Should the control streams use sparse file term buffers.

Parameters:

controlTermBufferSparse - for the control stream.

Returns:

this for a fluent API.

See Also:

AeronArchive.Configuration.CONTROL_TERM_BUFFER_SPARSE_PROP_NAME

controlTermBufferSparse

public boolean controlTermBufferSparse()

Should the control streams use sparse file term buffers.

Returns:

true if the control stream should use sparse file term buffers.

See Also:

AeronArchive.Configuration.CONTROL_TERM_BUFFER_SPARSE_PROP_NAME

controlTermBufferLength

public Archive.Context controlTermBufferLength(int controlTermBufferLength)

Set the term buffer length for the control streams.

Parameters:

controlTermBufferLength - for the control streams.

Returns:

this for a fluent API.

See Also:

AeronArchive.Configuration.CONTROL_TERM_BUFFER_LENGTH_PROP_NAME

controlTermBufferLength

public int controlTermBufferLength()

Get the term buffer length for the control streams.

Returns:

the term buffer length for the control streams.

See Also:

AeronArchive.Configuration.CONTROL_TERM_BUFFER_LENGTH_PROP_NAME

controlMtuLength

public Archive.Context controlMtuLength(int controlMtuLength)

Set the MTU length for the control streams.

Parameters:

controlMtuLength - for the control streams.

Returns:

this for a fluent API.

See Also:

AeronArchive.Configuration.CONTROL_MTU_LENGTH_PROP_NAME

controlMtuLength

public int controlMtuLength()

Get the MTU length for the control streams.

Returns:

the MTU length for the control streams.

See Also:

AeronArchive.Configuration.CONTROL_MTU_LENGTH_PROP_NAME

localControlStreamId

public Archive.Context localControlStreamId(int controlStreamId)

Set the local stream id on which the control request subscription will listen.

Parameters:

controlStreamId - stream id on which the control request subscription will listen.

Returns:

this for a fluent API.

See Also:

AeronArchive.Configuration.LOCAL_CONTROL_STREAM_ID_PROP_NAME

recordingEventsChannel

public String recordingEventsChannel()

Get the channel URI on which the recording events publication will publish.

Returns:

the channel URI on which the recording events publication will publish.

See Also:

AeronArchive.Configuration.RECORDING_EVENTS_CHANNEL_PROP_NAME

recordingEventsChannel

public Archive.Context recordingEventsChannel(String recordingEventsChannel)

Set the channel URI on which the recording events publication will publish.

To support dynamic subscribers then this can be set to multicast or MDC (Multi-Destination-Cast) if multicast cannot be supported for on the available the network infrastructure.

Parameters:

recordingEventsChannel - channel URI on which the recording events publication will publish.

Returns:

this for a fluent API.

See Also:

AeronArchive.Configuration.RECORDING_EVENTS_CHANNEL_PROP_NAME, CommonContext.MDC_CONTROL_PARAM_NAME

recordingEventsStreamId

public int recordingEventsStreamId()

Get the stream id on which the recording events publication will publish.

Returns:

the stream id on which the recording events publication will publish.

See Also:

AeronArchive.Configuration.RECORDING_EVENTS_STREAM_ID_PROP_NAME

recordingEventsStreamId

public Archive.Context recordingEventsStreamId(int recordingEventsStreamId)

Set the stream id on which the recording events publication will publish.

Parameters:

recordingEventsStreamId - stream id on which the recording events publication will publish.

Returns:

this for a fluent API.

See Also:

AeronArchive.Configuration.RECORDING_EVENTS_STREAM_ID_PROP_NAME

recordingEventsEnabled

public boolean recordingEventsEnabled()

Should the recording events channel be enabled.

Returns:

true if the recording events channel should be enabled.

See Also:

AeronArchive.Configuration.RECORDING_EVENTS_ENABLED_PROP_NAME

recordingEventsEnabled

public Archive.Context recordingEventsEnabled(boolean recordingEventsEnabled)

Set if the recording events channel should be enabled.

Parameters:

recordingEventsEnabled - indication of if the recording events channel should be enabled.

Returns:

this for a fluent API.

See Also:

AeronArchive.Configuration.RECORDING_EVENTS_ENABLED_PROP_NAME

replicationChannel

public String replicationChannel()

Get the channel URI for replicating stream from another archive as replays.

Returns:

the channel URI for replicating stream from another archive as replays.

See Also:

Archive.Configuration.REPLICATION_CHANNEL_PROP_NAME

replicationChannel

public Archive.Context replicationChannel(String replicationChannel)

The channel URI for replicating stream from another archive as replays.

Parameters:

replicationChannel - channel URI for replicating stream from another archive as replays.

Returns:

this for a fluent API.

See Also:

Archive.Configuration.REPLICATION_CHANNEL_PROP_NAME

connectTimeoutNs

public Archive.Context connectTimeoutNs(long connectTimeoutNs)

The timeout in nanoseconds to wait for connection to be established.

Parameters:

connectTimeoutNs - to wait for a connection to be established.

Returns:

this for a fluent API.

See Also:

Archive.Configuration.CONNECT_TIMEOUT_PROP_NAME

connectTimeoutNs

public long connectTimeoutNs()

The timeout in nanoseconds to wait for connection to be established.

Returns:

the message timeout in nanoseconds to wait for a connection to be established.

See Also:

Archive.Configuration.CONNECT_TIMEOUT_PROP_NAME

replayLingerTimeoutNs

public Archive.Context replayLingerTimeoutNs(long replayLingerTimeoutNs)

The timeout in nanoseconds for or a replay publication to linger after draining.

Parameters:

replayLingerTimeoutNs - in nanoseconds for a replay publication to linger after draining.

Returns:

this for a fluent API.

See Also:

Archive.Configuration.REPLAY_LINGER_TIMEOUT_PROP_NAME, Configuration.PUBLICATION_LINGER_PROP_NAME

replayLingerTimeoutNs

public long replayLingerTimeoutNs()

The timeout in nanoseconds for a replay publication to linger after draining.

Returns:

the timeout in nanoseconds for a replay publication to linger after draining.

See Also:

Archive.Configuration.REPLAY_LINGER_TIMEOUT_PROP_NAME, Configuration.PUBLICATION_LINGER_PROP_NAME

recordChecksum

public Archive.Context recordChecksum(Checksum recordChecksum)

Provides an explicit Checksum for checksum computation during recording.

Parameters:

recordChecksum - to be used for recordings.

Returns:

this for a fluent API.

See Also:

Archive.Configuration.RECORD_CHECKSUM_PROP_NAME

recordChecksum

public Checksum recordChecksum()

Get the Checksum for checksum computation during recording.

Returns:

the Checksum instance for checksum computation during recording or null if no Checksum was configured.

See Also:

Archive.Configuration.RECORD_CHECKSUM_PROP_NAME

replayChecksum

public Archive.Context replayChecksum(Checksum replayChecksum)

The Checksum for checksum computation during replay.

Parameters:

replayChecksum - to be used for replays.

Returns:

this for a fluent API.

See Also:

Archive.Configuration.REPLAY_CHECKSUM_PROP_NAME

replayChecksum

public Checksum replayChecksum()

Get the Checksum for checksum computation during replay.

Returns:

the Checksum instance for checksum computation during replay or null if no replay Checksum was configured.

See Also:

Archive.Configuration.REPLAY_CHECKSUM_PROP_NAME

idleStrategySupplier

public Archive.Context idleStrategySupplier(Supplier<IdleStrategy> idleStrategySupplier)

Provides an IdleStrategy supplier for idling the conductor or composite Agent. Which is also the default for recorder and replayer Agents.

Parameters:

idleStrategySupplier - supplier for idling the conductor.

Returns:

this for a fluent API.

idleStrategy

public IdleStrategy idleStrategy()

Get a new IdleStrategy for idling the conductor or composite Agent. Which is also the default for recorder and replayer Agents.

Returns:

a new IdleStrategy for idling the conductor or composite Agent.

recorderIdleStrategySupplier

public Archive.Context recorderIdleStrategySupplier(Supplier<IdleStrategy> idleStrategySupplier)

Provides an IdleStrategy supplier for idling the recorder Agent.

Parameters:

idleStrategySupplier - supplier for idling the conductor.

Returns:

this for a fluent API.

recorderIdleStrategy

public IdleStrategy recorderIdleStrategy()

Get a new IdleStrategy for idling the recorder Agent.

Returns:

a new IdleStrategy for idling the recorder Agent.

replayerIdleStrategySupplier

public Archive.Context replayerIdleStrategySupplier(Supplier<IdleStrategy> idleStrategySupplier)

Provides an IdleStrategy supplier for idling the replayer Agent.

Parameters:

idleStrategySupplier - supplier for idling the replayer.

Returns:

this for a fluent API.

replayerIdleStrategy

public IdleStrategy replayerIdleStrategy()

Get a new IdleStrategy for idling the replayer Agent.

Returns:

a new IdleStrategy for idling the replayer Agent.

epochClock

public Archive.Context epochClock(EpochClock clock)

Set the EpochClock to be used for tracking wall clock time.

Parameters:

clock - EpochClock to be used for tracking wall clock time.

Returns:

this for a fluent API.

epochClock

public EpochClock epochClock()

Get the EpochClock to used for tracking wall clock time.

Returns:

the EpochClock to used for tracking wall clock time.

segmentFileLength

public Archive.Context segmentFileLength(int segmentFileLength)

Set the file length to be used for recording data segment files. If the Image.termBufferLength() is larger than the segment file length then the term length will be used.

Parameters:

segmentFileLength - the file length to be used for recording data segment files.

Returns:

this for a fluent API.

See Also:

Archive.Configuration.SEGMENT_FILE_LENGTH_PROP_NAME

fileSyncLevel

public Archive.Context fileSyncLevel(int syncLevel)

Set level at which files should be sync'ed to disk.

• 0 - normal writes.
• 1 - sync file data.
• 2 - sync file data + metadata.

Parameters:

syncLevel - to be applied for file writes.

Returns:

this for a fluent API.

See Also:

catalogFileSyncLevel(), Archive.Configuration.FILE_SYNC_LEVEL_PROP_NAME

catalogFileSyncLevel

public Archive.Context catalogFileSyncLevel(int syncLevel)

Set level at which the catalog file should be sync'ed to disk.

• 0 - normal writes.
• 1 - sync file data.
• 2 - sync file data + metadata.

Parameters:

syncLevel - to be applied for file writes.

Returns:

this for a fluent API.

See Also:

fileSyncLevel(), Archive.Configuration.CATALOG_FILE_SYNC_LEVEL_PROP_NAME

mediaDriverAgentInvoker

public Archive.Context mediaDriverAgentInvoker(AgentInvoker mediaDriverAgentInvoker)

Set the AgentInvoker that should be used for the Media Driver if running in a lightweight mode.

Parameters:

mediaDriverAgentInvoker - that should be used for the Media Driver if running in a lightweight mode.

Returns:

this for a fluent API.

errorHandler

public ErrorHandler errorHandler()

Get the ErrorHandler to be used by the Archive.

Returns:

the ErrorHandler to be used by the Archive.

errorHandler

public Archive.Context errorHandler(ErrorHandler errorHandler)

Set the ErrorHandler to be used by the Archive.

Parameters:

errorHandler - the error handler to be used by the Archive.

Returns:

this for a fluent API

countedErrorHandler

public Archive.Context countedErrorHandler(CountedErrorHandler countedErrorHandler)

Non-default for context.

Parameters:

countedErrorHandler - to override the default.

Returns:

this for a fluent API.

countedErrorHandler

public CountedErrorHandler countedErrorHandler()

The errorHandler() that will increment errorCounter() by default.

Returns:

errorHandler() that will increment errorCounter() by default.

threadingMode

public ArchiveThreadingMode threadingMode()

Get the archive threading mode.

Returns:

the archive threading mode.

See Also:

Archive.Configuration.THREADING_MODE_PROP_NAME

threadingMode

public Archive.Context threadingMode(ArchiveThreadingMode threadingMode)

Set the archive threading mode.

Parameters:

threadingMode - archive threading mode.

Returns:

this for a fluent API.

See Also:

Archive.Configuration.THREADING_MODE_PROP_NAME

threadFactory

public ThreadFactory threadFactory()

Get the thread factory used for creating threads in ArchiveThreadingMode.SHARED and ArchiveThreadingMode.DEDICATED threading modes.

Returns:

thread factory used for creating threads in SHARED and DEDICATED threading modes.

threadFactory

public Archive.Context threadFactory(ThreadFactory threadFactory)

Set the thread factory used for creating threads in ArchiveThreadingMode.SHARED and ArchiveThreadingMode.DEDICATED threading modes.

Parameters:

threadFactory - used for creating threads in SHARED and DEDICATED threading modes.

Returns:

this for a fluent API.

errorBufferLength

public Archive.Context errorBufferLength(int errorBufferLength)

Set the error buffer length in bytes to use.

Parameters:

errorBufferLength - in bytes to use.

Returns:

this for a fluent API.

See Also:

Archive.Configuration.ERROR_BUFFER_LENGTH_PROP_NAME

errorBufferLength

public int errorBufferLength()

The error buffer length in bytes.

Returns:

error buffer length in bytes.

See Also:

Archive.Configuration.ERROR_BUFFER_LENGTH_PROP_NAME

errorCounter

public AtomicCounter errorCounter()

Get the error counter that will record the number of errors observed.

Returns:

the error counter that will record the number of errors observed.

errorCounter

public Archive.Context errorCounter(AtomicCounter errorCounter)

Set the error counter that will record the number of errors observed.

Parameters:

errorCounter - the error counter that will record the number of errors observed.

Returns:

this for a fluent API.

controlSessionsCounter

public Counter controlSessionsCounter()

Get the counter used to track the number of active control sessions.

Returns:

the counter used to track the number of active control sessions.

controlSessionsCounter

public Archive.Context controlSessionsCounter(Counter controlSessionsCounter)

Set the counter used to track the number of active control sessions.

Parameters:

controlSessionsCounter - the counter used to track the number of active control sessions.

Returns:

this for a fluent API.

maxConcurrentRecordings

public int maxConcurrentRecordings()

Get the max number of concurrent recordings.

Returns:

the max number of concurrent recordings.

See Also:

Archive.Configuration.MAX_CONCURRENT_RECORDINGS_PROP_NAME

maxConcurrentRecordings

public Archive.Context maxConcurrentRecordings(int maxConcurrentRecordings)

Set the max number of concurrent recordings.

Parameters:

maxConcurrentRecordings - the max number of concurrent recordings.

Returns:

this for a fluent API.

See Also:

Archive.Configuration.MAX_CONCURRENT_RECORDINGS_PROP_NAME

maxConcurrentReplays

public int maxConcurrentReplays()

Get the max number of concurrent replays.

Returns:

the max number of concurrent replays.

See Also:

Archive.Configuration.MAX_CONCURRENT_REPLAYS_PROP_NAME

maxConcurrentReplays

public Archive.Context maxConcurrentReplays(int maxConcurrentReplays)

Set the max number of concurrent replays.

Parameters:

maxConcurrentReplays - the max number of concurrent replays.

Returns:

this for a fluent API.

See Also:

Archive.Configuration.MAX_CONCURRENT_REPLAYS_PROP_NAME

fileIoMaxLength

public int fileIoMaxLength()

Get the max length of a file IO operation.

Returns:

the max length of a file IO operation.

See Also:

Archive.Configuration.FILE_IO_MAX_LENGTH_PROP_NAME

fileIoMaxLength

public Archive.Context fileIoMaxLength(int fileIoMaxLength)

Set the max length of a file IO operation.

Parameters:

fileIoMaxLength - the max length of a file IO operation.

Returns:

this for a fluent API.

See Also:

Archive.Configuration.FILE_IO_MAX_LENGTH_PROP_NAME

deleteArchiveDirectory

@Deprecated
public void deleteArchiveDirectory()

Deprecated.

Delete the archive directory if the archiveDir() value is not null.

Use deleteDirectory() instead.

deleteDirectory

public void deleteDirectory()

Delete the archive directory if the archiveDir() value is not null.

aeronDirectoryName

public Archive.Context aeronDirectoryName(String aeronDirectoryName)

Set the top level Aeron directory used for communication between the Aeron client and Media Driver.

Parameters:

aeronDirectoryName - the top level Aeron directory.

Returns:

this for a fluent API.

aeronDirectoryName

public String aeronDirectoryName()

Get the top level Aeron directory used for communication between the Aeron client and Media Driver.

Returns:

The top level Aeron directory.

aeron

public Archive.Context aeron(Aeron aeron)

Aeron client for communicating with the local Media Driver.

This client will be closed when the Archive.close() or close() methods are called if ownsAeronClient() is true.

Parameters:

aeron - client for communicating with the local Media Driver.

Returns:

this for a fluent API.

See Also:

Aeron.connect()

aeron

public Aeron aeron()

Aeron client for communicating with the local Media Driver.

If not provided then a default will be established during conclude() by calling Aeron.connect().

Returns:

client for communicating with the local Media Driver.

ownsAeronClient

public Archive.Context ownsAeronClient(boolean ownsAeronClient)

Does this context own the aeron() client and this takes responsibility for closing it?

Parameters:

ownsAeronClient - does this context own the aeron() client.

Returns:

this for a fluent API.

ownsAeronClient

public boolean ownsAeronClient()

Does this context own the aeron() client and this takes responsibility for closing it?

Returns:

does this context own the aeron() client and this takes responsibility for closing it?

catalog

public Archive.Context catalog(io.aeron.archive.Catalog catalog)

The Catalog describing the contents of the Archive.

Parameters:

catalog - Catalog describing the contents of the Archive.

Returns:

this for a fluent API.

catalog

public io.aeron.archive.Catalog catalog()

The Catalog describing the contents of the Archive.

Returns:

the Catalog describing the contents of the Archive.

archiveMarkFile

public Archive.Context archiveMarkFile(ArchiveMarkFile archiveMarkFile)

The ArchiveMarkFile for the Archive.

Parameters:

archiveMarkFile - ArchiveMarkFile for the Archive.

Returns:

this for a fluent API.

archiveMarkFile

public ArchiveMarkFile archiveMarkFile()

The ArchiveMarkFile for the Archive.

Returns:

ArchiveMarkFile for the Archive.

maxCatalogEntries

@Deprecated
public Archive.Context maxCatalogEntries(long maxCatalogEntries)

Deprecated. This method was deprecated in favor of catalogCapacity(long) which works with bytes rather than number of entries.

Maximum number of catalog entries for the Archive.

Parameters:

maxCatalogEntries - for the archive.

Returns:

this for a fluent API.

See Also:

catalogCapacity(long)

maxCatalogEntries

@Deprecated
public long maxCatalogEntries()

Deprecated. This method was deprecated in favor of catalogCapacity() which returns capacity of the Catalog in bytes rathen than in number of entries.

Maximum number of catalog entries for the Archive.

Returns:

maximum number of catalog entries for the Archive.

See Also:

catalogCapacity()

catalogCapacity

public Archive.Context catalogCapacity(long catalogCapacity)

Capacity in bytes of the Catalog.

Parameters:

catalogCapacity - in bytes.

Returns:

this for a fluent API.

catalogCapacity

public long catalogCapacity()

Capacity in bytes of the Catalog.

Returns:

capacity in bytes of the Catalog.

authenticatorSupplier

public AuthenticatorSupplier authenticatorSupplier()

Get the AuthenticatorSupplier that should be used for the Archive.

Returns:

the AuthenticatorSupplier to be used for the Archive.

authenticatorSupplier

public Archive.Context authenticatorSupplier(AuthenticatorSupplier authenticatorSupplier)

Set the AuthenticatorSupplier that will be used for the Archive.

Parameters:

authenticatorSupplier - AuthenticatorSupplier to use for the Archive.

Returns:

this for a fluent API.

close

public void close()

Close the context and free applicable resources.

If ownsAeronClient() is true then the aeron() client will be closed.