io.aeron.driver

Class MediaDriver

java.lang.Object

io.aeron.driver.MediaDriver

All Implemented Interfaces:

java.lang.AutoCloseable

public final class MediaDriver
extends java.lang.Object
implements java.lang.AutoCloseable

Main class for JVM-based media driver

Usage: $ java -jar aeron-driver.jar $ java -Doption=value -jar aeron-driver.jar

See Also:

Configuration

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MediaDriver.Context Configuration for the MediaDriver that can be used to override Configuration.

Method Summary

Modifier and Type	Method and Description
java.lang.String	aeronDirectoryName() Used to access the configured aeronDirectoryName for this MediaDriver, typically used after the launchEmbedded() method is used.
void	close() Shutdown the media driver by stopping all threads and freeing resources.
MediaDriver.Context	context() Get the MediaDriver.Context that is used by this MediaDriver.
static MediaDriver	launch() Launch a MediaDriver embedded in the current process with default configuration.
static MediaDriver	launch(MediaDriver.Context ctx) Launch a MediaDriver embedded in the current process and provided a configuration ctx.
static MediaDriver	launchEmbedded() Launch an isolated MediaDriver embedded in the current process with a generated aeronDirectoryName that can be retrieved by calling aeronDirectoryName.
static MediaDriver	launchEmbedded(MediaDriver.Context ctx) Launch an isolated MediaDriver embedded in the current process with a provided configuration ctx and a generated aeronDirectoryName (overwrites configured CommonContext.aeronDirectoryName()) that can be retrieved by calling aeronDirectoryName.
static void	main(java.lang.String[] args) Start Media Driver as a stand-alone process.
org.agrona.concurrent.AgentInvoker	sharedAgentInvoker() Get the AgentInvoker for the shared agents when running without threads.

Methods inherited from class java.lang.Object

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

Method Detail

main

public static void main(java.lang.String[] args)

Start Media Driver as a stand-alone process.

Parameters:

args - command line arguments

launchEmbedded

public static MediaDriver launchEmbedded()

Launch an isolated MediaDriver embedded in the current process with a generated aeronDirectoryName that can be retrieved by calling aeronDirectoryName.

If the aeronDirectoryName is set as a system property to something different than CommonContext.AERON_DIR_PROP_DEFAULT then this set value will be used.

Returns:

the newly started MediaDriver.

launchEmbedded

public static MediaDriver launchEmbedded(MediaDriver.Context ctx)

Launch an isolated MediaDriver embedded in the current process with a provided configuration ctx and a generated aeronDirectoryName (overwrites configured CommonContext.aeronDirectoryName()) that can be retrieved by calling aeronDirectoryName.

If the aeronDirectoryName is set as a system property, or via context, to something different than CommonContext.AERON_DIR_PROP_DEFAULT then this set value will be used.

Parameters:

ctx - containing the configuration options.

Returns:

the newly started MediaDriver.

launch

public static MediaDriver launch()

Launch a MediaDriver embedded in the current process with default configuration.

Returns:

the newly started MediaDriver.

launch

public static MediaDriver launch(MediaDriver.Context ctx)

Launch a MediaDriver embedded in the current process and provided a configuration ctx.

Parameters:

ctx - containing the configuration options.

Returns:

the newly created MediaDriver.

context

public MediaDriver.Context context()

Get the MediaDriver.Context that is used by this MediaDriver.

Returns:

the MediaDriver.Context that is used by this MediaDriver.

sharedAgentInvoker

public org.agrona.concurrent.AgentInvoker sharedAgentInvoker()

Get the AgentInvoker for the shared agents when running without threads.

Returns:

the AgentInvoker for the shared agents when running without threads.

close

public void close()

Shutdown the media driver by stopping all threads and freeing resources.

Specified by:

close in interface java.lang.AutoCloseable

aeronDirectoryName

public java.lang.String aeronDirectoryName()

Used to access the configured aeronDirectoryName for this MediaDriver, typically used after the launchEmbedded() method is used.

Returns:

the context aeronDirectoryName