com.google.cloud.datastore.testing

Class LocalDatastoreHelper

java.lang.Object

com.google.cloud.testing.BaseEmulatorHelper<DatastoreOptions>

com.google.cloud.datastore.testing.LocalDatastoreHelper

@InternalApi
public class LocalDatastoreHelper
extends BaseEmulatorHelper<DatastoreOptions>

Utility to start and stop local Google Cloud Datastore emulators.

This class is unstable.

Nested Class Summary

Nested classes/interfaces inherited from class com.google.cloud.testing.BaseEmulatorHelper

BaseEmulatorHelper.DownloadableEmulatorRunner, BaseEmulatorHelper.EmulatorRunner, BaseEmulatorHelper.GcloudEmulatorRunner

Field Summary

Fields inherited from class com.google.cloud.testing.BaseEmulatorHelper

DEFAULT_HOST, DEFAULT_PORT, PROJECT_ID_PREFIX

Method Summary

Modifier and Type	Method and Description
static LocalDatastoreHelper	create() Creates a local Datastore helper with a placeholder project ID and the default consistency setting of 0.9.
static LocalDatastoreHelper	create(double consistency) Creates a local Datastore helper with the specified settings for project ID and consistency.
static LocalDatastoreHelper	create(double consistency, int port) Creates a local Datastore helper with the specified settings for project ID and consistency.
static LocalDatastoreHelper	create(int port) Creates a local Datastore helper with a placeholder project ID and the default consistency setting of 0.9.
double	getConsistency() Returns the consistency setting for the local Datastore emulator.
protected List<BaseEmulatorHelper.EmulatorRunner>	getEmulatorRunners() Returns the emulator runners supported by this emulator.
protected Logger	getLogger() Returns a logger.
DatastoreOptions	getOptions() Returns a DatastoreOptions instance that sets the host to use the Datastore emulator on localhost.
DatastoreOptions	getOptions(String namespace) Returns a DatastoreOptions instance that sets the host to use the Datastore emulator on localhost.
void	reset() Resets the internal state of the Datastore emulator.
void	start() Starts the local Datastore emulator through gcloud, downloads and caches the zip file if user does not have gcloud or a compatible emulator version installed.
void	stop() Stops the Datastore emulator.
void	stop(org.threeten.bp.Duration timeout) Stops the Datastore emulator.

Methods inherited from class com.google.cloud.testing.BaseEmulatorHelper

findAvailablePort, getPort, getProjectId, isWindows, sendPostRequest, startProcess, waitForProcess

Methods inherited from class java.lang.Object

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

Method Detail

getEmulatorRunners

protected List<BaseEmulatorHelper.EmulatorRunner> getEmulatorRunners()

Description copied from class: BaseEmulatorHelper

Returns the emulator runners supported by this emulator. Runners are evaluated in order, the first available runner is selected and executed

Specified by:

getEmulatorRunners in class BaseEmulatorHelper<DatastoreOptions>

getLogger

protected Logger getLogger()

Description copied from class: BaseEmulatorHelper

Returns a logger.

Specified by:

getLogger in class BaseEmulatorHelper<DatastoreOptions>

getOptions

public DatastoreOptions getOptions()

Returns a DatastoreOptions instance that sets the host to use the Datastore emulator on localhost.

Specified by:

getOptions in class BaseEmulatorHelper<DatastoreOptions>

getOptions

public DatastoreOptions getOptions(String namespace)

Returns a DatastoreOptions instance that sets the host to use the Datastore emulator on localhost. The default namespace is set to namespace.

getConsistency

public double getConsistency()

Returns the consistency setting for the local Datastore emulator.

create

public static LocalDatastoreHelper create(double consistency)

Creates a local Datastore helper with the specified settings for project ID and consistency.

Parameters:

consistency - the fraction of Datastore writes that are immediately visible to global queries, with 0.0 meaning no writes are immediately visible and 1.0 meaning all writes are immediately visible. Note that setting this to 1.0 may mask incorrect assumptions about the consistency of non-ancestor queries; non-ancestor queries are eventually consistent.

create

public static LocalDatastoreHelper create(double consistency,
                                          int port)

Creates a local Datastore helper with the specified settings for project ID and consistency.

Parameters:

consistency - the fraction of Datastore writes that are immediately visible to global queries, with 0.0 meaning no writes are immediately visible and 1.0 meaning all writes are immediately visible. Note that setting this to 1.0 may mask incorrect assumptions about the consistency of non-ancestor queries; non-ancestor queries are eventually consistent.

port - the port to be used to start the emulator service. Note that setting this to 0 the emulator will search for a free random port.

create

public static LocalDatastoreHelper create(int port)

Creates a local Datastore helper with a placeholder project ID and the default consistency setting of 0.9.

Parameters:

port - the port to be used to start the emulator service. Note that setting this to 0 the emulator will search for a free random port.

create

public static LocalDatastoreHelper create()

Creates a local Datastore helper with a placeholder project ID and the default consistency setting of 0.9. Consistency refers to the fraction of Datastore writes that are immediately visible to global queries, with 0.0 meaning no writes are immediately visible and 1.0 meaning all writes are immediately visible.

start

public void start()
           throws IOException,
                  InterruptedException

Starts the local Datastore emulator through gcloud, downloads and caches the zip file if user does not have gcloud or a compatible emulator version installed.

Currently the emulator does not persist any state across runs.

Specified by:

start in class BaseEmulatorHelper<DatastoreOptions>

Throws:

IOException

InterruptedException

reset

public void reset()
           throws IOException

Resets the internal state of the Datastore emulator.

When running tests, one might reset() before each test, so earlier tests would not affect later ones.

Specified by:

reset in class BaseEmulatorHelper<DatastoreOptions>

Throws:

IOException

stop

public void stop(org.threeten.bp.Duration timeout)
          throws IOException,
                 InterruptedException,
                 TimeoutException

Stops the Datastore emulator.

It is important to stop the emulator. Since the emulator runs in its own process, not stopping it might cause it to become orphan.

It is not required to call reset() before stop.

Specified by:

stop in class BaseEmulatorHelper<DatastoreOptions>

Parameters:

timeout - The duration to wait for the emulator process to stop. It is recommended to set this value high to ensure proper shutdown, like 5 seconds or more.

Throws:

IOException

InterruptedException

TimeoutException

stop

public void stop()
          throws IOException,
                 InterruptedException,
                 TimeoutException

Stops the Datastore emulator. The same as stop(Duration) but with timeout duration of 20 seconds.

It is important to stop the emulator. Since the emulator runs in its own process, not stopping it might cause it to become orphan.

It is not required to call reset() before stop().

Throws:

IOException

InterruptedException

TimeoutException