核心概念

项目

项目:托管在 GitHub 或 GitLab 上的“普通 Java 项目”。 项目通过 CLI 进行注册,以便可以通过简单的名称来引用它们。spring-doc.cadn.net.cn

例如,如果您注册了一个使用 Spring Data JPA 且名称为'jpa'的项目的 GitHub URL,则可以通过调用boot new my-jpa-app jpa命令基于该项目创建一个新项目。 同样,您可以通过调用boot add jpa命令向现有项目添加 JPA 功能。spring-doc.cadn.net.cn

与项目相关的命令是 project listproject addproject removespring-doc.cadn.net.cn

项目目录

项目目录: 项目目录是一组共享共同主题的项目集合。spring-doc.cadn.net.cn

使用 CLI 注册目录后,在使用 boot newboot add 命令时即可直接使用这些项目。 该目录是一个名为 project-catalog.yaml 的 YAML 文件。 它包含项目仓库 URL 列表及其关联的名称。 该目录托管在 GitHub 或 GitLab 上spring-doc.cadn.net.cn

与项目目录相关的命令是 catalog listcatalog addcatalog removespring-doc.cadn.net.cn

用户自定义命令

命令:这些是声明式定义的命令,允许您添加或修改代码和配置文件。spring-doc.cadn.net.cn

您还可以运行任意可执行文件,以执行开发工作流中常见的任何自定义任务。 用户定义的命令已集成到 CLI 中,其表现与内置命令相同。spring-doc.cadn.net.cn

用户自定义命令包含三个部分:command namesub-command nameoptions。 命令名称和子命令名称是通过目录结构约定来定义的。spring-doc.cadn.net.cn

例如,要创建一个命令名为 controller 且子命令名为 new 的新用户自定义命令,请建立以下目录结构:spring-doc.cadn.net.cn

.spring/commands/controller/new

在此目录中,您可以拥有一个名为 command.yaml 的文件,用于定义命令的描述、选项和默认值。 此目录(及其子目录)包含操作文件,用于定义对项目执行的操作。spring-doc.cadn.net.cn

操作文件

操作文件:这些定义了可以在项目上执行的操作。spring-doc.cadn.net.cn

角色

在您的 CLI 中,角色提供了一种在用户定义的命令之间组织和复用变量的方法。spring-doc.cadn.net.cn

Spring CLI 包含一个始终存在的默认无名角色。 此外,角色可以与特定名称关联,以进一步区分其用途和使用方式。这些角色以 YAML 文件的形式存储在 .spring/roles 目录中,该目录与 .spring/commands 目录位于同一层级。spring-doc.cadn.net.cn

这些角色允许您定义在操作文件中可访问的变量,从而提供一种在命令之间共享数据的方式。spring-doc.cadn.net.cn

您还可以使用角色为命令行选项提供值。如果某个命令行选项未指定值,且已定义了一个与该命令选项同名的角色变量,则该命令将使用该角色变量的值作为此特定命令选项的值。spring-doc.cadn.net.cn

一些与项目相关的常见角色命令是 role addrole removerole setspring-doc.cadn.net.cn