5分で最初のエンドポイント#

用意するもの#

• JDK 25（LTS）。jimble は仮想スレッドと ScopedValue を使います
• Gradle 9 以上。Gradle 8 は Java 25 の上では動きません （ツールチェーンとして Java 25 を使うのは 8 でもできますが、Gradle 自身が動きません）

DB はまだ要りません。あとから足せます。

jimble コマンドの入れ方は jimble コマンド にあります （リポジトリで ./gradlew :jimble-cli:installDist して PATH に通すだけです）。

1. 雛形を作る#

jimble new my-blog
cd my-blog
gradle wrapper --gradle-version 9.7.1

gradle wrapper に版を付けるのは、手元の Gradle が 8 だと 8 のラッパーができてしまうためです。

jimble new が作るのは、ビルドファイル・application.conf・App.java・ index.jte・.gitignore だけです。空のディレクトリは作りません。

2. 起動する#

./gradlew run

jimble 構成: env=local / session=none / cache=db / redis=なし / db=[]
route: GET     /
jimble を起動しました: http://localhost:9000

起動ログに ルート一覧が全部出ます。 「登録したつもりのルートが無い」を起動の時点で見つけるためです。

curl http://localhost:9000/

3. エンドポイントを足す#

App.java の初期化ブロックに1行足します。

get("/hello", context -> context.response().send("hello, jimble\n"));

{ } の中はコンストラクタの前に走る初期化ブロックです。 JimbleApp を継承したクラスの初期化ブロックが、そのままルート定義になります。

JSON を返すなら:

get("/posts", context -> context.response().json("posts", BlogApp.listPosts()));

json() は Data（LinkedHashMap<String,Object> の派生）を組み立てて、 send() の時点で JSON にします。

上のコード片はサンプルアプリ（examples/blog）から抜いたものなので、 listPosts() のようなそのアプリのメソッドが出てきます。 自分のアプリでは、そこを自分の処理に置き換えてください。

4. 直したら反映されるようにする#

./gradlew jimbleRun

jimbleRun は 9000 番でプロキシを立て、その裏で同じ JVM の中にアプリを起動します。 ソースを直すと次のリクエストのときにビルドして入れ替えます。 ビルドが失敗したら、そのエラーがブラウザに出ます。

詳しくは ホットリロード を見てください。

5. エラーの出し方を決める#

error((context, cause, statusCode) ->
	context.response().code(statusCode).send("エラー: %d %s%n".formatted(statusCode, cause.getMessage())));

error() に渡したものが、投げられた例外にも、どのルートにも当たらなかった 404 にも使われます。 何も登録しないと jimble の既定の形で返ります。

クラスの置き場所#

コード片には import を書いていません。よく使うものはここにあります。

次に読むもの#

• ルーティング — パスパラメータ、フィルタ、まとめ方
• DB を使う — DB を足す
• 落とし穴 — 先に読んでおくと1日得します