|
Grails, release 1.3.6
----------------------------------- http://grails.org/ 1. INTRODUCTION ============================================================================= Grails 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. With Grails you can easily create web applications thanks to: - 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. - inclusion of an embedded web server - development mode that automatically reloads changes made to application code, without having to restart the web server. - automatic persistence mapping of domain classes with automatic relationship management. - scaffolding on data access classes for rapid development of CRUD (Create, Read, Update, Delete) operations. - powerful view technology with dynamic tag libraries and support for Groovy Server Pages (GSP) 2. GETTING STARTED ============================================================================= To get started follow these steps: - create a GRAILS_HOME environment variable that points to the path of the Grails distribution (the folder contain this file). - add the bin folder in the Grails distribution to the PATH environment variable On a Windows computer these step are done as follows: > set GRAILS_HOME=C:\download\grails > echo %GRAILS_HOME% C:\download\grails > set PATH=%GRAILS_HOME%\bin;%PATH% On a Unix-like computer these steps are done as follows: > set GRAILS_HOME=~/download/grails > export GRAILS_HOME > echo ${GRAILS_HOME} ~/download/grails > cd ${GRAILS_HOME} > chmod a+x bin/grails > set PATH=${GRAILS_HOME}/bin:${PATH} > export PATH You can now run the grails command, as follows: > grails create-app YourProject For more info checkout the Grails homepage at http://grails.org 3. UPGRADING ============================================================================= To upgrade your existing Grails projects you must run: grails clean grails upgrade ...for each project. 3. BUILDING GRAILS FROM SOURCES ============================================================================= To build Grails from sources use the Gradle build from the root of your Grails distribution. The 'assemble' target will create a new distribution in build/distributions: ./gradlew assemble The 'libs' target will rebuild the JAR files located in the 'dist' directory: ./gradlew libs The 'test' target will run Grails' test cases: ./gradlew test ============================================================================= Enjoy working with Grails. The Grails team. |