idea聚合工程搭建过程详解

注:本篇文章主要参考周阳老师讲解的cloud进行整理的!

前言

本章主要以order订单服务来远程调用payment支付服务为例,当然这里只是简单的一个远程调用,没有太复杂的逻辑,重点是要掌握的是maven的聚合工程搭建,微服务分模块的思想,每一个步骤我都会详细记录,并且文章下方还提供了git源码地址!

idea聚合工程搭建过程详解_第1张图片

最后要实现的代码结构:

idea聚合工程搭建过程详解_第2张图片

框架:mybatis-plus3.4 + springboot2.2.5 + mysql + springcloud的H版本 + spring-cloud-alibaba2.1.0 + maven

本章并不会用到springcloud相关组件,只是在父工程声明了版本!

一、创建父工程

1、New Project

idea聚合工程搭建过程详解_第3张图片

2、聚合父工程的名字

idea聚合工程搭建过程详解_第4张图片

3、指定maven仓库

idea聚合工程搭建过程详解_第5张图片

4、字符编码

idea聚合工程搭建过程详解_第6张图片

5、注解生效激活

idea聚合工程搭建过程详解_第7张图片

6、java编译版本选8

idea聚合工程搭建过程详解_第8张图片

7、File Type过滤

idea聚合工程搭建过程详解_第9张图片

8、父工程POM

约定 > 配置 > 编码



    4.0.0

    com.gzl.cn
    mscloudpom
    1.0-SNAPSHOT

    
        cloud-provider-payment8001
    

    
    
        UTF-8
        1.8
        1.8
        4.12
        1.2.17
        1.16.18
        5.1.47
        1.1.16
        3.4.0
   

    
    
       
           
           
               org.springframework.boot
               spring-boot-dependencies
               2.2.2.RELEASE
               pom
               import
           
           
           
               org.springframework.cloud
               spring-cloud-dependencies
               Hoxton.SR1
               pom
               import
           
           
           
               com.alibaba.cloud
               spring-cloud-alibaba-dependencies
               2.1.0.RELEASE
               pom
               import
           
           
               mysql
               mysql-connector-java
               ${mysql.version}
           
           
               com.alibaba
               druid
               ${druid.version}
           
           
                com.baomidou
                mybatis-plus-boot-starter
                ${mybatis-plus.boot.version}
           
           
               junit
               junit
               ${junit.version}
           
           
               log4j
               log4j
               ${log4j.version}
           
           
               org.projectlombok
               lombok
               ${lombok.version}
               true
           
       
   


   
       
            
                org.apache.maven.plugins
                maven-surefire-plugin
                
                
                    true
                
            
        
    


关于maven依赖 ${xxx.version}报错问题:不用管他,当我们有了子项目之后,这里就不报错了。

idea聚合工程搭建过程详解_第10张图片

二、Maven工程细节复习

Maven 使用dependencyManagement 元素来提供了一种管理依赖版本号的方式。
通常会在一个组织或者项目的最顶层的父POM 中看到dependencyManagement 元素。

作用: pom.xml 中的dependencyManagement 元素能让所有在子项目中引用一个依赖而不用显式的列出版本号。 Maven 会沿着父子层次向上走,直到找到一个拥有dependencyManagement 元素的项目,然后它就会使用这个dependencyManagement 元素中指定的版本号。

例如在父项目里:xml代码


   
	   
		   mysql
		   mysql-connector-java
		   5.1.47
	   
   

然后在子项目里就可以添加mysql-connector时可以不指定版本号,例如:xml代码


	
		mysql
		mysql-connector-java
	

好处: 如果有多个子项目都引用同一样依赖,则可以避免在每个使用的子项目里都声明一个版本号,这样当想升级或切换到另一个版本时,只需要在顶层父容器里更新,而不需要一个一个子项目的修改 ;另外如果某个子项目需要另外的一个版本,只需要声明version就可以。

注意:

  • dependencyManagement里只是声明依赖,并不实现引入,因此子项目需要显示的声明需要用的依赖。
  • 如果不在子项目中声明依赖,是不会从父项目中继承下来的;只有在子项目中写了该依赖项,并且没有指定具体版本,
  • 才会从父项目中继承该项,并且version和scope都读取自父pom;
  • 如果子项目中指定了版本号,那么会使用子项目中指定的jar版本。
  • 父工程创建完成执行mvn:install将父工程发布到仓库方便子工程继承

三、创建子工程

1、微服务提供者支付Module模块

创建过后的项目结构:

idea聚合工程搭建过程详解_第11张图片

(1)、删掉无用的文件

idea聚合工程搭建过程详解_第12张图片

(2)、创建cloud-provider-payment8001项目

右键项目-》new-》Module

idea聚合工程搭建过程详解_第13张图片

(3)、改pom



mscloudcom.gzl.cn1.0-SNAPSHOT
    4.0.0

    cloud-provider-payment8001

    
        8
        8
    

    
        
            org.springframework.boot
            spring-boot-starter-web
        
        
            org.springframework.boot
            spring-boot-starter-actuator
        
        
            com.baomidou
            mybatis-plus-boot-starter
        
        
            com.alibaba
            druid-spring-boot-starter
            1.1.10
        
        
        
            mysql
            mysql-connector-java
        
        
        
            org.springframework.boot
            spring-boot-starter-jdbc
        
        
            org.projectlombok
            lombok
            true
        
        
            org.springframework.boot
            spring-boot-starter-test
            test
        
    


(4)、写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/db2022?useUnicode=true&characterEncoding=utf-8&useSSL=false
    username: root
    password: root

# mybatis-plus配置打印sql日志
mybatis-plus:
  configuration:
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl

(5)、创建表

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

(6)、创建启动类

@SpringBootApplication
@MapperScan("com.gzl.cn.mapper")
public class PaymentMain8001 {
    public static void main(String[] args) {
        SpringApplication.run(PaymentMain8001.class, args);
    }
}

(7)、创建实体类

@Data
@AllArgsConstructor
@NoArgsConstructor
@TableName("payment")
public class Payment implements Serializable {

    @TableId(value = "id", type = IdType.AUTO)
    private Long id;

    @TableField(value = "serial")
    private String serial;
}

这个类用于作为controller统一接口返回参数类

@Data
@AllArgsConstructor
@NoArgsConstructor
public class CommonResult {
    private Integer code;
    private String message;
    private T data;

    public CommonResult(Integer code, String message) {
        this(code, message, null);
    }
}

(8)、创建mapper类

@Repository
public interface PaymentMapper extends BaseMapper {
}

(9)、创建controller类

@RestController
@Slf4j
public class PaymentController {

    @Autowired
    private PaymentMapper paymentMapper;

    @PostMapping(value = "/payment/create")
    public CommonResult create(@RequestBody Payment payment) {
        int result = paymentMapper.insert(payment);
        log.info("*****插入操作返回结果:" + result);

        if (result > 0) {
            return new CommonResult(200, "插入数据库成功", result);
        } else {
            return new CommonResult(444, "插入数据库失败", null);
        }
    }

    @GetMapping(value = "/payment/get/{id}")
    public CommonResult getPaymentById(@PathVariable("id") Long id) {
        Payment payment = paymentMapper.selectById(id);
        log.info("*****查询结果:{}", payment);
        if (payment != null) {
            return new CommonResult(200, "查询成功", payment);
        } else {
            return new CommonResult(444, "没有对应记录,查询ID: " + id, null);
        }
    }
}

(10)、测试一下两个接口,确保接口可以正常访问

2、微服务消费者订单Module模块

创建过后的项目结构:

idea聚合工程搭建过程详解_第14张图片

(1)、创建cloud-provider-payment8001项目
(2)、改pom(pom跟上个model的pom一样就行)
(3)、写yml(跟上面的model也一样,端口不一样,名称不一样)

 server:
  port: 80
spring:
  application:
    name: cloud-order-service

(4)、主启动
(5)、创建配置类,远程调用我用的RestTemplate,所以这个配置类主要就是把RestTemplate注入到容器

@Configuration
public class ApplicationContextConfig {
   @Bean
   public RestTemplate restTemplate() {
       return new RestTemplate();
   }
}

(6)、创建实体类(跟上个服务的实体类一模一样)
(7)、创建controller

@RestController
public class OrderController {
    public static final String PaymentSrv_URL = "http://localhost:8001";
    @Autowired
    private RestTemplate restTemplate;
    @GetMapping("/consumer/payment/create") //客户端用浏览器是get请求,但是底层实质发送post调用服务端8001
    public CommonResult create(Payment payment) {
        return restTemplate.postForObject(PaymentSrv_URL + "/payment/create", payment, CommonResult.class);
    }

    @GetMapping("/consumer/payment/get/{id}")
    public CommonResult getPayment(@PathVariable Long id) {
        return restTemplate.getForObject(PaymentSrv_URL + "/payment/get/" + id, CommonResult.class, id);
    }
}

(8)、测试接口

3、创建common共用

(1)、观察问题,我们可以创建一个model来专门存放公用的 entity 或者 util 等等,甚至共用的pom依赖我们都可以放到这个里面来。

假如要是存放公用的依赖一定要注意点,例如mysql的依赖,一旦放到公共的model里面,那也就是意味着只要是web的模块引入了公用model,就需要配置mysql,否则项目启动就会报错!所以向model存放公用依赖的时候一定要慎重!

idea聚合工程搭建过程详解_第15张图片

(2)、新建cloud-api-common
(3)、创建pom


	
    
        org.projectlombok
        lombok
        true
    
    
        cn.hutool
        hutool-all
        5.1.0
    
    
    
         com.baomidou
         mybatis-plus-annotation
         3.4.0
         compile
     

(4)、将entity放到这个项目当中
(5)、maven命令clean install一下,或者可以在这里clean install

idea聚合工程搭建过程详解_第16张图片

clean install就是打成jar包放到我们的maven本地仓库当中,然后我们别的项目就可以通过坐标来引用他。

(6)、删除各自的原先有过的entity文件夹
(7)、添加依赖,在8001和80的model当中添加,让他引入我们自己的common


    com.gzl.cn
    cloud-api-common
    ${project.version}

创建过后的项目结构:

idea聚合工程搭建过程详解_第17张图片

git源码:https://gitee.com/gzl_com/spring-cloud.git

到此这篇关于idea聚合工程搭建详解的文章就介绍到这了,更多相关idea聚合工程内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

你可能感兴趣的:(idea聚合工程搭建过程详解)