🔥 FREE PRO OFFER Linkage.page Pro Version is 100% Free of Cost till 31 December, 2026! Claim Free Pro

Quarkus

Quarkus 中使用 CDI 的依赖注入:ArC、范围、限定符和构建时注入

Quarkus 中使用 CDI 的依赖注入:ArC、范围、限定符和构建时注入

依赖注入 (DI) 是现代企业 Java 应用程序开发的基石。多年来,Java 开发人员依赖 Spring IoC(控制反转)或标准 Jakarta EE CDI(上下文和依赖注入)容器(如 Hibernate Weld 或 OpenWebBeans)来解耦组件生命周期、管理服务依赖项和注入配置属性。 然而,随着企业应用程序向云原生微服务、Docker 和 Kubernetes 容器化以及无服务器执行模型(AWS Lambda、Knative)过渡,传统的依赖项注入容器暴露了一个严重缺陷:繁重的运行时反射和高内存开销。 输入 Quarkus 及其轻量级 CDI 引擎 ArC。 Quarkus 专为 Kubernetes 和 GraalVM 本机编译而全新构建,通过将反射、类路径扫描和 bean 图连接从应用程序运行时转移到构建时,重新定义了依赖注入。 在本深入指南中,我们将探索 Quarkus 中使用 CDI 的依赖注入,涵盖 ArC 容器的内部机制、CDI 范围、自定义限定符、生产者、拦截器、事件驱动的观察者、编程式查找以及编写高性能云原生 Java 应用程序的最佳实践。 1. 了解 ArC:Quarkus 构建时 CDI 引擎 标准 Jakarta EE CDI 容器完全在应用程序启动时运行。当旧应用程序启动时,CDI 容器会扫描类路径中的每个 JAR、解析元数据、使用 Java 反射 (java.lang.reflect) 检查注释、在内存中生成动态代理并构建依赖关系图。这种动态反射会消耗大量 RAM(元空间)并增加冷启动启动时间。
Java Quarkus CDI ArC Dependency Injection Microservices Cloud Native Software Architecture GraalVM
使用 Java Quarkus 构建 REST API:高性能、响应式和云原生指南

使用 Java Quarkus 构建 REST API:高性能、响应式和云原生指南

在现代企业软件工程中,构建 RESTful API 是后端系统开发的核心石。几十年来,Java 开发者一直依赖 Spring Boot 或 Jakarta EE 等传统框架。 Quarkus 应运而生——这是专为 OpenJDK HotSpot 和 GraalVM 量身定制的 Supersonic Subatomic Java 框架。 1. 为什么选择 Quarkus 构建 Java REST API? A. RESTEasy 响应式范式 B. Dev Services 与零配置实时编码 2. Quarkus REST API 架构 3. 项目初始化与依赖项 mvn io.quarkus.platform:quarkus-maven-plugin:3.15.0:create \ -DprojectGroupId=com.ghaznix.api \ -DprojectArtifactId=quarkus-product-api \ -DclassName="com.ghaznix.api.ProductResource" \ -Dpath="/api/products" \ -Dextensions="resteasy-reactive-jackson,hibernate-orm-panache,jdbc-postgresql,hibernate-validator,smallrye-openapi" 4. 配置应用程序属性 # Application Configuration quarkus.application.name=quarkus-product-api quarkus.http.port=8080 # Database Configuration (Dev Services will override in dev mode automatically) quarkus.datasource.db-kind=postgresql quarkus.datasource.username=postgres quarkus.datasource.password=secret quarkus.datasource.jdbc.url=jdbc:postgresql://localhost:5432/product_db # Hibernate ORM Configuration quarkus.hibernate-orm.database.generation=drop-and-create quarkus.hibernate-orm.log.sql=true # Swagger UI & OpenAPI Path quarkus.swagger-ui.always-include=true quarkus.swagger-ui.path=/swagger-ui 5. 领域模型与 Panache Active Record package com.ghaznix.api; import io.quarkus.hibernate.orm.panache.PanacheEntity; import jakarta.persistence.Column; import jakarta.persistence.Entity; import jakarta.persistence.Table; import jakarta.validation.constraints.Min; import jakarta.validation.constraints.NotBlank; import jakarta.validation.constraints.NotNull; import java.math.BigDecimal; import java.util.List; @Entity @Table(name = "products") public class Product extends PanacheEntity { @NotBlank(message = "Product name cannot be blank") @Column(nullable = false) public String name; @Column(length = 1000) public String description; @NotNull(message = "Price is required") @Min(value = 0, message = "Price must be non-negative") @Column(nullable = false) public BigDecimal price; @Column(nullable = false) public Integer stockQuantity; public String category; // Static Finder Utility Methods powered by Panache public static List<Product> findByCategory(String category) { return list("category", category); } public static List<Product> findAvailableProducts() { return list("stockQuantity > 0"); } } 6. 构建生产级 REST 端点 package com.ghaznix.api; import io.quarkus.panache.common.Page; import io.quarkus.panache.common.Sort; import jakarta.transaction.Transactional; import jakarta.validation.Valid; import jakarta.ws.rs.*; import jakarta.ws.rs.core.MediaType; import jakarta.ws.rs.core.Response; import org.eclipse.microprofile.openapi.annotations.Operation; import org.eclipse.microprofile.openapi.annotations.responses.APIResponse; import org.eclipse.microprofile.openapi.annotations.tags.Tag; import java.net.URI; import java.util.List; @Path("/api/products") @Produces(MediaType.APPLICATION_JSON) @Consumes(MediaType.APPLICATION_JSON) @Tag(name = "Product REST API", description = "Operations for managing catalog products") public class ProductResource { @GET @Operation(summary = "Get all products with pagination") @APIResponse(responseCode = "200", description = "List of products retrieved successfully") public List<Product> getAllProducts( @QueryParam("page") @DefaultValue("0") int pageIndex, @QueryParam("size") @DefaultValue("10") int pageSize, @QueryParam("sort") @DefaultValue("name") String sortBy) { return Product.findAll(Sort.by(sortBy)) .page(Page.of(pageIndex, pageSize)) .list(); } @GET @Path("/{id}") @Operation(summary = "Get product by ID") @APIResponse(responseCode = "200", description = "Product details found") @APIResponse(responseCode = "404", description = "Product not found") public Product getProductById(@PathParam("id") Long id) { Product product = Product.findById(id); if (product == null) { throw new NotFoundException("Product with ID " + id + " does not exist."); } return product; } @POST @Transactional @Operation(summary = "Create a new product") @APIResponse(responseCode = "201", description = "Product created successfully") @APIResponse(responseCode = "400", description = "Invalid request payload") public Response createProduct(@Valid Product product) { product.persist(); return Response.created(URI.create("/api/products/" + product.id)) .entity(product) .build(); } @PUT @Path("/{id}") @Transactional @Operation(summary = "Update an existing product") @APIResponse(responseCode = "200", description = "Product updated") @APIResponse(responseCode = "404", description = "Product ID not found") public Product updateProduct(@PathParam("id") Long id, @Valid Product updatedProduct) { Product entity = Product.findById(id); if (entity == null) { throw new NotFoundException("Product with ID " + id + " not found."); } entity.name = updatedProduct.name; entity.description = updatedProduct.description; entity.price = updatedProduct.price; entity.stockQuantity = updatedProduct.stockQuantity; entity.category = updatedProduct.category; return entity; } @DELETE @Path("/{id}") @Transactional @Operation(summary = "Delete a product by ID") @APIResponse(responseCode = "204", description = "Product deleted successfully") @APIResponse(responseCode = "404", description = "Product ID not found") public Response deleteProduct(@PathParam("id") Long id) { boolean deleted = Product.deleteById(id); if (!deleted) { throw new NotFoundException("Product with ID " + id + " not found."); } return Response.noContent().build(); } } 7. 响应式 REST 端点与阻塞执行 import io.smallrye.mutiny.Uni; import io.smallrye.mutiny.Multi; @GET @Path("/reactive/{id}") public Uni<Product> getProductReactive(@PathParam("id") Long id) { return Product.<Product>findByIdAsync(id) .onItem().ifNull().failWith(new NotFoundException("Product not found")); } @GET @Path("/stream") @Produces(MediaType.SERVER_SENT_EVENTS) public Multi<Product> streamProducts() { return Product.streamAll(); } 8. 全局异常处理与错误标准 package com.ghaznix.api.exception; import jakarta.ws.rs.NotFoundException; import jakarta.ws.rs.core.MediaType; import jakarta.ws.rs.core.Response; import jakarta.ws.rs.ext.ExceptionMapper; import jakarta.ws.rs.ext.Provider; import java.time.Instant; import java.util.HashMap; import java.util.Map; @Provider public class GlobalExceptionMapper implements ExceptionMapper<Exception> { @Override public Response toResponse(Exception exception) { Map<String, Object> errorPayload = new HashMap<>(); errorPayload.put("timestamp", Instant.now().toString()); if (exception instanceof NotFoundException) { errorPayload.put("status", 404); errorPayload.put("error", "Not Found"); errorPayload.put("message", exception.getMessage()); return Response.status(Response.Status.NOT_FOUND) .entity(errorPayload) .type(MediaType.APPLICATION_JSON) .build(); } errorPayload.put("status", 500); errorPayload.put("error", "Internal Server Error"); errorPayload.put("message", exception.getMessage()); return Response.status(Response.Status.INTERNAL_SERVER_ERROR) .entity(errorPayload) .type(MediaType.APPLICATION_JSON) .build(); } } 9. 使用 @QuarkusTest 和 REST Assured 进行自动化测试 package com.ghaznix.api; import io.quarkus.test.junit.QuarkusTest; import io.restassured.http.ContentType; import org.junit.jupiter.api.Test; import static io.restassured.RestAssured.given; import static org.hamcrest.CoreMatchers.*; @QuarkusTest public class ProductResourceTest { @Test public void testGetAllProductsEndpoint() { given() .when().get("/api/products") .then() .statusCode(200) .contentType(ContentType.JSON); } @Test public void testCreateAndGetProduct() { Product product = new Product(); product.name = "Gaming Laptop"; product.description = "High-performance GPU laptop"; product.price = new java.math.BigDecimal("1499.99"); product.stockQuantity = 15; product.category = "Electronics"; // Test POST Endpoint Integer createdId = given() .contentType(ContentType.JSON) .body(product) .when().post("/api/products") .then() .statusCode(201) .body("name", equalTo("Gaming Laptop")) .extract().path("id"); // Test GET Endpoint by ID given() .pathParam("id", createdId) .when().get("/api/products/{id}") .then() .statusCode(200) .body("category", equalTo("Electronics")); } } ./mvnw test 10. 打包并编译为 GraalVM 原生可执行文件 ./mvnw quarkus:dev ./mvnw package java -jar target/quarkus-app/quarkus-run.jar ./mvnw package -Dnative -Dquarkus.native.container-build=true ./target/quarkus-product-api-1.0.0-runner 2026-09-21 22:30:00,014 INFO [io.quarkus] (main) quarkus-product-api 1.0.0-runner native (powered by Quarkus 3.15.0) started in 0.018s. Listening on: http://0.0.0.0:8080 11. 性能基准测试:Quarkus 与 Spring Boot 指标 Spring Boot (JVM) Quarkus (OpenJDK JVM) Quarkus (GraalVM Native) 提升 启动时间 (冷启动) 3.82 秒 1.18 秒 0.015 秒 快 254 倍 内存占用 (RSS) 184 MB 108 MB 28 MB 内存降低 84% 12. 总结与最佳实践 Ghaznix Blog.
Java Quarkus REST API 微服务 GraalVM 响应式编程 Hibernate Panache 云原生 软件架构
Quarkus 与 Spring Boot:您应该选择哪个 Java 框架?

Quarkus 与 Spring Boot:您应该选择哪个 Java 框架?

十多年来,Spring Boot 一直是构建企业 Java 应用程序的事实上的标准。其丰富的生态系统、约定优于配置的范例、强大的依赖注入引擎和广泛的社区支持使 Java 成为全球后端系统的基石。 然而,向云原生架构、Kubernetes 编排、Docker 容器化和无服务器执行(AWS Lambda、Knative) 的转变给后端基础设施带来了新的技术挑战:内存效率、即时扩展和冷启动延迟。 传统的 Java 框架是为长期运行的整体服务器而设计的,最初并不是为短暂的容器化环境而设计的。当微服务在 Kubernetes 上从 0 个实例水平扩展到 50 个实例或作为短期无服务器函数执行时,等待 3 到 10 秒等待 Java 虚拟机 (JVM) 进程启动(同时消耗 200MB 以上的堆内存)会带来运营和财务障碍。 输入 Quarkus:一个从头开始构建的 Kubernetes 原生 Java 框架,专为 GraalVM 和 OpenJDK HotSpot 定制 Java。 Quarkus 被称为“超音速亚原子 Java”*,从根本上重新定义了 Java 代码的编译、启动和执行方式。 在本架构比较指南中,我们将在核心架构、运行时内存、冷启动时间、开发人员体验、响应式模型、生态系统成熟度和可操作的决策框架等方面详细分析 Quarkus 与 Spring Boot,以帮助您为下一个项目选择正确的框架。 1. 核心架构理念 Spring Boot 和 Quarkus 之间的根本区别在于何时应用程序元数据、依赖关系连接和配置扫描发生:运行时与构建时。
Java Quarkus Spring Boot GraalVM Microservices Cloud Native Kubernetes JVM Software Architecture
Quarkus 简介:为什么 Java 开发人员转向 Supersonic Java

Quarkus 简介:为什么 Java 开发人员转向 Supersonic Java

近三十年来,Java 一直是企业软件开发的主导力量。其丰富的生态系统、强大的面向对象基础、通过 Java 虚拟机 (JVM) 实现的平台独立性以及像 Spring Boot 这样久经考验的框架,使其成为无可争议的后端基础设施之王。 然而,向云原生架构、Kubernetes 编排、容器化 (Docker) 和 无服务器计算(AWS Lambda、Knative) 的转变暴露了传统 Java 应用程序框架中的一个严重漏洞:内存开销高和启动时间慢。 当微服务需要从 0 到 100 个副本水平扩展以响应流量峰值时,或者当无服务器功能按需执行时,等待 3 到 10 秒等待 Java 进程启动是不可接受的。现代云基础设施需要即时启动和轻量的内存消耗——传统上为 Go、Rust 或 Node.js 等语言保留的特征。 输入 Quarkus:一个专为 GraalVM 和 OpenJDK HotSpot 设计的 Kubernetes 原生 Java 框架。 Quarkus 通常被称为“超音速亚原子 Java”*,它从根本上重新设计了 Java 应用程序的编译、启动和运行方式。 在本深入指南中,我们将探讨 Java 开发人员为何采用 Quarkus、Quarkus 如何实现亚秒级启动时间和微内存占用、构建时优化的架构机制,以及如何使用 Quarkus 在 Java 中构建可用于生产的反应式微服务。
Java Quarkus GraalVM Microservices Cloud Native Spring Boot JVM Software Architecture Serverless