在安装 grails 3 之前, 您至少需要安装一个安装了1.7 或1.8 版的 java 开发工具包 (jdk)。

如果要使用 jdk 1.7, 则需要使用 java 1.7.0 _ 131-b31 或更高版本运行 gradle, 以便在停止 tls v1.1 和 v1.1 支持时修复 gradle 依赖关系解析.

为您的操作系统下载适当的 jdk, 运行安装程序, 然后设置一个环境变量称为JAVA_HOME指向此安装的位置。

为了自动安装 grails, 我们建议sdkman , 它大大简化了安装和管理多个 grails 版本。

在某些平台 (例如 os x) 上, 会自动检测 java 安装。但是, 在许多情况下, 您需要手动配置 java 的位置。例如, 如果您使用的是 bash 或 Bourne Shell:

export JAVA_HOME=/Library/Java/Home

export PATH="$PATH:$JAVA_HOME/bin"

2.2 下载和安装

与 grails 一起启动和运行的第一步是安装发行版。

在 * nix 系统上安装 grails 的最佳方法是sdkman , 它大大简化了安装和管理多个 grails 版本。

使用 sdkman 安装

要使用 sdkman 安装最新版本的 grails, 请在您的终端上运行此操作:

sdk install grails

您还可以指定一个版本

sdk install grails 3.2.3

您可以在sdkman 文档上找到有关 sdkman 用法的更多信息

手动安装

对于手动安装, 请按照下列步骤操作:

下载grails 的二进制分布, 并将生成的 zip 文件提取到您选择的位置将GRAILS_HOME环境变量设置为提取 zip 的位置在基于 unix/linux 的系统上, 这通常是在您的配置文件中添加类似于以下内容export GRAILS_HOME=/path/to/grails在 windows 上, 这通常是将环境变量设置在My Computer/Advanced/Environment Variables然后将目录添加到变量中:binPATH在基于 unix/linux 的系统上, 这可以通过添加到您的配置文件来实现export PATH="$PATH:$GRAILS_HOME/bin"在 windows 上, 这是通过修改Path的环境变量来完成的。My Computer/Advanced/Environment Variables

如果 grails 工作正常, 您现在应该可以在终端窗口中键入并查看类似于以下内容的输出:grails -version

Grails version: 3.3.9

2.3 创建应用程序

要创建 grails 应用程序, 您首先需要熟悉以grails以下方式使用的命令的用法:

grails <<command name>>

运行create-app以创建应用程序:

grails create-app helloworld

这将在包含项目的当前目录内创建一个新目录。导航到控制台中的此目录:

cd helloworld

2.4 一个Hello World 例子

现在让我们拿新项目, 把它变成经典的 "Hello world!" 的例子。首先, 更改为刚刚创建的 "helloworld" 目录并启动 grails 交互式控制台:

$ cd helloworld$ grails

您应该会看到如下所示的提示:

我们想要的是一个简单的页面, 只需打印消息 "Hello world!" 到浏览器。在 grails 中, 每当您想要一个新页面时, 您只需为其创建一个新的控制器操作。由于我们还没有控制器, 让我们现在创建一个create-controller命令:

grails> create-controller hello

不要忘记, 在交互式控制台中, 我们对命令名称进行了自动完成。因此, 您可以键入 "cre", 然后按 <tab> 以获取所有命令的列表。再键入几个命令名称的字母, 然后再次 <tab> 完成。create-*

上述命令将在调用的目录grails-app/controllers/helloworld中创建一个新控制器HelloController.groovy。为什么会有额外的helloworld目录？因为在 java领域, 强烈建议将所有类都放置到包中, 因此, 如果不提供应用程序名称, grails将默认为应用程序名称。创建控制器的参考页提供了这方面的更多详细信息。

我们现在有一个控制器, 所以让我们添加一个操作来生成 "hello world!"，在任何文本编辑器中, 通过添加呈现行编辑新控制器 (HelloController.groovy文件)。编辑后的文件的代码应如下所示:

package helloworldclass HelloController { def index() { render "Hello World!" }}

操作只是一种方法。在这种特殊情况下, 它调用 grails 提供的一种特殊方法来呈现页面。

工作完成了要查看应用程序的运行情况, 您只需使用另一个名为run-app的命令启动服务器:

grails> run-app

这将在承载应用程序的端口8080上启动嵌入式服务器。您现在应该能够访问您的应用程序在url -尝试它!

请注意, 在 grails 的早期版本中, 上下文路径默认为应用程序的名称。如果要还原此行为, 可以在以下位置grails-app/conf/application.yml配置上下文路径:

server: contextPath: /helloworld

在上述配置到位的情况下, 服务器将改为在 url 启动。

如果您看到错误 "服务无法启动端口8080: 地址已在使用中", 则表示该端口上正在运行另一个服务。您可以通过使用在其他端口run-app -port=9090上运行服务来轻松解决此问题。"9090" 只是一个例子: 你几乎可以选择1024至49151范围内的任何东西。

在 windows 上, 如果您看到错误 "> 出现问题启动进程" 命令 "C:\path\to\java.exe '", 请使用--stacktrace标志再次运行它。如果根错误是 "Caused by: java.io.IOException: CreateProcess error=206, The filename or extension is too long", 则添加grails { pathingJar = true }到您的build.gradle文件中。这是 windows 的已知限制。

结果将如下所示:

这是由文件grails-app/view/index.gsp呈现的 grails 简介页面。它检测控制器的存在, 并提供指向它们的链接。您可以点击 "HelloController" 链接, 查看我们的自定义页面, 其中包含文本 "hello world!"瞧！你有你的第一个工作 grails 应用程序。

最后一点: 控制器可以包含许多操作, 每个操作对应于不同的页面 (此时忽略 ajax)。每个页面都可以通过由控制器名称和操作名称组成的唯一 url 进行访问:/<appname>/<controller>/<action>。这意味着您可以通过/helloworld/hello/index访问hello world 页面, 其中 "hello" 是控制器名称 (从类名中删除 "Controller" 后缀, 从第一个字母小写), "index" 是操作名称。但您也可以通过相同的 url 访问页面, 而不使用操作名称: 这是因为 "index" 是默认操作。请参阅用户指南的控制器和操作部分的末尾, 以了解有关默认操作的详细信息。