如果需要学习更多SpringCloud Alibaba的集成使用
这个项目可以帮助你快速的启动一个基于SpringCloud Alibaba技术栈的微服务框架搭建
基于SpringCloud Gateway的网关系统，包括：认证、鉴权、路由、负载均衡、流控等
基于AntDesignPro的登录，包括用户名密码登录、短信验证码登录，实现了图形验证码防刷功能
Nacos负责服务注册、配置管理
Sentinel负责流量控制、熔断降级、系统负载等多个维度保护服务的稳定性
Seata负责分布式事务管理
前端使用了AntDesignPro框架，参考这个项目，你可以快速的开启集成开发
基于 SpringBoot3 项目更容易集成到多个平台（K8S、Istio）
演示了如何通过starter扩展功能(Doc、Route)
演示了如何统一控制接口规范
演示了如何规范异常处理
演示了如何规范使用Mybaits、Mybatis-Plus、分页
演示了单元测试、mock测试、测试数据回滚，包括对controller、service的测试
项目分包明确，规范微服务的开发模式，使包与包之间的分工清晰
链路追踪
ES日志管理
请参考：SpringCloud Alibaba Micro Service System
本文为了简单易学，只演示如下功能：
- 使用
Nacos进行配置管理 - 使用
Nacos进行服务注册
本文源码
https://gitee.com/bestaone/study/tree/master/springboot3-nacos
环境依赖
- JDK 17+
- Nacos 2.2.0+
- SpringBoot 3
- SpringCloud 2022.0.0
- SpringCloud Alibaba 2022.0.0.0-RC1
安装 Nacos
安装包安装运行
# 下载安装包
>wget https://github.com/alibaba/nacos/releases/download/2.2.0/nacos-server-2.2.0.tar.gz
# 解压
>tar -zxvf nacos-server-2.2.0.tar.gz -C /usr/local/
# 配置文件在 conf/application.properties
>cd /usr/local/nacos
# 启动
>./bin/startup.sh -m standalone
Docker安装运行
>docker run -d \
-e MODE=standalone \
-e JVM_XMS=256m -e JVM_XMX=256m \
-e PREFER_HOST_MODE=hostname \
-p 8848:8848 -p 9848:9848 -p 9849:9849 \
--privileged=true \
--restart=always \
--name nacos-2.2.0 \
nacos/nacos-server:v2.2.0
Docker+MySQL安装运行
- 在
MySQL数据库中创建nacos库，并执行如下脚本
springboot3-nacos/nacos-2.0.0-mysql-schema.sql
- 执行启动脚本
>docker run -d \
-e MODE=standalone \
-e JVM_XMS=256m -e JVM_XMX=256m \
-e PREFER_HOST_MODE=hostname \
-e SPRING_DATASOURCE_PLATFORM=mysql \
-e MYSQL_SERVICE_HOST=127.0.0.1 \
-e MYSQL_SERVICE_PORT=3306 \
-e MYSQL_SERVICE_USER=root \
-e MYSQL_SERVICE_PASSWORD=123456 \
-e MYSQL_SERVICE_DB_NAME=nacos \
-p 8848:8848 -p 9848:9848 -p 9849:9849 \
--privileged=true \
--restart=always \
--name nacos-2.2.0 \
nacos/nacos-server:v2.2.0
验证
-
Nacos控制台：http://127.0.0.1:8848/nacos 账密：nacos/nacos
项目代码
创建一个基础的SpringBoot项目
- pom.xm
<?xml version="1.0" encoding="UTF-8"?>
<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.0</modelVersion>
<groupId>com.bestaone.study</groupId>
<artifactId>springboot3-nacos</artifactId>
<version>0.0.1-SNAPSHOT</version>
<name>springboot3-demo</name>
<description>demo</description>
<properties>
<maven.compiler.source>17</maven.compiler.source>
<maven.compiler.target>17</maven.compiler.target>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<spring-boot.build-image.imageName>springboot3demo</spring-boot.build-image.imageName>
</properties>
<dependencyManagement>
<dependencies>
<!-- SpringCloud -->
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-dependencies</artifactId>
<version>2022.0.0</version>
<type>pom</type>
<scope>import</scope>
</dependency>
<!-- SpringBoot -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-dependencies</artifactId>
<version>3.0.0</version>
<type>pom</type>
<scope>import</scope>
</dependency>
<!-- SpringCloudAlibaba -->
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-alibaba-dependencies</artifactId>
<version>2022.0.0.0-RC1</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<dependencies>
<!-- 使用bootstrap.yml必须依赖此类 -->
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-bootstrap</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.graalvm.buildtools</groupId>
<artifactId>native-maven-plugin</artifactId>
</plugin>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>
- 启动类
Starter
@SpringBootApplication
public class Starter {
public static void main(String[] args) {
SpringApplication.run(Starter.class, args);
}
}
HomeController
@RestController
public class HomeController {
@Value(value = "${test.name:LiSi}")
private String name;
@RequestMapping("/")
String home() {
return "Hello " + name;
}
}
- 配置文件
bootstrap.yml
spring.application.name: springboot3-nacos
test.name: WangWu
启动项目验证
>curl --location --request GET 'http://127.0.0.1:8080'
Hello WangWu
添加集成Nacos所需的依赖
<!--注册中心客户端-->
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>
<!--配置中心客户端-->
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
</dependency>
调整代码，只需在启动类上添加注解@EnableDiscoveryClient
@EnableDiscoveryClient
@SpringBootApplication
public class Starter {
public static void main(String[] args) {
SpringApplication.run(Starter.class, args);
}
}
调整配置文件bootstrap.yml
spring.application.name: springboot3-nacos
test.name: WangWu
spring.cloud.nacos.config:
# 换成自己nacos服务器地址
server-addr: nacos-server:8848
file-extension: yml
shared-configs:
- application-common.yml
- application-redis.yml
namespace: sams
spring.cloud.nacos.discovery:
server-addr: nacos-server:8848
namespace: sams
添加Nacos配置
- 在
Nacos的namespace中添加sams - 在
namespacesams下创建配置文件application-common.yml，并添加配置
test.name: ZhangSan
测试验证
- 测试接口
>curl --location --request GET 'http://127.0.0.1:8080'
Hello ZhangSan
# 此配置已经能够从Nacos中获取了
- 查看
Nacos服务列表
Nacos服务列表
