利用自动设置和与 Quarkus 开发服务的集成来实现高效开发-java教程-PHP中文网

JPrime 2024 圆满结束！！

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

然而，今天的文章并不是由 Michael Simons 的关于 “Spring 和 Quarkus 中集成测试的演变” 的演讲引发的，尽管它非常有洞察力。他探索了集成测试策略，重点关注 Spring Boot 中的设置。

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

Harnessing Automatic Setup and Integration with Quarkus Dev Services for Efficient Development

图 1 – JPrime 2024

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

Quarkus 开发服务

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

自动服务检测和启动

Quarkus Dev Services 可自动检测和启动必要的服务，例如数据库、消息代理和其他后端服务。此函数利用 pom.xml 或 build.gradle 中指定的应用程序依赖项。例如，添加数据库驱动程序会自动触发开发服务来启动该数据库的相应容器化实例（如果该实例尚未运行）。这里使用的技术主要涉及 Testcontainers，它允许创建通用数据库、Selenium Web 浏览器或任何其他可以在 Docker 容器中运行的轻量级一次性实例。
动态配置注入

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

开发服务专为各种类型的服务量身定制：
- 数据库： 自动提供根据您的应用程序需求量身定制的正在运行的数据库，无论是 PostgreSQL、MySQL、MongoDB 还是任何其他支持的数据库。开发服务确保相应的测试容器在开发过程中可用。
- 消息系统：对于使用 Kafka 或 AMQP 等消息系统的应用程序，Quarkus Dev Services 使用 Docker 启动必要的代理并将它们与应用程序连接。
- 自定义开发服务：开发人员可以通过创建利用开发服务框架的自定义 Quarkus 扩展来扩展功能。这允许针对特定项目进行定制设置，提供更大的灵活性和控制力。
网络处理和服务隔离

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

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 操作。设置环境的方法如下：

添加依赖项

首先，在 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>

登录后复制

定义实体

接下来，定义您的实体，例如 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();
}
}

登录后复制

创建存储库

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

@ApplicationScoped
public class CityRepository implements 
PanacheRepository<CityEntity> {
}

登录后复制

服务层

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

@ApplicationScoped
public class CityServiceImpl implements CityService {

  @Inject
  CityRepository cityRepository;

  @Override
  public long countCities() {
   return cityRepository.count();
  }
}

public interface CityService {
 long countCities();
}

登录后复制

资源端点

@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 开发服务的强大功能，通过自动配置和连接设置到应用程序所需的外部服务，使开发和测试变得更加简单。

Harnessing Automatic Setup and Integration with Quarkus Dev Services for Efficient Development