阅读 53

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-namecom.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(20NOT NULL PRIMARY KEY AUTO_INCREMENT,
  serial varchar(200DEFAULT ''
)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" "mybatis.org/dtd/mybatis…">

<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. 目前工程样图