README
1Grails, release 1.3.6
2-----------------------------------
3http://grails.org/
4
5
61. INTRODUCTION
7=============================================================================
8
9
10Grails is a web application framework based on the Groovy language that endorses the DRY (don't repeat yourself) and coding-by-convention philosophies. Grails runs on the Java Virtual Machine and thus has access to the entire Java Platform.
11
12With Grails you can easily create web applications thanks to:
13
14- a complete development and deployment environment. All dependencies and configuration that is required to the run Grails applications in a web server are provided by Grails. The only thing you have to worry about is your application code.
15
16- inclusion of an embedded web server
17
18- development mode that automatically reloads changes made to application code, without having to restart the web server.
19
20- automatic persistence mapping of domain classes with automatic relationship management.
21
22- scaffolding on data access classes for rapid development of CRUD (Create, Read, Update, Delete) operations.
23
24- powerful view technology with dynamic tag libraries and support for Groovy Server Pages (GSP)
25
26
272. GETTING STARTED
28=============================================================================
29
30
31To get started follow these steps:
32
33- create a GRAILS_HOME environment variable that points to the path of the Grails distribution (the folder contain this file).
34
35- add the bin folder in the Grails distribution to the PATH environment variable
36
37On a Windows computer these step are done as follows:
38
39> set GRAILS_HOME=C:\download\grails
40> echo %GRAILS_HOME%
41C:\download\grails
42> set PATH=%GRAILS_HOME%\bin;%PATH%
43
44On a Unix-like computer these steps are done as follows:
45
46> set GRAILS_HOME=~/download/grails
47> export GRAILS_HOME
48> echo ${GRAILS_HOME}
49~/download/grails
50> cd ${GRAILS_HOME}
51> chmod a+x bin/grails
52> set PATH=${GRAILS_HOME}/bin:${PATH}
53> export PATH
54
55You can now run the grails command, as follows:
56
57> grails create-app YourProject
58
59For more info checkout the Grails homepage at http://grails.org
60
61
623. UPGRADING
63=============================================================================
64
65
66To upgrade your existing Grails projects you must run:
67
68grails clean
69grails upgrade
70
71...for each project.
72
73
743. BUILDING GRAILS FROM SOURCES
75=============================================================================
76
77
78To build Grails from sources use the Gradle build from the root of your Grails distribution.
79
80The 'assemble' target will create a new distribution in build/distributions:
81
82./gradlew assemble
83
84The 'libs' target will rebuild the JAR files located in the 'dist' directory:
85
86./gradlew libs
87
88The 'test' target will run Grails' test cases:
89
90./gradlew test
91
92=============================================================================
93Enjoy working with Grails.
94
95The Grails team.
96