1.springcloudH版简介及服务工程构建

微服务服务工程构建

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 没问题

5. 目前工程样图