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

Microservices

تزریق وابستگی در کوارکوس با CDI: ArC، Scopes، Qualifiers و Build-Time Injection

تزریق وابستگی در کوارکوس با CDI: ArC، Scopes، Qualifiers و Build-Time Injection

تزریق وابستگی (DI) زیربنای توسعه برنامه کاربردی جاوا سازمانی مدرن است. برای سال‌ها، توسعه‌دهندگان جاوا برای جدا کردن چرخه‌های عمر مؤلفه، مدیریت وابستگی‌های سرویس و تزریق ویژگی‌های پیکربندی، به Spring IoC (Inversion of Control) یا کانتینرهای استاندارد Jakarta EE CDI (Contexts and Dependency Injection) مانند Hibernate Weld یا OpenWebBeans متکی بودند.
Java Quarkus CDI ArC Dependency Injection Microservices Cloud Native Software Architecture GraalVM
ساخت APIهای REST با جاوا کوارکوس: راهنمای عملکرد بالا، واکنش‌گرا و بومی ابری

ساخت APIهای REST با جاوا کوارکوس: راهنمای عملکرد بالا، واکنش‌گرا و بومی ابری

در مهندسی نرم‌افزار سازمانی مدرن، ساخت RESTful API سنگ بنای توسعه سیستم‌های بک‌اند است. برای دهه، توسعه‌دهندگان جاوا به فریم‌ورک‌های سنتی مانند Spring Boot متکی بودند. اینجا Quarkus وارد می‌شود—فریم‌ورک Supersonic Subatomic Java که اختصاصاً برای OpenJDK HotSpot و GraalVM طراحی شده است. 1. چرا کوارکوس را برای ساخت APIهای REST انتخاب کنیم؟ الف. پارادایم واکنش‌گرای RESTEasy ب. سرویس‌های توسعه و کدنویسی زنده بدون پیکربندی 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 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. اندپوینت‌های واکنش‌گرا در مقابل اجرای مسدودکننده 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. بنچمارک عملکرد: کوارکوس در مقابل اسپرینگ بوت معیار عملکرد Spring Boot (JVM) Quarkus (OpenJDK JVM) Quarkus (GraalVM Native) بهبود زمان راه‌اندازی (شروع سرد) 3.82 ثانیه 1.18 ثانیه 0.015 ثانیه 254 برابر سریع‌تر مصرف حافظه (RSS) 184 مگابایت 108 مگابایت 28 مگابایت 84% کاهش مصرف حافظه 12. نتیجه‌گیری و بهترین روش‌ها Ghaznix Blog.
Java Quarkus REST API Microservices GraalVM برنامه‌نویسی واکنش‌گرا Hibernate Panache Cloud Native معماری نرم‌افزار
Quarkus vs Spring Boot: کدام چارچوب جاوا را باید انتخاب کنید؟

Quarkus vs Spring Boot: کدام چارچوب جاوا را باید انتخاب کنید؟

برای بیش از یک دهه، Spring Boot به عنوان استاندارد بالفعل برای ساخت برنامه های کاربردی جاوا سازمانی برتر بوده است. اکوسیستم غنی، الگوی پیکربندی بیش از حد قرارداد، موتور تزریق وابستگی قوی، و پشتیبانی گسترده جامعه، جاوا را به بستر سیستم‌های باطنی در سراسر جهان تبدیل کرده است. با این حال، تغییر به سمت معماری‌های Cloud-Native، ارکستراسیون Kubernetes، کانتینرسازی Docker، و اجرای بدون سرور (AWS Lambda، Knative) چالش‌های فنی جدیدی را برای زیرساخت‌های بک‌اند معرفی کرد: کارایی حافظه، مقیاس‌پذیری فوری، و مقیاس‌پذیری سرد فوری.
Java Quarkus Spring Boot GraalVM Microservices Cloud Native Kubernetes JVM Software Architecture
مقدمه ای بر کوارکوس: چرا توسعه دهندگان جاوا به سمت جاوا مافوق صوت حرکت می کنند؟

مقدمه ای بر کوارکوس: چرا توسعه دهندگان جاوا به سمت جاوا مافوق صوت حرکت می کنند؟

برای نزدیک به سه دهه، جاوا نیروی غالب در توسعه نرم افزار سازمانی بوده است. اکوسیستم غنی، شالوده شی گرا قوی، استقلال پلت فرم از طریق ماشین مجازی جاوا (JVM) و چارچوب های آزمایش شده در نبرد مانند Spring Boot آن را به پادشاه بلامنازع زیرساخت های باطن تبدیل کرده است.
Java Quarkus GraalVM Microservices Cloud Native Spring Boot JVM Software Architecture Serverless
الگوی حماسه: تراکنش های توزیع شده در معماری میکروسرویس ها

الگوی حماسه: تراکنش های توزیع شده در معماری میکروسرویس ها

در برنامه های کاربردی یکپارچه سنتی، حفظ ثبات داده ها در چندین موجودیت ساده است. موتورهای پایگاه داده رابطه ای تضمین های ACID (اتمی، سازگاری، جداسازی، دوام) را در داخل تراکنش های SQL محلی ارائه می کنند. اگر قرار دادن سفارش، کسر پرداخت، یا ذخیره موجودی در نیمه راه با شکست مواجه شود، با فراخوانی ROLLBACK هر تغییر پایگاه داده فوراً برمی گردد.
Microservices Saga Pattern Distributed Transactions Event-Driven Architecture Kafka Orchestration Choreography System Design
الگوی Transactional Outbox: انتشار مطمئن رویدادها در معماری مایکروسرویس

الگوی Transactional Outbox: انتشار مطمئن رویدادها در معماری مایکروسرویس

در معماری‌های مدرن مبتنی بر رویداد (Event-Driven Architecture)، سرویس‌ها به‌صورت مداوم رویدادهایی مانند OrderCreated یا PaymentProcessed را منتشر می‌کنند تا تغییرات وضعیت را به‌صورت مستقل اطلاع‌رسانی کنند. اما چالش اصلی این است: چگونه تضمین کنیم که به‌روزرسانی پایگاه‌داده و انتشار رویداد یا هر دو با هم موفق می‌شوند یا هر دو لغو می‌گردند؟
Microservices Outbox Pattern Distributed Systems Kafka Debezium Event-Driven Architecture System Design
الگوی بازگشتی: طراحی تخریب برازنده در میکروسرویس ها

الگوی بازگشتی: طراحی تخریب برازنده در میکروسرویس ها

در معماری میکروسرویس ها، سرویس ها شبکه ای از تماس های شبکه توزیع شده را تشکیل می دهند. در حالی که این به تیم ها اجازه می دهد تا خدمات را به طور مستقل بسازند و مقیاس بندی کنند، همچنین به این معنی است که قابلیت اطمینان کلی سیستم شما به اندازه ضعیف ترین پیوند آن قوی است. اگر یک سرویس مهم از کار بیفتد یا پاسخگو نباشد، می تواند باعث خرابی آبشاری شود که کل برنامه را مختل کند.
Microservices Fallback Pattern Software Architecture System Design Fault Tolerance Resilience
الگوی امتحان مجدد: ساخت میکروسرویس های انعطاف پذیر

الگوی امتحان مجدد: ساخت میکروسرویس های انعطاف پذیر

در معماری میکروسرویس‌ها، سرویس‌ها به جای تماس‌های درون حافظه، از طریق شبکه ارتباط برقرار می‌کنند. در حالی که این جداسازی مقیاس افقی گسترده و استقرار مستقل را امکان پذیر می کند، یک آسیب پذیری بزرگ را نیز معرفی می کند: شبکه غیرقابل اعتماد است. در هر لحظه، یک سرویس پایین دستی ممکن است با یک مشکل کوتاه در شبکه، یک جهش موقت CPU، یک کشمکش سریع قفل پایگاه داده یا راه اندازی مجدد به روز رسانی رو به رو شود. این خرابی های موقت به نام عیب های گذرا شناخته می شوند.
Microservices Retry Pattern Software Architecture System Design Fault Tolerance Resilience
الگوی حفره: طراحی میکروسرویس های مقاوم در برابر خطا

الگوی حفره: طراحی میکروسرویس های مقاوم در برابر خطا

در معماری میکروسرویس، یک برنامه کاربردی به ده ها یا صدها سرویس مستقل و مشترک تقسیم می شود. در حالی که این طراحی ماژولار بودن و مقیاس‌پذیری را بهبود می‌بخشد، اما خطر بزرگی را نیز به همراه دارد: شکست در یک سرویس می‌تواند کل سیستم را از بین ببرد. اگر یک سرویس پایین دستی کند شود یا پاسخگو نباشد، درخواست های دریافتی به سرویس های بالادستی شما شروع به انباشته شدن خواهند کرد. اگر همه آنها حافظه، CPU یا Thread Pool یکسانی داشته باشند، وابستگی آهسته می تواند به سرعت تمام منابع موجود را تمام کند و باعث از کار افتادن کل برنامه شما شود.
Microservices Bulkhead Pattern Software Architecture System Design Fault Tolerance Resilience
الگوی Sidecar: گسترش خدمات میکرو بدون تغییر کد

الگوی Sidecar: گسترش خدمات میکرو بدون تغییر کد

در سیستم‌های ابری مدرن، انتظار می‌رود که میکروسرویس‌ها بسیار بیشتر از اجرای منطق تجاری انجام دهند. آنها باید ورود به سیستم را مدیریت کنند، گواهی‌های SSL/TLS را مدیریت کنند، معیارها را جمع‌آوری کنند، مکانیسم‌های امتحان مجدد را پیاده‌سازی کنند، و ارتباطات امن را با سایر سرویس‌ها هماهنگ کنند. اگر همه این قابلیت های مقطعی را مستقیماً در پایگاه کد هر برنامه جاسازی کنیم، در نهایت با کد نفخ، اتصال محکم و قفل شدن زبان مواجه می شویم.
Microservices Sidecar Pattern Software Architecture System Design Kubernetes DevOps
الگوی انجیر خفه کننده: راهی مطمئن برای مهاجرت برنامه های یکپارچه

الگوی انجیر خفه کننده: راهی مطمئن برای مهاجرت برنامه های یکپارچه

در مهندسی نرم افزار مدرن، برنامه های کاربردی یکپارچه قدیمی یک چالش رایج هستند. با گذشت زمان، یک پایگاه کد موفق به قدری بزرگ و به هم مرتبط می شود که ایجاد تغییرات ساده خطرناک می شود، استقرار ساعت ها طول می کشد و مقیاس بندی ویژگی های فردی عملاً غیرممکن است.
Software Architecture Microservices Monolith Migration System Design Strangler Fig API Routing Refactoring
درک الگوی Backend برای Frontend (BFF): یک راهنمای ساده

درک الگوی Backend برای Frontend (BFF): یک راهنمای ساده

در معماری میکروسرویس‌ها، سیستم‌های ما به ده‌ها سرویس کوچک و متمرکز تقسیم می‌شوند - مانند یک سرویس کاربر، یک سرویس سفارش و یک سرویس محصول. اما وقتی نوبت به نمایش این اطلاعات به کاربران می رسد، دستگاه های مختلف نیازهای بسیار متفاوتی دارند. یک مرورگر وب روی یک رایانه رومیزی پرسرعت، داشبورد غنی پر از جداول، ستون‌های کناری و نمودارها می‌خواهد. یک برنامه تلفن همراه در یک شبکه سلولی کند می خواهد یک طرح ساده و سبک وزن برای صرفه جویی در پهنای باند و باتری داشته باشد. یک برنامه ساعت هوشمند ممکن است فقط به یک خط متن نیاز داشته باشد.
Microservices BFF Pattern Backend for Frontend Software Architecture System Design Node.js
درک الگوی دروازه API در Microservices: یک راهنمای ساده

درک الگوی دروازه API در Microservices: یک راهنمای ساده

انتقال از یک کاربرد واحد و یکپارچه به معماری میکروسرویس بسیاری از مشکلات را حل می کند. این به تیم ها اجازه می دهد تا به طور مستقل کار کنند، خدمات را به طور جداگانه مستقر کنند و بخش هایی از سیستم را در صورت نیاز مقیاس کنند. با این حال، چالش جدیدی را نیز معرفی می کند: ** مشتریان چگونه با این همه خدمات مستقل تعامل می کنند؟**
Microservices API Gateway Software Architecture System Design Routing Security
چرا میکروسرویس های مدرن gRPC را به REST ترجیح می دهند

چرا میکروسرویس های مدرن gRPC را به REST ترجیح می دهند

در یک معماری یکپارچه، اجزاء از طریق فراخوانی متد درون حافظه، که آنی و بسیار قابل اعتماد هستند، ارتباط برقرار می کنند. با این حال، هنگام انتقال به معماری میکروسرویس، این اجزا با مرزهای شبکه از هم جدا می شوند. ارتباط به یک تماس شبکه خارج از فرآیند تبدیل می شود (ارتباط بین فرآیندی یا IPC).
gRPC REST Microservices Java Protocol Buffers HTTP/2 Software Architecture API Design
طراحی دامنه محور (DDD) در میکروسرویس ها

طراحی دامنه محور (DDD) در میکروسرویس ها

هنگامی که سازمان‌ها از معماری یکپارچه به ریزخدمات تغییر می‌کنند، با یک سوال مهم و پرمخاطب مواجه می‌شوند: چگونه مرزهای خدمات خود را ترسیم کنیم؟ در تئوری، ریزسرویس‌ها باید واحدهای شل و جداشده باشند که می‌توانند به طور مستقل توسعه، گسترش و مقیاس‌بندی شوند. با این حال، در عمل، بسیاری از تیم‌ها در نهایت به ساخت یکپارچه توزیع‌شده می‌پردازند – سیستمی که در آن سرویس‌ها به قدری به هم پیوسته‌اند که یک تغییر تجاری نیازمند اصلاح و استقرار چندین سرویس به طور همزمان، ترکیب تاخیر شبکه و گریدلاک‌های استقرار است.
Microservices Domain-Driven Design DDD Software Architecture Bounded Context System Design
مزایا و چالش های میکروسرویس ها در کاربردهای مدرن

مزایا و چالش های میکروسرویس ها در کاربردهای مدرن

در روزهای اولیه توسعه وب، ساختن یک برنامه نرم افزاری ساده بود: شما کد می نوشتید، آن را در یک آرشیو اجرایی یا قابل استقرار بسته بندی می کردید و آن را روی سرور اجرا می کردید. این رویکرد که به عنوان معماری یکپارچه شناخته می شود، برای دهه ها به خوبی به صنعت خدمت کرد.
Microservices Software Architecture Distributed Systems API Gateway Saga Pattern DevOps