Quarkus 开源项目教程

1. 项目目录结构及介绍

在Quarkus项目中，通常的目录结构如下：

├── src
│   ├── main
│   │   ├── java
│   │   │   └── com.example  // 应用代码包
│   │   └── resources
│   │       ├── application.properties  // 主配置文件
│   │       └──META-INF
│   └── test
│       ├── java
│       │   └── com.example  // 测试代码包
│       └── resources
└── target  // 构建输出目录（默认不提交到版本库）
    ├── classes  // 编译后的Java类文件
    └── maven-archiver  // Maven构建相关文件

• src/main/java: 存放应用程序的主要Java源码。
• src/main/resources: 存放资源配置文件和其他非Java资源。
• src/test/java: 存放单元测试和集成测试的Java源码。
• src/test/resources: 测试相关的资源文件。
• target: Maven或Gradle等构建工具生成的输出文件夹，包括编译后的字节码、打包后的JAR/WAR以及其他的构建产物。

2. 项目的启动文件介绍

Quarkus应用可以使用Maven或者Gradle构建，因此启动方式取决于使用的构建工具。

Maven

使用Maven时，可以通过以下命令启动开发模式：

mvn quarkus:dev

这将启动一个内嵌的HTTP服务器，提供实时代码更新能力。

Gradle

对于Gradle，同样有对应的命令来启动开发模式：

./gradlew quarkusDev

这个命令也会启用类似于Maven的实时编译和热部署功能。

3. 项目的配置文件介绍

Quarkus主要使用application.properties文件进行配置。该文件位于src/main/resources目录下。例如：

# application.properties 示例
quarkus.http.port=8080          # 设置HTTP监听端口
quarkus.log.level=INFO           # 日志级别
my.custom.property=my-value     # 自定义属性

# 数据库连接配置
quarkus.datasource.db-kind=h2
quarkus.datasource.jdbc.url=jdbc:h2:mem:test;DB_CLOSE_DELAY=-1;DB_CLOSE_ON_EXIT=FALSE
quarkus.hibernate-orm.dialect=org.hibernate.dialect.H2Dialect

配置项以quarkus.开头的是Quarkus自身的设置，而其他部分可以自定义。若需使用不同的数据源或者其他扩展，可以根据官方文档添加相应的配置项。

此外，Quarkus还支持通过环境变量和命令行参数来覆盖配置文件中的值，这对于容器化部署非常有用。

以上即为Quarkus项目的目录结构、启动文件和配置文件的基本介绍。更多详细信息可参考官方文档：https://quarkus.io/guides/getting-started