2 快速入门

本章提供有关如何启动和运行 Ratpack 应用程序以进行操作的说明。

1.2 使用 Groovy 脚本

Ratpack 应用程序可以实现为单个 Groovy 脚本。这是一种使用 Ratpack 和 Groovy 进行实验的有效方法。

首先，安装 Groovy。

创建文件 ratpack.groovy，其内容如下

@Grapes([
  @Grab('io.ratpack:ratpack-groovy:2.0.0-rc-1'),
  @Grab('org.slf4j:slf4j-simple:1.7.36')
])
import static ratpack.groovy.Groovy.ratpack

ratpack {
    handlers {
        get {
            render "Hello World!"
        }
        get(":name") {
            render "Hello $pathTokens.name!"
        }
    }
}

您现在可以通过在命令行上运行以下命令来启动应用程序

groovy ratpack.groovy

服务器将通过 http://localhost:5050/ 可用。

handlers() 方法 获取一个闭包，该闭包委托给 GroovyChain 对象。“Groovy 处理程序链 DSL” 用于构建响应处理策略。

在开发期间，对该文件的更改是实时的。您可以编辑该文件，更改将在下次请求时生效。

2.2 使用 Gradle 插件

我们建议使用 Gradle 构建系统 来构建 Ratpack 应用程序。Ratpack 不需要 Gradle；任何构建系统都可以使用。

以下说明假设您已安装 Gradle。有关安装说明，请参阅 Gradle 用户指南。

Ratpack 项目提供了两个 Gradle 插件

1. io.ratpack.ratpack-java - 用于在 Java 中实现的 Ratpack 应用程序
2. io.ratpack.ratpack-groovy - 用于在 Groovy 中实现的 Ratpack 应用程序

有关 Gradle 构建支持的更详细说明，请参阅 专用章节。

1.2.2 使用 Gradle Java 插件

创建具有以下内容的 build.gradle 文件

buildscript {
  repositories {
    mavenCentral()
  }
  dependencies {
    classpath "io.ratpack:ratpack-gradle:2.0.0-rc-1"
  }
}

apply plugin: "io.ratpack.ratpack-java"
apply plugin: "idea"

repositories {
  mavenCentral()
}

dependencies {
  runtimeOnly "org.slf4j:slf4j-simple:1.7.36"
}

mainClassName = "my.app.Main"

创建文件 src/main/java/my/app/Main.java，其内容如下

package my.app;

import ratpack.core.server.RatpackServer;

public class Main {
  public static void main(String... args) throws Exception {
    RatpackServer.start(server -> server 
      .handlers(chain -> chain
        .get(ctx -> ctx.render("Hello World!"))
        .get(":name", ctx -> ctx.render("Hello " + ctx.getPathTokens().get("name") + "!"))     
      )
    );
  }
}

您现在可以通过使用 Gradle 执行 run 任务（即在命令行上执行 gradle run），或将项目导入您的 IDE 并执行 my.app.Main 类来启动应用程序。

运行后，服务器将通过 http://localhost:5050/ 可用。

handlers() 方法 获取一个函数，该函数接收 Chain 对象。“处理程序链 API” 用于构建响应处理策略。

Ratpack Gradle 插件支持 Gradle 的持续构建功能。使用它使您对源代码的更改自动应用于正在运行的应用程序。

有关使用 Ratpack 与 Groovy 的更多信息，请参阅 Gradle 章节。

2.2.2 使用 Gradle Groovy 插件

创建具有以下内容的 build.gradle 文件

buildscript {
  repositories {
    mavenCentral()
  }
  dependencies {
    classpath "io.ratpack:ratpack-gradle:2.0.0-rc-1"
  }
}

apply plugin: "io.ratpack.ratpack-groovy"
apply plugin: "idea"

repositories {
  mavenCentral()
}

dependencies {
  runtimeOnly "org.slf4j:slf4j-simple:1.7.36"
}

创建文件 src/ratpack/ratpack.groovy，其内容如下

import static ratpack.groovy.Groovy.ratpack

ratpack {
    handlers {
        get {
            render "Hello World!"
        }
        get(":name") {
            render "Hello $pathTokens.name!"
        }
    }
}

您现在可以通过使用 Gradle 执行 run 任务（即在命令行上执行 gradle run），或将项目导入您的 IDE 并执行 ratpack.groovy.GroovyRatpackMain 类来启动应用程序。

运行后，服务器将通过 http://localhost:5050/ 可用。

handlers() 方法 获取一个闭包，该闭包委托给 GroovyChain 对象。“Groovy 处理程序链 DSL” 用于构建响应处理策略。

Ratpack Gradle 插件支持 Gradle 的持续构建功能。使用它使您对源代码的更改自动应用于正在运行的应用程序。

有关使用 Ratpack 与 Groovy 的更多信息，请参阅 Groovy 章节。

有关使用 Ratpack 与 Groovy 的更多信息，请参阅 Gradle 章节。