01-微服务1-3章的笔记

媒介

这是尚硅谷2024Cloud教程的笔记，只是记录学习历程，方便自己以后查询。周阳老师讲的很好，给出原视频地址
对应1.Boot和Cloud选项，2.Cloud组件的停更，升级，更换，3.Base工程构建。
1.Boot和Cloud选项

1.JDK

SpringBoot3.0开始，对于JDK的最低版本是JDK17，逼迫要求，从JDK8.x 到JDK17的变化。又因OracleJDK的协议，推荐使用OpenJDK。OpenJDK官网下载。在语法层面和OracleJDK没有区别，只是Oracle在OpenJDK上，加了一些额外的商业特性。一样平常使用，OpenJDK可以了。
2.Maven

Spring官网，对于SpringBoot3.0+的maven版本要求是3.6.3+。注意该组件的版本，会影响idea的版本，因为较高的Maven,在idea2021某个版本之前的版本无法使用，亲身踩坑/(ㄒoㄒ)/~~。可以使用3.6.3，对各个版本的boot和idea兼容新都不错。推荐，使用Maven3.6.3，但是为和老师，保持同等，故使用3.9.5。
3.MySQL

MySQL8.x版本，推出于2018年，距今已有较长时间。在稳定性，社区活跃度等方面都不错，以及免费的特性，实际项目开辟中有较多使用。
备注：Spring官网，查看框架底子的依赖组件的版本要求

选择一个版本的Boot，查看Reference Doc，其中的Getting Started中的System Requirements有本版本下，对于jdk，maven，tomcat最低的版本要求。
因为，要选择差别的jdk，差别的maven，所以需要这些信息。乃至，高版本的maven还需要和更高版本的idea适配。
4.技能选项问题

如果是新项目，直接上微服务，是Cloud版本决定，Boot版本。旧项目改造，是Boot版本决定Cloud版本，因为整体项目从boot2.7.x，升级到3.x的代价还是比较高的。在Spring官网，中有Cloud和与Boot的版本依赖关系。官网地址
5.本次课程先容

5.1 上篇

SpringCloud
5.2 下篇

SpringCloud Alibaba
5.3 说明

SpringCloud和SpringCloud Alibaba相互独立，都是微服务头脑的具体实现的产物，雷同点就是Spring官方，将Alibaba纳入到了其维护的项目中，不外alibaba也在维护，且alibaba版本会更快。因为毕竟是自己的产物，之后才会同步到Spring社区。
6.SpringBoot版本选择

6.1 GitHub地址

https://github.com/spring-projects/spring-boot/releases
6.2 官网看Boot版本

6.3 SpringBoot3.0的崛起

Spring Boot 3.0 requires Java 17 as a minimum version. SpringBoot3.0对于JDK的最低版本要求是JDK17。
7.SpringCloud版本选择

7.1 github地址

https://github.com/spring-cloud
7.2 官网看Cloud版本

7.2.1 Cloud定名规则

SpringCloud的版本关系
Spring Cloud 接纳了英国伦敦地铁站的名称来定名，并由地铁站名称字母A-Z依次类推的形式来发布迭代版本
SpringCloud是一个由许多子项目组成的综合项目，各子项目有差别的发布节奏。为了管理SpringCloud与各子项目的版本依赖关系，发布了一个清单，其中包括了某个SpringCloud版本对应的子项目版本。为了避免SpringCloud版本号与子项目版本号肴杂，SpringCloud版本接纳了名称而非版本号的定名，这些版本的名字接纳了伦敦地铁站的名字，根据字母表的顺序来对应版本时间顺序。例如Angel是第一个版本, Brixton是第二个版本。
当SpringCloud的发布内容积聚到临界点或者一个庞大BUG被解决后，会发布一个"service releases"版本，简称SRX版本，好比Greenwich.SR2就是SpringCloud发布的Greenwich版本的第2个SRX版本。
但是从2020年开始，以2020.0.x的方式定名版本，解决了，令人无法明白的版本定名。

7.2.2 官网地址

https://spring.io/projects/spring-cloud
8.SpringCloud Alibaba版本选择

8.1 SpringCloud官网

https://spring.io/projects/spring-cloud-alibaba
注意，此方式无法看到最新版。有延后。

8.2 Spring Cloud Alibaba官网GitHub说明

和老师保持同等，选择2020.x。
8.3 SpringCloudAlibaba版本

https://github.com/alibaba/spring-cloud-alibaba/releases
本次视频定稿

框架间的版本适配，请严格依照官网，或者GitHub。
SpringCloud和SpringBoot和SpringCloud Alibaba三者，制约关系。是Cloud版本决定，Boot版本。
下图是SpringCloudAlibaba - SpringCloud - SpringBoot的版本关系。

结论

底子组件版本JDKJava17+Maven3.9+MySQL8.0+Spring Cloud2023.0.0Spring Boot3.2.0Spring Cloud Alibaba2022.0.0.0-RC22.Cloud组件的听更，升级，更换

1.微服务理论知识入门

1.1 形象一点来说

微服务架构就像搭积木，每个微服务都是一个零件一个积木，并使用这些积木零件组装出差别的外形，出来最后一个完备的物体。
1.2 通俗来说

微服务架构就是把一个大系统按业务功能分解成多个职责单一的小系统，每一个小模块尽量埋头的只做一件事，并利用简朴的方法使多个小系统相互协作，组成一个大系统再统一对外提供整体服务。
1.3 学科派一点

专注一单一责任小型功能模块为底子，并利用轻量化机制（通常为HTTP RESTFUL API）实现通信完成复杂业务搭建的一种架构头脑。
2.Spring Cloud是什么？

方便程序员专注于业务逻辑的，由分布式头脑落地的框架和一些中间件“有机联合”的产物。

3.本次解说的内容-粗略版

4.本次解说的内容-详推版

4.1 2018第一季

4.2 Netflix OSS被移除的原因

Netflix OSS(Open Source System)，是Netflix公司开辟的一套代码框架和库，SpringCloud Netflix是在Netflix OSS底子之上的封装。
更新版本没有什么大惊小怪的，但是本次更新却正式开启了Spring Cloud Netflix体系的终结历程。Netflix公司是目前微服务落地中最乐成的公司。它开源了诸如Eureka、Hystrix、Zuul、Feign、Ribbon等等广大开辟者所知微服务套件，统称为Netflix OSS。在当时 Netflix OSS成为微服务组件上究竟的尺度。但是微服务鼓起不久，也就是在2018年前后Netflix公司公布其核心组件Eureka、Hystrix、Zuul、Feign、Ribbon等进入维护状态，不再进行新特性开辟，只修BUG。
这直接影响了Spring Cloud项目的发展路线,Spring官方不得不采取了应对措施,在2019年的在SpringOne2019大会中，Spring Cloud公布 Spring Cloud Netflix项目进入维护模式,并在2020年移除相关的Netflix OSS组件。
4.2.1 Netflix那些被移除了？

2019年进入Maintenance Mode。
维护模式，就是被动的修复bugs，不再接收合并请求，不再发布新版本。换句话说就是，除非出现特别严峻的bug，否则没人管了。
4.2.2 由停更引发的“升级惨案”

红叉：不能再使用了；感叹号：能用但是不推荐；对号：推荐使用。

备注，remove的组件都不能使用。
3.Base工程构建

1.订单->支付，业务需求说明

2.约定>设置>编码

约定，业内基本达成共识的一些想法，好比在Web开辟中，Post请求，往往用来添加数据，Get请求，用来获取数据，Delete请求，用来删除数据等。
设置，是提前确定好，使用的组件的版本信息，因为版本辩论的问题，导致的设置，是让人特别厌恶和反感的。这也是一般微服务项目，都会有一个公共的父模块，在这个父模块的pom文件中，定义好使用的各种框架，组建的版本。各个子模块，在自己的pom文件中，使用定义好的版本的依赖。
编码，就是写代码。
3.IDEA新建Project和Maven父工程

3.1 微服务cloud整体聚合Maven父工程

3.1.1 New Project

略，注意，创建父工程时，不要使用Spring的初始化工具，创建Maven项目。
3.1.2 定义父工程名字

1. <groupId>com.atguigu.cloud</groupId>
2. <artifactId>cloud</artifactId>
3. <version>1.0-SNAPSHOT</version>

复制代码

3.1.3 定义字符编码

File -> Settings ->  Editor -> File Encodings
设置Global Encoding，Project Encoding，Default encoding for properties files 都为UTF-8，以及勾选Transparent native-to-ascii conversion。
3.1.4 注解生效激活

File -> Settings ->  Build,Execution,Deployment -> Complier -> Annotation Processors
Enable annotation processing勾选。
3.1.5 Java编译版本选17

File -> Settings ->  Build,Execution,Deployment -> Complier -> Java Complie
Target bytecode version选择17
3.1.6 File Type过滤

File -> Settings ->  Editor -> File Types
Ignored FIles and Folders
添加*.idea文件
小结

以上设置，都可以设置在新创建项目中，也就是说新建的项目，会主动使用，设置好的。
File -> New Project Setup -> Settings for New Projects
3.2 父工程POM文件内容

这也是父工程存在的意义，提前定义好，本系统中，可能会使用的依赖的版本，防止，因版本辩论问题出现bug。注意，这里实际不引入jar包，只是定义版本。

1. <?xml version="1.0" encoding="UTF-8"?>
2. <project xmlns="http://maven.apache.org/POM/4.0.0"
3.          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
4.          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
5.     <modelVersion>4.0.0</modelVersion>
7.     <groupId>com.atguigu.cloud</groupId>
8.     <artifactId>mscloudV5</artifactId>
9.     <version>1.0-SNAPSHOT</version>
10.     <packaging>pom</packaging>
12.     <properties>
13.         <maven.compiler.source>17</maven.compiler.source>
14.         <maven.compiler.target>17</maven.compiler.target>
15.         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
16.         <hutool.version>5.8.22</hutool.version>
17.         <lombok.version>1.18.26</lombok.version>
18.         <druid.version>1.1.20</druid.version>
19.         <mybatis.springboot.version>3.0.2</mybatis.springboot.version>
20.         <mysql.version>8.0.11</mysql.version>
21.         <swagger3.version>2.2.0</swagger3.version>
22.         <mapper.version>4.2.3</mapper.version>
23.         <fastjson2.version>2.0.40</fastjson2.version>
24.         <persistence-api.version>1.0.2</persistence-api.version>
25.         <spring.boot.test.version>3.1.5</spring.boot.test.version>
26.         <spring.boot.version>3.2.0</spring.boot.version>
27.         <spring.cloud.version>2023.0.0</spring.cloud.version>
28.         <spring.cloud.alibaba.version>2022.0.0.0-RC2</spring.cloud.alibaba.version>
29.     </properties>
31.     <dependencyManagement>
32.         <dependencies>
33.             
34.             <dependency>
35.                 <groupId>org.springframework.boot</groupId>
36.                 <artifactId>spring-boot-starter-parent</artifactId>
37.                 <version>${spring.boot.version}</version>
38.                 <type>pom</type>
39.                 <scope>import</scope>
40.             </dependency>
41.             
42.             <dependency>
43.                 <groupId>org.springframework.cloud</groupId>
44.                 <artifactId>spring-cloud-dependencies</artifactId>
45.                 <version>${spring.cloud.version}</version>
46.                 <type>pom</type>
47.                 <scope>import</scope>
48.             </dependency>
49.             
50.             <dependency>
51.                 <groupId>com.alibaba.cloud</groupId>
52.                 <artifactId>spring-cloud-alibaba-dependencies</artifactId>
53.                 <version>${spring.cloud.alibaba.version}</version>
54.                 <type>pom</type>
55.                 <scope>import</scope>
56.             </dependency>
57.             
58.             <dependency>
59.                 <groupId>org.mybatis.spring.boot</groupId>
60.                 <artifactId>mybatis-spring-boot-starter</artifactId>
61.                 <version>${mybatis.springboot.version}</version>
62.             </dependency>
63.             
64.             <dependency>
65.                 <groupId>mysql</groupId>
66.                 <artifactId>mysql-connector-java</artifactId>
67.                 <version>${mysql.version}</version>
68.             </dependency>
69.             
70.             <dependency>
71.                 <groupId>com.alibaba</groupId>
72.                 <artifactId>druid-spring-boot-starter</artifactId>
73.                 <version>${druid.version}</version>
74.             </dependency>
75.             
76.             <dependency>
77.                 <groupId>tk.mybatis</groupId>
78.                 <artifactId>mapper</artifactId>
79.                 <version>${mapper.version}</version>
80.             </dependency>
81.             
82.             <dependency>
83.                 <groupId>javax.persistence</groupId>
84.                 <artifactId>persistence-api</artifactId>
85.                 <version>${persistence-api.version}</version>
86.             </dependency>
87.             
88.             <dependency>
89.                 <groupId>com.alibaba.fastjson2</groupId>
90.                 <artifactId>fastjson2</artifactId>
91.                 <version>${fastjson2.version}</version>
92.             </dependency>
93.             
94.             <dependency>
95.                 <groupId>org.springdoc</groupId>
96.                 <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
97.                 <version>${swagger3.version}</version>
98.             </dependency>
99.             
100.             <dependency>
101.                 <groupId>cn.hutool</groupId>
102.                 <artifactId>hutool-all</artifactId>
103.                 <version>${hutool.version}</version>
104.             </dependency>
105.             
106.             <dependency>
107.                 <groupId>org.projectlombok</groupId>
108.                 <artifactId>lombok</artifactId>
109.                 <version>${lombok.version}</version>
110.                 <optional>true</optional>
111.             </dependency>
112.             
113.             <dependency>
114.                 <groupId>org.springframework.boot</groupId>
115.                 <artifactId>spring-boot-starter-test</artifactId>
116.                 <version>${spring.boot.test.version}</version>
117.                 <scope>test</scope>
118.             </dependency>
119.         </dependencies>
120.     </dependencyManagement>
121. </project>

复制代码

3.3.Maven工程细节复习

Maven中的dependencyManagement和dependencies。
Maven 使用dependencyManagement元素来提供了一种管理依赖版本号的方式。
通常会在一个组织或者项目的最顶层的父POM 中看到dependencyManagement元素。
使用pom.xml 中的dependencyManagement元素能让所有在子项目中引用一个依赖而不用显式的列出版本号。Maven会沿着父子层次向上走，直到找到一个拥有dependencyManagement元素的项目，然后它就会使用这个dependencyManagemen元素中指定的版本号。
如许做的利益就是：如果有多个子项目都引用同一样依赖，则可以避免在每个使用的子项目里都声明一个版本号，优势：

• 1.如许当想升级或切换到另一个版本时，只需要在顶层父容器里更新，而不需要一个一个子项目的修改 ；
  
• 2.别的如果某个子项目需要别的的一个版本，只需要声明version就可。
  

dependencyManagement里只是声明依，并不实现引入，因此子项目需要显示的声明需要用的依赖。
如果不在子项目中声明依赖，是不会从父项目中继承下来的，只有在子项目中写了该依赖项并且没有指定具体版本，才会从父项目中继承该项     且version和scope都读取自父pom;
如果子项目中指定了版本号，那么会使用子项目中指定的jar版本。
Maven中跳过单元测试
1.设置

1. <build>
2.     <plugins>
3.         <plugin>
4.             <groupId>org.apache.maven.plugins</groupId>
5.             <artifactId>maven-surefire-plugin</artifactId>
6.             <configuration>
7.                 <skip>true</skip>
8.             </configuration>
9.         </plugin>
10.     </plugins>
11. </build>

复制代码

2.IDEA工具支持(推荐)

3.4 MySQL驱动说明

3.4.1 MySQL 5.7

1. # mysql5.7---JDBC四件套
2. jdbc.driverClass = com.mysql.jdbc.Driver
3. jdbc.url= jdbc:mysql://localhost:3306/db2024?useUnicode=true&characterEncoding=UTF-8&useSSL=false
4. jdbc.user = root
5. jdbc.password =123456

复制代码

1. # Maven的POM文件处理
2. <dependency>
3.     <groupId>mysql</groupId>
4.     <artifactId>mysql-connector-java</artifactId>
5.     <version>5.1.47</version>
6. </dependency>

复制代码

3.4.2 MySQL 8.0

推荐使用MySQL8.0

1. # mysql8.0---JDBC四件套
2. jdbc.driverClass = com.mysql.cj.jdbc.Driver
3. jdbc.url= jdbc:mysql://localhost:3306/db2024?characterEncoding=utf8&useSSL=false&serverTimezone=GMT%2B8&rewriteBatchedStatements=true&allowPublicKeyRetrieval=true
4. jdbc.user = root
5. jdbc.password =123456

复制代码

1. # Maven的POM
2. <dependency>
3.     <groupId>mysql</groupId>
4.     <artifactId>mysql-connector-java</artifactId>
5.     <version>8.0.11</version>
6. </dependency>

复制代码

4.Mapper4之一键生成

4.1 mybatis-generator

http://mybatis.org/generator
一款生成mapper的插件。
4.2 MyBatis通用Mapper4官网

https://github.com/abel533/Mapper
4.3 Mapper5官网

https://github.com/mybatis-generator/mapper
4.4 一键生成步骤

4.4.1 建表SQL

1. #注意，只提供了建表sql，要自己建立数据库。演示sql，无实际意义。
2. DROP TABLE IF EXISTS `t_pay`;
4. CREATE TABLE `t_pay` (
5.   `id` INT(10) UNSIGNED NOT NULL AUTO_INCREMENT,
6.   `pay_no` VARCHAR(50) NOT NULL COMMENT '支付流水号',
7.   `order_no` VARCHAR(50) NOT NULL COMMENT '订单流水号',
8.   `user_id` INT(10) DEFAULT '1' COMMENT '用户账号ID',
9.   `amount` DECIMAL(8,2) NOT NULL DEFAULT '9.9' COMMENT '交易金额',
10.   `deleted` TINYINT(4) UNSIGNED NOT NULL DEFAULT '0' COMMENT '删除标志，默认0不删除，1删除',
11.   `create_time` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
12.   `update_time` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
13.   PRIMARY KEY (`id`)
14. ) ENGINE=INNODB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8mb4 COMMENT='支付交易表';
16. INSERT INTO t_pay(pay_no,order_no) VALUES('pay17203699','6544bafb424a');
18. SELECT * FROM t_pay;

复制代码

4.4.2 创建generator模块

略
4.4.3 POM

1. <?xml version="1.0" encoding="UTF-8"?>
2. <project xmlns="http://maven.apache.org/POM/4.0.0"
3.          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
4.          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
5.     <modelVersion>4.0.0</modelVersion>
7.     <parent>
8.         <groupId>com.atguigu.cloud</groupId>
9.         <artifactId>mscloudV5</artifactId>
10.         <version>1.0-SNAPSHOT</version>
11.     </parent>
13.    
14.     <artifactId>mybatis_generator2024</artifactId>
16.     <properties>
17.         <maven.compiler.source>17</maven.compiler.source>
18.         <maven.compiler.target>17</maven.compiler.target>
19.         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
20.     </properties>
22.     <dependencies>
23.         
24.         <dependency>
25.             <groupId>org.mybatis</groupId>
26.             <artifactId>mybatis</artifactId>
27.             <version>3.5.13</version>
28.         </dependency>
29.         
30.         <dependency>
31.             <groupId>org.mybatis.generator</groupId>
32.             <artifactId>mybatis-generator-core</artifactId>
33.             <version>1.4.2</version>
34.         </dependency>
35.         
36.         <dependency>
37.             <groupId>tk.mybatis</groupId>
38.             <artifactId>mapper</artifactId>
39.         </dependency>
40.         
41.         <dependency>
42.             <groupId>mysql</groupId>
43.             <artifactId>mysql-connector-java</artifactId>
44.         </dependency>
45.         
46.         <dependency>
47.             <groupId>javax.persistence</groupId>
48.             <artifactId>persistence-api</artifactId>
49.         </dependency>
50.         
51.         <dependency>
52.             <groupId>cn.hutool</groupId>
53.             <artifactId>hutool-all</artifactId>
54.         </dependency>
55.         
56.         <dependency>
57.             <groupId>org.projectlombok</groupId>
58.             <artifactId>lombok</artifactId>
59.             <optional>true</optional>
60.         </dependency>
61.         <dependency>
62.             <groupId>org.springframework.boot</groupId>
63.             <artifactId>spring-boot-starter-test</artifactId>
64.             <scope>test</scope>
65.             <exclusions>
66.                 <exclusion>
67.                     <groupId>org.junit.vintage</groupId>
68.                     <artifactId>junit-vintage-engine</artifactId>
69.                 </exclusion>
70.             </exclusions>
71.         </dependency>
72.     </dependencies>
74.     <build>
75.         <resources>
76.             <resource>
77.                 <directory>${basedir}/src/main/java</directory>
78.                 <includes>
79.                     <include>**/*.xml</include>
80.                 </includes>
81.             </resource>
82.             <resource>
83.                 <directory>${basedir}/src/main/resources</directory>
84.             </resource>
85.         </resources>
86.         <plugins>
87.             
88.             <plugin>
89.                 <>
90.                 <groupId>org.springframework.boot</groupId>
91.                 <artifactId>spring-boot-maven-plugin</artifactId>
92.                 <configuration>
93.                     <excludes>
94.                         <exclude>
95.                             <groupId>org.projectlombok</groupId>
96.                             <artifactId>lombok</artifactId>
97.                         </exclude>
98.                     </excludes>
99.                 </configuration>
100.             </plugin>
101.             <plugin>
102.                 <groupId>org.mybatis.generator</groupId>
103.                 <artifactId>mybatis-generator-maven-plugin</artifactId>
104.                 <version>1.4.2</version>
105.                 <configuration>
106.                     <configurationFile>${basedir}/src/main/resources/generatorConfig.xml</configurationFile>
107.                     <overwrite>true</overwrite>
108.                     <verbose>true</verbose>
109.                 </configuration>
110.                 <dependencies>
111.                     <dependency>
112.                         <groupId>mysql</groupId>
113.                         <artifactId>mysql-connector-java</artifactId>
114.                         <version>8.0.33</version>
115.                     </dependency>
116.                     <dependency>
117.                         <groupId>tk.mybatis</groupId>
118.                         <artifactId>mapper</artifactId>
119.                         <version>4.2.3</version>
120.                     </dependency>
121.                 </dependencies>
122.             </plugin>
123.         </plugins>
124.     </build>
126. </project>

复制代码

4.4.4 设置

resource文件夹下
config.properties

1. #User表包名
2. package.name=com.atguigu.cloud
3. # mysql5.7
4. jdbc.driverClass = com.mysql.jdbc.Driver
5. jdbc.url= jdbc:mysql://localhost:3306/db2024?useUnicode=true&characterEncoding=UTF-8&useSSL=false
6. jdbc.user = root
7. jdbc.password =123456
8. #或
9. #t_pay表包名
10. package.name=com.atguigu.cloud
11. # mysql8.0
12. jdbc.driverClass = com.mysql.cj.jdbc.Driver
13. jdbc.url= jdbc:mysql://localhost:3306/db2024?characterEncoding=utf8&useSSL=false&serverTimezone=GMT%2B8&rewriteBatchedStatements=true&allowPublicKeyRetrieval=true
14. jdbc.user = root
15. jdbc.password =123456

复制代码

generatorConfig.xml

1. <?xml version="1.0" encoding="UTF-8"?>
2. <!DOCTYPE generatorConfiguration
3.         PUBLIC "-//mybatis.org//DTD MyBatis Generator Configuration 1.0//EN"
4.         "http://mybatis.org/dtd/mybatis-generator-config_1_0.dtd">
6. <generatorConfiguration>
7.     <properties resource="config.properties"/>
8.     <context id="Mysql" targetRuntime="MyBatis3Simple" defaultModelType="flat">
9.         <property name="beginningDelimiter" value="`"/>
10.         <property name="endingDelimiter" value="`"/>
11.         <plugin type="tk.mybatis.mapper.generator.MapperPlugin">
12.             <property name="mappers" value="tk.mybatis.mapper.common.Mapper"/>
13.             <property name="caseSensitive" value="true"/>
14.         </plugin>
15.         <jdbcConnection driver
16.                         connectionURL="${jdbc.url}"
17.                         userId="${jdbc.user}"
18.                         password="${jdbc.password}">
19.         </jdbcConnection>
20.         <javaModelGenerator targetPackage="${package.name}.entities" targetProject="src/main/java"/>
21.         <sqlMapGenerator targetPackage="${package.name}.mapper" targetProject="src/main/java"/>
22.         <javaClientGenerator targetPackage="${package.name}.mapper" targetProject="src/main/java" type="XMLMAPPER"/>
23.         <table tableName="t_pay" domainObjectName="Pay">
24.             <generatedKey column="id" sqlStatement="JDBC"/>
25.         </table>
26.     </context>
27. </generatorConfiguration>

复制代码

4.4.5 点击插件运行既可

5.通用Base工程构建

5.1 v1工程

cloud-provider-payment8001为例
5.1.1 微服务小口诀

• 1.建module
  
• 2.改POM
  
• 3.写YML
  
• 4.主启动
  
• 5.业务类
  

5.1.2  步骤

建module
略，创建完成后，父工程pom文件会多一个

1. <modules>
2.         <module>generator</module>
3.         <module>cloud-provider-payment8001</module>
4.     </modules>

复制代码

改POM

1. <?xml version="1.0" encoding="UTF-8"?>
2. <project xmlns="http://maven.apache.org/POM/4.0.0"
3.          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
4.          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
5.     <modelVersion>4.0.0</modelVersion>
6.     <parent>
7.         <groupId>com.atguigu.cloud</groupId>
8.         <artifactId>mscloudV5</artifactId>
9.         <version>1.0-SNAPSHOT</version>
10.     </parent>
12.     <artifactId>cloud-provider-payment8001</artifactId>
14.     <properties>
15.         <maven.compiler.source>17</maven.compiler.source>
16.         <maven.compiler.target>17</maven.compiler.target>
17.         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
18.     </properties>
21.     <dependencies>
22.         
23.         <dependency>
24.             <groupId>org.springframework.boot</groupId>
25.             <artifactId>spring-boot-starter-web</artifactId>
26.         </dependency>
27.         <dependency>
28.             <groupId>org.springframework.boot</groupId>
29.             <artifactId>spring-boot-starter-actuator</artifactId>
30.         </dependency>
31.         
32.         <dependency>
33.             <groupId>com.alibaba</groupId>
34.             <artifactId>druid-spring-boot-starter</artifactId>
35.         </dependency>
36.         
37.         <dependency>
38.             <groupId>org.springdoc</groupId>
39.             <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
40.         </dependency>
41.         
42.         <dependency>
43.             <groupId>org.mybatis.spring.boot</groupId>
44.             <artifactId>mybatis-spring-boot-starter</artifactId>
45.         </dependency>
46.         
47.         <dependency>
48.             <groupId>mysql</groupId>
49.             <artifactId>mysql-connector-java</artifactId>
50.         </dependency>
51.         
52.         <dependency>
53.             <groupId>javax.persistence</groupId>
54.             <artifactId>persistence-api</artifactId>
55.         </dependency>
56.         
57.         <dependency>
58.             <groupId>tk.mybatis</groupId>
59.             <artifactId>mapper</artifactId>
60.         </dependency>
61.         
62.         <dependency>
63.             <groupId>cn.hutool</groupId>
64.             <artifactId>hutool-all</artifactId>
65.         </dependency>
66.         
67.         <dependency>
68.             <groupId>com.alibaba.fastjson2</groupId>
69.             <artifactId>fastjson2</artifactId>
70.         </dependency>
71.         
72.         <dependency>
73.             <groupId>org.projectlombok</groupId>
74.             <artifactId>lombok</artifactId>
75.             <version>1.18.28</version>
76.             <scope>provided</scope>
77.         </dependency>
78.         
79.         <dependency>
80.             <groupId>org.springframework.boot</groupId>
81.             <artifactId>spring-boot-starter-test</artifactId>
82.             <scope>test</scope>
83.         </dependency>
84.     </dependencies>
86.    
88. </project>

复制代码

写yml

1. server:
2.   port: 8001
4. # ==========applicationName + druid-mysql8 driver===================
5. spring:
6.   application:
7.     name: cloud-payment-service
9.   datasource:
10.     type: com.alibaba.druid.pool.DruidDataSource
11.     driver-class-name: com.mysql.cj.jdbc.Driver
12.     #连接的url替换为自己安装的端口好，和数据库
13.     url: jdbc:mysql://localhost:3306/db2024?characterEncoding=utf8&useSSL=false&serverTimezone=GMT%2B8&rewriteBatchedStatements=true&allowPublicKeyRetrieval=true
14.     username: xxx 替换为自己账号
15.     password: xxx 替换为自己密码
17. # ========================mybatis===================
18. mybatis:
19.   mapper-locations: classpath:mapper/*.xml
20.   type-aliases-package: com.atguigu.cloud.entities
21.   configuration:
22.     map-underscore-to-camel-case: true

复制代码

主启动

1. import org.springframework.boot.SpringApplication;
2. import org.springframework.boot.autoconfigure.SpringBootApplication;
3. import tk.mybatis.spring.annotation.MapperScan;
5. /**
6. * @auther zzyy
7. * @create 2023-11-03 17:54
8. */
9. @SpringBootApplication
10. @MapperScan("com.atguigu.cloud.mapper") //import tk.mybatis.spring.annotation.MapperScan;
11. public class Main8001
12. {
13.     public static void main(String[] args)
14.     {
15.         SpringApplication.run(Main8001.class,args);
16.     }
17. }

复制代码

业务类
略
5.1.3 测试

Swagger3常用注解
注解标注位置作用@TagContoller类标识Controller@Paramter参数标识参数@Paramters参数参数多重说明@SchemaModel层的JavaBean或DTO形貌模型作用及每个属性@Operation方法形貌方法作用@ApiResponse方法形貌响应状态码举例

1. @Tag(name = "支付微服务模块", description = "支付CRUD")
2. public class PayController {
3.    
4. @Operation(summary = "新增", description = "新增支付流水方法,json串做参数")
5. public ResultData<String> addPay(@RequestBody Pay pay) {
6.    
7. @Schema(title = "支付交易表Entity")
8. public class Pay {
9.    
10.     /**
11.      * 订单流水号
12.      */
13.     @Schema(title = "订单流水号")
14.     private String orderNo;

复制代码

设置类

1. import io.swagger.v3.oas.models.ExternalDocumentation;
2. import io.swagger.v3.oas.models.OpenAPI;
3. import io.swagger.v3.oas.models.info.Info;
4. import org.springdoc.core.models.GroupedOpenApi;
5. import org.springframework.context.annotation.Bean;
6. import org.springframework.context.annotation.Configuration;
8. /**
9. * @auther zzyy
10. * @create 2023-11-04 10:40
11. */
12. @Configuration
13. public class Swagger3Config
14. {
15.     @Bean
16.     public GroupedOpenApi PayApi()
17.     {
18.         return GroupedOpenApi.builder().group("支付微服务模块").pathsToMatch("/pay/**").build();
19.     }
20.     @Bean
21.     public GroupedOpenApi OtherApi()
22.     {
23.         return GroupedOpenApi.builder().group("其它微服务模块").pathsToMatch("/other/**", "/others").build();
24.     }
25.     /*@Bean
26.     public GroupedOpenApi CustomerApi()
27.     {
28.         return GroupedOpenApi.builder().group("客户微服务模块").pathsToMatch("/customer/**", "/customers").build();
29.     }*/
31.     @Bean
32.     public OpenAPI docsOpenApi()
33.     {
34.         return new OpenAPI()
35.                 .info(new Info().title("cloud2024")
36.                         .description("通用设计rest")
37.                         .version("v1.0"))
38.                 .externalDocs(new ExternalDocumentation()
39.                         .description("www.atguigu.com")
40.                         .url("https://yiyan.baidu.com/"));
41.     }
42. }

复制代码

5.1.4 上述模块存在的问题

1.时间格式
返回的时间格式不是yyyy-MM-dd HH:mm:ss
2.统一计划API接口实现统一格式返回
3 全局非常接入返回的尺度格式
5.2 v2工程

5.2.1 解决时间格式问题

1.使用@JsonFormat注解

1. /**
2. * 创建时间
3. */
4. @Column(name = "create_time")
5. @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss",timezone = "GBT+8")
6. private Date createTime;
8. /**
9. * 更新时间
10. */
11. @Column(name = "update_time")
12. @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss",timezone = "GBT+8")
13. private Date updateTime;

复制代码

2.Spring Boot项目，也可以在application.yml文件中指定：

1. #建议使用该方式
2. spring:  
3.   jackson:
4.     date-format: yyyy-MM-dd HH:mm:ss
5.     time-zone: GMT+8

复制代码

5.2.2 解决统一返回值

思绪：定义返回尺度格式，三大标配：

• code状态值：由后端统一定义各种返回结果的状态码。
  
• message形貌：本次接口调用结果的形貌。
  
• data数据：本次返回的数据。
  

扩展：接口调用时间：

• timestamp：接口调用时间
  

新建枚举类

1. import java.util.Arrays;
3. public enum ReturnCodeEnum {
4.     /**
5.      * 操作失败
6.      **/
7.     RC999("999", "操作XXX失败"),
8.     /**
9.      * 操作成功
10.      **/
11.     RC200("200", "success"),
12.     /**
13.      * 服务降级
14.      **/
15.     RC201("201", "服务开启降级保护,请稍后再试!"),
16.     /**
17.      * 热点参数限流
18.      **/
19.     RC202("202", "热点参数限流,请稍后再试!"),
20.     /**
21.      * 系统规则不满足
22.      **/
23.     RC203("203", "系统规则不满足要求,请稍后再试!"),
24.     /**
25.      * 授权规则不通过
26.      **/
27.     RC204("204", "授权规则不通过,请稍后再试!"),
28.     /**
29.      * access_denied
30.      **/
31.     RC403("403", "无访问权限,请联系管理员授予权限"),
32.     /**
33.      * access_denied
34.      **/
35.     RC401("401", "匿名用户访问无权限资源时的异常"),
36.     RC404("404", "404页面找不到的异常"),
37.     /**
38.      * 服务异常
39.      **/
40.     RC500("500", "系统异常，请稍后重试"),
41.     RC375("375", "数学运算异常，请稍后重试"),
43.     INVALID_TOKEN("2001", "访问令牌不合法"),
44.     ACCESS_DENIED("2003", "没有权限访问该资源"),
45.     CLIENT_AUTHENTICATION_FAILED("1001", "客户端认证失败"),
46.     USERNAME_OR_PASSWORD_ERROR("1002", "用户名或密码错误"),
47.     BUSINESS_ERROR("1004", "业务逻辑异常"),
48.     UNSUPPORTED_GRANT_TYPE("1003", "不支持的认证模式");
50.     private final String code;
52.     private final String message;
54.     ReturnCodeEnum(String code, String message) {
55.         this.code = code;
56.         this.message = message;
57.     }
59.     public String getCode() {
60.         return code;
61.     }
63.     public String getMessage() {
64.         return message;
65.     }
67.     public static ReturnCodeEnum getReturnCodeEnum(String code) {
68.         for (ReturnCodeEnum rce : ReturnCodeEnum.values()) {
69.             if (rce.getCode().equals(code)) {
70.                 return rce;
71.             }
72.         }
73.         return null;
74.     }
76.     public static ReturnCodeEnum getReturnCodeEnumV2(String code) {
77.         return Arrays.stream(ReturnCodeEnum.values())
78.                 .filter(r -> r.getCode().equals(code))
79.                 .findFirst()
80.                 .orElse(null);
81.     }
82. }

复制代码

新建统一定义返回对象ResultData

1. import lombok.Data;
2. import lombok.experimental.Accessors;
4. @Data
5. @Accessors(chain = true)
6. public class ResultData<T> {
8.     private String code;
9.     private String message;
10.     private T data;
12.     private long timestamp;
14.     public ResultData(){
15.         this.timestamp = System.currentTimeMillis();
16.     }
18.     public static <T> ResultData<T> success(T data){
19.         ResultData<T> resultData = new ResultData<>();
20.         resultData.setCode(ReturnCodeEnum.RC200.getCode());
21.         resultData.setMessage(ReturnCodeEnum.RC200.getMessage());
22.         resultData.setData(data);
23.         return resultData;
24.     }
26.     public static <T> ResultData<T> fail(String code,String message){
27.         ResultData<T> resultData = new ResultData<>();
28.         resultData.setCode(code);
29.         resultData.setMessage(message);
30.         return resultData;
31.     }
33. }

复制代码

修改PayController
略
测试
略
5.2.3 全局非常接入返回的尺度格式

新建全局非常类

1. import com.atguigu.cloud.resp.ResultData;
2. import com.atguigu.cloud.resp.ReturnCodeEnum;
3. import lombok.extern.slf4j.Slf4j;
4. import org.springframework.http.HttpStatus;
5. import org.springframework.web.bind.annotation.ExceptionHandler;
6. import org.springframework.web.bind.annotation.ResponseStatus;
7. import org.springframework.web.bind.annotation.RestControllerAdvice;
9. @Slf4j
10. @RestControllerAdvice
11. public class GlobalExceptionHandler {
13.     /**
14.      * 默认全局异常处理
15.      * @param e
16.      * @return
17.      */
18.     @ExceptionHandler(RuntimeException.class)
19.     @ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
20.     public ResultData<String> exception(Exception e) {
21.         logger.error("----come in GlobalExceptionHandler");
22.         log.error("全局异常信息exception:{}", e.getMessage(), e);
23.         return ResultData.fail(ReturnCodeEnum.RC500.getCode(),e.getMessage());
24.     }
26. }

复制代码

修改Controller
略
6.引入微服务概念

6.1 订单微服务，如何才能调用到支付微服务8001

6.2 新建cloud-consumer-order80

不外，80端口，是HTTP协议的默认端口，一般开启浏览器，都会占用，所以修改为其他的端口即可，这里模块名未做修改。
这里，建moudle，改pom，写yml，主启动，业务类，都略，只是记笔记，不能再将编码，都重复一变，见视频
记一下，其中的核心的东西
新创建了PayDTO，用以微服务间的数据传输的载体。

1. import lombok.AllArgsConstructor;
2. import lombok.Data;
3. import lombok.NoArgsConstructor;
5. import java.io.Serializable;
6. import java.math.BigDecimal;
8. /**
9. * @author 长名06
10. * @year 2024
11. * 一般而言，调用者不应该获悉服务提供者的entity资源并知道表结构关系，所以服务提供方给出的
12. * 接口文档都都应成为DTO
13. */
14. @Data
15. @AllArgsConstructor
16. @NoArgsConstructor
17. public class PayDTO implements Serializable {
18.     private Integer id;
20.     /**
21.      * 支付流水号
22.      */
23.     private String payNo;
25.     /**
26.      * 订单流水号
27.      */
28.     private String orderNo;
30.     /**
31.      * 用户账号ID
32.      */
33.     private Integer userId;
35.     /**
36.      * 交易金额
37.      */
38.     private BigDecimal amount;
40. }

复制代码

6.3 RestTemplate

RestTemplate提供了多种便捷访问远程Http服务的方法， 是一种简朴便捷的访问restful服务模板类，是Spring提供的用于访问Rest服务的客户端模板工具集。
restful可以看作是一种构建头脑，也可以看作，标志服务器资源的协议(约定可能更合适)。好比Post接口，一般都是新增，Get接口，是查询等，都是Restful的表现。
官网地址
使用restTemplate访问restful接口非常的简朴粗暴无脑。
(url, requestMap, ResponseBean.class)这三个参数分别代表
REST请求地址、请求参数、HTTP响应转换被转换成的对象类型。
具体见官网API说明，这些东西，记不住，也正常。毕竟在盘算机的世界里，要学的东西着实是太多了，学东西重要的是明白其头脑。记不住就找笔记，或百度，问生成式AI都可以。
6.4 RestTemplate设置类

1. import org.springframework.cloud.client.loadbalancer.LoadBalanced;
2. import org.springframework.context.annotation.Bean;
3. import org.springframework.context.annotation.Configuration;
4. import org.springframework.web.client.RestTemplate;
6. @Configuration
7. public class RestTemplateConfig {
9.     @Bean
10.     @LoadBalanced
11.     public RestTemplate restTemplate(){
12.         return new RestTemplate();
13.     }
15. }

复制代码

6.5 OrderController

1. import com.atguigu.cloud.dto.PayDTO;
2. import com.atguigu.cloud.resp.ResultData;
3. import jakarta.annotation.Resource;
4. import org.springframework.web.bind.annotation.*;
5. import org.springframework.web.client.RestTemplate;
7. @RestController
8. @RequestMapping("/consumer")
9. public class OrderController {
11.     public static final String PAYMENT_SRV_URL = "http://localhost:8001";//硬编码
14.     @Resource
15.     private RestTemplate restTemplate;
17.     /**
18.      * 一般情况下，通过浏览器的地址栏输入url，发送的只能是get请求
19.      * 我们底层调用的是post方法，模拟消费者发送get请求，客户端消费者
20.      * 参数可以不添加@RequestBody
21.      * @param payDTO
22.      * @return
23.      */
24.     @GetMapping("/pay/add")
25.     public ResultData addOrder(PayDTO payDTO){
26.         return restTemplate.postForObject(PAYMENT_SRV_URL + "/pay/add",payDTO,ResultData.class);
27.     }
29.     @GetMapping("/pay/get/{id}")
30.     public ResultData getPayInfo(@PathVariable("id") Integer id){
31.         return restTemplate.getForObject(PAYMENT_SRV_URL + "/pay/get/" + id,ResultData.class,id);
32.     }
34.     @DeleteMapping("/pay/delete/{id}")
35.     public void deletePay(@PathVariable("id") Integer id){
36.         restTemplate.delete(PAYMENT_SRV_URL + "/pay/delete/"+id);
37.     }
39.     @GetMapping("/pay/update")
40.     public void updatePay(PayDTO payDTO){
41.         restTemplate.put(PAYMENT_SRV_URL + "/pay/update",payDTO);
42.     }
44. }

复制代码

测试略
6.6 工程重构

将PayDTO，ResultData，ReturnCodeEnum类提到common模块，打包到本地库，以及修改Order80，Pay8001的类和POM的修改，这些都略。
6.7 硬编码问题

微服务所在的IP地址和端口号硬编码到订单微服务中，会存在非常多的问题

• （1）如果订单微服务和支付微服务的IP地址或者端口号发生了变革，则支付微服务将变得不可用，需要同步修改订单微服务中调用支付微服务的IP地址和端口号。
  
• （2）如果系统中提供了多个订单微服务和支付微服务，则无法实现微服务的负载平衡功能。
  
• （3）如果系统需要支持更高的并发，需要摆设更多的订单微服务和支付微服务，硬编码订单微服务则后续的维护会变得非常复杂。
  

所以，在微服务开辟的过程中，需要引入服务治理功能，实现微服务之间的动态注册与发现，从此刻开始我们正式进入SpringCloud实战。
只是为了记录自己的学习历程，且本人程度有限，不对之处，请指正。

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。