google-cloud-datastore overview

com.google.cloud.datastore

A client for Cloud Datastore \u2013 A highly-scalable NoSQL database for web and mobile applications.

Here's a simple usage example for using google-cloud from App/Compute Engine. This example shows how to create a Datastore entity. For the complete source code see CreateEntity.java.


 Datastore datastore = DatastoreOptions.getDefaultInstance().getService();
 KeyFactory keyFactory = datastore.newKeyFactory().setKind("keyKind");
 Key key = keyFactory.newKey("keyName");
 Entity entity = Entity.newBuilder(key)
     .set("name", "John Doe")
     .set("age", 30)
     .set("access_time", Timestamp.now())
     .build();
 datastore.put(entity);
 

This second example shows how to get and update a Datastore entity if it exists. For the complete source code see UpdateEntity.java.


 Datastore datastore = DatastoreOptions.getDefaultInstance().getService();
 KeyFactory keyFactory = datastore.newKeyFactory().setKind("keyKind");
 Key key = keyFactory.newKey("keyName");
 Entity entity = datastore.get(key);
 if (entity != null) {
   System.out.println("Updating access_time for " + entity.getString("name"));
   entity = Entity.newBuilder(entity)
       .set("access_time", Timestamp.now())
       .build();
   datastore.update(entity);
 }
 

When using google-cloud from outside of App/Compute Engine, you have to specify a project ID and provide credentials. See Also: Google Cloud Datastore

com.google.cloud.datastore.spi

com.google.cloud.datastore.spi.v1

com.google.cloud.datastore.testing

A testing helper for Google Cloud Datastore.

A simple usage example:

Before the test:


 LocalDatastoreHelper helper = LocalDatastoreHelper.create();
 helper.start();
 Datastore localDatastore = helper.getOptions().getService();
 

After the test:


 helper.stop();
 

See Also: Google Cloud Java tools for testing

com.google.datastore.v1

com.google.datastore.v1.client