创建第一个Quarkus应用程序

第一次创建 Quarkus 应用程序有很多方法：

• 手动创建项目 pom.xml 或 build.gradle 文件，添加 Quarkus 依赖项，设置和配置插件，以及定义资源文件夹。 这是一个麻烦和无趣的方法！
• 使用 Maven 和 Quarkus 插件构建项目骨架。
• 浏览 https://code.quarkus.io 并选择所需的依赖项。 这是最简单、最快捷的开始方式，也是我将使用的方法。

前往 https://code.quarkus.io，您将看到图 1 中的页面。 我们已经圈出一些关键部分来详细解释它们。

页面顶部是生成项目的 Quarkus 版本。 在它的左下方，您可以自定义将为项目设置的 Group 和 Artifact 名称。 如果需要，这些也可以稍后更改； 如果您忘记自定义它，也没关系。

在右侧，用户可以决定是否要将 Starter code 添加到项目中。 默认值为 yes，因此如果您选择任何带有 CODE 标记的扩展，例如 RESTEasy JAX-RS，将为项目生成该扩展的 starter code。 页面顶部下方是所有可用 Quarkus 扩展的列表。 有很多扩展可用； 屏幕截图仅显示适合单个页面的屏幕截图。 使用每个复选框来选择要包含在项目中的特定扩展。

图 1 Quarkus 项目选择

最后，如果您不想滚动浏览所有扩展程序，请开始在所有扩展程序上方的搜索框中输入术语。 当您输入时，其下方的扩展名列表将过滤，仅显示与您的搜索条件匹配的扩展名。 选择扩展后，它们会出现在 “Generate your application.” 旁边的 Selected Extensions 区域下。

图 2 显示当我们即将生成应用程序时的屏幕。

图 2 Quarkus 项目生成

您可以看到我们选择不生成任何 Starter Code，并且选择了 RESTEasy Classic[quarkus-resteasy] 扩展。 我们现在坚持使用普通的 JAX-RS。 我们将在后续探讨更具响应式的 JAX-RS。

当我们将鼠标悬停在 “Generate your application,” 上时，我们可以决定将项目下载为 ZIP 文件或将其发布到 GitHub 仓库。 现在，我们将下载为 ZIP 文件。 该文件将自动下载，其名称与 Artifact 名称匹配。 下载完成后，将 ZIP 文件解压缩到一个目录。

完成后，我们打开一个终端窗口并切换到生成的项目被提取的目录。在终端执行以下命令

> mvn quarkus:dev

前面的命令在实时重新加载中启动 Quarkus，使我们能够快速迭代代码并立即看到影响。 成功启动将有终端输出，如下所示：

__  ____  __  _____   ___  __ ____  ______
 --/ __ / / / / _ | / _ / //_/ / / / __/
 -/ /_/ / /_/ / __ |/ , _/ ,< / /_/ / 
--________/_/ |_/_/|_/_/|_|____/___/
2023-03-19 18:10:58,444 INFO  [io.quarkus] (Quarkus Main Thread) code-with-quarkus 1.0.0-SNAPSHOT on JVM (powered by Quarkus 2.16.4.Final) started in 2.878s. Listening on: http://localhost:8080
2023-03-19 18:10:58,463 INFO  [io.quarkus] (Quarkus Main Thread) Profile dev activated. Live Coding activated.
2023-03-19 18:10:58,463 INFO  [io.quarkus] (Quarkus Main Thread) Installed features: [cdi, smallrye-context-propagation, vertx]

浏览器中打开 http://localhost:8080 ，你会看到 Resource not found。 不好了！ 什么地方出了错？

实际上，并没有出什么问题。 眼尖的读者可能已经注意到启动日志仅将 cdi 列为已安装功能。 RESTEasy 怎么样？ 我们在创建项目时选择了它的扩展名。 查看 pom.xml 内部，您将看到依赖项如下:

    
      io.quarkus
      quarkus-resteasy
    
    
      io.quarkus
      quarkus-arc
    
    
      io.quarkus
      quarkus-junit5
      test
    

RESTEasy 肯定是作为依赖项存在的，那么发生了什么？ 在构建过程中，Quarkus 发现实际上没有任何使用 REST‐Easy 的代码存在，因此卸载了该功能并可以将其删除以节省内存。 让我们现在解决这个问题。

在 Quarkus 仍在运行的情况下，在 /src/main/java 中创建 org.acme 包。 现在在包中创建一个名为 MyResource 的类，内容如下所示:

package org.acme;

import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.Produces;
import javax.ws.rs.core.MediaType;

@Path("/")
@Produces({MediaType.TEXT_PLAIN})
public class MyResource {
    @GET
    public String message() {
        return "Hi";
    }
}

注意: 您可能想知道为什么在前面的代码片段中没有一个导入行是 Quarkus 特定的。 Quarkus 通过利用不断增长的 50 多个同类最佳库的列表，提供了一个有凝聚力的全栈框架。 在前面的示例中，我们使用 JAX-RS，这是一种构建 HTTP 和 REST API 的简单但高效且灵活的方法。

刷新 http://localhost:8080。 哇，我们现在在浏览器中看到了 Hi； 发生了什么？ 查看终端窗口如下:

INFO [io.qua.dep.dev.RuntimeUpdatesProcessor] (vert.x-worker-thread-7) 
 Changed source files detected, recompiling 
 [{pathToProject}/code-with-quarkus/src/main/java/org/acme/MyResource.java]
INFO [io.quarkus] (Quarkus Main Thread) code-with-quarkus stopped in 0.037s
__ ____ __ _____ ___ __ ____ ______
 --/ __ / / / / _ | / _ / //_/ / / / __/
 -/ /_/ / /_/ / __ |/ , _/ ,< / /_/ / 
--________/_/ |_/_/|_/_/|_|____/___/
INFO [io.quarkus] (Quarkus Main Thread) code-with-quarkus 1.0.0-SNAPSHOT on JVM 
 (powered by Quarkus 1.11.1.Final) started in 0.195s. 
 Listening on: http://localhost:8080
INFO [io.quarkus] (Quarkus Main Thread) Profile dev activated. Live Coding activated
INFO [io.quarkus] (Quarkus Main Thread) Installed features: [cdi, resteasy]
INFO [io.qua.dep.dev.RuntimeUpdatesProcessor] (vert.x-worker-thread-7) 
 Hot replace total time: 0.291s

我们可以看到 Quarkus 注意到对 MyResource.java 的修改，停止，然后重新启动。 查看已安装的功能，我们看到它现在包含了 resteasy。 多么酷啊？ 更好的是，服务器在 300 多毫秒内停止并重新启动。

我们为什么不探索更多的实时重新加载以更好地感受真正的开发者喜悦！ 在 mvn quarkus:dev 仍在运行的情况下，在浏览器中打开 http://localhost:8080/welcome（图 3）。

图 3

不好了,我们有一个错误！

不要太害怕； 我们确实期待它，因为我们还没有任何东西可以响应 /welcome 端点。 但是，Quarkus 为我们提供了一些链接，以帮助根据它对应用程序的了解来诊断问题。 我们看到了有效端点的列表——在这种情况下，/ 上只有一个 HTTP GET。

在 “Additional endpoints,” 下，有一些端点可以在开发应用程序时提供帮助。 在此示例中，我们有与 ArC 相关的端点，这是基于 Quarkus 的上下文和依赖注入 (CDI) 的 bean 容器，以及到开发人员控制台的链接。 单击开发者控制台链接将带您进入其主页。

现在没有很多，但我们需要记住，我们添加的唯一扩展是 RESTEasy。 随着我们使用更多扩展来增强应用程序，开发人员控制台将提供更多选项和功能。 我们在那里走了一条支线，所以让我们回到解决页面加载失败的问题上！ 随着 /welcome 页面在浏览器中打开失败，回到源代码并创建一个名为 WelcomeResource 的新类如下:

@Path("/welcome")
public class WelcomeResource {
 @GET
 public String welcomeMessage() {
    return "Welcome to Quarkus!";
 }
}

编写完类后，返回浏览器并单击 Refresh。

触发 HTTP 请求会导致 Quarkus 检查自上次请求以来是否有任何文件被修改，因为我们正在运行实时重新加载。 Quarkus 注意到 WelcomeResource 的存在，对其进行编译，然后重新启动服务器。 如果您像我们一样，您可能没有意识到幕后发生的一切，因为浏览器立即给出了预期的响应。

这是关于第一次使用 https://code.quarkus.io 创建 Quarkus 项目以及体验使用 Quarkus 实时重新加载带来的轻松开发的大量信息。 它确实有缺点，包括在编译和重新启动期间喝咖啡的机会较少。 我们将继续探索实时重新加载可以完成的所有章节，但您可以自己试一试，添加新的扩展，看看可以在不停止的情况下完成什么！

那么下一篇我们看看在 Kubernetes 使用 Quarkus!