Skip to content

Commit 8e61ef7

Browse files
garrettjonesgooglegarrettjonesgoogle
authored
Removing Cloud Datastore section of main README (googleapis#2337)
1 parent 768ec4a commit 8e61ef7

3 files changed

Lines changed: 24 additions & 62 deletions

File tree

‎README.md‎

Lines changed: 1 addition & 58 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ Java idiomatic client for [Google Cloud Platform][cloud-platform] services.
1414

1515
This client supports the following Google Cloud Platform services at a [GA](#versioning) quality level:
1616
- [Stackdriver Logging](#stackdriver-logging-ga) (GA)
17-
- [Cloud Datastore](#google-cloud-datastore-ga) (GA)
17+
- [Cloud Datastore](google-cloud-datastore) (GA)
1818
- [Cloud Storage](google-cloud-storage) (GA)
1919
- [Cloud Translation](#google-translation-ga) (GA)
2020

@@ -297,63 +297,6 @@ LoggingHandler.addHandler(logger, new LoggingHandler());
297297
logger.warning("test warning");
298298
```
299299
300-
Google Cloud Datastore (GA)
301-
----------------------
302-
303-
- [API Documentation][datastore-api]
304-
- [Official Documentation][cloud-datastore-docs]
305-
306-
*Follow the [activation instructions][cloud-datastore-activation] to use the Google Cloud Datastore API with your project.*
307-
308-
#### Preview
309-
310-
Here are two code snippets showing simple usage examples from within Compute/App Engine. Note that you must [supply credentials](#authentication) and a project ID if running this snippet elsewhere.
311-
312-
The first snippet shows how to create a Datastore entity. Complete source code can be found at
313-
[CreateEntity.java](./google-cloud-examples/src/main/java/com/google/cloud/examples/datastore/snippets/CreateEntity.java).
314-
315-
```java
316-
import com.google.cloud.datastore.Datastore;
317-
import com.google.cloud.datastore.DatastoreOptions;
318-
import com.google.cloud.datastore.DateTime;
319-
import com.google.cloud.datastore.Entity;
320-
import com.google.cloud.datastore.Key;
321-
import com.google.cloud.datastore.KeyFactory;
322-
323-
Datastore datastore = DatastoreOptions.getDefaultInstance().getService();
324-
KeyFactory keyFactory = datastore.newKeyFactory().setKind("keyKind");
325-
Key key = keyFactory.newKey("keyName");
326-
Entity entity = Entity.newBuilder(key)
327-
.set("name", "John Doe")
328-
.set("age", 30)
329-
.set("access_time", DateTime.now())
330-
.build();
331-
datastore.put(entity);
332-
```
333-
The second snippet shows how to update a Datastore entity if it exists. Complete source code can be
334-
found at
335-
[UpdateEntity.java](./google-cloud-examples/src/main/java/com/google/cloud/examples/datastore/snippets/UpdateEntity.java).
336-
```java
337-
import com.google.cloud.datastore.Datastore;
338-
import com.google.cloud.datastore.DatastoreOptions;
339-
import com.google.cloud.datastore.DateTime;
340-
import com.google.cloud.datastore.Entity;
341-
import com.google.cloud.datastore.Key;
342-
import com.google.cloud.datastore.KeyFactory;
343-
344-
Datastore datastore = DatastoreOptions.getDefaultInstance().getService();
345-
KeyFactory keyFactory = datastore.newKeyFactory().setKind("keyKind");
346-
Key key = keyFactory.newKey("keyName");
347-
Entity entity = datastore.get(key);
348-
if (entity != null) {
349-
System.out.println("Updating access_time for " + entity.getString("name"));
350-
entity = Entity.newBuilder(entity)
351-
.set("access_time", DateTime.now())
352-
.build();
353-
datastore.update(entity);
354-
}
355-
356-
```
357300
Google Translation (GA)
358301
----------------
359302

‎google-cloud-datastore/README.md‎

Lines changed: 20 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -136,11 +136,30 @@ while (results.hasNext()) {
136136

137137
Cloud Datastore relies on indexing to run queries. Indexing is turned on by default for most types of properties. To read more about indexing, see the [Cloud Datastore Index Configuration documentation](https://cloud.google.com/datastore/docs/tools/indexconfig).
138138

139+
#### Updating data
140+
Another thing you'll probably want to do is update your data. The following snippet shows how to update a Datastore entity if it exists.
141+
142+
``` java
143+
KeyFactory keyFactory = datastore.newKeyFactory().setKind("keyKind");
144+
Key key = keyFactory.newKey("keyName");
145+
Entity entity = datastore.get(key);
146+
if (entity != null) {
147+
System.out.println("Updating access_time for " + entity.getString("name"));
148+
entity = Entity.newBuilder(entity)
149+
.set("access_time", DateTime.now())
150+
.build();
151+
datastore.update(entity);
152+
}
153+
```
154+
155+
The complete source code can be found at
156+
[UpdateEntity.java](../google-cloud-examples/src/main/java/com/google/cloud/examples/datastore/snippets/UpdateEntity.java).
157+
139158
#### Complete source code
140159

141160
In
142161
[AddEntitiesAndRunQuery.java](../google-cloud-examples/src/main/java/com/google/cloud/examples/datastore/snippets/AddEntitiesAndRunQuery.java)
143-
we put together all the code shown above into one program. The program assumes that you are
162+
we put together all the code to store data and run queries into one program. The program assumes that you are
144163
running on Compute Engine or from your own desktop. To run the example on App Engine, simply move
145164
the code from the main method to your application's servlet class and change the print statements to
146165
display on your webpage.

‎google-cloud-storage/README.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -104,7 +104,7 @@ Blob blob = storage.create(blobInfo, "a simple blob".getBytes(UTF_8));
104104
```
105105

106106
A complete example for creating a blob can be found at
107-
[CreateBlob.java](./google-cloud-examples/src/main/java/com/google/cloud/examples/storage/snippets/CreateBlob.java).
107+
[CreateBlob.java](../google-cloud-examples/src/main/java/com/google/cloud/examples/storage/snippets/CreateBlob.java).
108108

109109
At this point, you will be able to see your newly created bucket and blob on the Google Developers Console.
110110

@@ -118,7 +118,7 @@ String contentString = new String(content, UTF_8);
118118
```
119119

120120
A complete example for accessing blobs can be found at
121-
[CreateBlob.java](./google-cloud-examples/src/main/java/com/google/cloud/examples/storage/snippets/CreateBlob.java).
121+
[CreateBlob.java](../google-cloud-examples/src/main/java/com/google/cloud/examples/storage/snippets/CreateBlob.java).
122122

123123
#### Updating data
124124
Another thing we may want to do is update a blob. The following snippet shows how to update a Storage blob if it exists.
@@ -136,7 +136,7 @@ if (blob != null) {
136136
```
137137

138138
The complete source code can be found at
139-
[UpdateBlob.java](./google-cloud-examples/src/main/java/com/google/cloud/examples/storage/snippets/UpdateBlob.java).
139+
[UpdateBlob.java](../google-cloud-examples/src/main/java/com/google/cloud/examples/storage/snippets/UpdateBlob.java).
140140

141141
#### Listing buckets and contents of buckets
142142
Suppose that you've added more buckets and blobs, and now you want to see the names of your buckets and the contents of each one. Add the following code to list all your buckets and all the blobs inside each bucket.

0 commit comments

Comments
 (0)