import spock.lang.Specification
import grails.testing.web.controllers.ControllerUnitTest
class HelloControllerTests extends Specification implements ControllerUnitTest<HelloController> {
void "Test message action"() {
when:"The message action is invoked"
controller.message()
then:"Hello is returned"
response.text == 'Hello'
}
}1 Introduction
Version: 3.3.16
Table of Contents
1 Introduction
Many modern web frameworks in the Java space are more complicated than needed and don’t embrace the Don’t Repeat Yourself (DRY) principles.
Dynamic frameworks like Rails and Django helped pave the way to a more modern way of thinking about web applications. Grails builds on these concepts and dramatically reduces the complexity of building web applications on the Java platform. What makes it different, however, is that it does so by building on already established Java technologies like Spring and Hibernate.
Grails is a full stack framework and attempts to solve as many pieces of the web development puzzle through the core technology and its associated plugins. Included out the box are things like:
-
GORM - An easy to use Object Mapping library with support for SQL, MongoDB, Neo4j and more.
-
View technologies for rendering HTML as well as JSON
-
A controller layer built on Spring Boot
-
A plugin system featuring hundreds of plugins.
-
Flexible profiles to create applications with AngularJS, React and more.
-
An interactive command line environment and build system based on Gradle
-
An embedded Tomcat container which is configured for on the fly reloading
All of these are made easy to use through the power of the Groovy language and the extensive use of Domain Specific Languages (DSLs)
This documentation will take you through getting started with Grails and building web applications with the Grails framework.
In addition to this documentation there are comprehensive guides that walk you through various aspects of the technology.
Finally, Grails is far more than just a web framework and is made up of various sub-projects. The following table summarizes some other key projects in the eco-system with links to documentation.
| Project | Description |
|---|---|
An Object Mapping implementation for SQL databases |
|
An Object Mapping implementation for the MongoDB Document Database |
|
An Object Mapping implementation for Neo4j Graph Database |
|
A View technology for rendering JSON on the server side |
|
A View technology for rendering HTML and other markup on the server |
|
Asynchronous programming abstraction with support for RxJava, GPars and more |
1.1 What's new in Grails 3.3?
This section covers all the new features introduced in Grails 3.3.
1.1.1 GORM 6.1
Grails 3.3 comes with GORM 6.1, which includes the following new features:
-
Multi-Tenancy AST Transforms
-
Rewritten
@Transactionaland@Rollbacktransformations -
Common Services like
TenantServiceandTransactionService -
Data Services Concept - Implement interfaces automatically!
-
Bean Validation API Support
-
JPA Annotation Support
-
Package Scanning and Easy Unit Testing
-
Neo4j Bolt 1.2 Driver Support
-
MongoDB 3.4 Driver Support
There are so many new features and novelties in GORM that we had to write its own independent What’s New Guide!
1.1.2 New Events API
The Grails Async Framework has been extracted from Grails and moved to a separate project.
This allows the Async support to evolve independent of the framework itself in a fast moving and evolving area.
In order to support multiple different asynchronous and reactive frameworks Grails 3.3 has been decoupled from Reactor 2.x and an abstract EventBus notation added.
The EventBus interface provides the foundation and multiple implementations including GPars and RxJava.
A new set of annotations usable in services classes and regular Spring beans can be leveraged to publish and consume events:
-
Publisher - A transformation that transforms a method ensuring the return value is published as an event
-
Subscriber - A transformation that transforms a method to listen for an event.
For more information see the new documentation.
1.1.3 New Testing Framework
Grails 3.3 includes a new Trait-based testing framework that replaces the existing @TestMixin based framework with a simpler implementation that is easier to debug, provides better code completion and is easier to extend.
An example hello world test can be seen below:
1.1.4 JSON Views 1.2
Version 1.2 of the JSON Views plugin is included with Grails 3.3’s "rest-api" profile and includes a number of new features. Below are some of the highlights:
-
Support for the JSON API specification
-
Ability to register custom converters
-
Multiple configuration options for date formatting, unicode escaping, etc
1.1.5 Updated Dependencies
Grails 3.3 ships with the following dependency upgrades:
-
Hibernate 5.1.5 (now the default version of Hibernate for new applications)
-
Spring Framework 4.3.9
-
Spring Boot 1.5.4
-
Gradle 3.5 (Grails 3.3 is also compatible with Gradle 4.x)
-
Spock 1.1
1.1.6 Other Novelties
Cache Plugin Rewritten
The Cache Plugin has been rewritten and no longer use proxies which improves startup time and performance. The plugin is also now Multi-Tenant aware, ensuring that cached data is not seen by other tenants.
Converters plugin now Separate
With JSON Views now being the recommended way to render JSON. The converters plugin has been split out from core into a separate project.
Logger name changes
Grails logger names for artifacts have been simplifled from grails.app.<type>.<className> to use the the package name.
For example grails.app.controller.com.example.BookController is now simply com.example.BookController.
For more information see the documentation.