微服务服务工程构建
1. 从2.2.X和H版开始说起
1.1 springboot版本选择
git源码地址: https://github.com/spring-projects/spring-boot/releases/
springboot2.0新特性
https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-2.0-Release-Notes
通过上面官网发现,Boot官方强烈建议升级到2.X以上版本
官网看Boot版本
https://spring.io/projects/spring-boot#learn
1.2 springcloud版本选择
- cloud版本命名规则
SpringCloud采用英国伦敦地铁站的名称来命名,并由地铁站名称字母A-Z依次类推的形式来发布迭代版本
SpringCloud是一个由许多子项目组成的综合项目,各子项目有不同的发布节奏。为了管理 SpringCloud与各子项目的版本依赖关系,发布了一个清单,其中包括了某个SpringCloud版本对应的子项目版本。为了避免SpringCloud版本号与子项目版本号混淆,SpringCloud版本采用了名称而非版本号的命名,这些版本的名字采用了伦敦地铁站的名字,根据字母表的顺序来对应版本时间顺序。例如Angel是第一个版本,Brixton是第二个版本。当SpringCloud的发布内容积累到临界点或一个重大BUG被解决后,会发布一个"service release"版本,简称SRX版本,比如Greenwich.SR2就是SpringCloud发布的Greenwich版本的第2个SRX版本。
- 官网看Cloud版本
截止2020.2.15号springcloud最新版本
1.3 springcloud和springboot之间的依赖关系如何看
打开 https://spring.io/projects/spring-cloud#overview
从官网看到如果cloud版本是Hoxton Boot的版本必须是2.2.x
更详细的版本对应查看方法
https://start.spring.io/actuator/info
查看json返回结果
1.4 最终此次工程使用的版本如下
- cloud Hoxton.SR1
- boot 2.2.2.RELEASE
- cloud alibaba 2.1.0.RElEASE
- Java Java8
- Maven 3.5及以上
- Mysql 5.7及以上
boot为什么选2.2.2?
如果只用boot,直接用最新
同时用boot和cloud,需要照顾cloud,由cloud决定boot版本
2 关于Cloud各种组件的停更/升级/替换
2.1 组件的替换
2.2 参考资料
https://cloud.spring.io/spring-cloud-static/Hoxton.SR1/reference/htmlsingle/
springcloud 中文文档 https://www.bookstack.cn/read/spring-cloud-docs/docs-index.md
3、IDEA创建project工作空间
3.1 微服务聚合父工程
3.1.1 新建空的maven项目
由于第一个是pom统一工程,不选择模板create from archetype
3.1.2 聚合父工程名字
3.1.3 Maven选版本
3.1.4 字符编码
Editor |File Encodings 设置为UTF-8
3.1.5 注解生效激活
Build,Execution,Deployment|Compiler|Annotation Processors| Enable annotation processing 打勾
3.1.6 java编译版本选1.8
Build,Execution,Deployment|Compiler|Java Compiler 设置为1.8
3.1.7 FileType 过滤
Editor |File Types 在ignore files and folders下的输入框里加上 *.idea; *.iml; 表示在idea工具隐藏*.iml等文件
3.2 父工程pom
<groupId>com.jd.springcloud</groupId>
<artifactId>mscloud_H</artifactId>
<version>1.0-SNAPSHOT</version>
<packaging>pom</packaging>
<!-- 统一管理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>
<!-- 子模块继承之后,提供作用:锁定版本+子module不用写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>
<!-- mysql-->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>${mysql.version}</version>
</dependency>
<!-- druid-->
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>druid</artifactId>
<version>${druid.version}</version>
</dependency>
<!-- mybatis-->
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>${mybatis.spring.boot.version}</version>
</dependency>
<!-- lombok-->
<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>
dependencyManagement的作用
锁定版本+继承父工程后子module不用写groupId和version
dependencyManagement和dependencies的区别?
maven使用dependencyManagement元素来提供了管理依赖版本号的方式,通常会在一个组织或项目的最顶层的父pom中看到dependencyManagement元素
使用pom.xml中的dependencyManagement元素能让所有子项目中引用一个依赖而不用显式的列出版本号。maven会沿着父子层次向上走,直到找到一个拥有dependencyManagement
元素的项目,然后它就会使用这个dependencyManagement元素中指定的版本号
例如在父项目里:
<dependencyManagement>
<dependencies>
<!-- mysql-->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.2</version>
...
</dependency>
</dependencies>
</dependencyManagement>
然后在子项目里就可以添加mysql-connector时可以不指定版本号
这样做的好处是如果有多个子项目都引用同一样依赖,则可以避免在每个使用的子项目里都声明一个版本号,这样当想升级或切换到另一个版本时,只需要在顶层父容器里更新,而不需要一个一个子项目的修改,
另外如果某个子项目需要另外的一个版本,只需要声明version即可
dependencyManagement里只是声明依赖,并不实现引入,因此子项目需要显示的声明需要用的依赖
如果不在子项目中声明依赖,是不会从父项目中继承下来的,只有在子项目中写了该依赖项,并且没有指定具体版本,才会从父项目中继承该项,并且version和scope都读取自父pom
如果子项目中指定的版本号,那么会使用子项目中指定的jar版本
3.3 Maven工程跳过单元测试
3.4 父工程创建完成执行mvn:install 将新父工程发布到仓库方便子工程
4. Rest微服务工程构建
4.1 cloud-provider-payment8001微服务提供者支付模块
4.1.1 idea创建 cloud-provider-payment8001
4.1.2 修改pom文件
<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>
4.1.3 编写yml文件
server:
port: 8001
spring:
application:
name: cloud-payment-service
datasource:
type: com.alibaba.druid.pool.DruidDataSource #当前数据源操作类型
driver-class-name: com.mysql.jdbc.Driver
url: jdbc:mysql://localhost:3306/clouddb?useUnicode=true&characterEncoding=utf-8&useSSL=false
username: root
password: root
mybatis:
mapper-locations: classpath:mapper/*.xml
type-aliases-package: com.jd.springcloud.entities #所有Entity别名类所在包
4.1.4 修改主启动类
package com.jd.springcloud;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
/**
* @author lijun
* @create 2020-03-05 19:53
*/
@SpringBootApplication
public class PaymentMain8001 {
public static void main(String[] args) {
SpringApplication.run(PaymentMain8001.class, args);
}
}
4.1.5 业务类
(1)创建payment数据库脚本
DROP DATABASE IF EXISTS clouddb;
CREATE DATABASE clouddb CHARACTER SET UTF8;
USE clouddb;
CREATE TABLE payment(
id bigint(20) NOT NULL PRIMARY KEY AUTO_INCREMENT,
serial varchar(200) DEFAULT ''
)ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8;
(2) entities
主实体Payment
@Data @AllArgsConstructor @NoArgsConstructor public class Payment implements Serializable {
¨K54K
}
¨G6G
@Data
@AllArgsConstructor
@NoArgsConstructor
public class CommonResult<T> {
private Integer code;
private String message;
private T data;
¨K55K
}
¨G7G
@Mapper
public interface PaymentDao {
¨K56K
}
¨G8G
<?xml version=“1.0” encoding=“UTF-8” ?>
<!DOCTYPE mapper PUBLIC “-//mybatis.org//DTD Mapper 3.0//EN”
“http://mybatis.org/dtd/mybatis-3-mapper.dtd”>
<mapper namespace=“com.jd.springcloud.dao.PaymentDao”>
¨K57K
</mapper>
¨G9G
public interface PaymentService {
¨K58K
}
¨G10G
@Service
public class PaymentServiceImpl implements PaymentService {
¨K59K
}
¨G11G
@RestController
@Slf4j
public class PaymentController {
¨K60K
}
¨G12G
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-devtools</artifactId>
<scope>runtime</scope>
<optional>true</optional>
</dependency>
¨G13G
<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>
¨G14G
<dependencies>
<!-- 引入自己定义的api通用包–>
<dependency>
<groupId>com.jd.springcloud</groupId>
<artifactId>cloud-api-commons</artifactId>
<version>${project.version}</version>
</dependency>
<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.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>
¨G15G
server:
port: 80
¨G16G
@SpringBootApplication
public class OrderMain80 {
¨K61K
}
¨G17G
@Configuration
public class ApplicationContextConfig {
¨K62K
}
¨G18G
@RestController
@Slf4j
public class OrderController {
¨K63K
}
¨G19G
<dependencies>
<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>cn.hutool</groupId>
<artifactId>hutool-all</artifactId>
<version>5.1.0</version>
</dependency>
</dependencies>
¨G20G
¨K21K
<dependency>
<groupId>com.jd.springcloud</groupId>
<artifactId>cloud-api-commons</artifactId>
<version>${project.version}</version>
</dependency>
改造完测试工程
ok 没问题