Overview

Google Cloud Datastore is a NoSQL document database built for automatic scaling, high performance, and ease of application development. In this lab, you use Datastore to store application data for an online Quiz application. You also configure the application to retrieve from Datastore and display the data in the quiz.

The Quiz application skeleton has already been written. You clone the repository that contains the skeleton using Google Cloud Shell, review the code using the Cloud Shell editor, and view it using the Cloud Shell web preview feature. You then modify the code that stores data to use Cloud Datastore.

Objectives

In this lab, you perform the following tasks:

• Harness Cloud Shell as your development environment
• Preview the application
• Update the application code to integrate Cloud Datastore

Setup and requirements

Lab setup

For each lab, you get a new Google Cloud project and set of resources for a fixed time at no cost.

1. Sign in to Google Skills using an incognito window.

2. Note the lab's access time (for example, 1:15:00), and make sure you can finish within that time. There is no pause feature. You can restart if needed, but you have to start at the beginning.

3. When ready, click Start lab.

4. Note your lab credentials (Username and Password). You will use them to sign in to the Google Cloud Console.

5. Click Open Google Console.

6. Click Use another account and copy/paste credentials for this lab into the prompts. If you use other credentials, you'll receive errors or incur charges.

7. Accept the terms and skip the recovery resource page.

Activate Google Cloud Shell

Google Cloud Shell is a virtual machine that is loaded with development tools. It offers a persistent 5GB home directory and runs on the Google Cloud.

Google Cloud Shell provides command-line access to your Google Cloud resources.

1. In Cloud console, on the top right toolbar, click the Open Cloud Shell button.

   

2. Click Continue.

It takes a few moments to provision and connect to the environment. When you are connected, you are already authenticated, and the project is set to your PROJECT_ID. For example:

gcloud is the command-line tool for Google Cloud. It comes pre-installed on Cloud Shell and supports tab-completion.

• You can list the active account name with this command:

Output:

Example output:

• You can list the project ID with this command:

Output:

Example output:

Task 1. Prepare the Quiz application

In this section, you access Cloud Shell, clone the git repository that contains the Quiz application, and then run the application.

Clone source code in Cloud Shell

1. In Cloud Shell command line, enter the following command to clone the repository for the class:

2. Create a soft link to your working directory:

Configure and run the Quiz application

1. Navigate to the directory that contains the sample files for this lab:

   cd ~/datastore/start

2. Create the environment variable GCLOUD_PROJECT that references the GCP Project ID:

   export GCLOUD_PROJECT=$DEVSHELL_PROJECT_ID

3. Install the application dependencies:

   mvn clean install

   The installation may take a couple of minutes. It's complete when you see output similar to the following:

   [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 03:16 min [INFO] Finished at: 2021-12-06T11:43:13Z [INFO] ------------------------------------------------------------------------

4. Run the application:

   mvn spring-boot:run

   The application is running when the last line output is similar to the following:

   11:48:08.939 [restartedMain] INFO c.g.training.appdev.QuizApplication - Started QuizApplication in 7.468 seconds (JVM running for 9.786)

Review the Quiz application

1. In Cloud Shell, click Web preview > Preview on port 8080 to preview the quiz application.

2. Click Create Question.

   You should see a simple form that contains textboxes for the question and answers with radio buttons to select the correct answer. Quiz authors can add questions in this part of the application.

3. Click Take Test.

   You are taken to a client application. Since you haven't made any questions, the Quite Interesting Quiz is blank.

4. In the top navigation bar, click GCP.

You should see a Dummy Title and Dummy Answers. The Dummy Title represents a sample question.

Quiz takers will answer questions in this part of the application.

5. To return to the server-side application, click on Quite Interesting Quiz in the navigation bar.

Task 2. Examine the Quiz application code

In this section and throughout the lab you'll review the Quiz application code in a code editor. You can use the shell editors that are installed on Cloud Shell, such as nano or vim, or use the Cloud Shell code editor. This lab uses the Cloud Shell code editor.

Launch the Cloud Shell text editor

• From Cloud Shell, click on the Open Editor icon.

Review the code

1. Navigate to the /training-data-analyst/courses/developingapps/v1.3/java/datastore/start folder using the file browser panel on the left side of the editor.

This is the root folder for the application.

2. From the start folder, navigate to the src/main/java/com/google/training/appdev folder using the file browser panel on the left side of the editor.

   The paths for Java source code files are relative to the appdev folder.

Review the Spring Boot web application

1. Select the .../QuizApplication.java file.

   In this file, the class contains the entrypoint for the Spring Boot application.

2. Select the .../services/gcp/domain/Question.java file.

   In this file, the domain class represents question data submitted in the question form and questions displayed when taking a quiz.

3. Select the .../web/QuestionsController.java file.

   This file contains the handlers that display the form and collect form data posted by quiz authors in the web application.

   In the QuestionsController.java file, find the handler that responds to HTTP POST requests for the /questions/add route.

4. Navigate to the /training-data-analyst/courses/developingapps/v1.3/java/datastore/start/src/main/resources folder using the file browser panel on the left side of the editor.

5. Select the templates folder.

This folder contains the template for the web application user interface using the Thyme templating engine.

6. Select the .../templates/new_question.html file.

   This file contains the template for the Create Question form. Notice how there is a select list to pick a quiz, textboxes where an author can enter the question and answers, and radio buttons to select the correct answer.

7. Return to the folder containing Java source code using the file browser panel on the left side of the editor. (Do you remember? It's start/src/main/java/com/google/training/appdev.)

8. Select the .../api/QuizEndpoint.java file.

   This file contains the handler that sends JSON data to students taking a test. Notice that the handlers also make use of the questionService object.

9. Select the .../services/gcp/datastore/QuestionService.java file.

   This is the file where you write Datastore code to save and load quiz questions to and from Cloud Datastore. The web application and API use this class.

Task 3. Add entities to Cloud Datastore

In this section, you write code to save form data in Cloud Datastore.

Create an App Engine application to provision Cloud Datastore

1. From Cloud Shell, click on the Open Terminal icon and stop the application by pressing Ctrl+C.

2. To create an App Engine application in your project, execute the following command in Cloud Shell:

Import and use the Java Datastore package

1. Open the .../services/gcp/datastore/QuestionService.java file in the Cloud Shell editor.

2. Write a star import for the com.google.cloud.datastore.* package:

   // TODO: Import the com.google.cloud.datastore.* package import com.google.cloud.datastore.*; // END TODO

3. Declare a Datastore client object named datastore and initialize it:

   // TODO: Create a Datastore client object, datastore // The DatastoreOptions class has a getDefaultInstance() // static method. // Use the getService() method of the DatastoreOptions // object to get the Datastore client private Datastore datastore = DatastoreOptions.getDefaultInstance().getService(); // END TODO

After the updates, the first part of QuestionService.java is as follows:

Write code to create a Cloud Datastore entity

1. Declare a static final string named ENTITY_KIND, initialized with the value "Question":

   // TODO: Declare a static final String named kind //The Datastore key is the equivalent of a primary key in a // relational database. // There are two main ways of writing a key: // 1. Specify the kind, and let Datastore generate a unique // numeric id // 2. Specify the kind and a unique string id private static final String ENTITY_KIND = "Question"; // END TODO

2. Create a KeyFactory for Question entities:

   // TODO: Create a KeyFactory for Question entities private final KeyFactory keyFactory = datastore.newKeyFactory().setKind(ENTITY_KIND); // END TODO

   Learn more about entities from the Entities, Properties, and Keys guide.

3. In the createQuestion(Question question) method, modify the method's return type to Key:

   // TODO: Modify return type to Key public Key createQuestion(Question question) { // END TODO

4. Declare a key with an allocated ID for the Question entity using the datastore client and Key Factory:

   // TODO: Declare the entity key, // with a Datastore allocated id Key key = datastore.allocateId(keyFactory.newKey()); // END TODO

   For more information view the KeyFactory (Google App Engine API for Java) guide.

5. Declare an entity named questionEntity, and initialize it using an entity builder:

   // TODO: Declare the entity object, with the key and data // The entity's members are set using the Entity.Builder. // This has a set method for property names and values // Values are retrieved from the Domain object Entity questionEntity = Entity.newBuilder(key) .set(Question.QUIZ, question.getQuiz()) .set(Question.AUTHOR, question.getAuthor()) .set(Question.TITLE, question.getTitle()) .set(Question.ANSWER_ONE,question.getAnswerOne()) .set(Question.ANSWER_TWO, question.getAnswerTwo()) .set(Question.ANSWER_THREE,question.getAnswerThree()) .set(Question.ANSWER_FOUR, question.getAnswerFour()) .set(Question.CORRECT_ANSWER, question.getCorrectAnswer()) .build(); // END TODO

6. Use the Datastore client object (datastore) to save the entity by calling its put(questionEntity) method:

   // TODO: Save the entity datastore.put(questionEntity); // END TODO

7. Modify the return statement to return the key for the entity:

   // TODO: Return the key return key; // END TODO

8. Save the file.

The following is the QuestionService.java content with all updates to this point:

Run the application and create a Cloud Datastore entity

1. From Cloud Shell, click on the Open Terminal icon and run the application:

   mvn spring-boot:run

   The application is running when you see the last line output similar to the following:

   11:50:12.862 [restartedMain] INFO c.g.training.appdev.QuizApplication - Started QuizApplication in 6.048 seconds (JVM running for 7.66)

2. In Cloud Shell, click Web preview > Preview on port 8080 to preview the quiz application.

3. Click Create Question, complete the form with the following values, and then click Save.

You are returned to the application home page.

4. The question you just made is now in DataReturn. In the Console, click Navigation menu > Datastore > default > Datastore Studio > Under Query results to see your new question in entities!

Task 4. Query Cloud Datastore

In this section, you write code to retrieve entity data from Cloud Datastore.

Write code to retrieve Cloud Datastore entities

1. From Cloud Shell, click on the Open Editor icon. Move to the getAllQuestions(String quiz) method in the .../services/gcp/datastore/QuestionService.java file, and remove the code for the existing Dummy questions:

   // TODO: Remove this code List<Question> questions = new ArrayList<>(); Question dummy = new Question.Builder() .withQuiz("gcp") .withAuthor("Dummy Author") .withTitle("Dummy Title") .withAnswerOne("Dummy Answer One") .withAnswerTwo("Dummy Answer Two") .withAnswerThree("Dummy Answer Three") .withAnswerFour("Dummy Answer Four") .withCorrectAnswer(1) .withId(-1) .build(); questions.add(dummy); return questions; // END TODO

2. Still in the getAllQuestions(String quiz)method, create a query object and initialize it with a query that retrieves Question entities for a specific quiz from Cloud Datastore:

   // TODO: Create the query // The Query class has a static newEntityQueryBuilder() // method that allows you to specify the kind(s) of // entities to be retrieved. // The query can be customized to filter the Question // entities for one quiz. Query<Entity> query = Query.newEntityQueryBuilder() .setKind(ENTITY_KIND) .setFilter(StructuredQuery.PropertyFilter.eq( Question.QUIZ, quiz)) .build(); // END TODO

   For more information view the Datastore Queries guide.

3. Call the Datastore client object's datastore.run(query) method, and assign the result to entity iterator named entities:

   // TODO: Execute the query // The datastore.run(query) method returns an iterator // for entities Iterator<Entity> entities = datastore.run(query); // END TODO

4. Return the transformed results, using buildQuestions(entities) method to convert Datastore entities to domain objects:

   // TODO: Return the transformed results // Use the buildQuestions(entities) method to convert // from Datastore entities to domain objects return buildQuestions(entities); // END TODO

5. Uncomment the buildQuestions(...) and entityToQuestion(...) helper methods provided in the QuestionService class and use them to map the iterator to a list of question domain objects.

The following is the updated QuestionService.java:

Run the application and test the Cloud Datastore query

1. Save the .../services/gcp/datastore/QuestionService.java file, and then return to the Cloud Shell command.

2. From Cloud Shell, click on the Open Terminal Stop the application by pressing Ctrl+C.

3. Start the application.

4. In Cloud Shell, click Web preview > Preview on port 8080 to preview the quiz application.

5. Replace the query string at the end of the application's URL with /api/quizzes/gcp.

6. Return to the application home page, and click Take Test and then click GCP.

End your lab

When you have completed your lab, click End Lab. Google Skills removes the resources you’ve used and cleans the account for you.

You will be given an opportunity to rate the lab experience. Select the applicable number of stars, type a comment, and then click Submit.

The number of stars indicates the following:

• 1 star = Very dissatisfied
• 2 stars = Dissatisfied
• 3 stars = Neutral
• 4 stars = Satisfied
• 5 stars = Very satisfied

You can close the dialog box if you don't want to provide feedback.

For feedback, suggestions, or corrections, please use the Support tab.

Copyright 2026 Google LLC All rights reserved. Google and the Google logo are trademarks of Google LLC. All other company and product names may be trademarks of the respective companies with which they are associated.