Quarkus 5分钟快速开始

Quarkus是一个超音速亚原子Java框架,专为云原生和容器环境设计,快速启动并运行你的第一个应用。

环境要求

支持的操作系统

macOS Windows Linux

运行环境

Java 11或更高 必需

所需工具

Maven

构建工具

必需

操作步骤

1

创建Quarkus项目

使用Maven命令生成一个简单的Quarkus项目。

创建名为my-quarkus-app的项目,包含REST API扩展
mvn io.quarkus.platform:quarkus-maven-plugin:3.6.0:create -DprojectGroupId=com.example -DprojectArtifactId=my-quarkus-app -Dextensions='resteasy-reactive'

预期结果::BUILD SUCCESS 表示项目创建成功。

确保Maven和Java已正确安装并配置环境变量。

2

进入项目目录

切换到新创建的项目文件夹。

进入项目根目录
cd my-quarkus-app

预期结果::命令行提示符显示当前路径为my-quarkus-app。

如果路径错误,请检查上一步的输出确认项目名称。

3

启动开发模式

运行Quarkus开发服务器,支持热重载。

在Unix/Linux/macOS上启动;Windows使用mvnw.cmd quarkus:dev
./mvnw quarkus:dev

预期结果::控制台显示'Listening on: http://localhost:8080'和'Quarkus application started in X.XXXs',表示服务器已启动。

首次运行可能需要下载依赖,请耐心等待。

验证应用运行

访问默认的REST端点确认应用正常工作。

浏览器打开http://localhost:8080/hello显示'Hello from RESTEasy Reactive'
控制台无错误日志,保持运行状态

快速提示

开发效率

开发模式下修改代码会自动重载,无需重启服务器。

操作

使用Ctrl+C停止开发服务器。

常见问题

1

Maven命令失败,提示'command not found'或类似错误。

检查Maven和Java安装,确保已添加到系统PATH环境变量。

2

启动时端口8080被占用。

停止占用端口的进程,或通过-Dquarkus.http.port=新端口参数指定其他端口。

下一步

探索更多扩展

使用mvn quarkus:list-extensions查看可用扩展,如数据库或消息队列。

构建原生可执行文件

运行./mvnw package -Pnative生成优化后的原生应用(需GraalVM)。

助手