Quarkus 凭借其创新的扩展框架，为开发人员提供了一种将各种技术无缝集成到其应用程序中的强大方法。这些扩展简化了配置、启用依赖项注入并优化了性能，使其成为 Java 开发人员的一个有吸引力的选择。然而，在深入创建您自己的 Quarkus 扩展之前，了解何时需要以及如何有效地做到这一点至关重要。

何时创建 Quarkus 扩展

1. 复杂集成： 如果您正在使用 ORM 映射器、响应式客户端或数据访问库等复杂框架，那么创建扩展可以帮助管理复杂的配置和依赖项管理。扩展简化了 Quarkus 应用程序中这些框架的使用。

2. 性能优化： Quarkus 扩展旨在与 Quarkus 的本机编译保持一致，从而使应用程序能够快速启动并具有最小的内存占用。通过创建扩展，您可以利用 Quarkus 的构建时优化能力来扫描依赖项并尽早生成配置，从而避免启动延迟。

3. 开发者体验增强：扩展可以显着增强开发者体验。它们支持实时重新加载、CLI 扩展、模板化等，从而简化了开发过程。如果您想为您的团队提供无缝且高效的开发环境，扩展可以帮助实现这一目标。

4. API 强化： 如果您正在构建供其他 Quarkus 开发人员使用的 API 或库，扩展提供了一种绝佳的方法来强化您的 API 并确保它们在 Quarkus 生态系统中无缝工作.

但是，扩展可能并不总是最好的方法。对于更简单的需求，例如在组件之间共享实用程序代码和粘合逻辑，基本的 JAR 文件可能就足够了，而无需创建扩展的开销。如果您的集成是特定于应用程序的并且不太可能在其他地方重用，则基本 JAR 可能是更简单的解决方案。此外，如果您需要完全控制依赖项版本，并且不想遵守 Quarkus 的 BOM（物料清单）进行依赖项管理，那么 JAR 可能是更好的选择。最后，如果您的代码需要跨多个 JVM 框架工作，例如 Spring 和 Micronaut，最好避免与 Quarkus 紧密耦合。

创建 Quarkus 扩展可能很复杂，通常需要深入了解 Quarkus 内部工作原理。然而，对于许多场景，创建标准 JAR 就足够了。当 Jandex 索引此 JAR 时，Quarkus 可以在构建期间无缝地发现该 JAR。虽然 Quarkus 扩展提供了一系列优势，包括卓越的性能和开发人员生产力，但它们可能并不总是必要的。

Quarkus 将工作转移到构建时间而不是运行时的独特方法是其快速启动时间和低内存占用的核心。这一理念延伸到了 Quarkus 扩展，它可以利用这些构建时优化。即使您主要关心的不是快速启动时间，创建扩展的好处还包括简化配置、扩展 Quarkus CLI 以及与 Quarkus 的开发模式集成。

创建 Quarkus 扩展不必过于复杂。通过正确的方法和对项目需求的清晰了解，您可以有效地解决复杂的问题。扩展提供了一种灵活而强大的方式来增强您的 Quarkus 应用程序并使其更加高效且对开发人员友好。

创建 Quarkus 扩展

当您确定创建 Quarkus 扩展是正确的方法时，了解扩展的结构组件至关重要：

• 运行时部分： 该部分包含作为 bean、服务或与 Quarkus 集成的其他组件实现的核心业务逻辑；
• 部署部分：部署部分处理构建时的增强和配置。它确保您的扩展与 Quarkus 的优化流程无缝集成；
• 描述符： 描述符声明有关您的扩展的元数据，包括其名称、参数、兼容性信息等；
• 文档： 综合文档应随您的扩展一起提供。它指导用户如何有效地使用和配置您的扩展。

Quarkus 扩展的解剖

考虑一个场景，您想要为 Quarkus 创建自定义缓存扩展。此扩展将使开发人员能够轻松地将缓存功能集成到他们的 Quarkus 应用程序中。

1. 运行时部分：

   • 在本节中，您将使用 Java 代码实现核心缓存功能。这可能包括缓存数据、检索缓存数据和管理缓存过期的方法。
   • 例如，您可能有一个 CustomCacheService 类，其中包含 put(key, value)、get(key) 和 evict(key) 等方法来处理缓存操作。

2. 部署部分：

   • 部署部分负责构建时优化。在这里，您可以指定在构建过程中如何生成缓存配置。
   • 对于我们的缓存扩展，本节可能包括有关如何扫描应用程序代码中的缓存对象并生成缓存配置的说明。

3. 描述符：

   • 描述符文件 (custom-cache-extension.yaml) 提供有关您的扩展的元数据。它包括扩展名称、版本、与 Quarkus 的兼容性以及配置参数等信息。
   • 例如，您的描述符可能指定扩展名为“custom-cache-extension”，与 Quarkus 2.0 兼容，并且需要缓存超时配置参数。

4. 文档：

   • 您的扩展应附带全面的文档。它指导用户如何在 Quarkus 应用程序中有效地使用自定义缓存扩展。
   • 文档应包括如何配置缓存、将其集成到 Quarkus 服务以及管理缓存数据的示例。此外，它应该提供缓存利用的最佳实践。

通过遵循此结构，您的自定义缓存扩展将成为 Quarkus 开发人员的宝贵工具。他们可以轻松地将缓存合并到应用程序中，从而提高性能并优化资源使用。

运行时模块：

class CustomCacheService {

    // Core caching functionality using Java code
    public void put(String key, Object value) {
      // Cache data implementation
    }

    public Object get(String key) {
      // Retrieve cached data implementation
    }

    public void evict(String key) {
      // Evict cached data implementation
    }
}

部署模块：

class CustomCacheProcessor {
    @BuildStep
    FeatureBuildItem feature() {
        // This declares the custom cache extension as a feature
        return new FeatureBuildItem("custom-cache");
    }
}

描述符文件： custom-cache-extension.yaml

extension:
name: custom-cache-extension
metadata:
    short-name: "resteasy-reactive"
    keywords:
    - "jaxrs"
    - "web"
    - "rest"
    categories:
    - "web"
    - "reactive"
    status: "stable"
    guide: "https://quarkus.io/guides/resteasy-reactive"

结论

总之，是否创建 Quarkus 扩展取决于您项目的具体需求和目标。 Quarkus 扩展是用于深度集成、性能优化和增强开发人员体验的强大工具。然而，权衡利弊并考虑更简单的解决方案（例如标准 JAR 库）是否更适合您的用例至关重要。通过了解何时以及如何有效地创建 Quarkus 扩展，您可以做出明智的决策并充分利用这一创新框架的潜力。