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

Java

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
为什么现代微服务更喜欢 gRPC 而不是 REST

为什么现代微服务更喜欢 gRPC 而不是 REST

在整体架构中,组件通过内存中的方法调用进行通信,这是即时且高度可靠的。然而,当迁移到微服务架构时,这些组件被网络边界分隔开。通信变成进程外网络调用(进程间通信,或 IPC)。 多年来,通过 HTTP/1.1 和 JSON 有效负载的 REST(表述性状态传输) 一直是构建 Web API 的默认标准。虽然 REST 非常适合面向公众的 Web 服务和客户端到服务器交互,但当用于高频、低延迟、内部服务到服务通信时,它会带来严重的瓶颈。 这就是现代微服务迅速转向**gRPC(Google 远程过程调用)**的原因。在本文中,我们将分析 REST 的局限性,剖析 gRPC 的架构支柱,并逐步完成在 Java 中 gRPC 服务的完整实现。 1. 微服务中 REST 的瓶颈 REST 为网络提供了二十多年的动力。然而,其底层技术并未针对内部分布式架构进行优化: A. 纯文本 JSON 的开销 JSON 是人类可读的,这使得调试变得容易,但对于机器到机器的通信来说效率极低: 序列化/反序列化成本:解析文本字符串标记并将其转换为对象会消耗大量 CPU 周期。 大有效负载大小:JSON 键在每个请求中都会重复(例如 {"transactionId": "123", "amount": 99.99})。对于每秒处理数百万个请求的系统来说,这种冗余元数据浪费了巨大的网络带宽。 B. HTTP/1.1 连接限制 REST 通常在 HTTP/1.1 上运行,它表现出一些结构上的低效率: 队头 (HoL) 阻塞:在单个 TCP 连接上,客户端必须等待当前请求的响应,然后才能发送下一个请求。 连接池耗尽:为了处理并发请求,客户端必须打开多个 TCP 连接。当连接不断打开和关闭时,这会导致显着的操作系统资源开销、套接字耗尽以及慢启动性能损失。 C. 弱 API 合约 REST API 缺乏内置的编译时合约。虽然 OpenAPI/Swagger 有助于记录 API,但它们与代码库是分开的。后端开发人员很容易更改 JSON 字段名称并意外破坏下游服务,而不会出现编译时警告。
gRPC REST Microservices Java Protocol Buffers HTTP/2 Software Architecture API Design
使用 Ghaznix Explorer 立即将 JSON 转换为任何代码模型

使用 Ghaznix Explorer 立即将 JSON 转换为任何代码模型

如果您在处理外部 API,您一定深有感触。您收到一个巨大的 JSON 有效负载,在您开始编写业务逻辑之前,您必须花 30 分钟手动编写数据类、结构体或模型来正确解析它。 在 Go 中定义嵌套属性、在 Java 中处理 getter 和 setter,或者在 Python 中编写 Pydantic 验证模式,这些工作既枯燥又极易出错。 这就是为什么 Ghaznix 的 JSON Explorer 现在包含一键式的 JSON 转代码模型转换器。 1. 支持的语言与框架 我们设计了这款转换器,以支持最流行的语言和框架。目前,Ghaznix JSON Explorer 可以立即将任何有效的 JSON 转换为: Python: 标准数据类 (Data Classes) 和 Pydantic 模型 Go (Golang): 带有正确 JSON 标签的结构体 (Structs) Java: 带有 getter 和 setter 的标准 Java 对象 (POJOs) C#: 带有 JSON 属性特性的类 Kotlin: 数据类 Dart: 带有 fromJson 和 toJson 序列化的类 JavaScript/TypeScript: Mongoose Schema 和 TS 接口 2. 它是如何工作的 生成生产就绪的代码完全是无缝的:
json 代码生成 python golang java csharp pydantic kotlin dart mongoose