转载

SpringBoot的微信点餐系统后台开发要点

项目设计

角色划分

买家（微信端）
卖家（PC端）

功能分析

关系

部署架构

架构和基础框架

演进：单一应用架构->垂直应用架构->分布式服务架构->流动计算架构

国内微服务门派：

阿里系：
- Duboo
- Zookeeper
- SpringMVC or SpringBoot
Spring Cloud系：
- Spring Cloud
- Netfilx Eureka
- SpringBoot

数据库设计

数据库表之间的关系

类目表(product_category)
商品表(product_info)
订单主表(order_master)
订单详情表(order_detail)
卖家信息表(order_detail)

数据库表结构

create table `product_info`(
    `product_id` varchar(32) not null, --企业级的用varchar，自己玩的项目可以用自增的但数量大了可能不够用
    `product_name` varchar(64) not null comment '商品名称',
    `product_price` decimal(8,2) not null comment '单价',
    `product_stock` int not null comment '库存',
    `product_description` varchar(64) comment '描述',
    `product_icon` varchar(512) comment '小图',
    `category_type` int not null comment '类目编号',
    `create_time` timestamp not null default current_timestamp comment '创建时间',
    `update_time` timestamp not null default current_timestamp on update current_timestamp comment '更新时间',  --MYSQL5.7才可以default current_timestamp
    primary key (`product_id`)
) comment '商品表';

create table `product_category`(
    `category_id` int not null auto_increment,  -- 类目不太可能爆多，所以可以自增
    `category_name` varchar(64) not null comment '类目名字',
    `category_type` int not null comment '类目编号',
    `create_time` timestamp not null default current_timestamp comment '创建时间',
    `update_time` timestamp not null default current_timestamp on update current_timestamp comment '更新时间',  --MYSQL5.7才可以default current_timestamp
    primary key (`category_id`)
    unique key `uqe_category_type` (`category_type`) --类目是唯一的
) comment '类目表'

create table `order_master`(
    `order_id` varchar(32) not null,
    `buyer_name` varchar(32) not null comment '买家名字',
    `buyer_phone` varchar(32) not null comment '买家电话',
    `buyer_address` varchar(128) not null comment '买家地址',
    `buyer_openid` varchar(64) not null comment '买家微信openid',
    `order_amount` decimal(8,2) not null comment '订单总金额'，
    `order_status` tinyint(3) not null default '0' comment '订单状态，默认0新下单',
    `pay_status` tinyint(3) not null default '0' comment '支付状态，默认0未支付',
    `create_time` timestamp not null default current_timestamp comment '创建时间',
    `update_time` timestamp not null default current_timestamp on update current_timestamp comment '更新时间',  --MYSQL5.7才可以default current_timestamp
    primary key (`order_id`),
    key `idx_buyer_openid` (`buyer_openid`)
) comment '订单表';

create table `order_detail`(
    `detail_id` varchar(32) not null,
    `order_id` varchar(32) not null,
    `product_id` varchar(32) not null,
    `product_name` varchar(64) not null comment '商品名字',
    `product_price` decimal(8,2) not null comment '商品价格',
    `product_quantity` int not null comment '商品数量'，
    `product_icon` varchar(512) comment '商品小图',
    `create_time` timestamp not null default current_timestamp comment '创建时间',
    `update_time` timestamp not null default current_timestamp on update current_timestamp comment '更新时间',  --MYSQL5.7才可以default current_timestamp
    primary key (`detail_id`),
    key `idx_order_id`(`order_id`)
) comment '订单详情表';

项目起步

日志的使用和配置

选用：logback
配置方式：
- 在application.yml配置
- 在logback-spring.xml logback-spring.xml配置示例

<?xml version="1.0" encoding="UTF-8" ?>
<configuration>
    <appender name="consoleLog" class="ch.qos.logback.core.ConsoleAppender">
        <layout class="ch.qos.logback.classic.PatternLayout">
            <pattern>
                %d - %msg%n
            </pattern>
        </layout>
    </appender>

    <appender name="fileInfoLog" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <level>ERROR</level>
            <onMatch>DENY</onMatch>
            <onMismatch>ACCEPT</onMismatch>
        </filter>
        <encoder>
            <pattern>
                %msg%n
            </pattern>
        </encoder>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>/Users/ztev/tomcat/sell/info.%d.log</fileNamePattern>
        </rollingPolicy>
    </appender>

    <appender name="fileErrorLog" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
            <level>ERROR</level>
        </filter>
        <encoder>
            <pattern>
                %msg%n
            </pattern>
        </encoder>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>/Users/ztev/tomcat/sell/error.%d.log</fileNamePattern>
        </rollingPolicy>
    </appender>

    <root level="info">
        <appender-ref ref="consoleLog"/>
        <appender-ref ref="fileInfoLog"/>
        <appender-ref ref="fileErrorLog"/>
    </root>


</configuration>

买家端开发

买家端类目模块的开发，按照dao->service->api的顺序开发。贯穿单元测试。

SpringBoot JPA把驼峰命名和表映时，小写+下划线，如ProductCategory=product_category

@Entity
public class ProductCategory {

    @Id
    @GeneratedValue
    private Integer categoryId;

    private String categoryName;

    private Integer categoryType;
    ...
}

在测试里增加 @Transactional 就可以回滚插入的测试数据
Getter和Setter方法的快捷实现，配合IDEA的插件lombok

<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
</dependency>

MySQL里的DECIMAL对应java里的BigDecimal
反复用到的类型值如 categoryType 可以定义一个枚举

@Getter
public enum ProductStatusEnum {
    UP(0, "在架"),
    DOWN(1, "下架");

    private Integer code;

    private String message;

    ProductStatusEnum(Integer code, String message) {
        this.code = code;
        this.message = message;
    }
}

项目统一前缀

server:
  context-path: /sell

返回给前端和数据库不同字段的话用 VO ，通过 @JsonProperty 可以起名不一致

@Data
public class ProductVO {

    @JsonProperty("name")
    private String categoryName;

    private Integer type;
}

千万不要把数据库的查询放入for循环，开销巨大，一次性查出来以后再用for循环遍历处理比较合适。
OrderMaster 和 OrderDetail 之间有关联在创建订单的时候，用一个 OrderDTO 的类把他们连接起来
多线程，查库存再扣库存的操作在数据库层面是分两步的，可能存在超卖
Controller里传进来的参数用表单验证注解。

@Data
public class OrderForm {
    @NotEmpty(message = "姓名必填")
    private String name;

    @NotEmpty(message = "手机号必填")
    private String phone;

    @NotEmpty(message = "地址必填")
    private String address;

    @NotEmpty(message = "openid必填")
    private String openid;

    @NotEmpty(message = "购物车不能为空")
    private String items;
}
....

public ResultVO<Map<String, String>> create(@Valid OrderForm orderForm, BindingResult bindingResult) {

如果你的类型在返回给json不一致时，可以用自定义的 JsonSerialize

public class Date2LongSerializer extends JsonSerializer<Date> {
    @Override
    public void serialize(Date date, JsonGenerator jsonGenerator, SerializerProvider serializerProvider) throws IOException, JsonProcessingException {
        jsonGenerator.writeNumber(date.getTime() / 1000);
    }
}

//另一个类

@JsonSerialize(using = Date2LongSerializer.class)
private Date updateTime;

不想把null的传给前端
- 类上用`@JsonInclude(JsonInclude.Include.NON_NULL)
- 你也可以全局配置在 application.yml 上用 jackson:default-property-inclusion:non_null
如果null的情况下想返回空，则在类里的成员变量里用上初始化，如stirng就用""