快速搭建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的版本号
4.0.0
org.springframework.boot
spring-boot-starter-parent
2.3.12.RELEASE
com.csdn
springcloud
0.0.1-SNAPSHOT
pom
1.8
UTF-8
UTF- 8
Hoxton.SR8
2.2.3.RELEASE
org.springframework.cloud
spring-cloud-dependencies
${spring-cloud.version}
pom
import
com.alibaba.cloud
spring-cloud-alibaba-dependencies
${spring-cloud-alibaba.version}
pom
import
org.springframework.boot
spring-boot-maven-plugin
注意,springcloud和alibabaversion以及springboot之间的版本号要对应.具体对应的关系见下表:
(2) 建立公共模块微服务
①点击父工程文件右键新建一个Module.
②建立一个maven工程 起名为springcloud-common
③引入依赖(注意是springcloud-common下的pom.xml中的依赖,不是父工程中的pom.xml)
org.projectlombok
lombok
mysql
mysql-connector-java
com.baomidou
mybatis-plus-boot-starter
3.5.2
④在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和实体类工具类)
com.csdn
springcloud-common
0.0.1-SNAPSHOT
org.springframework.boot
spring-boot-starter-web
④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);
}
}
商品微服务模块的工程结构如下图所示:
(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 {
}
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();
}
}订单微服务的工程目录如下图所示:
