Jello Framework

This guide will walk you through creating and deploying your first Jello web application. For more details, please see the Developer's Guide.

Jello is a java framework for developing web applications on Google App Engine (GAE). As a prerequisite, you will need to setup a GAE project using the Google Plugin for Eclipse.

Refer to the official Google Plugin for Eclipse page for instructions on how to install Google eclipse plugin.

GAE SDK plugin
GAE SDK plugin GAE SDK plugin

To create a new project, click on the New Web Application Project toolbar button. You can also access this wizard by selecting the Web Application Project item from the drop-down menu associated with the New toolbar button, or by selecting File » New » Web Application Project.

Creating a New Web Application

- Add a project name "HelloWorld" and a root package.

- Make sure the Use Google App Engine > Use default SDK is checked.

- Uncheck Use Google Web Toolkit as we will not use it for now.

- Leave the app id field blank. You will obtain an app id later before uploading the app to the cloud.


Test your app locally with the Development Server

  1. Right click on your project root folder » Run As » Web Application.

  2. Check the console and look for the dev server URL. It should be http://localhost:8888 Test your app
  3. Open a web browser and type this URL. Test your app

Download Jello SDK


All the resources you need for your Jello Application are available in the pre-packed Jello SDK jar archive file.

The easiest and recommended way to set up Jello is by installing the Jello Plugin for Eclipse which can be downloaded using the Jello plugin update site URL.

To install Jello SDK:

  1. Click on Help » Install New Software....

  2. In the Work with text box enter the following update site URL: http://jello-framework.com/plugin.

  3. Select Jello Framework SDK, click Next and OK as needed until the IDE is restarted and the plugin is installed. Test your app

Adding Jello support to a project an existing App Engine project

  1. Right click on the project root folder Jello Framework » Convert to Jello project.... add Jello support to an existing App Engine project
  2. Check the Generate sample code option and click OK. add Jello support to an existing App Engine project
  3. Take a minute to explore the project structure. A new app folder has been created, containing the sample jello application app namespace. In addition, a few files were added or modified under the war/WEB-INF folder. Test your app
  1. To run the project as a Web application - click on the run booton Run toolbar button and select run helloWrold
    You can also run it by right clicking on your project root folder » Run As » Web Application Test your app

    Test your app
  2. Open a web browser and type http://localhost:8888/jello. Click on the Product Data view link. Test your app
  3. Open a web browser and type http://localhost:8888/jello. Click on the Product Data view link. Test your app
  4. click on the Actions button, select and run createCatalog action. Test your app

  5. Check action results and click the Back button. Test your app
  6. Click the New button to create new product or click on one of the Key fields to edit an existing product record. Test your app
  7. click on the Entities button and navigate to the Category entity. Test your app

Sign in for Free Google Cloud Platform account

  1. Go to cloud.google.com/appengine/ and sign in for new free acount. Click the TRY IT FREE button. After signing in, you will be redirected to the Google Developers Console.

  2. From the Developers Console, open the google developers console projects dropdown located on the upper left corner of the page and click Create a project.... Test your app
  3. Select a name for your project and pick a unique Project ID by clicking on the edit project idlink. Project ID

  4. To assign the new Project ID to your eclipse project, right click on the project root folder in Eclipse » Google » App Engine Settings....
    in the Application ID text box enter the new Project ID. You can click on the My Applications... link to check your available apps. add Jello support to an existing App Engine project
  5. To deploy the application, right click on the project root folder in Eclipse Google » Deploy to App Engine » Deploy.

  6. If everythings went well and the application has been deployed successfuly, you should be able to check your new app in the following public URL: http://<Application-ID>.appspot.com/jello (replace <Application-ID> with the actual project ID). application public URL

Congratulations! You have just deployed your first Jello application on Google cloud!

Last updated May 26, 2016.