使用 Spring Boot 建立您的第一個微服務系統：初學者指南

介紹

在本指南中，我們將逐步介紹如何使用 Spring Boot 創建一個簡單而全面的微服務系統。我們將介紹微服務的基礎知識，設定所需的環境，並實作兩個微服務：OrderService 和 InventoryService。此外，我們將使用 Eureka 和 API 閘道整合服務發現來管理服務之間的路由。

什麼是微服務？

微服務是一種軟體架構風格，其中應用程式被建構為協同工作的小型獨立服務的集合。每個服務都是獨立的，並透過明確定義的 API 與其他服務進行通信，使系統更加靈活、可擴展且更易於管理。

系統架構

我們系統的架構將由兩個微服務組成：OrderService 和 InventoryService。 OrderService 將使用關聯式資料庫 (MySQL) 來儲存訂單詳細信息，而 InventoryService 將使用 NoSQL 資料庫 (MongoDB) 來管理庫存資料。我們還將使用 Eureka 實作服務發現，並使用 API 閘道來路由請求。

項目設定

在開始之前，請確保您已安裝以下工具：

• IDE：IntelliJ IDEA（首選）或 Eclipse
• JDK：版本 17 或更高版本
• 建置工具：Maven
• 資料庫：MySQL 和 MongoDB

微服務一：訂單服務

第 1 步：初始化項目

1. 到 Spring Initializr。
2. 填入項目詳情：
   • 專案：Maven 專案
   • 語言：Java
   • Spring Boot：2.5.7（或相容版本）
   • 群組：com.ordersystem
   • 神器：訂單服務
   • 名稱：訂單服務
   • 包名: com.ordersystem.orderservice
   • 包裝：罐裝
   • Java：17
3. 加入以下依賴：
   • 春天網
   • Spring 資料 JPA
   • MySQL 驅動程式
   • 龍目島
4. 點擊產生下載專案。解壓縮下載的 zip 檔案並在 IDE 中開啟它。

第 2 步：配置應用程式

開啟 src/main/resources 中的 application.properties 文件，新增以下設定：

第 3 步：實施模型

在src/main/java/com/ordersystem/orderservice/model/Order.java建立Order實體類別：

第 4 步：建立儲存庫

在 src/main/java/com/ordersystem/orderservice/repository/OrderRepository.java 中建立 OrderRepository 介面：

第 5 步：實施服務

在 src/main/java/com/ordersystem/orderservice/service/OrderService.java 中建立 OrderService 類別：

第 6 步：建立控制器

在 src/main/java/com/ordersystem/orderservice/controller/OrderController.java 中建立 OrderController 類別：

微服務2：庫存服務

第 1 步：初始化項目

1. 到 Spring Initializr。
2. 填入項目詳情：
   • 專案：Maven 專案
   • 語言：Java
   • Spring Boot：2.5.7（或相容版本）
   • 群組：com.ordersystem
   • Artifact：庫存服務
   • 名稱：庫存服務
   • 包名: com.ordersystem.inventoryservice
   • 包裝：罐裝
   • Java：17
3. 加入以下依賴：
   • 春天網
   • Spring Data MongoDB
   • 龍目島
4. 點擊產生下載專案。解壓縮下載的 zip 檔案並在 IDE 中開啟它。

第 2 步：配置應用程式

開啟 src/main/resources 中的 application.properties 文件，新增以下設定：

第 3 步：實施模型

在src/main/java/com/ordersystem/inventoryservice/model/InventoryItem.java中建立InventoryItem實體類別：

第 4 步：建立儲存庫

在 src/main/java/com/ordersystem/inventoryservice/repository/InventoryRepository.java 中建立 InventoryRepository 介面：

package com.ordersystem.inventoryservice.repository; import com.ordersystem.inventoryservice.model.InventoryItem; import org.springframework.data.mongodb.repository.MongoRepository; public interface InventoryRepository extends MongoRepository { }

Step 5: Implement the Service

Create the InventoryService class in src/main/java/com/ordersystem/inventoryservice/service/InventoryService.java:

package com.ordersystem.inventoryservice.service; import com.ordersystem.inventoryservice.model.InventoryItem; import com.ordersystem.inventoryservice.repository.InventoryRepository; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Service; import java.util.List; @Service public class InventoryService { @Autowired private InventoryRepository inventoryRepository; public List getAllItems() { return inventoryRepository.findAll(); } public InventoryItem getItemById(String id) { return inventoryRepository.findById(id).orElse(null); } public InventoryItem createItem(InventoryItem item) { return inventoryRepository.save(item); } public void deleteItem(String id) { inventoryRepository.deleteById(id); } }

Step 6: Create the Controller

Create the InventoryController class in src/main/java/com/ordersystem/inventoryservice/controller/InventoryController.java:

package com.ordersystem.inventoryservice.controller; import com.ordersystem.inventoryservice.model.InventoryItem; import com.ordersystem.inventoryservice.service.InventoryService; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.web.bind.annotation.*; import java.util.List; @RestController @RequestMapping("/api/inventory") public class InventoryController { @Autowired private InventoryService inventoryService; @GetMapping public List getAllItems() { return inventoryService.getAllItems(); } @GetMapping("/{id}") public InventoryItem getItemById(@PathVariable String id) { return inventoryService.getItemById(id); } @PostMapping public InventoryItem createItem(@RequestBody InventoryItem item) { return inventoryService.createItem(item); } @DeleteMapping("/{id}") public void deleteItem(@PathVariable String id) { inventoryService.delete Item(id); } }

Service Discovery with Eureka

Step 1: Initialize the Eureka Server

1. Go to Spring Initializr.
2. Fill in the project details:
   • Project: Maven Project
   • Language: Java
   • Spring Boot: 2.5.7 (or a compatible version)
   • Group: com.ordersystem
   • Artifact: eureka-server
   • Name: eureka-server
   • Package name: com.ordersystem.eurekaserver
   • Packaging: Jar
   • Java: 17
3. Add theEureka Serverdependency.
4. ClickGenerateto download the project. Extract the downloaded zip file and open it in your IDE.

Step 2: Configure the Eureka Server

Open the application.properties file in src/main/resources and add the following configuration:

server.port=8761 eureka.client.register-with-eureka=false eureka.client.fetch-registry=false

Step 3: Enable Eureka Server

Annotate the main application class in src/main/java/com/ordersystem/eurekaserver/EurekaServerApplication.java with @EnableEurekaServer:

package com.ordersystem.eurekaserver; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; import org.springframework.cloud.netflix.eureka.server.EnableEurekaServer; @SpringBootApplication @EnableEurekaServer public class EurekaServerApplication { public static void main(String[] args) { SpringApplication.run(EurekaServerApplication.class, args); } }

Integrate Services with Eureka

Add the Eureka client dependency to both OrderService and InventoryService:

 org.springframework.cloud spring-cloud-starter-netflix-eureka-client 

Add Eureka client configuration to the application.properties files:

Order Service:

eureka.client.service-url.defaultZone=http://localhost:8761/eureka/ spring.application.name=order-service

Inventory Service:

eureka.client.service-url.defaultZone=http://localhost:8761/eureka/ spring.application.name=inventory-service

API Gateway

Step 1: Initialize the API Gateway

1. Go to Spring Initializr.
2. Fill in the project details:
   • Project: Maven Project
   • Language: Java
   • Spring Boot: 2.5.7 (or a compatible version)
   • Group: com.ordersystem
   • Artifact: api-gateway
   • Name: api-gateway
   • Package name: com.ordersystem.apigateway
   • Packaging: Jar
   • Java: 17
3. Add theGatewayandEureka Discovery Clientdependencies.
4. ClickGenerateto download the project. Extract the downloaded zip file and open it in your IDE.

Step 2: Configure the API Gateway

Open the application.yml file in src/main/resources and add the following configuration:

server: port: 8080 spring: application: name: api-gateway cloud: gateway: routes: - id: order-service uri: lb://order-service predicates: - Path=/api/orders/** - id: inventory-service uri: lb://inventory-service predicates: - Path=/api/inventory/** eureka: client: service-url: defaultZone: http://localhost:8761/eureka/

Step 3: Enable Discovery Client

Annotate the main application class in src/main/java/com/ordersystem/apigateway/ApiGatewayApplication.java with @EnableDiscoveryClient:

package com.ordersystem.apigateway; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; import org.springframework.cloud.client.discovery.EnableDiscoveryClient; @SpringBootApplication @EnableDiscoveryClient public class ApiGatewayApplication { public static void main(String[] args) { SpringApplication.run(ApiGatewayApplication.class, args); } }

Testing the Microservices

1. Start Eureka Server: Run the Eureka Server application.
2. Start Order Service: Run the Order Service application.
3. Start Inventory Service: Run the Inventory Service application.
4. Start API Gateway: Run the API Gateway application.

Use Postman or any other API client to test the endpoints through the API Gateway:

• Create Order: POST http://localhost:8080/api/orders
• Get Orders: GET http://localhost:8080/api/orders
• Create Inventory Item: POST http://localhost:8080/api/inventory
• Get Inventory Items: GET http://localhost:8080/api/inventory

Conclusion

In this guide, we've built a simple microservices system using Spring Boot. We created two microservices (OrderService and InventoryService), integrated service discovery with Eureka, and set up an API Gateway for routing requests. This architecture allows for scalable and maintainable microservices that can be easily extended in the future.

以上是使用 Spring Boot 建立您的第一個微服務系統：初學者指南的詳細內容。更多資訊請關注PHP中文網其他相關文章！