Spring cloud Alibaba 分布式微服务，配置 nacos + gateway + feign + hystrix - 根目录97 - 博客园
Spring cloud Alibaba 分布式微服务，配置 nacos + gateway + feign + hystrix
这篇随笔本人2021/04/09 原创，应该目前看了这篇博客的人都能搭成功。
环境：IDEA ，JDK 1.8， Mysql 5.*
项目配置：nacos + gateway + feign + hystrix + mybatis plus
mybatis plus 我有在另一篇博文里写过，有兴趣的可以去看：https://www.cnblogs.com/anpieBlog/p/14607131.html
很多初学者被网上各种博文搞得头昏眼花，从第一步就开始创建项目，搞到最后也没搞出来。
第一步：搭建Spring cloud Alibaba 需要先装nacos服务。这里我使用的1.4.1
nacos服务下载地址：https://github.com/alibaba/nacos/releases/tag/1.4.1
下载完成后，不能直接双击startup.cmd运行，会报错，需要进入cmd命令，使用命令行启动
这个样子就算成功了。
第二步：创建父项目
ali-nacos的pom
<?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>
<!--<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.4.4</version>
<relativePath/> <!– lookup parent from repository –>
</parent>-->
<groupId>com.anear</groupId>
<artifactId>ali-nacos</artifactId>
<version>0.0.1-SNAPSHOT</version>
<packaging>pom</packaging>
<!--<modules>
<module>**</module>
<module>**</module>
<module>**</module> <!-- 配置子项目的地方，先注掉，后面一个个放开配置 -->
<module>**</module>
<module>**</module>
</modules>-->
<name>studycloud</name>
<description>Demo project for Spring Boot</description>
<properties>
<java.version>1.8</java.version>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<maven.compiler.source>1.8</maven.compiler.source>
<maven.compiler.target>1.8</maven.compiler.target>
<junit.version>4.12</junit.version>
<log4j.version>1.2.17</log4j.version>
<lombok.version>1.16.18</lombok.version>
<mysql.version>8.0.23</mysql.version>
<druid.version>1.1.16</druid.version>
<mybatis.spring.boot.version>1.3.0</mybatis.spring.boot.version>
</properties>
<dependencyManagement>
<dependencies>
<!--spring boot 2.2.2-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-dependencies</artifactId>
<version>2.2.2.RELEASE</version>
<type>pom</type>
<scope>import</scope>
</dependency>
<!--spring cloud Hoxton.SR1-->
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-dependencies</artifactId>
<version>Hoxton.SR1</version>
<type>pom</type>
<scope>import</scope>
</dependency>
<!--spring cloud alibaba 2.1.0.RELEASE-->
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-alibaba-dependencies</artifactId>
<version>2.1.0.RELEASE</version>
<type>pom</type>
<scope>import</scope>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>${mysql.version}</version>
</dependency>
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>druid</artifactId>
<version>${druid.version}</version>
</dependency>
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>${mybatis.spring.boot.version}</version>
</dependency>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>${junit.version}</version>
</dependency>
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>${log4j.version}</version>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>${lombok.version}</version>
<optional>true</optional>
</dependency>
</dependencies>
</dependencyManagement>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<configuration>
<fork>true</fork>
<addResources>true</addResources>
</configuration>
</plugin>
</plugins>
</build>
</project>
第三步：创建子项目
创建完之后，打开子项目user的pom 修改如下，指向父项目
同事父项目的pom里配置子项目
对父项目和子项目的pom文件分别右击对maven进行reload
这里的user项目就是一个服务，可以选择用它来处理业务也可以选择用它提供调用的接口。
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!--SpringCloud ailibaba sentinel-datasource-nacos 后续做持久化用到-->
<dependency>
<groupId>com.alibaba.csp</groupId>
<artifactId>sentinel-datasource-nacos</artifactId>
</dependency>
<!--SpringCloud ailibaba sentinel -->
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-sentinel</artifactId>
</dependency>
<!--openfeign-->
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>
<!-- 代码生成 -->
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-generator</artifactId>
<version>3.1.2</version>
</dependency>
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-boot-starter</artifactId>
<version>2.2.0</version>
</dependency>
<!-- freemarker 模板引擎-->
<dependency>
<groupId>org.freemarker</groupId>
<artifactId>freemarker</artifactId>
</dependency>
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-core</artifactId>
<version>3.0.7.1</version>
</dependency>
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-extension</artifactId>
<version>3.0.7.1</version>
</dependency>
继续对user的maven pom进行reload，jar就引进去了，下面开始自动生成，在这里我假设你已经建立好了mybatisplus文件夹，在其文件夹下创建一个类用来执行生成代码。将下面代码拷贝的类里，按照各自情况微调生成路径以及数据库连接信息。
package com.anear.aliuser.mybatisplus;
import com.baomidou.mybatisplus.annotation.DbType;
import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.core.exceptions.MybatisPlusException;
import com.baomidou.mybatisplus.core.toolkit.StringUtils;
import com.baomidou.mybatisplus.generator.AutoGenerator;
import com.baomidou.mybatisplus.generator.InjectionConfig;
import com.baomidou.mybatisplus.generator.config.*;
import com.baomidou.mybatisplus.generator.config.po.TableInfo;
import com.baomidou.mybatisplus.generator.config.rules.NamingStrategy;
import com.baomidou.mybatisplus.generator.engine.FreemarkerTemplateEngine;
import java.util.*;
//演示例子，执行 main 方法控制台输入模块表名回车自动生成对应项目目录中
public class MybatisPlusGenerator {
/**
* <p>
* 读取控制台内容
* </p>
*/
public static String scanner(String tip) {
Scanner scanner = new Scanner(System.in);
StringBuilder help = new StringBuilder();
help.append("请输入" + tip + "：");
System.out.println(help.toString());
if (scanner.hasNext()) {
String ipt = scanner.next();
if (StringUtils.isNotEmpty(ipt)) {
return ipt;
}
}
throw new MybatisPlusException("请输入正确的" + tip + "！");
}
public static void main(String[] args) {
AutoGenerator mpg = new AutoGenerator(); //整合配置 全局配置+数据源配置+策略配置+包名策略配置
// 选择 freemarker 引擎，默认 Velocity 需要在配置文件引入依赖
mpg.setTemplateEngine(new FreemarkerTemplateEngine());
// 1全局配置
GlobalConfig gc = new GlobalConfig();
gc.setAuthor("Anear");
gc.setOutputDir("C://Users//Anear//IdeaProjects//ali-nacos//ali-user//src//main//java");
gc.setFileOverride(false);// 是否覆盖同名文件，默认是false
gc.setIdType(IdType.AUTO);// 主键策略
gc.setActiveRecord(true);// 不需要ActiveRecord特性的请改为false
gc.setEnableCache(false);// XML 二级缓存
gc.setBaseResultMap(true);// XML ResultMap 生成基本的resultmap
gc.setBaseColumnList(false);// XML columList 生成基本的sql片段
/* 自定义文件命名，注意 %s 会自动填充表实体属性！ */
gc.setMapperName("%sMapper");
gc.setXmlName("%sMapper");
gc.setServiceName("%sService");
gc.setServiceImplName("%sServiceImpl");
gc.setControllerName("%sController");
mpg.setGlobalConfig(gc);
// 2数据源配置
DataSourceConfig dsc = new DataSourceConfig();
dsc.setDbType(DbType.MYSQL);
dsc.setDriverName("com.mysql.cj.jdbc.Driver");
dsc.setUsername("root");
dsc.setPassword("123456");
dsc.setUrl("jdbc:mysql://localhost:3306/anear?serverTimezone=Hongkong&useUnicode=true&characterEncoding=utf8");
mpg.setDataSource(dsc);
// 3策略配置globalConfiguration中
StrategyConfig strategy = new StrategyConfig();
strategy.setEntityLombokModel(true);//实体类以lombok注解氏生产
strategy.setRestControllerStyle(true);//controller以restFule风格
// strategy.setCapitalMode(true);// 全局大写命名 ORACLE 注意
strategy.setNaming(NamingStrategy.underline_to_camel);// 表名生成策略 此处可以更换为underline_to_camel 下滑线转驼峰
strategy.setInclude(new String[]{"user"}); // 需要生成的表
// strategy.setExclude(new String[]{"test"}); // 排除生成的表
// 自定义实体父类
// strategy.setSuperEntityClass("com.baomidou.demo.TestEntity");
// 自定义实体，公共字段
// strategy.setSuperEntityColumns(new String[] { "test_id", "age" });
// 自定义 mapper 父类
// strategy.setSuperMapperClass("com.baomidou.demo.TestMapper");
// 自定义 service 父类
// strategy.setSuperServiceClass("com.baomidou.demo.TestService");
// 自定义 service 实现类父类
// strategy.setSuperServiceImplClass("com.baomidou.demo.TestServiceImpl");
// 自定义 controller 父类
// strategy.setSuperControllerClass("com.baomidou.demo.TestController");
// 【实体】是否生成字段常量（默认 false）
// public static final String ID = "test_id";
// strategy.setEntityColumnConstant(true);
// 【实体】是否为构建者模型（默认 false）
// public User setName(String name) {this.name = name; return this;}
// strategy.setEntityBuilderModel(true);
mpg.setStrategy(strategy);
// 4包配置 修改包生成的名称
//pkConfig.setParent("com.imooc")
// .setMapper("dao")//dao
// .setService("service")//servcie
// .setController("controller")//controller
// .setEntity("entity")
// .setXml("resource");//mapper.xml
PackageConfig pc = new PackageConfig();
pc.setParent("com.springboot.study").setController("controller").setMapper("dao");
// pc.setModuleName("test");
pc.setParent("com.anear.aliuser.mybatisplus");
pc.setEntity("entity");
pc.setMapper("mapper");
pc.setController("controller");
mpg.setPackageInfo(pc);
// 注入自定义配置，可以在 VM 中使用 cfg.abc 【可无】
InjectionConfig cfg = new InjectionConfig() {
@Override
public void initMap() {
Map<String, Object> map = new HashMap<String, Object>();
map.put("abc", this.getConfig().getGlobalConfig().getAuthor() +
"-mp");
this.setMap(map);
}
};
// 自定义 xxList.jsp 生成
List<FileOutConfig> focList = new ArrayList<>();
/*focList.add(new FileOutConfig("/template/list.jsp.vm") {
@Override
public String outputFile(TableInfo tableInfo) {
// 自定义输入文件名称
return "D://workspace/study/springboot_mybatisplus_lombok/src/main/webapp/" + tableInfo.getEntityName() + ".jsp";
}
});
cfg.setFileOutConfigList(focList);
mpg.setCfg(cfg);*/
// 调整 xml 生成目录演示
// 如果模板引擎是 freemarker
String templatePath = "/templates/mapper.xml.ftl";
// 如果模板引擎是 velocity
// String templatePath = "/templates/mapper.xml.vm";
focList.add(new FileOutConfig(templatePath) {
@Override
public String outputFile(TableInfo tableInfo) {
return "C://Users//Anear//IdeaProjects//ali-nacos//ali-user//src/main/resources/mybatis/" + tableInfo.getEntityName()+"Mapper" + ".xml";
}
});
cfg.setFileOutConfigList(focList);
mpg.setCfg(cfg);
// 关闭默认 xml 生成，调整生成 至 根目录
TemplateConfig tc = new TemplateConfig();
tc.setXml(null);
mpg.setTemplate(tc);
// 自定义模板配置，可以 copy 源码 mybatis-plus/src/main/resources/templates 下面内容修改，
// 放置自己项目的 src/main/resources/templates 目录下, 默认名称一下可以不配置，也可以自定义模板名称
// TemplateConfig tc = new TemplateConfig();
// tc.setController("...");
// tc.setEntity("...");
// tc.setMapper("...");
// tc.setXml("...");
// tc.setService("...");
// tc.setServiceImpl("...");
// 如上任何一个模块如果设置 空 OR Null 将不生成该模块。
// mpg.setTemplate(tc);
// 执行生成
mpg.execute();
// 打印注入设置【可无】
// System.err.println(mpg.getCfg().getMap().get("abc"));
}
}
修改完后右键执行，你会看到.xml到controller它都自动帮你生成了，文件夹也帮你生成了
为了使用它提供的CRUD，需要修改entity类与数据库表名和字段对应。
随便在controller里写个接口，获取数据。
启动类里配置这五个注解，有开启Feign，设置mapper映射，开始注册与发现等，设置mapper映射时，建议自己先点出来mapper路径，再加引号，防止路径出错。
在配置文件里配置数据库连接，开始启动子项目ali-user
server.port=6001 spring.datasource.url=jdbc:mysql://localhost:3306/anear?useUnicode=true&characterEncoding=utf-8 spring.datasource.driverClassName=com.mysql.jdbc.Driver spring.datasource.username=root spring.datasource.password=123456
#mybatis-plus # 如果是放在src/main/java目录下 classpath:/com/yourpackage/*/mapper/*Mapper.xml # 如果是放在resource目录 classpath:/mapper/*Mapper.xml #mybatis-plus.mapper-locations=classpath:mybatis/*.xml #实体扫描，多个package用逗号或者分号分隔 mybatis-plus.type-aliases-package=com.anear.aliuser.mybatisplus.entity
还记得你刚启动的nacos服务吗，它会给你个提示，访问http://127.0.0.1:8848/ ，默认用户名和密码都是nacos，登陆进去配置列表是空的，请忽略我原先的配置
新建一个配置
可以看到我们添加了一个配置，回到我们的子项目ali-user，添加配置文件，配置对应内容，设置注册到我们本机的nacos，重新启动服务，会发现服务已经注册到nacos上了。
mybatis: mapper-locations: classpath:mybatis/*.xml #补上xml映射
用刚才创建子项目的步骤继续创建一个子项目，名叫ali-order，一样使用mybatis plus进行自动生成
像下面这张图，建个一样的项目，在controller 里面 return “haha”;
不要忘记在nacos服务上建个配置，再启动项目
我本地已经起了两个子服务，测试一下吧
到目前我们发现每个服务都可以用，并且这两个服务都注册到了nacos，分布式特点在于根据请求转发选择对应实例服务进行处理，来完成处理并发等等的能力，这里的网关采用gate way。
创建一个新的子项目，里面是空的，pom我会贴上，什么依赖都不要。单词拼错，懒得改了。
pom依赖：
<?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>
<parent>
<groupId>com.anear</groupId>
<artifactId>ali-nacos</artifactId>
<version>0.0.1-SNAPSHOT</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>
<groupId>com.anear</groupId>
<artifactId>ali-gateway</artifactId>
<version>0.0.1-SNAPSHOT</version>
<name>gateway</name>
<description>Demo project for Spring Boot</description>
<properties>
<java.version>1.8</java.version>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-gateway</artifactId>
</dependency>
<!--SpringCloud ailibaba nacos -->
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>
另外不要忘记配置ali-gateway
还要配置各服务的网关：新建application.yml，将下面代码贴进去。
spring:
application:
name: ali-gateway
cloud:
nacos:
discovery:
server-addr: http://127.0.0.1:8848/
gateway:
discovery:
locator:
enabled: true
routes:
- id: ali-user
uri: http://localhost:6001
predicates:
- Path=/user/**
- id: ali-order
uri: http://localhost:6002
predicates:
- Path=/order/**
下面这是我启动的三个服务，user>6001,order>6002,gateway>6003,测试转发是否可以
我们用相同的6003接口，user 和 order 接口都能请求到，这说明我们的两个服务成功被gateway代理了。
转发代理可以，负载均衡和熔断器在分布式里是必不可少的，下面配置熔断器和服务调用feign。
由于我们再user和order里都在启动类里添加了开启feign注解，所以接下来将非常简单就是先。
太累了，我不适合写这么长的博客，我直接贴代码吧。
调用方新建feign文件夹，专门用来调用其他服务的接口，再配一个实现类包。fallback是发生熔断去的地方
熔断发生处理类
修改controller，调用ali-user的接口
测试：
我们通过6003 gateway网关服务请求ali-order服务，ali-order服务调用了ali-user服务，所以返回了user里面的xixi。
结束，下班。
对了，开启熔断的开关在配置文件里打开，
# open hystrix feign.hystrix.enabled=true
你可以关掉被调用的服务，再次请求，程序请求超市会根据熔断机制返回你配置的熔断处理。is Feign error.
这里面涉及很多原理，有时间且不明白的朋友有必要去了解了解，这篇博客只教你如何搭建。