Gradle プラグイン#

3つあります。必要なものだけ入れてください。

plugins {
	application
	id("io.jimble.jte") version "0.4.0"
	id("io.jimble.run") version "0.4.0"
	id("io.jimble.db")  version "0.4.0"
}

**Plugin Portal には出していません。**Maven Central から取るので、 settings.gradle.kts に置き場所を書いてください（jimble new の雛形には入っています）。

pluginManagement {
	repositories {
		mavenCentral()
		gradlePluginPortal()
	}
}

まっさらから書く#

jimble new を使わないなら、この2つを置けば動きます。 下は実際に動かして確かめたものです（gradle build で migrate → codegen → compileJava が繋がり、gradle run で起動します）。

// settings.gradle.kts
pluginManagement {
	repositories {
		mavenCentral()
		gradlePluginPortal()
	}
}

rootProject.name = "memo"

// build.gradle.kts
plugins {
	application
	id("io.jimble.jte") version "0.4.0"   // src/main/jte を使うなら
	id("io.jimble.run") version "0.4.0"   // ホットリロードを使うなら
	id("io.jimble.db")  version "0.4.0"   // DB を使うなら
}

repositories {
	mavenCentral()
}

// jimble は Java 25 で作ってあります。これが無いと依存が解決できません
java {
	toolchain {
		languageVersion = JavaLanguageVersion.of(25)
	}
}

dependencies {
	implementation("io.jimble:jimble-web:0.4.0")

	testImplementation(platform("org.junit:junit-bom:5.11.4"))
	testImplementation("org.junit.jupiter:junit-jupiter")
	testRuntimeOnly("org.junit.platform:junit-platform-launcher")
}

tasks.withType<Test>().configureEach {
	useJUnitPlatform()
}

// conf/ をリソースに足す。設定もマイグレーションもここから読みます（[設定](./config)）
sourceSets {
	main {
		resources {
			srcDir("conf")
		}
	}
}

application {
	mainClass = "memo.App"
}

jimbleRun {
	mainClass = "memo.App"
}

Dependency resolution is looking for a library compatible with JVM runtime version 21,
but 'io.jimble:jimble-web:0.4.0' is only compatible with JVM runtime version 25 or newer

どれを依存に足すか#

まとめて入るものは書かなくてよいです（jimble-web を足せば jimble-db も jimble-util も付いてきます）。

DB のドライバは要りません（MySQL / MariaDB と PostgreSQL は jimble-db が持っています）。

io.jimble.db#

./gradlew migrate       # 未適用の SQL を当てる
./gradlew codegen       # テーブル定義のクラスを作る（migrate のあと）
./gradlew codegenCheck  # コミットされている生成物がスキーマと合うか見る

中身は マイグレーションとコード生成 を見てください。

jimble {
	sourceRoot   = "src/main/java"   // 生成先
	env          = "local"           // CLI に -Denv=... で渡る
	autoGenerate = true              // compileJava の前に繋ぐか
}

つまりローカルでだけ migrate → codegen → compileJava が繋がります。 CI では繋がらないので、コミットされた生成物でそのままコンパイルできます。

./gradlew build -Pjimble.autoGenerate=true    # CI でも繋ぎたいとき

codegenCheck がずれを見つけると、こう言って落ちます。

コミットされている生成物がスキーマと一致しません（2 件）。codegen を実行してコミットしてください。
  生成物が古いです: db/blog_example/table/post/Post.java
  生成物が足りません: db/blog_example/table/tag/Tag.java

io.jimble.jte#

src/main/jte の .jte を Java に変換します。コンパイルは compileJava がやるので、 テンプレートの型の間違いはビルドで落ちます（テンプレート）。

jte {
	sourceDirectory       = "src/main/jte"
	packageName           = "gg.jte.generated.precompiled"
	contentType           = "Html"    // Html | Plain
	trimControlStructures = true
	htmlCommentsPreserved = false
}

コンパイラ（gg.jte:jte）を持っているのはプラグインだけです。 アプリの実行時クラスパスには jte-runtime しか入りません（要件 D-27）。

io.jimble.run#

./gradlew jimbleRun

仕組みと注意は ホットリロード にあります。ここは設定の一覧です。

jimbleRun {
	mainClass = "my_blog.App"        // 必須
}

見張るのは src と conf（あれば）＋ watchDirs です。

ビルドに失敗したら#

止まりません。ブラウザにそのまま出ます。

直して保存し、リロードすれば続きができます。