黑客灵魂

这个屌丝很懒，什么也没留下！

热门标签

SpringCloud Alibaba 实战：搭建第一个 SpringCloud Alibaba 项目_springcloudalibaba搭建教程

作者：黑客灵魂 | 2024-08-11 16:41:19

踩

springcloudalibaba搭建教程

SpringCloud Alibaba 实战：搭建第一个 SpringCloud Alibaba 项目

引言

在现代微服务架构中，SpringCloud 已经成为开发者构建分布式系统的首选工具之一。SpringCloud Alibaba 是 SpringCloud 生态中的一个重要子集，提供了一整套微服务开发的解决方案，集成了阿里巴巴的中间件和服务。这篇博客将带领大家一步一步搭建一个简单的 SpringCloud Alibaba 项目，帮助开发者快速上手。

SpringCloud Alibaba 简介
项目准备
- 环境要求
- 工具安装
创建 SpringCloud Alibaba 项目
- 使用 Spring Initializr 初始化项目
- 项目结构分析
引入 SpringCloud Alibaba 依赖
- Maven 依赖配置
搭建服务注册中心（Nacos）
- Nacos 简介
- Nacos 安装与配置
实现服务消费者与提供者
- 创建服务提供者
- 创建服务消费者
- 服务调用测试
配置网关（Spring Cloud Gateway）
- 网关简介
- 网关配置与路由规则
服务降级与熔断（Sentinel）
- Sentinel 简介
- 配置与使用示例
配置中心（Nacos Config）
- 动态配置管理
总结与展望

SpringCloud Alibaba 简介

SpringCloud Alibaba 是一个为微服务解决方案提供全面支持的工具集。它集成了阿里巴巴的开源技术栈，如 Nacos、Sentinel、RocketMQ 等，旨在简化微服务架构的构建与管理。其主要特点包括：

服务注册与发现：通过 Nacos 实现服务注册与发现。
负载均衡与路由：使用 Spring Cloud Gateway 提供 API 网关功能。
限流与熔断：Sentinel 提供了流量控制和熔断降级功能。
配置管理：Nacos Config 允许动态配置管理，便于服务的配置更新。

项目准备

环境要求

在开始搭建项目之前，需要确保本地环境满足以下要求：

Java 11 或以上
Maven 3.6.0 或以上
IDEA 或 Eclipse 开发工具

工具安装

Java 安装：从 Oracle 或 OpenJDK 下载并安装 JDK 11。
Maven 安装：从 Maven 官方网站下载并安装 Maven。
IDEA/Eclipse 安装：推荐使用 IDEA，下载地址：JetBrains IDEA

创建 SpringCloud Alibaba 项目

使用 Spring Initializr 初始化项目

Spring Initializr 是 Spring 官方提供的项目初始化工具，能够快速生成项目结构。

访问 Spring Initializr，选择如下配置：
- Project：Maven Project
- Language：Java
- Spring Boot：2.7.x
- Project Metadata：
  - Group：com.example
  - Artifact：springcloud-alibaba-demo
  - Name：SpringCloudAlibabaDemo
  - Package name：com.example.springcloudalibabademo
  - Packaging：Jar
  - Java：11
Dependencies：
- Spring Web
- Spring Cloud Alibaba Nacos Discovery
- Spring Cloud Alibaba Nacos Config
- Spring Cloud Gateway
- Spring Cloud Alibaba Sentinel

点击“Generate”生成项目并下载。

项目结构分析

解压并导入项目后，项目结构大致如下：

springcloud-alibaba-demo
│   pom.xml
└───src
    ├───main
    │   ├───java
    │   │   └───com.example.springcloudalibabademo
    │   │       └───SpringCloudAlibabaDemoApplication.java
    │   └───resources
    │       ├───application.properties
    │       └───static
    └───test
        └───java
1
2
3
4
5
6
7
8
9
10
11
12

引入 SpringCloud Alibaba 依赖

Maven 依赖配置

在 pom.xml 中添加 SpringCloud Alibaba 相关依赖：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-alibaba-dependencies</artifactId>
            <version>2021.1</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

<dependencies>
    <!-- Spring Web -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>

    <!-- Nacos Discovery -->
    <dependency>
        <groupId>com.alibaba.cloud</groupId>
        <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
    </dependency>

    <!-- Nacos Config -->
    <dependency>
        <groupId>com.alibaba.cloud</groupId>
        <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
    </dependency>

    <!-- Spring Cloud Gateway -->
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-gateway</artifactId>
    </dependency>

    <!-- Sentinel -->
    <dependency>
        <groupId>com.alibaba.cloud</groupId>
        <artifactId>spring-cloud-starter-alibaba-sentinel</artifactId>
    </dependency>
</dependencies>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

搭建服务注册中心（Nacos）

Nacos 简介

Nacos 是一个易于使用的动态服务发现、配置和服务管理平台。它帮助开发者快速实现微服务架构中的注册、配置与发现功能。

Nacos 安装与配置

下载 Nacos：Nacos Releases
启动 Nacos：

解压后进入 bin 目录，执行启动命令：
- Windows：startup.cmd -m standalone
- Linux/Unix/Mac：sh startup.sh -m standalone
访问控制台：

启动成功后，访问 http://localhost:8848/nacos 进入 Nacos 控制台。

实现服务消费者与提供者

创建服务提供者

在项目中创建一个模块 provider，并添加以下代码：

pom.xml：

<dependencies>
    <!-- Spring Web -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>

    <!-- Nacos Discovery -->
    <dependency>
        <groupId>com.alibaba.cloud</groupId>
        <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
    </dependency>
</dependencies>
1
2
3
4
5
6
7
8
9
10
11
12
13

application.properties：

server.port=8081
spring.application.name=service-provider
spring.cloud.nacos.discovery.server-addr=localhost:8848
1
2
3

ProviderApplication.java：

package com.example.springcloudalibabademo.provider;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@SpringBootApplication
@RestController
public class ProviderApplication {

    public static void main(String[] args) {
        SpringApplication.run(ProviderApplication.class, args);
    }

    @GetMapping("/hello")
    public String hello() {
        return "Hello from Provider!";
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

创建服务消费者

在项目中创建一个模块 consumer，并添加以下代码：

pom.xml：

<dependencies>
    <!-- Spring Web -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>


    </dependency>

    <!-- Nacos Discovery -->
    <dependency>
        <groupId>com.alibaba.cloud</groupId>
        <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
    </dependency>

    <!-- OpenFeign -->
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-openfeign</artifactId>
    </dependency>
</dependencies>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

application.properties：

server.port=8082
spring.application.name=service-consumer
spring.cloud.nacos.discovery.server-addr=localhost:8848
1
2
3

ConsumerApplication.java：

package com.example.springcloudalibabademo.consumer;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.openfeign.EnableFeignClients;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.beans.factory.annotation.Autowired;

@SpringBootApplication
@EnableFeignClients
@RestController
public class ConsumerApplication {

    @Autowired
    private ProviderClient providerClient;

    public static void main(String[] args) {
        SpringApplication.run(ConsumerApplication.class, args);
    }

    @GetMapping("/hello")
    public String hello() {
        return providerClient.hello();
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

ProviderClient.java：

package com.example.springcloudalibabademo.consumer;

import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;

@FeignClient(name = "service-provider")
public interface ProviderClient {

    @GetMapping("/hello")
    String hello();
}
1
2
3
4
5
6
7
8
9
10
11

服务调用测试

启动服务提供者和消费者模块。
访问消费者服务的接口：http://localhost:8082/hello
返回结果应为：“Hello from Provider!”

配置网关（Spring Cloud Gateway）

网关简介

Spring Cloud Gateway 是 Spring 官方提供的 API 网关解决方案，提供路由、断言和过滤器等功能，支持对微服务进行统一管理。

网关配置与路由规则

在项目中创建一个模块 gateway，并添加以下代码：

pom.xml：

<dependencies>
    <!-- Spring Cloud Gateway -->
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-gateway</artifactId>
    </dependency>

    <!-- Nacos Discovery -->
    <dependency>
        <groupId>com.alibaba.cloud</groupId>
        <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
    </dependency>
</dependencies>
1
2
3
4
5
6
7
8
9
10
11
12
13

application.properties：

server.port=8080
spring.application.name=gateway
spring.cloud.nacos.discovery.server-addr=localhost:8848
spring.cloud.gateway.discovery.locator.enabled=true
spring.cloud.gateway.discovery.locator.lower-case-service-id=true
1
2
3
4
5

GatewayApplication.java：

package com.example.springcloudalibabademo.gateway;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class GatewayApplication {

    public static void main(String[] args) {
        SpringApplication.run(GatewayApplication.class, args);
    }
}
1
2
3
4
5
6
7
8
9
10
11
12

配置路由规则：

在 application.properties 中添加路由规则，使请求 /api/hello 路由到 service-consumer 服务：

spring.cloud.gateway.routes[0].id=consumer
spring.cloud.gateway.routes[0].uri=lb://service-consumer
spring.cloud.gateway.routes[0].predicates[0]=Path=/api/hello
1
2
3

启动网关模块，访问 http://localhost:8080/api/hello，应返回“Hello from Provider!”

服务降级与熔断（Sentinel）

Sentinel 简介

Sentinel 是阿里巴巴开源的一款流量防护和熔断降级解决方案，用于保护服务的稳定性和可用性。

配置与使用示例

在消费者模块中添加 Sentinel 依赖：

pom.xml：

<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-sentinel</artifactId>
</dependency>
1
2
3
4

ConsumerApplication.java：

修改 ProviderClient 接口以支持熔断降级：

@FeignClient(name = "service-provider", fallback = ProviderClientFallback.class)
public interface ProviderClient {

    @GetMapping("/hello")
    String hello();
}

@Component
public class ProviderClientFallback implements ProviderClient {
    @Override
    public String hello() {
        return "Fallback: Service Unavailable";
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14

启动消费者模块，停止提供者服务，访问 http://localhost:8082/hello，应返回“Fallback: Service Unavailable”。

配置中心（Nacos Config）

动态配置管理

在 Nacos 控制台添加配置：
- Data ID：service-provider-dev.yaml
- Group：DEFAULT_GROUP
- Content：
```
server:
  port: 8081
1
2
```

在服务提供者的 application.properties 中启用 Nacos Config：

spring.profiles.active=dev
spring.cloud.nacos.config.server-addr=localhost:8848
spring.cloud.nacos.config.file-extension=yaml
1
2
3

启动服务提供者，查看是否读取了 Nacos 配置的端口号。

总结与展望

通过本次实践，我们成功搭建了一个简单的 SpringCloud Alibaba 项目，涵盖了服务注册与发现、网关路由、服务降级与熔断以及配置中心等核心功能。SpringCloud Alibaba 提供了一整套解决方案，帮助开发者轻松构建和管理微服务架构。在未来的开发中，可以进一步探索更多高级功能，如分布式事务（Seata）、消息队列（RocketMQ）等，构建更加复杂和健壮的微服务系统。

通过这种方式，读者可以逐步理解和实践 SpringCloud Alibaba 的核心功能，从而在真实项目中应用这些技术。希望这篇博客能够为您的开发旅程提供帮助！如果有任何疑问或建议，欢迎在评论区留言。

声明：本文内容由网友自发贡献，不代表【wpsshop博客】立场，版权归原作者所有，本站不承担相应法律责任。如您发现有侵权的内容，请联系我们。转载请注明出处：https://www.wpsshop.cn/w/黑客灵魂/article/detail/965197

SpringCloud Alibaba 实战：搭建第一个 SpringCloud Alibaba 项目_springcloudalibaba搭建教程

SpringCloud Alibaba 实战：搭建第一个 SpringCloud Alibaba 项目

引言

目录

SpringCloud Alibaba 简介

项目准备

环境要求

工具安装

创建 SpringCloud Alibaba 项目

使用 Spring Initializr 初始化项目

项目结构分析

引入 SpringCloud Alibaba 依赖

Maven 依赖配置

搭建服务注册中心（Nacos）

Nacos 简介

Nacos 安装与配置

实现服务消费者与提供者

创建服务提供者

创建服务消费者

服务调用测试

配置网关（Spring Cloud Gateway）

网关简介

网关配置与路由规则

服务降级与熔断（Sentinel）

Sentinel 简介

配置与使用示例

配置中心（Nacos Config）

动态配置管理

总结与展望