1 イントロダクション

• Hibernate上に構築された、簡単に利用できるオブジェクト・リレーショナル・マッピング(ORM)レイヤ
• 表現豊かなビューテクノロジーGroovy Server Pages (GSP)
• コントローラレイヤは Spring MVCを利用
• コマンドラインスクリプト環境にはGroovy版のAnt Gant
• リロード可能に設定された組込 Tomcat
• 組込 Spring による依存注入
• SpringのMessageSourceで実装された国際化(i18n)対応
• Springフレームワークのトランザクション概念によるサービスレイヤのトランザクション

1.1 Grails 2.4の新機能

Groovy 2.2

Spring 4.0

静的アセット管理はリソースプラグインからアセットパイプラインに変更されました

• javascripts
• stylesheets
• images

//= require jquery
//= require_self
//= require file_a
//= require_tree .
console.log('some javascript');

<asset:javascript src="application.js"/>
<asset:stylesheet href="application.css"/>
<asset:image src="grails_logo.png" height="60" />

スタティックコンパイル

Groovyは、デフォルトでで動的ディスパッチ・動的型付け言語ですが、同時に静的型付けスタティックコンパイルもサポートしています。 この、スタティックコンパイルに関してはGroovyのドキュメントを確認してください。 今までのGrails(2.x以降)でも、Groovyのスタティックコンパイルに対応している部分もありましたが、Grailsアプリで共通な、いくつかの特別な条件において使用できない場合がありました。例えば、@CompileStaticとマークされているメソッドの中でGORMにダイナミックファインダが実行されている場合などは、Groovyコンパイラがダイナミックファインダが有効と判断できないためスタティックコンパイルされません。Grails 2.4では、その部分にも対応して、GORMのダイナミックファインダが使用されていてもスタティックコンパイル可能にしました。

api:grails.compiler.GrailsCompileStaticアノテーションは、ほぼapi:groovy.transform.CompileStaticアノテーションと同等で、Grailsの特殊な仕組みをハンドルできるように提供されています。

次のコントローラの例は @GrailsCompileStaticを使用しています。スタティックコンパイル可能な物は全てスタティックコンパイルします。コンパイラがスタティックコンパイルが不可能と判断した場合はコンパイルエラーを出します。Grailsのコンパイラは内容を特定して判断します。

// grails-app/controllers/com/demo/PersonController.groovy
package com.demo
import grails.compiler.GrailsCompileStatic
@GrailsCompileStatic
class PersonController {
    def showKids() {
        def kids = Person.findAllByAgeLessThan(16)
        // …
    }
}

import grails.compiler.GrailsCompileStatic
import groovy.transform.TypeCheckingMode
@GrailsCompileStatic
class SomeClass {
    def update() {
        // this method will be statically compiled
    }
    @GrailsCompileStatic(TypeCheckingMode.SKIP)
    def save() {
        // this method will not be statically compiled
    }
    def delete() {
        // this method will be statically compiled
    }
}

import grails.compiler.GrailsCompileStatic
import groovy.transform.TypeCheckingMode
@GrailsCompileStatic
class SomeClass {
    def update() {
        // このメソッドはスタティックコンパイルされます
    }
    @GrailsCompileStatic(TypeCheckingMode.SKIP)
    def save() {
        // このメソッドはスタティックコンパイルされません！
    }
    def delete() {
        // このメソッドはスタティックコンパイルされます
    }
}

2.4.0の最終リリースまでに、さらなるスタティックコンパイル情報を提供する予定です

1.2 Grails 2.3の新機能

依存管理の向上

grails.project.dependency.resolver = "maven" // or ivy

データバインダー

• フィールドごとのカスタムデータフォーマット - api:org.grails.databinding.BindingFormat
• ユーザ定義可能なデータコンバーター - api:org.grails.databinding.converters.ValueConverter
• ユーザ定義フォーマットデータコンバーター - api:org.grails.databinding.BindingFormat api:org.grails.databinding.converters.FormattedValueConverter
• クラスごとのカスタムバインディング - api:org.grails.databinding.BindUsing
• フィールドごとのカスタムバインディング - api:org.grails.databinding.BindUsing
• デフォルトで全ての空文字列とブランクはデータバインディングでnullに変換されます(設定可能)

リクエストボディをコマンドオブジェクトにバインド

コントローラアクションがコマンドオブジェクトを受け取れる状態でリクエストがボディを含んでいる場合、ボディの内容はパースされコマンドオブジェクトにデータバインドされます。この機能は、リクエストの内容が対象のコマンドオブジェクトに対応したJSONまたXMLのボディを含んでいる処理を単純化します。 詳細は Command Objects のドキュメントを参照してください。

ドメインクラスをコマンドオブジェクトとして使用する際の振る舞い

ドメインクラスをコマンドオブジェクトとして使用して、リクエストパラメータに id が存在した場合は、 id を使用してデータベースからドメインクラスインスタンスを取り出します。 詳細は Command Objects のドキュメントを参照してください。

フォーク実行

grails.project.fork = [
   test: [maxMemory: 768, minMemory: 64, debug: false, maxPerm: 256, daemon:true], // configure settings for the test-app JVM
   run: [maxMemory: 768, minMemory: 64, debug: false, maxPerm: 256], // configure settings for the run-app JVM
   war: [maxMemory: 768, minMemory: 64, debug: false, maxPerm: 256], // configure settings for the run-war JVM
   console: [maxMemory: 768, minMemory: 64, debug: false, maxPerm: 256]// configure settings for the Console UI JVM
]

grails.project.fork = [
   test: [maxMemory: 768, minMemory: 64, debug: false, maxPerm: 256, daemon:true], // test-app用JVMへの設定
   run: [maxMemory: 768, minMemory: 64, debug: false, maxPerm: 256], // run-app用JVMへの設定
   war: [maxMemory: 768, minMemory: 64, debug: false, maxPerm: 256], // run-war用JVMへの設定
   console: [maxMemory: 768, minMemory: 64, debug: false, maxPerm: 256]// console用JVMへの設定
]

テストランナーデーモン

$ grails> restart-daemon

サーバサイドRESTの向上

• リソースマッピング、シンギュラリソースマッピング、ネステッドリソース、バージョニングなどの、豊富なREST URLマッピングサポート
• 新たな拡張可能なレスポンスレンダリングとバインディングAPI
• HAL, Atom, Hypermedia (HATEAOS)対応
• RESTコントローラのスカッフォルディング

スカッフォルディング2.0プラグイン

URLマッピングのリダイレクト指定

class UrlMappings {
    static mappings = {
        "/viewBooks"(redirect: '/books/list')
        "/viewAuthors"(redirect: [controller: 'author', action: 'list'])
        "/viewPublishers"(redirect: [controller: 'publisher', action: 'list', permanent: true])
        // …
    }
}

非同期サポート

import static grails.async.Promises.*
…
def index() {
   tasks books: Book.async.list(),
         totalBooks: Book.async.count(),
         otherValue: {
           // do hard work
         }
}

エンコーディング / エスケーピングの向上

• デフォルトでGSPエクスプレッションとスクリプトレットをHTMLエスケーピング
• タグでの状況依存エンコーディング切替
• 多重エンコーディング防止
• GSPページ内の全てのデータに対して安全と判断しない場合の自動エンコーディング

Hibernate 3と4をサポート

コントローラ例外ハンドリング

// grails-app/controllers/demo/DemoController.groovy
package demo
class DemoController {
    def someAction() {
        // do some work
    }
    def handleSQLException(SQLException e) {
        render 'A SQLException Was Handled'
    }
    def handleBatchUpdateException(BatchUpdateException e) {
        redirect controller: 'logging', action: 'batchProblem'
    }
    def handleNumberFormatException(NumberFormatException nfe) {
        [problemDescription: 'A Number Was Invalid']
    }
}

コントローラネームスペース

// grails-app/controllers/com/app/reporting/AdminController.groovy
package com.app.reporting
class AdminController {
    static namespace = 'reports'
    // …
}

// grails-app/controllers/com/app/security/AdminController.groovy
package com.app.security
class AdminController {
    static namespace = 'users'
    // …
}

// grails-app/conf/UrlMappings.groovy
class UrlMappings {
    static mappings = {
        '/userAdmin' {
            controller = 'admin'
            namespace = 'users'
        }
        '/reportAdmin' {
            controller = 'admin'
            namespace = 'reports'
        }
        "/$namespace/$controller/$action?"()
    }
}

<g:link controller="admin" namespace="reports">Click For Report Admin</g:link>
<g:link controller="admin" namespace="users">Click For User Admin</g:link>

詳しくは、 ドキュメント を参照してください。

コマンドライン

grails create-app appname --skip-wrapper

1.3 Grails 2.2の新機能

ネームスペース対応

Namespace Support

プラグインで提供されたドメインクラスは、 grails.gorm.table.prefix.enabled が true に設定されている場合、テーブル名称にプラグイン名のプリフィックスが追加されます。例として、 PublishingUtilities プラグインが提供した Book とい名称のドメインクラスであれば、テーブル名称が PUBLISHING_UTILITIES_BOOK となります。

static mappings = {
    // requests to /bookAuthors will be handled by the
    // AuthorController provided by the BookUtilities plugin
    "/bookAuthors" {
        controller = 'author'
        plugin = 'bookUtilities'
    }
    // requests to /publishingAuthors will be handled by the
    // AuthorController provided by the Publishing plugin
    "/publishingAuthors" {
        controller = 'author'
        plugin = 'publishing'
    }
}

<g:link controller="user" plugin="springSecurity">Manage Users</g:link>

class DemoController {
    def index() {
        redirect controller: 'user', action: 'list', plugin: 'springSecurity'
    }
}

フォークされたTomcat実行

Forked Tomcat Execution

• Grailsビルドシステムから抜けられるため、メモリーの消耗を減らします。
• ランタイムクラスパスから、独立したビルドクラスパス。
• 依存衝突無く並行して、別のGrails/Springアプリケーションのデプロイを可能にします。

クライテリアクエリーでのSQLプロジェクション

SQL Projections In Criteria Queries

// Use SQL projections to retrieve the perimeter and area of all of the Box instances…
def c = Box.createCriteria()
def results = c.list {
    projections {
      sqlProjection '(2 * (width + height)) as perimiter, (width * height) as area', ['perimeter', 'area'], [INTEGER, INTEGER]
    }
}

Groovy 2

1.4 Grails 2.1の新機能

Maven機能向上 / Maven マルチモジュールビルド対応

Maven Improvements / Multi Module Build Support

<dependency>
    <groupId>org.grails.plugins</groupId>
    <artifactId>hibernate</artifactId>
    <version>2.1.0</version>
    <type>zip</type>
    <scope>compile</scope>
</dependency>

The Maven plugin now resolves plugins as well as jar dependencies (previously jar dependencies were resolved by Maven and plugins by Ivy). Ivy is completely disabled leaving all dependency resolution up to Maven ensuring that evictions work as expected.

There is also a new Grails create-multi-project-build script which features initial support for Maven (Gradle coming in a future release). This script can be run from a parent directory containing Grails applications and plugins and it will generate a Maven multi-module build.

Enabling Maven in a project has been made easier with the inclusion of the create-pom command:

grails create-app myapp
cd myapp
grails create-pom com.mycompany
mvn package

To create a multi-module Maven build follow these steps:

grails create-app myapp
grails create-plugin plugin-a
grails create-plugin plugin-b
grails create-multi-project-build com.mycompany:parent:1.0-SNAPSHOT
mvn install

Grailsラッパー

Grails Wrapper

The Grails Wrapper allows a Grails application to build without having to install Grails and configure a GRAILS_HOME environment variable. The wrapper includes a small shell script and a couple of small bootstrap jar files that typically would be checked in to source code control along with the rest of the project. The first time the wrapper is executed it will download and configure a Grails installation. This wrapper makes it more simple to setup a development environment, configure CI and manage upgrades to future versions of Grails. When the application is upgraded to the next version of Grails, the wrapper is updated and checked in to the source code control system and the next time developers update their workspace and run the wrapper, they will automatically be using the correct version of Grails.

See the Wrapper Documentation for more details.

デバッグオプション

Debug Option

The grails command now supports a -debug option which will startup the remote debug agent. This behavior used to be provided by the grails-debug command. grails-debug is still available but is deprecated and may be removed from a future release.

grails -debug run-app

Grailsコマンドエイリアス

Grails Command Aliases

The alias command may be used to define aliases for grails commands.

The following command creates an alias named rit (short for "run integration tests"):

grails alias rit test-app integration:

See the alias docs for more info.

キャッシュプラグイン

Cache Plugin

Grails 2.1 installs the cache plugin by default. This plugin provides powerful and easy to use cache functionality to applications and plugins. The main plugin provides basic map backed caching support. For more robust caching options one of the implementation plugins should be installed and configured. See the cache-redis docs and the cache-ehcache docs for details.

See the main plugin documentation for details on how to configure and use the plugin.

新たなGORMメソッド

New GORM Methods

In Grails 2.1.1 domain classes now have static methods named first and last to retrieve the first and last instances from the datastore. See the first and last documentation for details.

1.5 Grails 2.0の新機能

1.5.1 開発環境機能

インタラクティブモードとコンソールの強化

Interactive Mode and Console Enhancements

リロードエージェント

Reloading Agent

新テストレポートとドキュメントテンプレート

New Test Report and Documentation Templates

プロジェクトドキュメントでの目次

Use a TOC for Project Docs

The old documentation engine relied on you putting section numbers into the gdoc filenames. Although convenient, this effectively made it difficult to restructure your user guide by inserting new chapters and sections. In addition, any such restructuring or renaming of section titles resulted in breaking changes to the URLs.

You can now use logical names for your gdoc files and define the structure and section titles in a YAML table-of-contents file, as described in the section on the documentation engine. The logical names appear in the URLs, so as long as you don't change those, your URLs will always remain the same no matter how much restructuring or changing of titles you do.

Grails 2.0 even provides a migrate-docs command to aid you in migrating existing gdoc user guides.

エラーレポートと分析表示の強化

Enhanced Error Reporting and Diagnosis

Line | Method
->>   9 | getValue     in Book.groovy
- - - - - - - - - - - - - - - - - - - - - - - - -
|     7 | getBookValue in BookService.groovy
|   886 | runTask . .  in ThreadPoolExecutor.java
|   908 | run          in     ''
^   662 | run . . . .  in Thread.java

H2データベースとDBコンソール

H2 Database and Console

プラグイン使用数等のトラッキング機能

Plugin Usage Tracking

依存管理機能改善

Dependency Resolution Improvements

• Grailsは、 BuildConfig.groovy を変更しない限り前回の依存解決した内容を再解決させないように前回の内容をキャッシュするようになりました。
• プラグイン依存関係も grails dependency-report のレポートに現れるようになりました。
• release-plugin で発行されたプラグインは、推移的なプラグイン依存をPOMに発行するようになりました。
• ivyキャッシュ用ディレクトリを BuildConfig.groovy で変更できます。

grails.project.dependency.resolution = {
    cacheDir "target/ivy-cache"
}

• settings.groovyに設定することで、全てのプロジェクトのivyキャッシュディレクトリを変更できます。

grails.dependency.cache.dir = "${userHome}/.ivy2/cache"

• リポジトリの引継を完全に無効にできます(他のプラグインで定義されている場合等):

grails.project.dependency.resolution = {
    repositories {
        inherits false // Whether to inherit repository definitions from plugins
        …
    }
    …
}

• チェックサムを無効にできます:

grails.project.dependency.resolution = {
    checksums false // whether to verify checksums or not
}

1.5.2 コア機能

バイナリプラグイン

Binary Plugins

Groovy 1.8

Groovy 1.8

Spring 3.1 プロファイルサポート

Spring 3.1 Profile Support

1.5.3 Web機能

コントローラのアクションにメソッドを利用

Controller Actions as Methods

// メソッドのアクション (action as a method)
def index() {
}
// クロージャのアクション (action as a closure)
def index = {
}

アクションに引数を指定してバインド

Binding Primitive Method Action Arguments

<g:form name="myForm" action="save">
    <input name="name" />
    <input name="age" />
</g:form>

def save(String name, int age) {
    // remaining
}

静的リソース抽象化

Static Resource Abstraction

サーブレット3.0の非同期処理

Servlet 3.0 Async Features

def index() {
    def ctx = startAsync()
    ctx.start {
        new Book(title:"The Stand").save()
        render template:"books", model:[books:Book.list()]
        ctx.complete()
    }
}

リンク生成API

Link Generation API

LinkGenerator grailsLinkGenerator
def generateLink() {
    grailsLinkGenerator.link(controller:"book", action:"list")
}

ページレンダリングAPI

Page Rendering API

grails.gsp.PageRenderer groovyPageRenderer
void welcomeUser(User user) {
    def contents = groovyPageRenderer.render(view:"/emails/welcomeLetter", model:[user: user])
    sendEmail {
        to user.email
        body contents
    }
}

new File("/path/to/welcome.html").withWriter { w ->
    groovyPageRenderer.renderTo(view:"/page/content", w)
}

フィルター除外機能

Filter Exclusions

filter1(actionExclude: 'log*') {
    before = {
        // …
    }
}
filter2(controllerExclude: 'auth') {
    before = {
        // …
    }
}
filter3(uriExclude: '/secure*') {
    before = {
        // …
    }
}

パフォーマンスの向上

Performance Improvements

HTML5スカッフォルド

HTML5 Scaffolding

jQueryがデフォルトになりました

jQuery by Default

簡単な日付解析

Easy Date Parsing

def val = params.date('myDate', 'dd-MM-yyyy')
// or a list for formats
def val = params.date('myDate', ['yyyy-MM-dd', 'yyyyMMdd', 'yyMMdd'])
// or the format read from messages.properties via the key 'date.myDate.format'
def val = params.date('myDate')

URLフォーマットのカスタマイズ

The default URL Mapping mechanism supports camel case names in the URLs. The default URL for accessing an action named addNumbers in a controller named MathHelperController would be something like /mathHelper/addNumbers. Grails allows for the customization of this pattern and provides an implementation which replaces the camel case convention with a hyphenated convention that would support URLs like /math-helper/add-numbers. To enable hyphenated URLs assign a value of "hyphenated" to the grails.web.url.converter property in grails-app/conf/Config.groovy.

// grails-app/conf/Config.groovy
grails.web.url.converter = 'hyphenated'

Arbitrary strategies may be plugged in by providing a class which implements the api:grails.web.UrlConverter interface and adding an instance of that class to the Spring application context with the bean name of grails.web.UrlConverter.BEAN_NAME. If Grails finds a bean in the context with that name, it will be used as the default converter and there is no need to assign a value to the grails.web.url.converter config property.

// src/groovy/com/myapplication/MyUrlConverterImpl.groovy
package com.myapplication
class MyUrlConverterImpl implements grails.web.UrlConverter {
    String toUrlElement(String propertyOrClassName) {
        // return some representation of a property or class name that should be used in URLs…
    }
}

// grails-app/conf/spring/resources.groovy
beans = {
    "${grails.web.UrlConverter.BEAN_NAME}"(com.myapplication.MyUrlConverterImpl)
}

Webフローのインプットとアウトプット

Web Flow input and output

1.5.4 永続化機能

GORM API

The GORM API

DetachedクライテリアとWhereクエリー

Detached Criteria and Where Queries

Grails 2.0 features support for DetachedCriteria which are criteria queries that are not associated with any session or connection and thus can be more easily reused and composed:

def criteria = new DetachedCriteria(Person).build {
    eq 'lastName', 'Simpson'
}
def results = criteria.list(max:4, sort:"firstName")

To support the addition of DetachedCriteria queries and encourage their use a new where method and DSL has been introduced to greatly reduce the complexity of criteria queries:

def query = Person.where {
    (lastName != "Simpson" && firstName != "Fred") || (firstName == "Bart" && age > 9)
}
def results = query.list(sort:"firstName")

See the documentation on DetachedCriteria and Where Queries for more information.

新findOrCreateとfindOrSaveメソッド

New findOrCreate and findOrSave Methods

def book = Book.findOrCreateWhere(author: 'Douglas Adams', title: "The Hitchiker's Guide To The Galaxy")
def book = Book.findOrSaveWhere(author: 'Daniel Suarez', title: 'Daemon')
def book = Book.findOrCreateByAuthorAndTitle('Daniel Suarez', 'Daemon')
def book = Book.findOrSaveByAuthorAndTitle('Daniel Suarez', 'Daemon')

抽象クラス継承のサポート

Abstract Inheritance

abstract class Media {
    String title
    …
}
class Book extends Media {
}
class Album extends Media {
}
class Account {
    static hasMany = [purchasedMedia:Media]
}
..
def allMedia = Media.list()

複数データソースサポート

Multiple Data Sources Support

class ZipCode {
   String code
   static mapping = {
      datasource 'ZIP_CODES'
   }
}

def zipCode = ZipCode.auditing.get(42)

データベースマイグレーション

Database Migrations

データベースリバースエンジニアリング

Database Reverse Engineering

Hibernate 3.6

Hibernate 3.6

Bagコレクション

Bag Collections

1.5.5 テスト機能

新ユニットテストのコンソール出力

New Unit Testing Console Output

新しいユニットテストAPI

New Unit Testing API

import grails.test.mixin.TestFor
@TestFor(SimpleController)
class SimpleControllerTests  {
    void testIndex() {
        controller.home()
        assert view == "/simple/homePage"
        assert model.title == "Hello World"
    }
}

GORMのユニットテスト

Unit Testing GORM

インタラクティブモードで快速なユニットテストを

Faster Unit Testing with Interactive Mode

Unit Test スカッフォルド

Unit Test Scaffolding