本文讲述springcloud项目从0开始的搭建过程以及其中需要注意的问题,不涉及具体的理论内容以及微服务项目中的五大问题和具体解决办法的插件或手段.五大问题的具体解决办法在本合集中分别进行逐一讲解
本文模拟了电商项目中的订单微服务模块和商品微服务模块.商品微服务模块只实现一个功能:"通过商品id获取商品信息的功能,返回一个商品对象(product)",订单微服务模块也只实现一个功能:"生成订单",实现该功能需要调用商品微服务模块中的功能.
(1) maven:3.5.0+
(2) MySQL:5.7+
(3) Mybatis-plus
(4) SpringCloud Alibaba
(5)lombok
数据库名: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;
两张表里的数据随意发挥,不重要.
springcloud-parent 父工程
springcloud-common 公共模块(存放实体类,工具类等)
springcloud-product 商品微服务(端口号:8080~8090)
springcloud-order 订单微服务(端口号:8090~8099)
①删掉工程中给的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文件
- "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.0modelVersion>
- <parent>
- <groupId>org.springframework.bootgroupId>
- <artifactId>spring-boot-starter-parentartifactId>
- <version>2.3.12.RELEASEversion>
- <relativePath/>
- parent>
- <groupId>com.csdngroupId>
- <artifactId>springcloudartifactId>
- <version>0.0.1-SNAPSHOTversion>
-
- <packaging>pompackaging>
-
-
- <properties>
- <java.version>1.8java.version>
- <project.build.sourceEncoding>UTF-8project.build.sourceEncoding>
- <project.reporting.outputEncoding>UTF- 8project.reporting.outputEncoding>
- <spring-cloud.version>Hoxton.SR8spring-cloud.version>
- <spring-cloud-alibaba.version>2.2.3.RELEASEspring-cloud-alibaba.version>
- properties>
-
-
- <dependencyManagement>
- <dependencies>
-
- <dependency>
- <groupId>org.springframework.cloudgroupId>
- <artifactId>spring-cloud-dependenciesartifactId>
- <version>${spring-cloud.version}version>
- <type>pomtype>
- <scope>importscope>
- dependency>
-
- <dependency>
- <groupId>com.alibaba.cloudgroupId>
- <artifactId>spring-cloud-alibaba-dependenciesartifactId>
- <version>${spring-cloud-alibaba.version}version>
- <type>pomtype>
- <scope>importscope>
- dependency>
- dependencies>
- dependencyManagement>
-
- <build>
- <plugins>
- <plugin>
- <groupId>org.springframework.bootgroupId>
- <artifactId>spring-boot-maven-pluginartifactId>
- plugin>
- plugins>
- build>
-
- project>
注意,springcloud和alibabaversion以及springboot之间的版本号要对应.具体对应的关系见下表:

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

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

③引入依赖(注意是springcloud-common下的pom.xml中的依赖,不是父工程中的pom.xml)
- <dependencies>
- <dependency>
- <groupId>org.projectlombokgroupId>
- <artifactId>lombokartifactId>
- dependency>
- <dependency>
- <groupId>mysqlgroupId>
- <artifactId>mysql-connector-javaartifactId>
- dependency>
- <dependency>
- <groupId>com.baomidougroupId>
- <artifactId>mybatis-plus-boot-starterartifactId>
- <version>3.5.2version>
- 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;
- }
最终工程结构图如图所示:

①点击父工程文件右键新建一个Module.
②新建一个maven项目,命名为springcloud-product
③引入依赖,(这里需要引入公共模块服务,从而可以获取其中的jar和实体类工具类)
- <dependencies>
- <dependency>
- <groupId>com.csdngroupId>
- <artifactId>springcloud-commonartifactId>
- <version>0.0.1-SNAPSHOTversion>
- dependency>
- <dependency>
- <groupId>org.springframework.bootgroupId>
- <artifactId>spring-boot-starter-webartifactId>
- 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
{ -
- }
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);
- }
- }
商品微服务模块的工程结构如下图所示:

①新建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
{ - }
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();
- }
- }
订单微服务的工程目录如下图所示:
