百木园-与人分享,
就是让自己快乐。

day01-项目介绍和功能实现

项目练习01

1.项目介绍

这是一个简单的项目练习,用于掌握新学习的SpringBoot技术。

  • 项目操作界面

image-20230326161555846

● 技术栈

Vue3+ElementPlus+Axios+MyBatisPlus+SpringBoot 前后端分离

前后端分离开发,前端主体框架 Vue3 + 后端基础框架 SpringBoot

  1. 前端技术栈:Vue3+Axios+ElementPlus
  2. 后端技术栈:Spring Boot + MyBatisPlus
  3. 数据库-MySQL
  4. 项目的依赖管理-Maven
  5. 分页-MyBatis Plus 的分页插件

2.功能01-搭建Vue前端工程

2.1代码实现

以下过程,前面在讲解SSM_VUE项目时已经安装过了,包括整个vue项目的创建过程、项目结构,具体看SSM整合day02的功能01实现的笔记

  1. 先下载node.js LTS 并安装node.js的npm,用于管理前端项目包依赖

  2. 创建Vue项目(需要联网)

    1)创建项目,指令vue create <项目名>

    2)选择 Manually select features

    3)用空格键选择Bebel、Router、Vuex

    4)选择3.x

    5)Use history mode for router? 输入Y,回车

    6)Where do you prefer placing config for Babel, ESLint, etc.? 选择In package. json

    7)Save this as a preset for future projects? (y/N) 是否要保存当前的设置,根据你意思随意选择,如果选择了的话会有 Save preset as: 让你命名当前保存的设置

    8)最后回车

    image-20230326164141911

    9)创建完毕的显示结果如下

    image-20230326164616871

  3. 使用idea打开刚创建的vue项目,并配置项目启动

    1)点击配置Configuration,配置npm方式启动项目

    2)选择serve,其他保持默认,保存

    image-20230326170248081

    3)点击运行,即可在提示的地址访问项目

    image-20230326170347230

  4. 停止项目,安装element-plus插件,在项目中运行指令npm install element-plus --save

    image-20230326171014729

  5. 在vue.config.js中修改项目的端口,防止端口占用

module.exports = {
    devServer: {
        port: 10000//启动端口
    }
}

3.功能02-创建项目基础界面

这个功能步骤在ssm整合框架day01-功能02中也有详细描述,这里不再赘述

3.1需求分析

页面原型:

image-20230326161555846

3.2思路分析

使用vue3+ElementPlus完成

3.3代码实现

(1)修改Home.vue,引入表单、搜索框、按钮组件

<template>
  <div>
    <div style=\"margin: 10px 0\">
      <el-button type=\"primary\">新增</el-button>
      <el-button>其它</el-button>
    </div>
    <!--搜索-->
    <div style=\"margin: 10px 0\">
      <el-input v-model=\"search\" placeholder=\" 请 输 入 关 键 字 \" style=\"width:30%\"></el-input>
      <el-button style=\"margin-left: 10px\" type=\"primary\">查询</el-button>
    </div>
    <el-table :data=\"tableData\" stripe style=\"width: 100%\">
      <el-table-column sortable prop=\"date\" label=\"日期\"></el-table-column>
      <el-table-column prop=\"name\" label=\"姓名\"></el-table-column>
      <el-table-column prop=\"address\" label=\"地址\"></el-table-column>
      <el-table-column fixed=\"right\" label=\"操作\" width=\"100\">
        <template #default=\"scope\">
          <el-button @click=\"handleEdit(scope.row)\" type=\"text\">编辑</el-button>
          <el-button type=\"text\">删除</el-button>
        </template>
      </el-table-column>
    </el-table>
  </div>
</template>
<script>
export default {
  name: \'HomeView\',
  components: {
  },
  data() {
    return {
      search : \'\',
      tableData: [{
        date: \'2016-05-02\',
        name: \'王小虎\',
        address: \'上海市普陀区金沙江路 1518 弄\',
      },
        {
          date: \'2016-05-04\',
          name: \'王小虎\',
          address: \'上海市普陀区金沙江路 1517 弄\',
        },
        {
          date: \'2016-05-01\',
          name: \'王小虎\',
          address: \'上海市普陀区金沙江路 1519 弄\',
        }
      ]
    }
  },
  methods: {
    handleEdit() {
    }
  }
}
</script>

(2)删除HelloWorld.vue组件

(3)创建components/Header.vue

(4)创建全局的global.css(src/assets/css/global.css),以后有全局样式可以放在这里

* {
    margin: 0;
    padding: 0;
    box-sizing: border-box;
}

(5)修改src/main.js,引入global.css,同时引入ElementPlus,顺便国际化

import {createApp} from \'vue\'
import App from \'./App.vue\'
import router from \'./router\'
import store from \'./store\'
//引入css
import \'@/assets/css/global.css\'

//引入ElementPlus
import ElementPlus from \'element-plus\'
import \'element-plus/dist/index.css\'
//国际化
import zhCn from \'element-plus/es/locale/lang/zh-cn\'

createApp(App).use(store).use(router).use(ElementPlus, {locale: zhCn}).mount(\'#app\')

(6)Header.vue,引入ElementPlus组件的下拉框

<template>
  <div style=\"height: 50px; line-height: 50px; border-bottom: 1px solid #ccc; display:flex\">
    <div style=\"width: 200px; padding-left: 30px;
    font-weight: bold; color: dodgerblue\">后台管理
    </div>
    <div style=\"flex: 1\"></div>
    <div style=\"width: 100px\">
      <el-dropdown>
        <span class=\"el-dropdown-link\" style=\"padding: 18px\">
          tom<i class=\"el-icon-arrow-down el-icon--right\"></i>
        </span>
        <template #dropdown>
          <el-dropdown-menu>
            <el-dropdown-item>个人信息</el-dropdown-item>
            <el-dropdown-item>退出登录</el-dropdown-item>
          </el-dropdown-menu>
        </template>
      </el-dropdown>
    </div>
  </div>
</template>
<script>
export default {
  name: \"Header\"
}
</script>
<style scoped>
</style>

image-20230326180733797

(7)创建侧边栏组件Aside.vue,引入导航菜单组件

<template>
  <div>
    <!--说明-先去掉这两个方法, 否则会报错-->
    <!--@open=\"handleOpen\"-->
    <!--@close=\"handleClose\"-->
    <el-menu
        style=\"width: 200px\"
        default-active=\"2\"
        class=\"el-menu-vertical-demo\">
      <el-sub-menu index=\"1-4\">
        <template #title>选项 4</template>
        <el-menu-item index=\"1-4-1\">选项 1</el-menu-item>
      </el-sub-menu>
      <el-menu-item index=\"2\">
        <i class=\"el-icon-menu\"></i>
        <template #title>导航二</template>
      </el-menu-item>
      <el-menu-item index=\"3\" disabled>
        <i class=\"el-icon-document\"></i>
        <template #title>导航三</template>
      </el-menu-item>
      <el-menu-item index=\"4\">
        <i class=\"el-icon-setting\"></i>
        <template #title>导航四</template>
      </el-menu-item>
    </el-menu>
  </div>
</template>
<script>
export default {
  name: \"Aside\"
}
</script>
<style scoped>
</style>

(8)在App.vue将页面分成三部分

<template>
  <div>
    <!--头部-->
    <Header/>
    <!--主体-->
    <div style=\"display: flex\">
      <!--侧边栏-->
      <Aside/>
      <!--内容区域,表格, 这个部分是从 HomeView.vue 组件来的-->
      <router-view style=\"flex: 1\"/>
    </div>
  </div>
</template>
<style>
</style>
<script>
import Header from \"@/components/Header\";
import Aside from \"@/components/Aside\";

export default {
  name: \"Layout\",
  components: {
    Header,
    Aside
  }
}
</script>

(9)项目的基本页面如下:

image-20230327202052299

4.功能03-创建SpringBoot后端项目

4.1需求分析

项目前后端分离情况如下:分成两个子项目(前端和后端),现在来完成后端的子项目创建。

4.2代码实现

(1)创建maven项目,引入需要的依赖

<!--导入SpringBoot父工程-->
<parent>
    <artifactId>spring-boot-starter-parent</artifactId>
    <groupId>org.springframework.boot</groupId>
    <version>2.5.3</version>
</parent>

<dependencies>
    <!--web starter-->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
        <version>2.5.3</version>
    </dependency>
    <!--mysql驱动-->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.26</version>
    </dependency>
    <!--配置处理器-->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-configuration-processor</artifactId>
    </dependency>
    <!--lombok-->
    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
    </dependency>
    <!--test starter-->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
    </dependency>
    <!--druid依赖-->
    <dependency>
        <groupId>com.alibaba</groupId>
        <artifactId>druid</artifactId>
        <version>1.1.17</version>
    </dependency>
    <!--mybatis-plus starter-->
    <dependency>
        <groupId>com.baomidou</groupId>
        <artifactId>mybatis-plus-boot-starter</artifactId>
        <version>3.4.3</version>
    </dependency>
</dependencies>

(2)application.yml中配置port和配置DB连接信息

server:
  port: 9090
spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/springboot_furn?useSSL=true&useUnicode=true&characterEncoding=UTF-8
    username: root
    password: 123456

(3)主程序

@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

测试启动,运行成功:

image-20230327203807752

(4)配置数据源

package com.li.furn.config;

import com.alibaba.druid.pool.DruidDataSource;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import javax.sql.DataSource;

/**
 * @author 李
 * @version 1.0
 */
@Configuration
public class DruidInitConfig {
    @ConfigurationProperties(\"spring.datasource\")
    @Bean
    public DataSource getDataSource(){
        DruidDataSource druidDataSource = new DruidDataSource();
        return druidDataSource;
    }
}

5.功能04-添加家居信息

5.1需求分析

在前端点击添加家居,弹出一个对话框,可以让我们填写家居的数据,填完之后点击确定,可以将数据发送到后端,然后保存到数据库表中。

5.2思路分析

  1. 完成后台代码从mapper->service->controller,并第每层代码进行测试,到controller这一层,使用postman发送http请求完成测试。

  2. 完成前台代码,使用axios发送json数据给后台,实现添加家居信息

5.3代码实现

5.3.1创建数据库和表

-- 创建数据库
DROP DATABASE IF EXISTS springboot_furn;
CREATE DATABASE springboot_furn;
USE springboot_furn;

-- 创建表
CREATE TABLE furn(
`id` INT(11) PRIMARY KEY AUTO_INCREMENT,#id
`name` VARCHAR(64) NOT NULL,#家居名
`maker` VARCHAR(64) NOT NULL,#厂商
`price` DECIMAL(11,2) NOT NULL,#价格
`sales` INT(11) NOT NULL,#销量
`stock` INT(11) NOT NULL#库存
)CHARSET=utf8;

image-20230327204908681

5.3.2工具类

(2)创建 com/li/furn/util/Result.java,该工具类用于返回结果(json 格式)

package com.li.furn.util;

/**
 * @author 李
 * @version 1.0
 */
public class Result<T> {
    private String code;//状态码 200-success 400-fail
    private String msg;//状态说明
    private T data;//返回的数据,使用泛型

    public Result() {
    }

    public Result(T data) {
        this.data = data;
    }

    //返回需要的result对象,表示成功
    public static Result success() {
        Result result = new Result<>();
        result.setCode(\"200\");
        result.setMsg(\"success\");
        return result;
    }

    //返回成功的result对象,表示成功,同时携带数据
    //如果需要在static方法中使用泛型,需要在static关键字后添加<T>
    public static <T> Result<T> success(T data) {
        Result<T> result = new Result<>(data);
        result.setCode(\"200\");
        result.setMsg(\"success\");
        return result;
    }

    //返回需要的result对象-表示失败
    //因为失败的原因有很多中,因此直接将其作为参数传进来
    public static Result error(String code, String msg) {
        Result result = new Result<>();
        result.setCode(code);
        result.setMsg(msg);
        return result;
    }

    //返回成功的result对象,表示失败,同时携带数据
    public static <T> Result<T> error(String code, String msg, T data) {
        Result<T> result = new Result<>(data);
        result.setCode(code);
        result.setMsg(msg);
        return result;
    }

    public String getCode() {
        return code;
    }

    public void setCode(String code) {
        this.code = code;
    }

    public String getMsg() {
        return msg;
    }

    public void setMsg(String msg) {
        this.msg = msg;
    }

    public T getData() {
        return data;
    }

    public void setData(T data) {
        this.data = data;
    }
}

5.3.3bean层

创建furn表映射的bean--Furn.java

package com.li.furn.bean;

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

/**
 * @author 李
 * @version 1.0
 */
@Data
@NoArgsConstructor
@AllArgsConstructor
public class Furn {
    private Integer id;
    private String name;
    private String maker;
    private double price;
    private Integer sales;
    private Integer stock;
}

5.3.4mapper层

创建funMapper.java接口

package com.li.furn.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.li.furn.bean.Furn;
import org.apache.ibatis.annotations.Mapper;

/**
 * @author 李
 * @version 1.0
 * 如果是MyBatisPlus,FurnMapper接口可以通过mp提供的BaseMapper接口来扩展功能
 */
//@Mapper 这里如果没有添加mapper注解,可以在主程序中指定扫描
public interface FurnMapper extends BaseMapper<Furn> {
}

如果使用@MapperScan(basePackages = \"xxx\") ,需要指定到确切的包

测试FurnMapper接口

package com.li.furn;

import com.li.furn.bean.Furn;
import com.li.furn.mapper.FurnMapper;
import org.junit.jupiter.api.Test;
import org.springframework.boot.test.context.SpringBootTest;

import javax.annotation.Resource;

/**
 * @author 李
 * @version 1.0
 */
//注意,测试时,如果测试的类和对应源码中的类的包名不同,需要手动指定
@SpringBootTest
public class FurnMapperTest {
    //装配FurnMapper对象(实际上是该接口的代理对象)
    @Resource
    private FurnMapper furnMapper;

    @Test
    public void furnMapperTest() {
        Furn furn = furnMapper.selectById(1);
        System.out.println(\"furn=\" + furn);
    }
}

测试结果:

image-20230327214046416

5.3.5service层

FurnService接口:

package com.li.furn.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.li.furn.bean.Furn;

/**
 * @author 李
 * @version 1.0
 */

public interface FurnService extends IService<Furn> {
}

FurnServiceImpl实现类:

package com.li.furn.service.impl;

import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.li.furn.bean.Furn;
import com.li.furn.mapper.FurnMapper;
import com.li.furn.service.FurnService;
import org.springframework.stereotype.Service;

/**
 * @author 李
 * @version 1.0
 */
@Service
public class FurnServiceImpl
        extends ServiceImpl<FurnMapper, Furn>
        implements FurnService {
}

service层测试:测试成功

package com.li.furn;
...
    
@SpringBootTest
public class ApplicationTest {
    @Resource
    private FurnService furnService;

    @Test
    public void furnServiceTest() {
        List<Furn> furns = furnService.list();
        for (Furn furn : furns) {
            System.out.println(\"furn=\" + furn);
        }
    }
}

image-20230328182406797

5.3.6controller层

注意:如果是以表单形式提交数据,则不需要在参数前添加@RequestBody注解;如果使用了@RequestBody注解,要注意测试时,向后端发送的数据是json格式(Content-Type)。

package com.li.furn.controller;

import com.li.furn.bean.Furn;
import com.li.furn.service.FurnService;
import com.li.furn.util.Result;
import lombok.extern.slf4j.Slf4j;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;

import javax.annotation.Resource;

/**
 * @author 李
 * @version 1.0
 * 因为当前项目为前后端分离,在默认情况下,前端发出请求
 * 后端返回json数据,为了方便,我们就在类上使用@RestController
 */
@RestController//ResponseBody+Controller
@Slf4j
public class FurnController {
    @Resource
    private FurnService furnService;

    /**
     * 完成添加添加家居信息的功能
     *
     * 1.因为前端发送的数据通常也是使用json格式的,
     * 因此使用 @RequestBody 将前端提交的 json数据,封装成 Javabean 对象
     * 2.如果前端是以表单形式提交的,则不能使用 @RequestBody
     *
     * @param furn
     * @return
     */
    @PostMapping(\"/save\")
    public Result save(@RequestBody Furn furn) {
        log.info(\"furn={}\", furn);
        furnService.save(furn);
        return Result.success();//返回成功数据
    }
}

postman进行测试:(注意Headers中的Content-Type属性要指定为\"application/json\",否则会出错)

image-20230328184442625

测试结果:

image-20230328184510231

数据库显示插入成功:

image-20230328184923135

5.3.7解决id自增长问题

furn表的id字段被设计为自增长,但是当实际插入数据时,如果没有给定id的值,底层执行的时候将会报错:

org.mybatis.spring.MyBatisSystemException: nested exception is org.apache.ibatis.reflection.ReflectionException: Could not set property \'id\' of \'class com.li.furn.bean.Furn\' with value \'1640682391397732353\' Cause: java.lang.IllegalArgumentException: argument type mismatch

这是因为底层没有获取到自增长字段的值。我们可以使用@TableId来解决,该注解可以标识表的主键,并且如果指定的是自增主键,会将自增主键值返回到实体类中。

Mybatis中需要使用 useGeneratedKeys,keyProperty,keyColumn 设置自增主键值的回返,在实体类对象中获取即可。在MybatisPlus中在进行数据新增时,在新增成功后,会自动的将自增的主键值返回到实体类对象中,前提是需要在实体类中使用@TableId表明主键字段,并且为自增类型。

image-20230328200053910

5.3.8前端代码

(1)在前端项目中安装axios,用于发送ajax请求给后台:npm i axios -S

image-20230328202927959

(2)创建工具文件src/utils/request.js,用于创建axios request对象

//引入axios
// 如果在启动前端项目,提示找不到axios,把光标放在import axios from \'axios\' 的 \'axios\' 上
// 会有一个修复提示,导入 axios,点击导入即可正常使用
import axios from \"axios\";
//通过axios创建对象-request对象,用于发送请求到后端
const request = axios.create({
    timeout: 5000
})

//对request拦截器的处理
//1.可以对请求做统一的处理
//2.比如统一地加入token,Content-Type等
request.interceptors.request.use(
    config => {
        config.headers[\'Content-Type\'] = \'application/json;charset=uft-8\';
        return config;
    },
    error => {
        return Promise.reject(error)
    })

//导出request对象
export default request;

(3)在Home.vue中添加表单,添加添加按钮,可以出现添加家居的对话框:代码略

image-20230328204544786

(4)解决跨域问题

浏览器从一个域名的网页去请求另一个域名的资源时,域名、端口、协议任一不同,都是跨域。在前后端分离的模式下,前后端的域名是不一致的,此时就会发生跨域访问问题。在请求的过程中我们要想回去数据一般都post/get请求,所以跨域问题出现。

image-20230328210524186

解决跨域问题的方案很多,这里在vue.config.js文件中修改跨域配置来解决:

image-20230328213339347

const {defineConfig} = require(\'@vue/cli-service\')
module.exports = defineConfig({
    transpileDependencies: true
})
module.exports = {
    devServer: {
        port: 10000,//启动端口
        proxy: {//设置代理
            \'api/\': {//设置拦截器 拦截器格式(斜杠+拦截器名字)
                target: \'http://localhost:9090\',//目标地址(后端地址)
                changeOrigin: true,//是否设置同源,实现跨域
                pathRewrite: {//路径重写
                    \'/api\': \'\'//选择忽略拦截器里面的单词
                }
            }
        }
    }
}

注意,设置之后需要重新启动前端项目。

注意两点问题:

  1. 一定要确定 request.post(\"/api/save\") 替换后是项目后台服务对应提供的API接口url,否则报404错误
  2. 当执行跨域请求时,如果浏览器仍然提示 http://localhost:9090/api/xxx

来源:https://www.cnblogs.com/liyuelian/p/17266874.html
本站部分图文来源于网络,如有侵权请联系删除。

未经允许不得转载:百木园 » day01-项目介绍和功能实现

相关推荐

  • 暂无文章