このマニュアルは作成中のものであり、現在不完全です。
改善にご協力いただける場合は、README をご覧ください。

2 クイックスタート

この章では、Ratpackアプリケーションを立ち上げて試す方法について説明します。

1.2 Groovy スクリプトの使用

Ratpack アプリケーションは、単一の Groovy スクリプトとして実装できます。これは、Ratpack と 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

サーバーは https://:5050/ で利用可能になります。

handlers() メソッドは、GroovyChain オブジェクトに委譲するクロージャを取ります。「Groovy Handler Chain DSL」は、応答処理戦略を構築するために使用されます。

開発中は、ファイルの変更がリアルタイムで反映されます。ファイルを編集すると、次のリクエストで変更が有効になります。

2.2 Gradle プラグインの使用

Ratpack アプリケーションの構築には、Gradle ビルドシステムの使用をお勧めします。Ratpack は Gradle を必須としません。任意のビルドシステムを使用できます。

次の手順では、Gradle がすでにインストールされていることを前提としています。インストール手順については、Gradle ユーザーガイドを参照してください。

Ratpack プロジェクトは、2 つの Gradle プラグインを提供します。

io.ratpack.ratpack-java - Java で実装された Ratpack アプリケーション用
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 クラスを実行することで、アプリケーションを起動できます。

実行すると、サーバーは https://:5050/ で利用可能になります。

handlers() メソッドは、Chain オブジェクトを受け取る関数を取ります。「Handler Chain API」は、応答処理戦略を構築するために使用されます。

Ratpack Gradle プラグインは、Gradle の継続的ビルド機能をサポートしています。これを使用すると、ソースコードの変更が実行中のアプリケーションに自動的に適用されます。

Groovy での Ratpack の使用に関する詳細については、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 クラスを実行することで、アプリケーションを起動できます。

実行すると、サーバーは https://:5050/ で利用可能になります。

Groovy での Ratpack の使用に関する詳細については、Groovy の章を参照してください。

Groovy での Ratpack の使用に関する詳細については、Gradle の章を参照してください。