1、总体介绍
1.1、SpringCloud版本选择
大版本说明
SpringBoot | SpringCloud | 关系 |
---|---|---|
1.2.x | Angel版本(天使) | 兼容SpringBoot 1.2.x |
1.3.x | Brixton版本(布里克斯顿) | 兼容SpringBoot 1.3.x,也兼容SpringBoot 1.4.x |
1.4.x | Camden版本(卡姆登) | 兼容SpringBoot 1.4.x,也兼容SpringBoot 1.5.x |
1.5.x | Dalston版本(多尔斯顿) | 兼容SpringBoot 1.5.x,不兼容SpringBoot 2.0.x |
1.5.x | Edgware版本(埃奇韦尔) | 兼容SpringBoot 1.5.x,不兼容SpringBoot 2.0.x |
2.0.x | Finchley版本(芬奇利) | 兼容SpringBoot 2.0.x,不兼容SpringBoot 1.5.x |
2.1.x | Greenwith(格林威治) |
实际开发版本关系
spring-boot-starter-parent | spring-cloud-dependencies | ||
---|---|---|---|
版本号 | 发布日期 | 版本号 | 发布日期 |
1.5.2.RELEASE | 201年3月 | Dalston RC1 | 2017年未知月 |
1.5.9.RELEASE | Nov.2017 | Edgware.RELEASE | Nov.2017 |
1.5.16.RELEASE | Sep.2018 | Edgware.SR5 | Oct.2018 |
1.5.20.RELEASE | Apr.2019 | Edgware.SR5 | Oct.2018 |
2.0.2.RELEASE | May.2018 | Fomchiey.BULD-SNAPSHOT | 2018年未知月 |
2.0.6.RELEASE | Oct.2018 | Fomchiey-SR2 | Oct.2018 |
2.1.4.RELEASE | Apt.2019 | Greenwich.SR1 | Mar.2019 |
推荐:使用最后两个
2、创建项目
创建一个父工程
1.父工程操作
-
父工程是一个
maven
工程,项目中的打包方式修改为pom
方式
-
主要是定义
pom
文件,将后续各个子模块公用的jar包等统一提取出来,类似一个抽象父类 -
创建好之后,可以将
src目录
删除
2.父工程的pom.xml
配置
这块的版本信息可以提取出来,放在properties
标签中,修改时在properties
标签中修改即可。
<!-- 打包方式 -->
<packaging>pom</packaging>
<!--版本-->
<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>
<lombok.version>1.16.10</lombok.version>
<log4j.version>1.2.17</log4j.version>
</properties>
<dependencyManagement>
<dependencies>
<!-- springcloud的依赖 -->
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-dependencies</artifactId>
<version>Greenwich.SR1</version>
<type>pom</type>
<scope>import</scope>
</dependency>
<!-- springboot的依赖 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-dependencies</artifactId>
<version>2.1.4.RELEASE</version>
<type>pom</type>
<scope>import</scope>
</dependency>
<!-- 数据库驱动 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.47</version>
</dependency>
<!-- 数据源 -->
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>druid</artifactId>
<version>1.1.10</version>
</dependency>
<!-- springboot的启动器 ==> mybatis -->
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>1.3.2</version>
</dependency>
<!-- 日志测试 -->
<!-- junit -->
<dependency>
<groupId>ch.qos.logback</groupId>
<artifactId>logback-core</artifactId>
<version>1.2.3</version>
</dependency>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>${junit.version}</version>
</dependency>
<!-- lombok -->
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>${lombok.version}</version>
</dependency>
<!-- log4j -->
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>${log4j.version}</version>
</dependency>
</dependencies>
</dependencyManagement>
3、创建Maven子工程
3.1 创建springcloud-api
1. 创建springcloud-api ==> 这个微服务只需去管理pojo类
2. pom.xml配置信息
<?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.jl</groupId>
<version>1.0-SNAPSHOT</version>
</parent>
<modelVersion>4.0.0</modelVersion>
<artifactId>springcloud-api</artifactId>
<!-- 当前的Module自己需要的依赖,如果父依赖中已经配置了版本信息,这里就不用写了 -->
<dependencies>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
</dependency>
</dependencies>
</project>
这里的Module设置完之后,会在父工程的pom.xml文件中看到多了一个Module信息
3. 创建一个db01数据库,构建一个表
CREATE TABLE `dept` (
`deptno` bigint(20) NOT NULL AUTO_INCREMENT,
`dname` varchar(60) DEFAULT NULL,
`db_source` varchar(60) DEFAULT NULL,
PRIMARY KEY (`deptno`)
) ENGINE=InnoDB AUTO_INCREMENT=6 DEFAULT CHARSET=utf8 COMMENT='部门表';
我们这里可以尝试的在IDEA中去创建表
这里测试时可能会有时区的问题,可以去cmd连接数据库,设置时区
添加表结构
插入数据
4. 创建实体类,这里的实体类务必实现序列化
@Data
@NoArgsConstructor
@Accessors(chain = true) // 链式写法,默认为false
public class Dept implements Serializable {
private Long deptno;
private String dname;
// db_source:表示当前数据存在哪个数据库中
// 微服务,一个服务对应一个数据库,同一个信息可能存在不同的数据库
private String db_source;
public Dept(String dname) {
this.dname = dname;
}
/*
这里介绍一下什么是链式编程
Dept dept = new Dept();
dept.setDeptNo(11).setDname('ss').setDb_source('001')
*/
}
3.2 创建服务提供者
1. 创建一个maven子项目 springcloud-provider-dept-8001,此服务的端口号为8001
2. 编写pom.xml配置文件,导入需要的jar包
<?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.jl</groupId>
<version>1.0-SNAPSHOT</version>
</parent>
<modelVersion>4.0.0</modelVersion>
<artifactId>springcloud-provider-dept-8001</artifactId>
<dependencies>
<!-- 这里我们需要实体类,所以需要去配置api module -->
<dependency>
<groupId>org.jl</groupId>
<artifactId>springcloud-api</artifactId>
<version>1.0-SNAPSHOT</version>
</dependency>
<!-- junit -->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
</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>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-test</artifactId>
</dependency>
<!-- web -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!-- jetty ,类似于Tomcat-->
<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>
</dependencies>
</project>
3. 编写application.yml配置文件
补充
# 用于配置驼峰命名
mybatis:
configuration:
map-underscore-to-camel-case:
# 端口号
server:
port: 8001
# mybatis 配置
mybatis:
# 实体类的别名
type-aliases-package: com.jl.springcloud.pojo
# mapper.xml的位置
mapper-locations: classpath:mybatis/mappers/*.xml
# mybatis.config.xml的配置
config-location: classpath:mybatis/mybatis-config.xml
# spring的配置
spring:
application:
name: springcloud-provider-dept
# 数据源
datasource:
type: com.alibaba.druid.pool.DruidDataSource
driver-class-name: com.mysql.jdbc.Driver
url: jdbc:mysql://localhost:3306/db1?useSSL=false&useUnicode=true&characterEncoding=UTF-8
username: root
password: root
mybatis-config.xml,这个也可以不设置
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<!-- 开启二级缓存 -->
<settings>
<setting name="cacheEnabled" value="true"/>
</settings>
</configuration>
4. 编写DeptDao接口层
@Mapper
@Repository // 方便被spring托管
public interface DeptDao {
// 添加部门
public boolean addDept(Dept dept);
// 根据id查询部门
public Dept queryById(Long id);
// 查询所有部门
public List<Dept> queryAll();
}
5. 在resource的mybatis.mappers下新建DeptMapper.xml文件配置
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.jl.springcloud.dao.DeptDao">
<!-- 添加部门-->
<insert id="addDept" parameterType="dept">
insert into dept (dname, db_source)
values (#{dname},DATABASE());
</insert>
<!-- 根据id查询部门 -->
<select id="queryById" resultType="dept" parameterType="Long">
select * from dept where deptno=#{deptno};
</select>
<!-- 查询所有部门 -->
<select id="queryAll" resultType="dept" >
select * from dept ;
</select>
</mapper>
6. 编写DeptService业务层
public interface DeptService {
// 添加部门
public boolean addDept(Dept dept);
// 根据id查询部门
public Dept queryById(Long id);
// 查询所有部门
public List<Dept> queryAll();
}
DeptServiceImpl
@Service
public class DeptServiceImpl implements DeptService {
@Autowired
private DeptDao deptDao;
@Override
public boolean addDept(Dept dept) {
return deptDao.addDept(dept);
}
@Override
public Dept queryById(Long id) {
return deptDao.queryById(id);
}
@Override
public List<Dept> queryAll() {
return deptDao.queryAll();
}
}
7. 编写Controller层业务DeptProviderController
// 提供Restful服务
@RestController
public class DeptController {
@Autowired
private DeptService deptService;
@PostMapping("/dept/add")
public boolean addDept(Dept dept){
return deptService.addDept(dept);
}
@GetMapping("/dept/get/{id}")
public Dept getDept(@PathVariable("id") Long id){
return deptService.queryById(id);
}
@GetMapping("/dept/list")
public List<Dept> getDeptAll(){
return deptService.queryAll();
}
}
8. 编写服务者的启动类DeptProvider_8001
// 启动类
@SpringBootApplication
public class DeptProvider_8001 {
public static void main(String[] args) {
SpringApplication.run(DeptProvider_8001.class,args);
}
}
3.3 创建服务消费者
1. 创建一个maven子项目 springcloud-consumer-dept-80,此服务的端口号为80
2. 编写pom.xml配置文件,导入需要的jar包
<!-- 实体类 + web -->
<dependencies>
<dependency>
<groupId>org.jl</groupId>
<artifactId>springcloud-api</artifactId>
<version>1.0-SNAPSHOT</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!-- 热部署工具-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-devtools</artifactId>
</dependency>
</dependencies>
3. 编写application.yml配置文件
# 端口号
server:
port: 80
注意:如果端口号为80,那么浏览器访问时可以不用写端口号,eg: http://localhost/consumer/dept/query/all
4. 编写Controller层业务DeptConsumerController
这里,我们先思考一个问题,此时的服务是消费者,那么不应该有service层,那么我们该如何去访问生产者的业务呢?
解决方案
在ConfigBean
中进行配置,将RestTemplate
注册到spring
容器中,我们需要通过它来调用远程服务
@Configuration // 相当于spring中的 applicationContext.xml
public class ConfigBean {
@Bean
public RestTemplate geRestTemplate(){
return new RestTemplate();
}
}
DeptConsumerController
层业务
@RestController
public class DeptConsumerController {
@Autowired
// (url,实体:Map,Class<T> responseType)
private RestTemplate restTemplate; // 提供多种便捷访问远程http服务的方法,简单的Restful服务模板
private static final String REST_URL_PREFIX = "http://localhost:8001";
@RequestMapping("/consumer/dept/add")
public boolean add(Dept dept){
return restTemplate.postForObject(REST_URL_PREFIX + "/dept/add",dept,Boolean.class);
}
@RequestMapping("/consumer/dept/get/{id}")
public Dept get(@PathVariable("id") Long id){
return restTemplate.getForObject(REST_URL_PREFIX + "/dept/get/" + id,Dept.class);
}
@RequestMapping("/consumer/dept/list")
public List<Dept> list(){
return restTemplate.getForObject(REST_URL_PREFIX + "/dept/list",List.class);
}
}
当远程服务是get请求时,我们就用restTemplate.get***()进行调用,如果是post请求,我们就用restTemplate.post***()进行调用
5. 编写消费者的启动类
@SpringBootApplication
public class DeptConsumer_80 {
public static void main(String[] args) {
SpringApplication.run(DeptConsumer_80.class,args);
}
}
问题:启动进行测试,会发现添加数据成功,但是数据库数值却为null
解决方案:在服务提供者的参数上加@RequestBody
注意区分: @RequestBody @ResponseBody @RestController
-
@RequestBody
:与传入参数有关 -
@ResponseBody
:与返回参数有关 -
@RestController
:@ResponseBody + @Controller
学习视频:走你