Question

在 Spring MVC 和 JdbcTemplate 的例子中，为了获取必要的依赖并添加到 Classpath 里，Groovy 编译触发了 Spring Boot CLI。这是错误的。但如果需要一个依赖，而没有失败代码来触发自动依赖解析，又或者所需的依赖 CLI 不知道，那该怎么办？

在阅读列表应用程序中，我们需要 Thymeleaf 库，这样才能编写使用了 Thymeleaf 模板的视图。我们还需要 H2 的库，这样才能拥有嵌入式的 H2 数据库。但因为没有 Groovy 代码会直接引用 Thymeleaf 或 H2 的类，所以不会有编译错误来触发自动依赖解析。因此，我们要帮一帮 CLI，在 Grabs 类上添加 @Grab 依赖。

该把 @Grab 注解放在哪里？ 并不需要像我们这样，严格将 @Grab 注解放在一个单独的类上。它们在 ReadingListController 或 JdbcReadingListRepository 同样有效。不过，为了便于组织管理，最好创建一个空类，把所有 @Grab 注解放在一起。这样方便在一个地方看到所有显式声明的依赖。

@Grab 注解源自 Groovy Grape（Groovy Adaptable Packaging Engine 或 Groovy Advanced Packaging Engine）工具。从本质上来说，Grape 允许 Groovy 脚本在运行时下载依赖，无需 Maven 或 Gradle 这样的构建工具介入。除了支持 @Grab 注解，Spring Boot CLI 还用 Grape 来获取代码中推断出的依赖。

使用 @Grab 就和描述依赖一样简单。举例来说，假设你想往项目里添加 H2 数据库，可以往项目的一个 Groovy 脚本添加如下 @Grab 注解：

@Grab(group="com.h2database", module="h2", version="1.4.190")

这样能明确地声明依赖的组、模块和版本号。或者，你也可以用更简洁的冒号分割表示依赖，这和 Gradle 构建说明里的表示方式类似。

@Grab("com.h2database:h2:1.4.185")

这是两个教科书式的例子，但 Spring Boot CLI 对 @Grab 做了几处扩展，用起来更简单。

很多依赖不再要求指定版本号了。可以通过下面的方式，用 @Grab 添加 H2 数据库依赖：

@Grab("com.h2database:h2")

确切的版本号是由你所使用的 CLI 的版本来决定的。如果用的是 Spring Boot CLI 1.3.0.RELEASE，那么 H2 依赖的版本会解析为 1.4.190。

这还不算完，很多常用依赖还可以省去 Group ID，直接在 @Grab 里写上模块的 ID。正是这个特性让上文的 @Grab 注解成功加载了 H2。

@Grab("h2")

那你该如何获知某个依赖是需要 Group ID 和版本号，还是只需要 Module ID 呢？我在附录 D 中提供了一个完整的列表，包含了 Spring Boot CLI 知道的全部依赖。通常，你可以先试一下只写 Module ID，如果这样不行，再加上 Group ID 和版本号。

只用 Module ID 来表示依赖会很方便，但如果你并不认可 Spring Boot 选择的版本号怎么办？如果 Spring Boot 的起步依赖传递引入了一个库的某个版本，但你想要使用修正了 bug 的新版本又该如何呢？