com.google.datastore.v1.client

Class DatastoreEmulator

java.lang.Object

com.google.datastore.v1.client.Datastore

com.google.datastore.v1.client.DatastoreEmulator

public class DatastoreEmulator
extends Datastore

An extension to Datastore that provides lifecycle management for a datastore emulator.

In order to use the emulator for a JUnit 4 test you might do something like this:

 public class MyTest {

   static DatastoreEmulator datastore;

    @BeforeClass
   public static void startEmulator() throws DatastoreEmulatorException {
     DatastoreOptions options = new DatastoreOptions.Builder()
         .localHost("localhost:8080")
         .projectId("my-project-id")
         .build();
     datastore = DatastoreEmulatorFactory.get().create(options);
     datastore.start("/usr/local/cloud-datastore-emulator", "my-project-id");
   }

    @Before
   public void setUp() throws DatastoreEmulatorException {
     datastore.clear();
   }

    @AfterClass
   public static void stopEmulator() throws DatastoreEmulatorException {
     datastore.stop();
   }

    @Test
   public void testFoo1() { }

    @Test
   public void testFoo2() { }

 }
 

Method Summary

Modifier and Type	Method and Description
void	clear() Clears all data in the emulator.
File	getProjectDirectory()
void	start(String emulatorDir, String projectId, String... commandLineOptions) Starts the emulator.
void	stop() Stops the emulator.

Methods inherited from class com.google.datastore.v1.client.Datastore

allocateIds, beginTransaction, commit, getRpcCount, lookup, resetRpcCount, rollback, runQuery

Methods inherited from class java.lang.Object

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

Method Detail

clear

public void clear()
           throws DatastoreEmulatorException

Clears all data in the emulator.

Throws:

DatastoreEmulatorException - if the clear fails

start

public void start(String emulatorDir,
                  String projectId,
                  String... commandLineOptions)
           throws DatastoreEmulatorException

Starts the emulator. It is the caller's responsibility to call stop(). Note that receiving an exception does not indicate that the server did not start. We recommend calling stop() to ensure the server is not running regardless of the result of this method.

Parameters:

emulatorDir - The path to the emulator directory, e.g. /usr/local/cloud-datastore-emulator

projectId - The project ID

commandLineOptions - Command line options to pass to the emulator on startup

Throws:

DatastoreEmulatorException - If start(java.lang.String, java.lang.String, java.lang.String...) has already been called or the server does not start successfully.

stop

public void stop()
          throws DatastoreEmulatorException

Stops the emulator. Multiple calls are allowed.

Throws:

DatastoreEmulatorException - if the emulator cannot be stopped

getProjectDirectory

public File getProjectDirectory()