快速搭建springcloud项目

本文讲述springcloud项目从0开始的搭建过程以及其中需要注意的问题,不涉及具体的理论内容以及微服务项目中的五大问题和具体解决办法的插件或手段.五大问题的具体解决办法在本合集中分别进行逐一讲解

本文模拟了电商项目中的订单微服务模块和商品微服务模块.商品微服务模块只实现一个功能:"通过商品id获取商品信息的功能,返回一个商品对象(product)",订单微服务模块也只实现一个功能:"生成订单",实现该功能需要调用商品微服务模块中的功能.

一. 项目搭建详细步骤

1.技术选型

(1) maven:3.5.0+

(2) MySQL:5.7+

(3) Mybatis-plus

(4) SpringCloud Alibaba

(5)lombok

2.需要准备的内容

(1)数据库

数据库名:springcloud

商品表:shop_product

DROP TABLE IF EXISTS `shop_product`;
CREATE TABLE `shop_product`  (
  `pid` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '商品id',
  `pname` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NULL DEFAULT NULL COMMENT '商品名',
  `pprice` decimal(10, 2) NULL DEFAULT NULL COMMENT '商品价格',
  `stock` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NULL DEFAULT NULL COMMENT '商品库存',
  PRIMARY KEY (`pid`) USING BTREE
) ENGINE = InnoDB AUTO_INCREMENT = 3 CHARACTER SET = utf8mb4 COLLATE = utf8mb4_0900_ai_ci ROW_FORMAT = Dynamic;

订单表:shop_order

DROP TABLE IF EXISTS `shop_order`;
CREATE TABLE `shop_order`  (
  `oid` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '订单id',
  `uid` int(11) NULL DEFAULT NULL COMMENT '用户id',
  `username` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NULL DEFAULT NULL COMMENT '用户名',
  `pid` bigint(20) NULL DEFAULT NULL COMMENT '商品id',
  `pname` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NULL DEFAULT NULL COMMENT '商品名称',
  `pprice` decimal(10, 2) NULL DEFAULT NULL COMMENT '商品价格',
  `number` int(11) NULL DEFAULT NULL COMMENT '购买数量',
  PRIMARY KEY (`oid`) USING BTREE
) ENGINE = InnoDB AUTO_INCREMENT = 239 CHARACTER SET = utf8mb4 COLLATE = utf8mb4_0900_ai_ci ROW_FORMAT = Dynamic;

两张表里的数据随意发挥,不重要.

(2)jdk1.8+idea开发工具

3.模块设计

springcloud-parent                父工程

springcloud-common            公共模块(存放实体类,工具类等)

springcloud-product              商品微服务(端口号:8080~8090)

springcloud-order                  订单微服务(端口号:8090~8099)

4.具体步骤:

(1)创建一个springboot项目  起名为springcloud-parent

①删掉工程中给的src文件

最终该父工程的结构图如下图所示:

注:可能你创建的工程会有很多用不到的文件,比如.ieda,mvn等等.我们可以在设置中隐藏掉这些文件.具体方法可以参考一下连接:idea中隐藏不想看的文件和文件夹_Love_云宝儿的博客-CSDN博客_idea隐藏不想看到的文件1.file--settings2.editor--file types-- ignored files and folder --+3.输入你想要忽略的文件或文件夹名 可以用*通配符比如我想忽略mvn等等 可以这样写完事点击ok 或者点击apply+ok即可非常清爽https://blog.csdn.net/m0_38084879/article/details/123753512②编辑pom.xml文件

• 降低springboot的版本到2.3.12
• 设置父工程打包方式为pom
• 设置具体版本号
• 设置dependencyManagement管理jar的版本号

<?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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.3.12.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.csdn</groupId>
    <artifactId>springcloud</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <!--父工程需要设置打包方式为pom-->
    <packaging>pom</packaging>

    <!--设置具体版本号-->
    <properties>
        <java.version>1.8</java.version>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF- 8</project.reporting.outputEncoding>
        <spring-cloud.version>Hoxton.SR8</spring-cloud.version>
        <spring-cloud-alibaba.version>2.2.3.RELEASE</spring-cloud-alibaba.version>
    </properties>

    <!--
        dependencyManagement:它只负责jar的版本号管理，不负责jar的下载,交于子模块，子模块在使用时无需指定版本号
          :springboot springcloud  springcloudalibaba之间版本一定要匹配
    -->
    <dependencyManagement>
        <dependencies>
            <!--springcloud的版本管理-->
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>${spring-cloud.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
            <!--springcloudalibaba的版本管理-->
            <dependency>
                <groupId>com.alibaba.cloud</groupId>
                <artifactId>spring-cloud-alibaba-dependencies</artifactId>
                <version>${spring-cloud-alibaba.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

 注意,springcloud和alibabaversion以及springboot之间的版本号要对应.具体对应的关系见下表:

(2) 建立公共模块微服务

①点击父工程文件右键新建一个Module.

 ②建立一个maven工程 起名为springcloud-common

 

③引入依赖(注意是springcloud-common下的pom.xml中的依赖,不是父工程中的pom.xml)

<dependencies>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
        </dependency>
        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-boot-starter</artifactId>
            <version>3.5.2</version>
        </dependency>
</dependencies>

④在src下建立实体类包和工具包,将两张表对应的实体类放入对应包下

Product:

package com.csdn.common.entity;

import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import lombok.Data;

@Data
@TableName(value="shop_product")
public class Product {
    @TableId(type= IdType.AUTO)
    private Integer pid;
    private String pname;//商品名称
    private Double pprice;//商品价格
    private Integer stock;//库存
}

Order:

package com.csdn.common.entity;

import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import lombok.Data;

@Data
@TableName("shop_order")
public class Order {
    @TableId(type = IdType.AUTO)
    private Long oid; //订单id
    private Integer uid;//用户id
    private String username;//用户名
    private Integer pid;//商品id
    private String pname;//商品名称
    private Double pprice;//商品价格
    private Integer number;//购买数量
}

 CommonResult:

package com.csdn.common.utils;

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

/**
 * @作者：刘壬杉
 * @创建时间 2022/8/19 19:05
 **/
@Data
@AllArgsConstructor
@NoArgsConstructor
public class CommonResult {
    private Integer code;
    private String msg;
    private Object data;
}

 最终工程结构图如图所示:

(3)建立商品微服务模块

①点击父工程文件右键新建一个Module.

②新建一个maven项目,命名为springcloud-product

③引入依赖,(这里需要引入公共模块服务,从而可以获取其中的jar和实体类工具类)

<dependencies>
        <dependency>
            <groupId>com.csdn</groupId>
            <artifactId>springcloud-common</artifactId>
            <version>0.0.1-SNAPSHOT</version>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
    </dependencies>

④application.properties配置文件的内容

#端口号
server.port=8081

#数据源
spring.datasource.username=root
spring.datasource.password=lrs998563
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.datasource.url=jdbc:mysql://localhost:3306/springcloud?serverTimezone=Asia/Shanghai

#sql日志
mybatis-plus.configuration.log-impl=org.apache.ibatis.logging.stdout.StdOutImpl

⑤dao,service,controller业务的实现

ProductMapper

package com.lrs.product.dao;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.csdn.common.entity.Product;

/**
 * @作者：刘壬杉
 * @创建时间 2022/8/19 19:17
 **/
@Mapper
public interface ProductMapper extends BaseMapper<Product> {
    
}

ProductServiceImpl:

package com.lrs.product.service.impl;

import com.csdn.common.entity.Product;
import com.lrs.product.dao.ProductMapper;
import com.lrs.product.service.ProductService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

/**
 * @作者：刘壬杉
 * @创建时间 2022/8/19 19:21
 **/
@Service
public class ProductServiceImpl implements ProductService {
    @Autowired
    private ProductMapper productMapper;

    @Override
    public Product getById(Integer id) {
        return productMapper.selectById(id);
    }
}

ProductController

package com.lrs.product.controller;

import com.csdn.common.entity.Product;
import com.lrs.product.service.ProductService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

/**
 * @作者：刘壬杉
 * @创建时间 2022/8/19 19:19
 **/
@RestController
@RequestMapping("product")
public class ProductController {
    @Autowired
    private ProductService productService;

    @GetMapping("getById/{id}")
    public Product getById(@PathVariable Integer id){
        return productService.getById(id);
    }
}

⑥添加一个启动类

ProductApp

package com.lrs.product;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

/**
 * @作者：刘壬杉
 * @创建时间 2022/8/19 19:23
 **/
@SpringBootApplication
public class ProductApp {
    public static void main(String[] args) {
        SpringApplication.run(ProductApp.class,args);
    }
}

商品微服务模块的工程结构如下图所示:

(4)建立订单微服务模块

①新建maven工程,命名为springcloud-order

②导入依赖(同商品微服务中的依赖)

③application.properties配置文件(同商品微服务模块,唯一区别:端口号改为8091)

④dao,service,controller业务的实现

OrderMapper:

package com.lrs.order.dao;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.csdn.common.entity.Order;
import org.apache.ibatis.annotations.Mapper;

/**
 * @作者：刘壬杉
 * @创建时间 2022/8/19 19:30
 **/
@Mapper
public interface OrderMapper extends BaseMapper<Order> {
}

 OrderServiceImpl:

这里的业务中需要调用商品微服务中的接口.这就需要用到我们的RestTemplate类,该类可以访问我们其他微服务中的接口内容并接收返回值.

package com.lrs.order.service.impl;

import com.csdn.common.entity.Order;
import com.csdn.common.entity.Product;
import com.csdn.common.utils.CommonResult;
import com.lrs.order.dao.OrderMapper;
import com.lrs.order.service.OrderService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import org.springframework.web.client.RestTemplate;

/**
 * @作者：刘壬杉
 * @创建时间 2022/8/19 19:33
 **/
@Service
public class OrderServiceImpl implements OrderService {
    @Autowired
    private OrderMapper orderMapper;
    @Autowired
    private RestTemplate restTemplate;

    @Override
    public CommonResult saveOrder(Integer pid, Integer num) {
        Order order = new Order();
        order.setUid(1);
        order.setUsername("lrs");
        order.setNumber(num);
        order.setPid(pid);
        Product product = restTemplate.getForObject("http://localhost:8081/getById" + pid, Product.class);
        order.setPname(product.getPname());
        order.setPprice(product.getPprice());
        int insert = orderMapper.insert(order);
        if (insert==1){
            return new CommonResult(2000,"下单成功",null);
        }
        return new CommonResult(5000,"下单失败",null);
    }
}

OrderController:

package com.lrs.order.controller;

import com.csdn.common.utils.CommonResult;
import com.lrs.order.service.OrderService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

/**
 * @作者：刘壬杉
 * @创建时间 2022/8/19 19:38
 **/
@RestController
@RequestMapping("order")
public class OrderController {
    @Autowired
    private OrderService orderService;
    
    @GetMapping("saveOrder/{pid}/{num}")
    public CommonResult saveOrder(@PathVariable Integer pid,@PathVariable Integer num){
        return orderService.saveOrder(pid, num);
    }
}

   RestTemplate类没有交由容器去管理,所以无法自动注入,所以我们需要在启动类或者加了@Configuration注解的类中配置该类交由容器管理.为了方便我直接写在主启动类中

⑤建立启动类

OrderApp

package com.lrs.order;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;
import org.springframework.web.client.RestTemplate;

/**
 * @作者：刘壬杉
 * @创建时间 2022/8/19 19:42
 **/
@SpringBootApplication
public class OrderApp {
    public static void main(String[] args) {
        SpringApplication.run(OrderApp.class,args);
    }
    
    @Bean
    public RestTemplate restTemplate(){
        return new RestTemplate();
    }
}

订单微服务的工程目录如下图所示: