• Tutorial
• Download
• Plugins
• Search

Tutorial

The goal of this tutorial is to quickly get you started with using Gaelyk to write and deploy Groovy applications on Google App Engine. We'll assume you have already downloaded and installed the Google App Engine SDK on your machine. If you haven't, please do so by reading the instructions from Google.

The easiest way to get setup quickly is to download the template project from the download section. It provides a ready-to-go project with the right configuration files pre-filled and an appropriate directory layout:

• web.xml preconfigured with the Gaelyk servlets
• appengine-web.xml with the right settings predefined (static file directive)
• a sample Groovlet and template
• the needed JARs (Groovy, Gaelyk and Google App Engine SDK)

You can browse the JavaDoc of the classes composing Gaelyk.

Table of Content

• Setting up your project
• Directory layout
• Configuration files
• The template project
• Gradle build file
• Testing with Spock
• Views and controllers
• Variables available in the binding
• Eager variables
• Lazy variables
• Injecting services and variables in your classes
• Templates
• Includes
• Redirect and forward
• Groovlets
• Using MarkupBuilder to render XML or HTML snippets
• Delegating to a view template
• Logging messages
• Flexible URL routing system
• Configuring URL routing
• Defining URL routes
• Using wildcards
• Warmup requests
• Incoming email and jabber messages
• Using path variables
• Validating path variables
• Capability-aware routing
• Ignoring certain routes
• Caching groovlet and template output
• Namespace scoped routes
• Google App Engine specific shortcuts
• Improvements to the low-level datastore API
• Using Entitys as maps or POJOs/POGOs
• Converting beans to entities and back
• Adding CRUD operations to classes with @Entity
• List to Key conversion
• Added save() and delete() methods on Entity
• Added delete() and get() methods on Key
• Converting Key to an encoded String and vice-versa
• Added withTransaction() method on the datastore service
• Added get() methods on the datastore service
• Querying
• Asynchronous datastore
• Datastore metadata querying
• The task queue API shortcuts
• Email support
• Incoming email messages
• XMPP/Jabber support
• Sending messages
• Receiving messages
• XMPP presence handling
• XMPP subscription handling
• Enhancements to the Memcache service
• Asynchronous Memcache service
• Closure memoization
• Enhancements related to the Blobstore and File services
• Getting blob information
• Serving blobs
• Reading the content of a Blob
• Deleting a blob
• Example Blobstore service usage
• File service
• Namespace support
• Images service enhancements
• The images service and service factory wrapper
• An image manipulation language
• Capabilities service support
• URLFetch Service improvements
• Allowed options
• Channel service improvements
• Backend service support
• Search service support
• Simple plugin system
• What a plugin can do for you
• Anatomy of a Gaelyk plugin
• Hierarchy
• The plugin descriptor
• Using a plugin
• How to distribute and deploy a plugin
• Running and deploying Gaelyk applications
• Running and deploying Gaelyk applications
• Deploying your application in the cloud

© 2009-2014 — Guillaume Laforge and the Gaelyk development team

Powered by Gaelyk and Groovy

YourKit supports Gaelyk open source project with its full-featured Java Profiler. YourKit, LLC is the creator of innovative and intelligent tools for profiling Java and .NET applications. Take a look at YourKit's leading software products: YourKit Java Profiler and YourKit .NET Profiler.