• 新鲜速递:Spring Cloud Alibaba环境在Spring Boot 3时代的快速搭建


    了解

    首先,Spring Cloud Alibaba使用的是Nacos作为服务注册和服务发现的中间件。
    在这里插入图片描述
    能力在提供者那里,而消费者只需知道提供者提供哪些服务,而无需关心提供者在哪里,实际调用过程如下图
    在这里插入图片描述

    准备工作

    1、需要下载并安装Nacos最新版
    下载安装过程略,如果是单机启动请建立一个批处理放在解压后的bin目录里,命令内容就一行:startup.cmd -m standalone
    用单机模式启动Nacos,如果你是Linux系统,请改成.sh并加上bash头
    2、启动nacos,默认用户名密码均为nacos,端口号为8848,但同时要注意,如果你是docker部署,因为有gRPC协议,还需要放行9848端口。
    3、Nacos作为一个配置中心,还需要加上我们应用的配置,可以少写很多配置。
    在这里插入图片描述

    配置中心添加配置文件

    点击加号,添加这三个配置文件,配置格式都为YAML
    在这里插入图片描述
    application-dev.yml内容:

    feign:
      sentinel:
        enabled: true
      okhttp:
        enabled: true
      httpclient:
        enabled: false
      client:
        config:
          default:
            connectTimeout: 10000
            readTimeout: 10000
      compression:
        request:
          enabled: true
        response:
          enabled: true
    
    management:
      endpoints:
        web:
          exposure:
            include: '*'
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23

    provider-dev.yml和consumer-dev.yml内容:

    spring:
    
    • 1

    项目搭建

    先随便建立一个空白Maven项目,只要pom.xml文件,src目录是不需要的。然后把pom.xml改成如下:

    <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
        <modelVersion>4.0.0modelVersion>
        <groupId>com.demogroupId>
        <artifactId>demoartifactId>
        <version>1.0-SNAPSHOTversion>
    
        <modules>
            <module>providermodule>
            <module>consumermodule>
            <module>apimodule>
        modules>
    
        <properties>
            <java.version>17java.version>
            <maven.compiler.source>17maven.compiler.source>
            <maven.compiler.target>17maven.compiler.target>
        properties>
    
        <dependencyManagement>
            <dependencies>
                <dependency>
                    <groupId>org.springframework.bootgroupId>
                    <artifactId>spring-boot-dependenciesartifactId>
                    <version>3.1.4version>
                    <type>pomtype>
                    <scope>importscope>
                dependency>
                <dependency>
                    <groupId>org.springframework.cloudgroupId>
                    <artifactId>spring-cloud-dependenciesartifactId>
                    <version>2022.0.4version>
                    <type>pomtype>
                    <scope>importscope>
                dependency>
                <dependency>
                    <groupId>com.alibaba.cloudgroupId>
                    <artifactId>spring-cloud-alibaba-dependenciesartifactId>
                    <version>2022.0.0.0version>
                    <type>pomtype>
                    <scope>importscope>
                dependency>
    
                <dependency>
                    <groupId>com.demogroupId>
                    <artifactId>consumerartifactId>
                    <version>0.0.1-SNAPSHOTversion>
                dependency>
    
                <dependency>
                    <groupId>com.demogroupId>
                    <artifactId>apiartifactId>
                    <version>0.0.1-SNAPSHOTversion>
                dependency>
    
                <dependency>
                    <groupId>com.demogroupId>
                    <artifactId>providerartifactId>
                    <version>0.0.1-SNAPSHOTversion>
                dependency>
            dependencies>
        dependencyManagement>
    
        <dependencies>
            <dependency>
                <groupId>org.springframework.bootgroupId>
                <artifactId>spring-boot-starter-webartifactId>
            dependency>
            <dependency>
                <groupId>com.alibaba.cloudgroupId>
                <artifactId>spring-cloud-starter-alibaba-nacos-discoveryartifactId>
            dependency>
            <dependency>
                <groupId>com.alibaba.cloudgroupId>
                <artifactId>spring-cloud-starter-alibaba-nacos-configartifactId>
            dependency>
            <dependency>
                <groupId>org.projectlombokgroupId>
                <artifactId>lombokartifactId>
                <optional>trueoptional>
            dependency>
            <dependency>
                <groupId>org.springframework.cloudgroupId>
                <artifactId>spring-cloud-starter-bootstrapartifactId>
            dependency>
            <dependency>
                <groupId>org.springframework.cloudgroupId>
                <artifactId>spring-cloud-starter-openfeignartifactId>
            dependency>
            <dependency>
                <groupId>org.springframework.cloudgroupId>
                <artifactId>spring-cloud-starter-loadbalancerartifactId>
            dependency>
        dependencies>
    
        <repositories>
            <repository>
                <id>publicid>
                <name>aliyun nexusname>
                <url>https://maven.aliyun.com/repository/publicurl>
                <releases>
                    <enabled>trueenabled>
                releases>
            repository>
        repositories>
    
        <pluginRepositories>
            <pluginRepository>
                <id>publicid>
                <name>aliyun nexusname>
                <url>https://maven.aliyun.com/repository/publicurl>
                <releases>
                    <enabled>trueenabled>
                releases>
                <snapshots>
                    <enabled>falseenabled>
                snapshots>
            pluginRepository>
        pluginRepositories>
    
        <packaging>pompackaging>
    
        <build>
            <pluginManagement>
                <plugins>
                    <plugin>
                        <groupId>org.springframework.bootgroupId>
                        <artifactId>spring-boot-maven-pluginartifactId>
                        <configuration>
                            <excludes>
                                <exclude>
                                    <groupId>org.projectlombokgroupId>
                                    <artifactId>lombokartifactId>
                                exclude>
                            excludes>
                        configuration>
                        <version>3.1.4version>
                        <executions>
                            <execution>
                                <goals>
                                    <goal>repackagegoal>
                                goals>
                            execution>
                        executions>
                    plugin>
                plugins>
            pluginManagement>
        build>
    project>
    
    
    • 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
    • 44
    • 45
    • 46
    • 47
    • 48
    • 49
    • 50
    • 51
    • 52
    • 53
    • 54
    • 55
    • 56
    • 57
    • 58
    • 59
    • 60
    • 61
    • 62
    • 63
    • 64
    • 65
    • 66
    • 67
    • 68
    • 69
    • 70
    • 71
    • 72
    • 73
    • 74
    • 75
    • 76
    • 77
    • 78
    • 79
    • 80
    • 81
    • 82
    • 83
    • 84
    • 85
    • 86
    • 87
    • 88
    • 89
    • 90
    • 91
    • 92
    • 93
    • 94
    • 95
    • 96
    • 97
    • 98
    • 99
    • 100
    • 101
    • 102
    • 103
    • 104
    • 105
    • 106
    • 107
    • 108
    • 109
    • 110
    • 111
    • 112
    • 113
    • 114
    • 115
    • 116
    • 117
    • 118
    • 119
    • 120
    • 121
    • 122
    • 123
    • 124
    • 125
    • 126
    • 127
    • 128
    • 129
    • 130
    • 131
    • 132
    • 133
    • 134
    • 135
    • 136
    • 137
    • 138
    • 139
    • 140
    • 141
    • 142
    • 143
    • 144
    • 145
    • 146
    • 147
    • 148
    • 149
    • 150

    然后搭建三个子项目,api、provider、consumer,分别代表API库、提供者和消费者
    在这里插入图片描述
    目录结构应当是,api、provider、consumer目录和pom.xml文件平级

    提供者编写

    提供者的pom.xml,在provider目录下。要注意和主项目的dependencyManagement中provider的声明保持一致。

    
    <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
        <modelVersion>4.0.0modelVersion>
        <parent>
            <groupId>com.demogroupId>
            <artifactId>demoartifactId>
            <version>1.0-SNAPSHOTversion>
        parent>
    
        <artifactId>providerartifactId>
        <version>0.0.1-SNAPSHOTversion>
        <name>providername>
    
        <dependencies>
    
        dependencies>
    project>
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18

    编写启动类,关键点是添加@EnableFeignClients(basePackages = "com.demo")注解

    package com.demo.provider;
    
    import org.springframework.boot.SpringApplication;
    import org.springframework.boot.autoconfigure.SpringBootApplication;
    import org.springframework.cloud.openfeign.EnableFeignClients;
    
    @EnableFeignClients(basePackages = "com.demo")
    @SpringBootApplication
    public class ProviderApplication {
    
        public static void main(String[] args) {
            SpringApplication.run(ProviderApplication.class, args);
        }
    
    }
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15

    随便写一个非常正常、平平无奇的Controller:

    package com.demo.provider;
    
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.bind.annotation.RestController;
    
    @RestController
    @RequestMapping("/")
    public class ProviderController {
        @RequestMapping("sayHello")
        public String sayHello(String name){
            return "你好,"+name;
        }
    }
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13

    然后在resources目录里建立一个bootstrap.yml文件

    server:
      port: 9001
    
    spring:
      application:
        name: provider
      profiles:
        active: dev
      cloud:
        nacos:
          discovery:
            server-addr: localhost:8848
          config:
            server-addr: localhost:8848
            file-extension: yml
            shared-configs:
              - application-${spring.profiles.active}.${spring.cloud.nacos.config.file-extension}
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17

    注意,把localhost替换成你的Nacos服务器地址

    API编写

    API的pom.xml如下(除了name和artifactId不一样,其他都和提供者一样)。

    
    <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
        <modelVersion>4.0.0modelVersion>
        <parent>
            <groupId>com.demogroupId>
            <artifactId>demoartifactId>
            <version>1.0-SNAPSHOTversion>
        parent>
    
        <artifactId>apiartifactId>
        <version>0.0.1-SNAPSHOTversion>
        <name>apiname>
    
        <dependencies>
    
        dependencies>
    
    project>
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19

    关键位置来了,API类是这么写的,这里用了OpenFeign技术

    package com.demo.api;
    
    import org.springframework.cloud.openfeign.FeignClient;
    import org.springframework.web.bind.annotation.GetMapping;
    import org.springframework.web.bind.annotation.RequestParam;
    
    @FeignClient(contextId = "providerMicroService", value = "provider", fallbackFactory = ProviderMicroServiceFallBackFactory.class)
    public interface ProviderMicroService
    {
        @GetMapping("/sayHello")
        String sayHello(@RequestParam("name") String name);
    }
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12

    这里contextId指的是上下文ID,类名的小写驼峰即可。value表示你要调哪个服务,fallbackFactory是指当服务无法访问或抛出异常时服务降级类是哪个。剩下的都很好理解,注意Get Mapping指的就是上面提供者Controller的类和方法的RequestMapping注解拼起来的地址。然后每一个参数都要加上@RequestParam注解并写上叫什么名(不加就会报错)。
    然后我们写服务降级类,如果你不想降级,也可以不写:

    package com.demo.api;
    
    import org.springframework.cloud.openfeign.FallbackFactory;
    import org.springframework.stereotype.Component;
    @Component
    public class ProviderMicroServiceFallBackFactory implements FallbackFactory<ProviderMicroService>
    {
        @Override
        public ProviderMicroService create(Throwable throwable){
            return new ProviderMicroService() {
                @Override
                public String sayHello(String name) {
                    return "服务访问失败";
                }
            };
        }
    }
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17

    消费者编写

    consumer项目的pom.xml如下,注意这里多了一个对api的引用。

    
    <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
        <modelVersion>4.0.0modelVersion>
        <parent>
            <groupId>com.demogroupId>
            <artifactId>demoartifactId>
            <version>1.0-SNAPSHOTversion>
        parent>
    
        <artifactId>consumerartifactId>
        <version>0.0.1-SNAPSHOTversion>
        <name>consumername>
    
        <dependencies>
            <dependency>
                <groupId>com.demogroupId>
                <artifactId>apiartifactId>
            dependency>
        dependencies>
    
    project>
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22

    然后编写启动类,同样,关键是@EnableFeignClients(basePackages = "com.demo")这一行

    package com.demo.consumer;
    
    import org.springframework.boot.SpringApplication;
    import org.springframework.boot.autoconfigure.SpringBootApplication;
    import org.springframework.cloud.openfeign.EnableFeignClients;
    
    @EnableFeignClients(basePackages = "com.demo")
    @SpringBootApplication
    public class ConsumerApplication {
    
        public static void main(String[] args) {
            SpringApplication.run(ConsumerApplication.class, args);
        }
    
    }
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15

    最后我们编写消费者的Controller,这里的重点是MicroService是要用@Resource引入,不建议使用@Autowired:

    package com.demo.consumer;
    
    import com.demo.api.ProviderMicroService;
    import jakarta.annotation.Resource;
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.bind.annotation.RestController;
    
    @RestController
    @RequestMapping("/")
    public class ConsumerController {
        @Resource
        ProviderMicroService providerMicroService;
        @RequestMapping("consumer")
        public String consumer(String name){
            return providerMicroService.sayHello(name);
        }
    }
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17

    我们编写一个bootstrap.yml文件,用来启动时连接到nacos,只有name和port和provider不一样,其余的配置都是通过配置中心从nacos拉consumer-dev.yml来整合的。

    server:
      port: 9000
    
    spring:
      application:
        name: consumer
      profiles:
        active: dev
      cloud:
        nacos:
          discovery:
            server-addr: localhost:8848
          config:
            server-addr: localhost:8848
            file-extension: yml
            shared-configs:
              - application-${spring.profiles.active}.${spring.cloud.nacos.config.file-extension}
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17

    最后一步:测试

    此时我们打开consumer的Controller地址,给一个name参数,即可看到效果。这说明服务已经正常运行。
    在这里插入图片描述
    然后在nacos里可以看到服务的状态,说明微服务架构运行正常:
    在这里插入图片描述

  • 相关阅读:
    [附源码]计算机毕业设计JAVA个性化新闻推荐系统
    【ROS2原理16】SROS 2 访问控制策略
    什么是 GPT-4 Vision
    CCNA-DHCP(动态主机配置协议)
    day3 ARM
    详解傅立叶变换,看这一文足矣!
    ts1.基础类型
    [Power Query] 汇总表
    SQL必备基础知识
    jmeter遇到连接数据库的问题
  • 原文地址:https://blog.csdn.net/yry0304/article/details/133764011