SpringBoot 项目实战 ~ 1. 项目介绍及基础搭建

GROW 模型： 目标（Goal）、现状（Reality）、方案（Options）、行动&决心（Way Forward & Will）

一、项目介绍

1. 原型展示

2. 技术选型

3. 功能模块

• 前端： 登录、地址管理、订单、菜单管理、购物车、下单、菜品浏览
• 后端： 登录、退出、员工管理、订单管理、分类管理、菜品管理、套餐管理、菜品口味管理
  
  

---

二、创建项目

1. IDEA新建项目（mac 系统）

• 名称： reggie_tack_out
• 位置： （确保无中文路径）
• 语言： Java
• 构建系统： Maven
• JDK： 博主这里选择的是 18，可以按自己习惯

2. 创建数据库（Navicat）

⑴. 链接本地数据库

说明： 这里用的是可视化 Navicar 方法来创建数据库，也可以使用 SQL 语句来进行创建

• 连接名： 自定义名称
• 主机名： localhost（使用本地数据库）
• 端口号、用户名： 用默认即可
• 密码： Navicat 设置的密码

⑵. 导入数据表

数据表资源（数据模型/db_reggie.sql）： https://gitee.com/yuan0_0/reggie_resourcer.git

流程： Navicat -> localhost -> 右键（运行 SQL 文件） -> 数据模型（xx.sql文件）

⑶. 项目配置文件

编辑 pom.xml 文件：

<?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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <!--    继承 springboot 父工程-->
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.4.5</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>org.example</groupId>
    <artifactId>reggie_tack_out</artifactId>
    <version>1.0-SNAPSHOT</version>

    <!--    指定 JDK 版本-->
    <properties>
        <java.version>1.8</java.version>
    </properties>

    <!--    项目依赖的 jar 包-->
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
            <scope>compile</scope>
        </dependency>

        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-boot-starter</artifactId>
            <version>3.4.2</version>
        </dependency>

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

        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>fastjson</artifactId>
            <version>1.2.76</version>
        </dependency>

        <dependency>
            <groupId>commons-lang</groupId>
            <artifactId>commons-lang</artifactId>
            <version>2.6</version>
        </dependency>

        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <scope>runtime</scope>
        </dependency>

        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>druid-spring-boot-starter</artifactId>
            <version>1.1.23</version>
        </dependency>

    </dependencies>

    <!--    项目依赖的插件-->
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <version>2.4.5</version>
            </plugin>
        </plugins>
    </build>

</project>

⑷. SpringBoot配置文件

新建 src/main/resources/application.yml 文件：

# Spring Boot配置文件
server:
  port: 8080
spring:
  application:
    name: reggie_take_out
  datasource:
    druid:
      driver-class-name: com.mysql.cj.jdbc.Driver
      url: jdbc:mysql://localhost:3306/reggie?serverTimezone=Asia/Shanghai&useUnicode=true&characterEncoding=utf-8&zeroDateTimeBehavior=convertToNull&useSSL=false&allowPublicKeyRetrieval=true
      username: root
      password: root
mybatis-plus:
  configuration:
    #在映射实体或者属性时，将数据库中表名和字段名中的下划线去掉，按照驼峰命名法映射
    map-underscore-to-camel-case: true
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
  global-config:
    db-config:
      id-type: ASSIGN_ID

⑷. 导入前端资源

前端资源（前端资源/ backend + front）： https://gitee.com/yuan0_0/reggie_resourcer.git

导入静态资源文件：src/main/resources/bacnend 、src/main/resources/front

⑸. 配置静态资源映射关系

新建 src/main/java/com/reggie/config/WebMvcConfig 类：

//配置静态资源的映射
package com.reggie.config;

import lombok.extern.slf4j.Slf4j;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurationSupport;

@Slf4j
@Configuration
public class WebMvcConfig extends WebMvcConfigurationSupport {
    /**
     * 设置静态资源映射
     * @param registry
     */
    @Override
    protected void addResourceHandlers(ResourceHandlerRegistry registry) {
        // 设置日志，方便调试
        log.info("开始进入静态资源映射...");
        registry.addResourceHandler("/backend/**").addResourceLocations("classpath:/backend/");
        registry.addResourceHandler("/front/**").addResourceLocations("classpath:/front/");
    }
}

⑹. 启动类

新建 src/main/java/com/reggie/ReggieApplication 类：

//启动类
package com.reggie;

import lombok.extern.slf4j.Slf4j;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@Slf4j
@SpringBootApplication
public class ReggieApplication {
    public static void main(String[] args) {
        SpringApplication.run(ReggieApplication.class, args);
        log.info("项目启动成功...");
    }
}

⑺. 启动项目

浏览器路径： http://localhost:8080/backend/index.html

---

三、基础结构搭建

1. 实体类

新建 src/main/java/com/reggie/entity/Employee 类：

package com.reggie.entity;

import com.baomidou.mybatisplus.annotation.FieldFill;
import com.baomidou.mybatisplus.annotation.TableField;
import lombok.Data;
import java.io.Serializable;
import java.time.LocalDateTime;

/**
 * 员工实体
 */

@Data
public class Employee implements Serializable {

    private static final long serialVersionUID = 1L;

    private Long id;

    private String username;

    private String name;

    private String password;

    private String phone;

    private String sex;

    private String idNumber;

    private Integer status;

    private LocalDateTime createTime;

    private LocalDateTime updateTime;

    @TableField(fill = FieldFill.INSERT)
    private Long createUser;

    @TableField(fill = FieldFill.INSERT_UPDATE)
    private Long updateUser;

}

2. 控制器

新建 src/main/java/com/reggie/controller/EmployeeController 类：

package com.reggie.controller;

import com.reggie.common.R;
import com.reggie.entity.Employee;
import com.reggie.service.EmployeeService;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@Slf4j
@RestController
@RequestMapping("/employee")
public class EmployeeController {
    @Autowired
    private EmployeeService employeeService;
}

3. 映射接口

新建 src/main/java/com/reggie/mapper/EmployeeMapper 接口：

package com.reggie.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.reggie.entity.Employee;
import org.apache.ibatis.annotations.Mapper;

@Mapper
public interface EmployeeMapper extends BaseMapper<Employee> {
}

4. 服务接口

新建 src/main/java/com/reggie/service/EmployeeService 接口：

package com.reggie.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.reggie.entity.Employee;

public interface EmployeeService extends IService<Employee> {
}

5. 服务器实现类

新建 src/main/java/com/reggie/service/impl/EmployeeServiceImpl 类：

package com.reggie.service.impl;

import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.reggie.entity.Employee;
import com.reggie.mapper.EmployeeMapper;
import com.reggie.service.EmployeeService;
import org.springframework.stereotype.Service;

@Service
public class EmployeeServiceImpl extends ServiceImpl<EmployeeMapper, Employee> implements EmployeeService {
}

6. 公共类

新建 src/main/java/com/reggie/common/R 类：

package com.reggie.common;

import lombok.Data;
import java.util.HashMap;
import java.util.Map;

/**
 * 通过返回结果类，服务端相应的数据都会封装成此对象
 * @param <T>
 */

@Data
public class R<T> {

    private Integer code; //编码：1成功，0和其它数字为失败

    private String msg; //错误信息

    private T data; //数据

    private Map map = new HashMap(); //动态数据

    public static <T> R<T> success(T object) {
        R<T> r = new R<T>();
        r.data = object;
        r.code = 1;
        return r;
    }

    public static <T> R<T> error(String msg) {
        R r = new R();
        r.msg = msg;
        r.code = 0;
        return r;
    }

    public R<T> add(String key, Object value) {
        this.map.put(key, value);
        return this;
    }
}