文章目录
- 1.SpringCloud简介
- 2.官方对应关系
- 3.Cloud各组件的停更/升级/替换
- 4.微服务架构编码构建
- 5.Eureka服务注册与发现
1.SpringCloud简介
技术要求:
java8+maven+git、github+Nginx+RabbitMQ+SpringBoot2.0
springcloud官方文档(Hoxton SR5):https://cloud.spring.io/spring-cloud-static/Hoxton.SR5/reference/htmlsingle/
springcloud中文文档:https://www.springcloud.cc/
springcloud中国社区文档:http://docs.springcloud.cn/
https://www.bookstack.cn/read/spring-cloud-docs/docs-index.md
什么是微服务架构?
各模块常用的技术支撑:
- 服务注册与发现:eureka
- 服务负载与调用:ribbon、feign
- 服务熔断降级:hystrix
- 服务网关:zuul
- 服务分布式配置:Spring Cloud Config
- 服务开发:SpringBoot
它采用了名称,而非数字版本号。
SpringCloud 和 springCloud Alibaba 目前是最主流的微服务框架组合。
2.官方对应关系
https://spring.io/projects/spring-cloud#overview
版本选择:
选用 springboot 和 springCloud 版本有约束,不按照它的约束会有冲突。
3.Cloud各组件的停更/升级/替换
其中服务调用应为负载均衡,服务调用2是真正的服务调用。
官方对应关系:http://start.spring.io/actuator/info 浏览器访问以后会返回json字符串,然后去找一个格式化的工具,找到spring-cloud就可以看对应关系
mindmanager管理工具激活码:
2019: MP19-777-APE8-1162-BD8E
2020: MP20-345-DP56-7778-919A
本次使用版本型号:
4.微服务架构编码构建
IDEA新建project工作空间
微服务cloud整体聚合父工程Project
一共要做的是这几步,我们现在使用的idea是2022版本,所以前几步有所差别。
1.New Project
聚合总父工程名字是最下面
创建完项目以后首先是确认maven版本,注意使用3.5以上版本,我本地是3.6
配置好以后
配置字符编码
注解生效激活
java编译版本选8
File Type过滤
2.父工程依赖引入配置
创建好父工程项目以后,开始引入依赖
删除src目录,并在pom中添加
<packaging>pom</packaging>
然后把`pom下的都用下面这些替换了。
<!-- 统一管理jar包版本 -->
<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>
<mysql.version>5.1.47</mysql.version>
<druid.version>1.1.16</druid.version>
<mybatis.spring.boot.version>1.3.0</mybatis.spring.boot.version>
</properties>
<!-- 子模块继承之后,提供作用:锁定版本+子modlue不用写groupId和version -->
<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>
3.关于dependencyManagement标签
Maven 使用dependencyManagement 元素来提供了一种管理依赖版本号的方式。通常会在一个组织或者项目的最顶层的父POM 中看到dependencyManagement 元素。
使用pom.xml 中的dependencyManagement 元素能让所有在子项目中引用一个依赖而不用显式的列出版本号。Maven 会沿着父子层次向上走,直到找到一个拥有dependencyManagement 元素的项目,然后它就会使用这个dependencyManagement 元素中指定的版本号。、
这样做的好处就是:如果有多个子项目都引用同一样依赖,则可以避免在每个使用的子项目里都声明一个版本号,这样当想升级或切换到另一个版本时,只需要在顶层父容器里更新,而不需要一个一个子项目的修改 ;另外如果某个子项目需要另外的一个版本,只需要声明version就可。
-
dependencyManagement里只是声明依赖,并不实现引入,因此子项目需要显示的声明需要用的依赖。
- 如果不在子项目中声明依赖,是不会从父项目中继承下来的;只有在子项目中写了该依赖项,并且没有指定具体版本,
才会从父项目中继承该项,并且version和scope都读取自父pom; -
如果子项目中指定了版本号,那么会使用子项目中指定的jar版本。
如果这里你想直接下载依赖,可以先把dependencyManagement依赖先注释掉,然后引入依赖以后再打开就可以了,我之前忘记这个标签的作用了,导致一直刷新maven,找问题,就是依赖下载不下来,我还以为哪里出问题了,导入maven依赖报红,刷新也不好使
然后解决了依赖报红的问题以后,发现<fork>true</fork>
这个标签还是报错,提示Element fork is not allowed here
,网上搜了一下也没有对这个原因有解释,但是看了一个文章说是加上版本号就可以了。结果试了一下加上版本号以后就不报红了,但是没有在网上找到原因是因为什么
没加就有问题
4.maven中跳过单元测试
父工程创建完成后执行mvn:install
将父工程发布到仓库方便子工程继承。到此父工程所有配置都已经构建完成了。
Rest微服务工程构建
01.cloud-provider-payment8001 微服务提供者支付Module模块
1.主要步骤参考
2.建cloud-provider-payment8001
创建完成后请回到父工程查看pom文件变化
3.改POM
导入需要的依赖,我这里不小心又出现maven报红的问题,多次刷新都不好使,后来发现是父工程中的</dependencyManagement>
标签被我注释掉了,把它打开以后再次刷新就可以了。
<?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>springcloud2020</artifactId>
<groupId>org.xu.springcloud</groupId>
<version>1.0.0</version>
</parent>
<modelVersion>4.0.0</modelVersion>
<artifactId>cloud-provider-payment8001</artifactId>
<dependencies>
<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>
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
</dependency>
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>druid-spring-boot-starter</artifactId>
<version>1.1.10</version>
</dependency>
<!--mysql-connector-java-->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
</dependency>
<!--jdbc-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-jdbc</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-devtools</artifactId>
<scope>runtime</scope>
<optional>true</optional>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<optional>true</optional>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
</project>
发现标签有问题是我在install父工程的时候提示引入的依赖没有版本号。其他没有任何报错提示,所以写代码的时候一定要小心。
4.写YML
server:
port: 8001
spring:
application:
name: cloud-payment-service
datasource:
type: com.alibaba.druid.pool.DruidDataSource # 当前数据源操作类型
driver-class-name: org.gjt.mm.mysql.Driver # mysql驱动包 com.mysql.jdbc.Driver
url: jdbc:mysql://localhost:3306/test1?useUnicode=true&characterEncoding=utf-8&useSSL=false
username: root
password: 123456
mybatis:
mapperLocations: classpath:mapper/*.xml
type-aliases-package: com.java.springcloud.entities # 所有Entity别名类所在包,这样写方便在xml文件中可以省略到实体类路径前缀
5. 主启动
在java包下创建主启动类com.java.springcloud.PaymentMain8001
package com.java.springcloud;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class PaymentMain8001 {
public static void main(String[] args) {
SpringApplication.run(PaymentMain8001.class,args);
}
}
6.业务类
业务类步骤
1.建表sql
CREATE TABLE `payment` (
`id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT 'ID',
`serial` varchar(200) DEFAULT '',
PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8
2.entities 主实体Payment
package com.java.springcloud.entities;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import java.io.Serializable;
@Data
@AllArgsConstructor
@NoArgsConstructor
public class Payment implements Serializable {
private long id;
private String serial;
}
3.Json封装体CommonResult
package com.java.springcloud.common;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
@Data
@NoArgsConstructor
@AllArgsConstructor
public class CommonResult<T> {
private Integer code;
private String message;
private T data;
/**
* 这种构造函数重载的方式常用于简化对象的创建过程。
* 例如,在创建CommonResult对象时,如果不需要提供data参数,
* 可以直接使用只接受code和message的构造函数,这样可以减少代码的复杂度和冗余。
* @param code
* @param message
*/
public CommonResult(Integer code,String message){
this(code,message,null);
}
}
4.dao
package com.java.springcloud.dao;
import com.java.springcloud.entities.Payment;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
@Mapper
public interface PaymentDao {
public int create(Payment payment);
public Payment getPaymentById(@Param("id") Long id);
}
5.service
package com.java.springcloud.service;
import com.java.springcloud.entities.Payment;
import org.apache.ibatis.annotations.Param;
public interface PaymentService {
public int create(Payment payment);
public Payment getPaymentById(@Param("id") Long id);
}
impl
package com.java.springcloud.service.impl;
import com.java.springcloud.dao.PaymentDao;
import com.java.springcloud.entities.Payment;
import com.java.springcloud.service.PaymentService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
@Service
public class PaymentServiceImpl implements PaymentService {
@Autowired
private PaymentDao paymentDao;
@Override
public int create(Payment payment) {
return paymentDao.create(payment);
}
@Override
public Payment getPaymentById(Long id) {
return paymentDao.getPaymentById(id);
}
}
6.controller
package com.java.springcloud.controller;
import com.java.springcloud.common.CommonResult;
import com.java.springcloud.entities.Payment;
import com.java.springcloud.service.PaymentService;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.*;
@RestController
@Slf4j
public class PaymentController {
@Autowired
private PaymentService paymentService;
@PostMapping("/payment/create")
public CommonResult create(@RequestBody Payment payment) {
int result = paymentService.create(payment);
if(result>0){
return new CommonResult(200, "插入数据库成功",result);
}else{
return new CommonResult(444, "插入数据库失败",null);
}
}
@GetMapping("/payment/getPaymentById/{id}")
public CommonResult getPaymentById(@PathVariable Long id) {
Payment paymentById = paymentService.getPaymentById(id);
if(paymentById!=null){
return new CommonResult(200, "查询成功",paymentById);
}else{
return new CommonResult(444, "没有对应id记录,id为"