(Quick Reference)

The Grails Framework

Authors: The Grails Team

Version: 3.3.1

Table of Contents

1.1What's new in Grails 3.3?

1.1.1GORM 6.1

1.1.2New Events API

1.1.3New Testing Framework

1.1.4JSON Views 1.2

1.1.5Updated Dependencies

1.1.6Other Novelties

2Getting Started

2.1Installation Requirements

2.2Downloading and Installing

2.3Creating an Application

2.4A Hello World Example

2.5Using Interactive Mode

2.6Getting Set Up in an IDE

2.7Convention over Configuration

2.8Running and Debugging an Application

2.9Testing an Application

2.10Deploying an Application

2.11Supported Java EE Containers

2.12Creating Artefacts

2.13Generating an Application

3Upgrading from Grails 3.2.x

4.1Basic Configuration

4.1.1Options for the YML format Config

4.1.2Built in options

4.1.3Logging

4.1.3.1Logger Names

4.1.3.2Masking Request Parameters From Stacktrace Logs

4.1.3.3External Configuration File

4.1.5Configuring an HTTP proxy

4.2The Application Class

4.2.1Executing the Application Class

4.2.2Customizing the Application Class

4.2.3The Application LifeCycle

4.3Environments

4.4The DataSource

4.4.1DataSources and Environments

4.4.2Automatic Database Migration

4.4.3Transaction-aware DataSource Proxy

4.4.4Database Console

4.4.5Multiple Datasources

4.5Versioning

4.6Dependency Resolution

5The Command Line

5.1Interactive Mode

5.2Creating Custom Scripts

5.3Creating Custom Commands

5.4Re-using Grails scripts

5.5Building with Gradle

5.5.1Defining Dependencies with Gradle

5.5.2Working with Gradle Tasks

5.5.3Grails plugins for Gradle

6Application Profiles

6.1Creating Profiles

6.2Profile Inheritance

6.3Publishing Profiles

6.4Understanding Profiles

6.5Creating Profile Commands

6.6Creating Profile Features

7Object Relational Mapping (GORM)

7.1Quick Start Guide

7.1.1Basic CRUD

7.2Further Reading on GORM

8.1Controllers

8.1.1Understanding Controllers and Actions

8.1.2Controllers and Scopes

8.1.3Models and Views

8.1.4Redirects and Chaining

8.1.5Data Binding

8.1.6Responding with JSON

8.1.7More on JSONBuilder

8.1.8Responding with XML

8.1.9Uploading Files

8.1.10Command Objects

8.1.11Handling Duplicate Form Submissions

8.1.12Simple Type Converters

8.1.13Declarative Controller Exception Handling

8.2Groovy Server Pages

8.3URL Mappings

8.3.1Mapping to Controllers and Actions

8.3.2Mapping to REST resources

8.3.3Redirects In URL Mappings

8.3.4Embedded Variables

8.3.5Mapping to Views

8.3.6Mapping to Response Codes

8.3.7Mapping to HTTP methods

8.3.8Mapping Wildcards

8.3.9Automatic Link Re-Writing

8.3.10Applying Constraints

8.3.11Named URL Mappings

8.3.12Customizing URL Formats

8.3.13Namespaced Controllers

8.5Interceptors

8.5.1Defining Interceptors

8.5.2Matching Requests with Inteceptors

8.5.3Ordering Interceptor Execution

8.6Content Negotiation

9.1Traits Provided by Grails

9.1.1WebAttributes Trait Example

10.1Domain classes as REST resources

10.2Mapping to REST resources

10.3Linking to REST resources from GSP pages

10.4Versioning REST resources

10.5Implementing REST controllers

10.5.1Extending the RestfulController super class

10.5.2Implementing REST Controllers Step by Step

10.5.3Generating a REST controller using scaffolding

10.6The REST Profile

10.7The AngularJS Profile

10.8The Angular Profile

10.9JSON Views

10.9.1Getting Started

10.9.2Creating JSON Views

10.9.3JSON View Templates

10.9.4Rendering Domain Classes with JSON Views

10.9.5JSON Views by Convention

10.10Customizing Response Rendering

10.10.1Customizing the Default Renderers

10.10.2Implementing a Custom Renderer

10.10.3Using GSP to Customize Rendering

10.11Hypermedia as the Engine of Application State

10.11.1HAL Support

10.11.2Atom Support

10.11.3Vnd.Error Support

10.12Customizing Binding of Resources

10.13RSS and Atom

11Asynchronous Programming

12.1Declaring Constraints

12.2Validating Constraints

12.3Sharing Constraints Between Classes

12.4Validation on the Client

12.5Validation and Internationalization

12.6Applying Validation to Other Classes

13The Service Layer

13.1Declarative Transactions

13.1.1Transactions Rollback and the Session

13.2Scoped Services

13.3Dependency Injection and Services

14Static Type Checking And Compilation

14.1The GrailsCompileStatic Annotation

14.2The GrailsTypeChecked Annotation

15.1Unit Testing

15.2Integration Testing

15.3Functional Testing

16Internationalization

16.1Understanding Message Bundles

16.2Changing Locales

16.3Reading Messages

16.4Scaffolding and i18n

17.1Securing Against Attacks

17.2Cross Site Scripting (XSS) Prevention

17.3Encoding and Decoding Objects

17.4Authentication

17.5Security Plugins

17.5.1Spring Security

18.1Creating and Installing Plugins

18.2Plugin Repositories

18.3Providing Basic Artefacts

18.4Evaluating Conventions

18.5Hooking into Runtime Configuration

18.6Adding Methods at Compile Time

18.7Adding Dynamic Methods at Runtime

18.8Participating in Auto Reload Events

18.9Understanding Plugin Load Order

18.10The Artefact API

18.10.1Asking About Available Artefacts

18.10.2Adding Your Own Artefact Types

19Grails and Spring

19.1Configuring Additional Beans

19.2Runtime Spring with the Beans DSL

19.3The BeanBuilder DSL Explained

19.4Property Placeholder Configuration

19.5Property Override Configuration

19.6Spring Boot Actuators

21.1Standalone

21.2Container Deployment (e.g. Tomcat)

21.3Deployment Configuration Tasks

22Contributing to Grails

22.1Report Issues in Github's issue tracker

22.2Build From Source and Run Tests

22.3Submit Patches to Grails Core

22.4Submit Patches to Grails Documentation

Quick Reference (hide)