php中文网

利用自动设置和与 Quarkus 开发服务的集成来实现高效开发

php中文网

jprime 2024 圆满结束!!

jprime 2024 的组织者再次竭尽全力提供多样化的主题,确保每个人都能有所收获。

然而,今天的文章并不是由 michael simons 的演讲“spring 和 quarkus 中集成测试的演变”引发的,尽管它非常有洞察力。他探索了集成测试策略,重点关注 spring boot 中的设置。

作者明确强调,他强调的问题在 quarkus 中通过使用开发服务得到了有效解决(图 1)。这凸显了我对某些应用程序持怀疑态度的 spring boot 的另一个原因 - 它的复杂性与 quarkus 中的简化解决方案形成鲜明对比,特别是在使用开发服务时。

图 1 – jprime 2024

见证开发服务在新与会者中引发的惊讶是非常了不起的。然而,值得注意的是,dev services 并不是 quarkus 的最新功能。相当长一段时间以来,它一直是框架的组成部分。让我们更深入地研究 quarkus 开发服务并探索其持久的优势。

quarkus 开发服务

在 quarkus 中,开发服务有助于在开发和测试模式下自动配置未配置的服务。本质上,如果您在未配置的情况下包含扩展,quarkus 将自动启动相关服务(通常在后台使用 testcontainers)并配置您的应用程序以有效地使用此服务。

  1. 自动服务检测和启动

    quarkus dev services 可自动检测和启动必要的服务,例如数据库、消息代理和其他后端服务。此函数利用 pom.xml 或 build.gradle 中指定的应用程序依赖项。例如,添加数据库驱动程序会自动触发开发服务来启动该数据库的相应容器化实例(如果该实例尚未运行)。这里使用的技术主要涉及 testcontainers,它允许创建通用数据库、selenium web 浏览器或任何其他可以在 docker 容器中运行的轻量级一次性实例。

  2. 动态配置注入

    一旦实例化所需的服务,quarkus dev services 就会在运行时将相关服务连接详细信息动态注入到应用程序的配置中。这是在没有任何手动干预的情况下完成的,使用称为连续测试的功能将标准数据库或其他服务 url 重新路由到自动配置的测试容器。 url、用户凭据和其他操作参数等配置属性是无缝设置的,允许应用程序与这些服务交互,就像手动配置它们一样。

  3. 服务特定行为

    开发服务专为各种类型的服务量身定制:

    • 数据库: 自动提供根据您的应用程序需求量身定制的正在运行的数据库,无论是 postgresql、mysql、mongodb 还是任何其他支持的数据库。开发服务确保相应的测试容器在开发过程中可用。
    • 消息系统:对于使用 kafka 或 amqp 等消息系统的应用程序,quarkus dev services 使用 docker 启动必要的代理并将它们与应用程序连接。
    • 自定义开发服务:开发人员可以通过创建利用开发服务框架的自定义 quarkus 扩展来扩展功能。这允许针对特定项目进行定制设置,提供更大的灵活性和控制力。
  4. 网络处理和服务隔离

    quarkus dev services 启动的每项服务都在其隔离的环境中运行。这对于确保不同开发测试之间不存在端口冲突、数据残留或安全问题至关重要。尽管存在这种隔离,服务仍使用 docker 适当联网,确保它们可以根据需要相互通信,模仿真实世界的部署氛围。

  5. 生命周期管理

    quarkus 管理这些动态配置的服务的完整生命周期。当您在开发模式下启动应用程序时,必要的服务会自动启动。当您停止 quarkus 应用程序时,这些服务也会终止。此管理包括根据需要处理数据持久性,使开发人员能够从中断的地方继续操作,而不会出现任何设置延迟。

用法示例

假设您正在 quarkus 中使用 postgresql 数据库。如果没有检测到现有的 postgresql 配置,quarkus 将启动 postgresql docker 容器并自动连接您的应用程序。

这些服务在开发和测试模式下默认启用,但如有必要,可以通过 application.properties 禁用:

quarkus.datasource.devservices.enabled=false

让我们扩展一下 quarkus 使用 postgresql 数据库的场景,以及开发服务如何以最小的麻烦来促进这一点。

如果 quarkus 检测到没有 postgresql 配置处于活动状态(未运行或未显式配置),它将自动使用 docker 启动 postgresql 容器。这是通过开发服务在幕后设置的。

要通过 orm 层与数据库交互,请考虑使用 quarkus panache,它简化了 hibernate orm 操作。设置环境的方法如下:

  1. 添加依赖项

    首先,在 pom.xml 中包含必要的依赖项:

    <dependency>
     <groupid>io.quarkus</groupid>
     <artifactid>quarkus-hibernate-orm-panache</artifactid>
    </dependency>
    <dependency>
     <groupid>io.quarkus</groupid>
     <artifactid>quarkus-jdbc-postgresql</artifactid>
    </dependency>
    
  2. 定义实体

    接下来,定义您的实体,例如 cityentity:

    @entity
    @table(name = "cities")
    public class cityentity {
    
    @id
    @generatedvalue(strategy = generationtype.identity)
    private long id;
    
    private string name;
    
    @column(name = "public_id")
    private string publicid;
    
    @onetoone
    private stateentity state;
    
    @column(nullable = false, name = "created_at")
    private instant createdat;
    
    @column(nullable = false, name = "last_modified")
    private instant lastmodified;
    
    @prepersist
    protected void oncreate() {
     createdat = instant.now();
     lastmodified = createdat;
    }
    
    @preupdate
    protected void onupdate() {
     lastmodified = instant.now();
    }
    }
    
  3. 创建存储库

    实现将直接与数据库交互的存储库:

    @applicationscoped
    public class cityrepository implements 
    panacherepository<cityentity> {
    }
    
  4. 服务层

    定义使用存储库的服务层:

    @applicationscoped
    public class cityserviceimpl implements cityservice {
    
      @inject
      cityrepository cityrepository;
    
      @override
      public long countcities() {
       return cityrepository.count();
      }
    }
    
    public interface cityservice {
     long countcities();
    }
    
  5. 资源端点

    @Path("/cities")
    @Tag(name = "City Resource", description = "City APIs")
    public class CityResource {
    
      @Inject
      CityService cityService;
    
      @GET
      @Path("/count")
      @Operation(summary = "Get the total number of cities", 
       description = "Returns the total count of cities in the 
       system.")
      @APIResponse(responseCode = "200", description = "Successful 
      response", content = @Content(mediaType = "application/json", 
      schema = @Schema(implementation = Long.class)))
      public long count() {
       return cityService.countCities();
      }
     }
    

当您运行 quarkus 应用程序 (mvn quarkus:dev) 时,观察 postgresql 容器的自动启动(图 2)。这种无缝集成体现了 quarkus 开发服务的强大功能,通过自动配置和连接设置到应用程序所需的外部服务,使开发和测试变得更加简单。

图 2 – 应用程序日志

平台开发服务

quarkus dev services 通过处理各种服务的配置和管理来简化开发和测试阶段,使开发人员能够更加专注于实际应用程序。 quarkus 支持广泛的开发服务,包括:

  • amqp
  • apicurio 注册表
  • 数据库
  • 卡夫卡
  • 钥匙斗篷
  • kubernetes
  • mongodb
  • rabbitmq
  • 脉冲星
  • redis
  • 金库
  • 无限跨度
  • elasticsearch
  • 可观测性
  • neo4j
  • wiremock
  • 麦克克斯
  • 钥匙斗篷
  • 还有更多,每一个都旨在无缝增强您的开发环境

结论

quarkus 开发服务代表了开发人员在开发和测试阶段如何设置和集成外部服务的范式转变。环境设置的自动化不仅加速了开发过程,还减少了配置错误的可能性,使团队更容易专注于创建强大的、功能丰富的应用程序。

quarkus 开发服务的突出优势之一是强调开发人员的生产力。通过消除手动管理服务依赖项的需要,开发人员可以立即开始处理业务逻辑和应用程序功能。这种简化的工作流程在微服务架构中特别有益,其中多个服务可能需要同时开发和集成

总之,采用 quarkus 开发服务可以显着影响您的开发团队的效率和项目成果。 quarkus 的简单性和强大功能鼓励实验,
更快的迭代,最终加快开发周期。这种技术杠杆是现代企业在数字时代蓬勃发展所需要的。

以上就是利用自动设置和与 Quarkus 开发服务的集成来实现高效开发的详细内容,更多请关注php中文网其它相关文章!