(四)、SpringCloud Rest学习环境搭建：服务提供者
1.介绍
- 我们会使用一个Dept部门模块做一个微服务通用案例 Consumer消费者 (Client) 通过REST调用 Provider提供者(Server) 提供的服务。
- 回顾Spring，SpringMVC，Mybatis等以往学习的知识。
- Maven的分包分模块架构复习。
一个简单的Maven模块结构是这样的： -- app-parent: 一个父项目(app-parent)聚合了很多子项目(app-util\app-dao\app-web...) |-- pom.xml | |-- app-core ||---- pom.xml | |-- app-web ||---- pom.xml ...... 1234567891011
一个父工程带着多个Moudule子模块
MicroServiceCloud父工程(Project)下初次带着3个子模块(Module)
- microservicecloud-api 【封装的整体entity/接口/公共配置等】
- microservicecloud-consumer-dept-80 【服务提供者】
- microservicecloud-provider-dept-8001 【服务消费者】
2. SpringCloud版本选择
大版本说明
| SpringBoot | SpringCloud | 关系 |
| 1.2.x | Angel版本(天使) | 兼容SpringBoot1.2x |
| 1.3.x | Brixton版本(布里克斯顿) | 兼容SpringBoot1.3x，也兼容SpringBoot1.4x |
| 1.4.x | amden版本(卡姆登) | 兼容SpringBoot1.4x，也兼容SpringBoot1.5x |
| 1.5.x | Dalston版本(多尔斯顿) | 兼容SpringBoot1.5x，不兼容SpringBoot2.0x |
| 1.5.x | Edgware版本(埃奇韦尔) | 兼容SpringBoot1.5x，不兼容SpringBoot2.0x |
| 2.0.x | Finchley版本(芬奇利) | 兼容SpringBoot2.0x，不兼容SpringBoot1.5x |
实际开发版本关系
| spring-boot-starter-parent | spring-cloud-dependencles | ||
| 版本号 | 发布日期 | 版本号 | 发布日期 |
| 1.5.2.RELEASE | 2017-03 | Dalston.RC1 | 2017-x |
| 1.5.9.RELEASE | 2017-11 | Edgware.RELEASE | 2017-11 |
| 1.5.16.RELEASE | 2018-04 | Edgware.SR5 | 2018-10 |
| 1.5.20.RELEASE | 2018-09 | Edgware.SR5 | 2018-10 |
| 2.0.2.RELEASE | 2018-05 | Fomchiey.BULD-SNAPSHOT | 2018-x |
| 2.0.6.RELEASE | 2018-10 | Fomchiey-SR2 | 2018-10 |
| 2.1.4.RELEASE | 2019-04 | Greenwich.SR1 | 2019-03 |
3.创建父工程
- 新建父工程项目springcloud，切记 Packageing是pom模式
- 主要是定义POM文件，将后续各个子模块公用的jar包等统一提取出来，类似一个抽象父类
(1).添加父类Maven依赖
这里使用了dependecyManger,目的是为了让子项目如果引用的时候，会有一个父类指定的版本(目的是为了达到所有的子项目版本一致)
<?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 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>org.jsxs</groupId> <artifactId>SpringCloud</artifactId> <version>1.0-SNAPSHOT</version> <modules> <module>SpringCloud-api</module> <module>SpringCloud-provider-dept-8001</module> </modules> <properties> <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> </properties> <!-- 更改打包方式--> <packaging>pom</packaging> <!-- 使用依赖管理--> <dependencyManagement> <!-- 创建依赖项--> <dependencies> <!-- SpringCloud 的依赖--> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-dependencies</artifactId> <version>Hoxton.SR8</version> <type>pom</type> <scope>import</scope> </dependency> <!-- SpringBoot 的依赖--> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-dependencies</artifactId> <version>2.3.3.RELEASE</version> <type>pom</type> <scope>import</scope> </dependency> <!-- MySql 数据库--> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>5.1.6</version> </dependency> <!-- 导入德鲁伊数据源 --> <dependency> <groupId>com.alibaba</groupId> <artifactId>druid</artifactId> <version>1.1.10</version> </dependency> <!--SpringBoot 启动器--> <dependency> <groupId>org.mybatis.spring.boot</groupId> <artifactId>mybatis-spring-boot-starter</artifactId> <version>1.3.2</version> </dependency> <!--日志测试~--> <dependency> <groupId>ch.qos.logback</groupId> <artifactId>logback-core</artifactId> <version>1.2.3</version> </dependency> <!--junit--> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>${junit.version}</version> </dependency> <!-- log4j--> <dependency> <groupId>log4j</groupId> <artifactId>log4j</artifactId> <version>${log4j.version}</version> </dependency> <!-- lombok --> <dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <version>${lombok.version}</version> </dependency> </dependencies> </dependencyManagement> </project>
4.创建子工程 SpringCloud-api (普通Maven)
客户端的资源 80
1.编写一个数据库: 数据库语句如下
CREATE DATABASE db01; USE db01; CREATE TABLE dept( deptno BIGINT(20) Not Null PRIMARY KEY AUTO_INCREMENT, dname VARCHAR(60) DEFAULT NULL, db_source VARCHAR(60) DEFAULT NULL ); INSERT INTO dept(deptno,dname,db_source) VALUES(0,'开发部',DATABASE()); INSERT INTO dept(deptno,dname,db_source) VALUES(1,'人事部',DATABASE()); INSERT INTO dept(deptno,dname,db_source) VALUES(2,'财务部',DATABASE()); INSERT INTO dept(deptno,dname,db_source) VALUES(3,'售后部',DATABASE());
2.所需要的依赖
<?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 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <parent> <artifactId>SpringCloud</artifactId> <groupId>org.jsxs</groupId> <version>1.0-SNAPSHOT</version> </parent> <modelVersion>4.0.0</modelVersion> <groupId>com.jsxs</groupId> <artifactId>SpringCloud-api</artifactId> <properties> <maven.compiler.source>8</maven.compiler.source> <maven.compiler.target>8</maven.compiler.target> </properties> <dependencies> <dependency> <groupId>log4j</groupId> <artifactId>log4j</artifactId> </dependency> <dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> </dependency> </dependencies> </project>
3.创建一个实体类Dept 注意这里开启了链式编程注解并且实现了序列化的操作
package com.jsxs.pojo; import lombok.AllArgsConstructor; import lombok.Data; import lombok.NoArgsConstructor; import lombok.experimental.Accessors; import java.io.Serializable; @Data @NoArgsConstructor @AllArgsConstructor @Accessors(chain = true) //目的是为了打开链式写法， public class Dept implements Serializable { // 实体类在网络通信的时候，一定要进行序列化，否则会报错 ORM关系 private Long deptno; // 主键 private String dname; //部门的名字 // 这里的数据存在哪个数据库里面。微服务: 一个服务对应一个数据库，同一个信息可能存在不同的数据库中。 private String db_source; }
4.链式编程注解的介绍
⭐非链式写法: Dept dept=new Dept(); dept.getDeptno(); dept.getDname(); ⭐链式写法: Dept dept=new Dept(); dept.getDeptno() .getDname(); ***** 上面的写法与下面的写法等同 ****
5.创建子工程SpringCloud-provider-dept-8001 (普通Maven项目)
1.需要的依赖需要添加一些SpringBoot的启动器
<?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 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <parent> <artifactId>SpringCloud</artifactId> <groupId>org.jsxs</groupId> <version>1.0-SNAPSHOT</version> </parent> <modelVersion>4.0.0</modelVersion> <artifactId>SpringCloud-provider-dept-8001</artifactId> <properties> <maven.compiler.source>8</maven.compiler.source> <maven.compiler.target>8</maven.compiler.target> </properties> <dependencies> <!-- 我们需要拿到实体类，所以我们要获取刚才设置的Model -SpringCloud-api --> <dependency> <groupId>com.jsxs</groupId> <artifactId>SpringCloud-api</artifactId> <version>1.0-SNAPSHOT</version> </dependency> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <scope>test</scope> </dependency> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> </dependency> <dependency> <groupId>com.alibaba</groupId> <artifactId>druid</artifactId> </dependency> <dependency> <groupId>ch.qos.logback</groupId> <artifactId>logback-core</artifactId> </dependency> <dependency> <groupId>org.mybatis.spring.boot</groupId> <artifactId>mybatis-spring-boot-starter</artifactId> </dependency> <!-- test--> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-test</artifactId> </dependency> <!-- jetty--> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-jetty</artifactId> </dependency> <!-- 热部署工具--> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-devtools</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> </dependencies> </project>
2.在Classpath:目录下编写application.yaml 主要任务就是端口号 Mybatis绑定 和 数据源
server: port: 8081 # Mybatis的配置 mybatis: type-aliases-package: com.jsxs.pojo mapper-locations: classpath:mybatis/mapper/*.xml # Spring的配置 spring: application: name: SpringCloud-provider-dept datasource: url: jdbc:mysql://localhost:3306/db01?useUnicode=true&characterEncoding=utf-8 username: root password: 121788 driver-class-name: com.mysql.jdbc.Driver type: com.alibaba.druid.pool.DruidDataSource
3.编写dao层接口以及Mapper.xml
dao层的接口
package com.jsxs.dao; import com.jsxs.pojo.Dept; import org.apache.ibatis.annotations.Mapper; import org.springframework.stereotype.Repository; import java.util.List; @Mapper @Repository public interface DeptDao { public boolean addDept(Dept dept); public Dept queryById(Long id); public List<Dept> all(); }
mybatis/DeptMapper.xml
<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "https://mybatis.org/dtd/mybatis-3-mapper.dtd"> <!-- 1. 我们首先要绑定工作空间--> <mapper namespace="com.jsxs.dao.DeptDao"> <!-- 2. 我们编写SQL语句 --> <insert id="addDept" parameterType="com.jsxs.pojo.Dept"> insert into dept(deptno,dname,db_source) values(#{deptno},#{dname},DATABASE()) </insert> <select id="queryById" resultType="com.jsxs.pojo.Dept" parameterType="Long"> select *from dept where deptno=#{id} </select> <select id="all" resultType="com.jsxs.pojo.Dept"> select *from dept </select> </mapper>
