第 3 章 在命令行中创建 Quarkus 项目
您可以在命令行中使用 Quarkus Maven 插件来创建 Quarkus 项目,方法是在命令行中提供属性和值,也可以在交互模式中使用插件来创建 Quarkus 项目。生成的项目将包含以下元素:
- Maven 结构
- 关联的单元测试
-
在启动应用程序后,一个可在
http://localhost:8080上访问的登录页面 -
src/main/docker中的 JVM 和原生模式的Dockerfile文件示例 - 应用程序配置文件
流程
在命令终端中,输入以下命令验证 Maven 是否使用 JDK 11,并且 Maven 版本为 3.6.2 或更高版本:
mvn --version
mvn --versionCopy to Clipboard Copied! Toggle word wrap Toggle overflow - 如果前面的命令没有返回 JDK 11,请将到 JDK 11 的路径添加到 PATH 环境变量,然后再次输入前面的命令。
要使用 Quarkus Maven 插件创建新项目,请使用以下方法之一:
使用以下命令:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 在这个命令中,替换以下值:
-
<project_group_id> : 项目的唯一标识符 -
<project_artifact_id> : 项目和项目目录的名称 -
<classname> :生成的资源的完全限定名称,如org.acme.quarkus.sample.HelloResource
-
以互动模式创建项目:
mvn io.quarkus:quarkus-maven-plugin:1.11.7.Final-redhat-00009:create
mvn io.quarkus:quarkus-maven-plugin:1.11.7.Final-redhat-00009:createCopy to Clipboard Copied! Toggle word wrap Toggle overflow 提示时,输入 required 属性值。
注意另外,您可以通过输入以下命令来使用项目属性的默认值创建项目:
mvn io.quarkus:quarkus-maven-plugin:1.11.7.Final-redhat-00009:create -B下表列出了您可以使用
create命令定义的属性:Expand 属性 默认值 描述 projectGroupIdorg.acme.sample项目的唯一标识符。
projectArtifactIdnone
您的项目和项目目录的名称。如果您没有指定
projectArtifactId,则 Maven 插件将启动交互式模式。如果目录已存在,生成会失败。projectVersion1.0-SNAPSHOT项目的版本。
platformGroupIdio.quarkus您的平台的组群 ID。所有现有的平台均由
io.quarkus提供。但是,您可以更改默认值。platformArtifactIdQuarkus-universe-bom平台 BOM 的工件 ID。要使用本地构建的 Quarkus 将
quarkus-universe-bom添加到pom.xml文件中。platformVersion最新平台版本
要用于项目的平台版本。您可以提供一个版本范围,并且 Maven 插件使用最新版本。
className无
生成的资源的完全限定名称。创建应用程序后,REST 端点通过以下 URL 公开:
http://localhost:8080/$path如果您使用默认
路径,则 URL 为http://localhost:8080/hello。path/hello只有设置了
className时,资源路径。extensions[]
要添加到项目( comma)中的扩展列表。
默认情况下,Quarkus Maven 插件使用最新的 quarkus-universe-bom 文件。此 BOM 聚合扩展,以便您可以将应用程序中引用它们,以对齐依赖项版本。如果您离线,Quarkus Maven 插件使用 quarkus-universe-bom 的最新本地可用版本。如果 Maven 找到 quarkus-universe-bom 版本 2.0 或更早版本,则会使用基于 quarkus-universe-bom 的平台。