Grails 1.1. Web Application. Development. Reclaiming Productivity for Faster. Java Web Development. Jon Dickinson PUBLISHING J MUMBAI BIRMINGHAM

Grails 1.1 Web

_Application

Development

Reclaiming Productivity

for Faster

Java Web

_Development

Jon Dickinson

PUBLISHING J

Table

of

Contents

Preface

_{1_}

Chapter

1:

_Getting

Started with Grails ₇

Why

Grails? ₇

Less

_{configuration}

₈

Faster

_setup

₈

Shorter

_{develop/test cycle}

₉ Consistent

_development

_{environment 9}

Domain-specific

language

for web

_development

₁₀

Fewer

_dependencies

₁₀

Installing

Grails ₁₁

Build a team communication

_portal

₁₄

Summary

15

Chapter

2:

_Managing

Users with

_Scaffolding

₁₇

What is

_scaffolding?

₁₇ Createthe domain classes ₁₈

Create _{the User domain class 19}

Create the Roledomain class ₂₀

Creating

controllers to enable

_scaffolding

₂₁

Control

_through

constraints ₂₅

Meeting

the relations ₂₉

Relating

roles and users ₂₉

Ordering

fields_through constraints ₃₁

Bootstrapping

demo data ₃₁

Summary

33

Chapter

3:

_{Posting Messages}

₃₅

Message

domain class ₃₆

Rendering

a form ₃₇

Tabic_ofContents

Groovy

Server_Pages Create message view

Grails_layouts

Show the form

Handling userinput

Binding the _requestto thedomain

Validate and save

Flash scope Redirect

Render validation errors

Feedbackto theuser

Createa home _page

HomeController

List all messages

Home page view

Styles

and

_navigation

Setthe _{default page}

Update the _layout

Tidying up HTML_encoding

Overriding

validation error _messages

Summary

Chapter 4: Introduction to Groovy

What is

_Groovy?

59

Object-Oriented

60

Dynamic

60

Functional 61

Loosely typed and _{strongly typed} 61

Why Groovy? 62

Familiar _syntax 62

Direct integration with Java 62

Running Groovy

63

Installing Groovy

63

Groovy

shell 65

Groovy

console 66

Execute _{Groovy scripts} 66

Groovy classes and _scripts 67

GroovyFeatures 68 Semicolons ₆₈

Strings

69 Numbers 70 37 38 39 39 41 42 43 44 44 45 46 48 48 48 49 52 52 52 54 55 57 58 59

Table_ofContents

Lists ₇₂

Maps 74

Ranges

75

Truth and _{equality 76}

Closures ₇₇

Plain old

_{Groovy objects}

₇₈

Metaprogramming

79

Adding dynamicbehavior ₈₀

The _{great pretender}

80

Builders ₈₁

Summary

83

Chapter

5: Authentication with

_JSecurity

_Plug-in

₈₅ Where tofind

_plug-ins

₈₆

Installing

a _{plug-in 86}

Configuring JSecurity plug-in

88

How does

_JSecurity

_{work? 88}

More aboutrealms ₈₉

Create a

simple

realm ₉₀

Implementauthenticate ₉₁

Dynamicfinders ₉₂

Implement hasRole ₉₄

Install the authentication controller 94

The authenticationfilter ₉₅

Password

_encryption

₉₇

Add the

_missing

_{pieces 99}

Encryption

of users'

_passwords

₉₉

Permission denied page 101

Sign out link ₁₀₃

Who _posted that? ₁₀₅

Relate _{messages to} users ₁₀₆

Making

it

_happen

₁₀₇

Showing

the user ₁₀₈

Hibernate _{lazy loading 109}

Eagerload users ₁₁₀

Summary

111

Chapter 6:

_Testing

₁₁₃

Writing

unit tests ₁₁₄

Why wewrite unittests ₁₁₄

Confidencein code ₁₁₄

Improve design 114

Developerproductivity 114

Table_ofContents

How towriteunit tests 115

Test discreet units of code H5

Trust your libraries 115

Test yourproductioncode 116

Descriptivetestnames 116

Testonethingatatime 117

JUnit refresher 117

SetUp and TearDown 118

Asserting expectations 118

Unittests in Grails 119

Groovytestextensions 119

Create a

grails

test 121

Running

our tests 121

Grails_testing

_plug-in

122

Testing Metacontroller 123

Testingvalidation 127

Limitations of Grails in unit tests 128

Integration testing 128

External

_dependencies

129

Repeatable

tests 129

Integration

tests in Grails 129

Bootstrap

for environments 130

Functional _testing 132

Environment _setup 132

Repeatable

tests 133

Test _performance 133

Fragility of tests 133

Makingtests understandable 133

Functional

_testing

In Grails 134

Benefits of functional_testing in Grails 134

Installing

thefunctional_{testing plug-in} 134

Testing guidance

136

Summary 137

Chapter

7: File _{Sharing 139}

File domain

_object

₁₃₉

FileController ₁₄₀

File _Upload GSP ₁₄₁

Saving

the file 143

Grails file

_upload

₁₄₃

Thesave action ₁₄₃

Validation _{messages 145}

Table_ofContents

Modeling

for

_efficiency

₁₄₇

Downloading

files ₁₄₉

Summary

150

Chapter

8: More GORM and Criteria ₁₅₁

Sort order of

_{relationships}

₁₅₃

Update

validation messages 153

Querying

with criteria ₁₅₃

Comparing

criteria and

_dynamic

finders ₁₅₄

Using

logical

operators 155

Querying

across

relationships

₁₅₅

Specifying

afetchmode for

_{relationships}

₁₅₆

Criteria reference ₁₅₆

Logical

criteria ₁₅₈

Setting

criteria _{properties 158}

Updating

FileController ₁₅₉

Updating

the create file view ₁₅₉

Handling

save ₁₆₀

Render file versions ₁₆₁ Fixfiledownload ₁₆₄

Summary

164

Chapter

9: Services ₁₆₅

Introducing

services ₁₆₅

Dependency injection

166 Service scope 167

Implementing

FileService ₁₆₈

Summary

172

Chapter

10:

_Managing

Content

_{through Tagging}

₁₇₃

Add basic

_tagging

₁₇₃

Tagging

domain model ₁₇₄

The_Tag class ₁₇₄

The_Taggerclass ₁₇₄

Tagging

a _{message 176}

Tagging

afile ₁₇₈

GORM inheritance ₁₇₉

Taggable superclass 181

Polymorphic queries 182

Exposing

tagging

to the users ₁₈₅

Add the_{Tags input}field ₁₈₅

Add_{multiple tags}to_{Taggable 186}

Savingthe users_{tags 186}

Displaying tags 187

TableofContents

Customize the home page 189

Introducing

templates 189

Passing

data to a

template

190

Renderamap "191

Renderanobject "191

Renderacollection 191

Template

namespace 192

Create the _{message and} file _templates 192

User

_tags

193

Userto_{tag relationship} 193

User ProfileController 194

The_myTagsform 195

Personalizing the home page 196

Content service 196

UpdatetheHomeController 199

Updatethe home page 199

All _Messages and Files 201

Summary

204

Chapter 11: AJAX and RIA Frameworks 205

Edit_tags inline 205

The remoteLink_tag 206

The formRemote _tag 207

Taggable controller 208

Tag

views ₂₀₉

Tagging

domain

_changes

₂₁₁

Include the

_{Prototype library}

₂₁₁

Try

itout 212

Auto-complete

tags 213

Installing the RichU I 213

Implementthe

_{auto-complete}

₂₁₄

Suggest tagsaction ₂₁₄

RichUI _{autoComplete widget} 215

Introducing

tag clouds ₂₁₉

RichUI _tag cloud

_component

₂₁₉

Fetch the_tag cloud _{map 221}

Filter_{by tags 221}

Rendering

the_tag cloud 224

Summary

225

Chapter

12:

_Searching,

_RSS, and REST Services 227

Searching

227

Make our

_objects

searchable ₂₂₈

Tableof Contents

Site-wide search ₂₂₉

Create the search controller ₂₃₀

Viewthe search results ₂₃₁

Updatethe_{templates 232}

More

_searching

₂₃₄

RSS ₂₃₅

A note about builders ₂₃₅

Create the RSS feed ₂₃₆

Remove authorization check ₂₃₈

REST services ₂₃₉

REST overview ₂₃₉

URL _{mapping 240}

Mapping to variables ₂₄₁

Mapping toHTTP _responsecodes ₂₄₁

Mapping toHTTP methods ₂₄₁

REST service_{mappings 242}

Mapping to wildcards ₂₄₂

Applying constraints ₂₄₂ Our_MessageAPI _{mapping 243}

Implementing

the RESTful controller ₂₄₃

Retrieving messages 244

Creatingnew _{messages 245}

Authentication for RESTAPI ₂₄₇

A test

_script

₂₄₈

Summary

250

Chapter

13: Build Your _{Own Plug-in 251}

The_tagger

_plug-in

₂₅₁

Extractthe_tagging code ₂₅₃

Accessing

plug-in templates

through

Tag Libraries 253

Calling

tagsfrom controllers 255

Current limitations ₂₅₆

Packaging

a

plug-in

₂₅₆

Using plug-in

events ₂₅₇

Grails _plug-in

_lifecycle

events ₂₅₇

doWithSpring 258

doWithWebDescriptor 259

doWithApplicationContext 259

doWithDynamicMethods 259

onChange and_{onConfigChange 259}

Inspecting

Grailsartifacts 260

The_{GrailsApplication} class ₂₆₀

Find Taggabledomain classes ₂₆₁

Re-modeling

tag

relationships

262

TableofContents

GroovyMetaClass 263 Gettingthe home_pageworking

Items ofInterest

^70

Create messagesandfiles 272

Updatetags 274

List messagesandfiles 1'°

RSS 280

Summary 280

Chapter14:

Deployment

and the Real World 283 Set up the environment 283

Install

_MySQL

283

Install Tomcat 284

Configure Grails 285

Set up theDataSource 285

DataSource_{configuration} 285

Environmentallyaware 286

Database _management 287

UpdateyourDB configuration 288

Control thebootstrap 289

Package

the WAR file 291

Deploy 292

Hosting options 292

Next_steps 292

Java Hibernate classeswith GORM 292

Integrating

with other_presentation frameworks 293

Data _{migration 294}

Summary

295