Package berlin.yuna.natsserver.logic

Class NatsStreaming

java.lang.Object

berlin.yuna.natsserver.logic.NatsStreaming

public class NatsStreaming
extends Object

NatsStreaming

Field Summary

Fields

Modifier and Type	Field	Description
protected static org.slf4j.Logger	LOG
protected String	name
protected static berlin.yuna.clu.logic.SystemUtil.OperatingSystem	OPERATING_SYSTEM
protected int	pid	simpleName from NatsStreaming class
protected static String	TMP_DIR

Constructor Summary

Constructors

Constructor	Description
NatsStreaming()	Create NatsStreaming without any start able configuration
NatsStreaming(int port)	Create NatsStreaming with simplest start able configuration
NatsStreaming(String... config)	Create custom NatsStreaming with simplest configuration config(String...)

Method Summary

Modifier and Type	Method	Description
Map<NatsStreamingConfig,String>	config()	GetNatServerConfig
NatsStreaming	config(NatsStreamingConfig key, String value)	Sets a single config value
NatsStreaming	config(String... config)	Passes the original parameters to the server on startup
NatsStreaming	config(Map<NatsStreamingConfig,String> config)	Passes the original parameters to the server on startup
protected Path	getNatsServerPath(berlin.yuna.clu.logic.SystemUtil.OperatingSystem operatingSystem)	Gets Nats server path
Path	natsPath()	Gets Nats server path
int	pid()	get process id
Path	pidFile()
int	port()	Gets the port out of the configuration
NatsStreaming	port(int port)	Sets the port out of the configuration
String	source()	Url to find nats server source
NatsStreaming	source(String natsServerUrl)	Url to find nats server source
NatsStreaming	start()	Starts the server in ProcessBuilder with the given parameterConfig config(String...)
NatsStreaming	start(long timeoutMs)	Starts the server in ProcessBuilder with the given parameterConfig config(String...)
NatsStreaming	stop()	Stops the ProcessBuilder and kills the NatsStreaming Only a log error will occur if the NatsStreaming were never started
NatsStreaming	stop(long timeoutMs)	Stops the ProcessBuilder and kills the NatsStreaming Only a log error will occur if the NatsStreaming were never started
String	toString()
NatsStreaming	tryStart()	Starts the server in ProcessBuilder with the given parameterConfig config(String...) Throws all exceptions as RuntimeException
NatsStreaming	tryStart(long timeoutMs)	Starts the server in ProcessBuilder with the given parameterConfig config(String...) Throws all exceptions as RuntimeException
static boolean	waitForPort(int port, long timeoutMs, boolean isFree)

Methods inherited from class java.lang.Object

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

Field Detail

pid

protected int pid

simpleName from NatsStreaming class

name

protected final String name

LOG

protected static final org.slf4j.Logger LOG

OPERATING_SYSTEM

protected static final berlin.yuna.clu.logic.SystemUtil.OperatingSystem OPERATING_SYSTEM

TMP_DIR

protected static final String TMP_DIR

Constructor Detail

NatsStreaming

public NatsStreaming()

Create NatsStreaming without any start able configuration

NatsStreaming

public NatsStreaming(int port)

Create NatsStreaming with simplest start able configuration

Parameters:

port - -1 for random port

NatsStreaming

public NatsStreaming(String... config)

Create custom NatsStreaming with simplest configuration config(String...)

Parameters:

config - passes the original parameters to the server. example: port:4222, user:admin, password:admin

Method Detail

config

public Map<NatsStreamingConfig,String> config()

GetNatServerConfig

Returns:

the NatsStreaming configuration

config

public NatsStreaming config(NatsStreamingConfig key,
                            String value)

Sets a single config value

Returns:

the NatsStreaming configuration

config

public NatsStreaming config(Map<NatsStreamingConfig,String> config)

Passes the original parameters to the server on startup

Parameters:

config - passes the original parameters to the server.

Returns:

NatsStreaming

See Also:

config(String...), NatsStreamingConfig

config

public NatsStreaming config(String... config)

Passes the original parameters to the server on startup

Parameters:

config - example: port:4222, user:admin, password:admin

Returns:

NatsStreaming

See Also:

NatsStreamingConfig

tryStart

public NatsStreaming tryStart()

Starts the server in ProcessBuilder with the given parameterConfig config(String...) Throws all exceptions as RuntimeException

Returns:

NatsStreaming

tryStart

public NatsStreaming tryStart(long timeoutMs)

Starts the server in ProcessBuilder with the given parameterConfig config(String...) Throws all exceptions as RuntimeException

Parameters:

timeoutMs - defines the start up timeout -1 no timeout, else waits until port up

Returns:

NatsStreaming

start

public NatsStreaming start()
                    throws IOException

Starts the server in ProcessBuilder with the given parameterConfig config(String...)

Returns:

NatsStreaming

Throws:

IOException - if NatsStreaming is not found or unsupported on the SystemUtil.OperatingSystem

BindException - if port is already taken

PortUnreachableException - if NatsStreaming is not starting cause port is not free

start

public NatsStreaming start(long timeoutMs)
                    throws IOException

Starts the server in ProcessBuilder with the given parameterConfig config(String...)

Parameters:

timeoutMs - defines the start up timeout -1 no timeout, else waits until port up

Returns:

NatsStreaming

Throws:

IOException - if NatsStreaming is not found or unsupported on the SystemUtil.OperatingSystem

BindException - if port is already taken

PortUnreachableException - if NatsStreaming is not starting cause port is not free

stop

public NatsStreaming stop()

Stops the ProcessBuilder and kills the NatsStreaming Only a log error will occur if the NatsStreaming were never started

Returns:

NatsStreaming

stop

public NatsStreaming stop(long timeoutMs)

Stops the ProcessBuilder and kills the NatsStreaming Only a log error will occur if the NatsStreaming were never started

Parameters:

timeoutMs - defines the tear down timeout, -1 no timeout, else waits until port is free again

Returns:

NatsStreaming

port

public int port()

Gets the port out of the configuration

Returns:

configured port of the server

Throws:

RuntimeException - with ConnectException when there is no port configured

port

public NatsStreaming port(int port)

Sets the port out of the configuration

Parameters:

port - -1 for random port

Returns:

NatsStreaming

Throws:

RuntimeException - with ConnectException when there is no port configured

source

public NatsStreaming source(String natsServerUrl)

Url to find nats server source

Parameters:

natsServerUrl - url of the source NatsStreamingSourceConfig

Returns:

NatsStreaming

source

public String source()

Url to find nats server source

pid

public int pid()

get process id

Returns:

process id from nats server

pidFile

public Path pidFile()

natsPath

public Path natsPath()

Gets Nats server path

Returns:

Resource/{SIMPLE_CLASS_NAME}/{NATS_SERVER_VERSION}/{OPERATING_SYSTEM}/{SIMPLE_CLASS_NAME}

getNatsServerPath

protected Path getNatsServerPath(berlin.yuna.clu.logic.SystemUtil.OperatingSystem operatingSystem)

Gets Nats server path

Returns:

Resource/{SIMPLE_CLASS_NAME}/{NATS_SERVER_VERSION}/{OPERATING_SYSTEM}/{SIMPLE_CLASS_NAME}

waitForPort

public static boolean waitForPort(int port,
                                  long timeoutMs,
                                  boolean isFree)

toString

public String toString()

Overrides:

toString in class Object