功能实现03

9.功能08-分页显示

9.1需求分析

将查询的数据进行分页显示,要求功能如下:

  1. 显示共多少条记录
  2. 可以设置每页显示几条
  3. 点击第几页,显示对应的数据

9.2思路分析

  1. 后端使用MyBatisPlus分页插件完成查询
  2. 修改FurnController,增加处理分页显示代码
  3. 完成前台代码,加入分页导航,并将分页请求和后台接口结合

9.3代码实现

9.3.1分页插件

创建MyBatisPlusConfig.java,在配置类中引入MyBatis-Plus分页插件

package com.li.furn.config;

import com.baomidou.mybatisplus.annotation.DbType;
import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor;
import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

/**
 * @author 李
 * @version 1.0
 */
@Configuration
public class MybatisPlusConfig {
    /**
     * 思路:
     * 1.注入MyBatisPlusInterceptor对象/bean
     * 2.在注入MyBatisPlusInterceptor对象对象bean中,
     *	 加入分页插件-PaginationInnerInterceptor
     */
    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        //分页需要指定数据库类型,因为不同的数据库分页的sql语句不同
        interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));
        return interceptor;
    }
}

9.3.2Controller层

修改FurnController.java,增加分页查询处理

/**
 * 分页查询的接口方法
 *
 * @param pageNo   显示第几页,默认为1
 * @param pageSize 每页显示条数,默认为5
 * @return
 */
@GetMapping("/page")
@ResponseBody
public Result listFurnsByPage(@RequestParam(defaultValue = "1") Integer pageNo,
                              @RequestParam(defaultValue = "5") Integer pageSize) {
    //通过page方法,返回page对象,给对象封装分页数据
    Page<Furn> page = furnService.page(new Page<>(pageNo, pageSize));
    return Result.success(page);
}

使用postman测试:

image-20230330122150825

测试结果:

image-20230330122238453

后端发出的sql:可以看到实际上mybatis-plus底层发出了两次查询,先查询总记录数,再根据总记录数来分页。

image-20230330122306639

9.3.3前端代码

修改HomeView.vue,完成分页导航显示,分页请求。部分代码:

第一部分:引入组件

<!--引入分页组件-可以根据自己的需要进行定制-->
<div style="margin: 10px 0">
  <el-pagination
      @size-change="handlePageSizeChange"
      @current-change="handleCurrentChange"
      :current-page="currentPage"
      :page-sizes="[5,10,20]"
      :page-size="pageSize"
      layout="total, sizes, prev, pager, next, jumper"
      :total="total">
  </el-pagination>
</div>

第二部分:数据池,整个分页导航的功能主要就是依赖于pageSize和total

...
data() {
  return {
    currentPage: 1,//当前页数
    pageSize: 5,//每页显示多少条记录
    total: 10,//数据总记录数
      ...
  }
},
...

第三部分:方法池

...
handlePageSizeChange(pageSize) {//处理pageSizes的修改
  this.pageSize = pageSize;
  //刷新家居列表
  this.list();
},
handleCurrentChange(pageNum) {//修改当前要显示的页数
  this.currentPage = pageNum;
  this.list();
},
list() {//显示所有家居信息,后面再进行分页和考虑检索条件
      // request.get("/api/furns").then(res => {
      //   //将返回的数据和tableData绑定
      //   this.tableData = res.data;
      // })
      request.get("/api/furnsByPage", {
        params: {//params代表请求的数据
          pageNo: this.currentPage,
          pageSize: this.pageSize
        }
      }).then(res => {
        // console.log(res)
        //将返回的数据和tableData绑定
        this.tableData = res.data.records;
        //由返回结果修改对应的total
        this.total = res.data.total;
      })
    },
...

页面结果显示:

day03-功能实现03-小白菜博客
image-20230330132932202

10.功能09-带条件查询分页显示列表

10.1需求分析

如果在搜索框中根据名称查询家居,可以返回分页显示的家居列表,并且点击下一页时,显示的依然是符合条件的数据。

10.2思路分析

  1. 完成从后端代码从mapper(dao层)-->Service层-->Controller层,并对代码进行测试
  2. 完成前端代码,使用axios发送http请求,完成带条件查询分页显示

10.3代码实现

10.3.1Controller层

修改FurnController.java,添加按条件查询的方法

/**
 * 根据家居名查询家居数据
 *
 * @param pageNo    当前页
 * @param pageSize  每页显示的大小
 * @param condition 查询条件:家居名,默认为空串
 * @return
 */
@GetMapping("/furnsBySearchPage")
@ResponseBody
public Result listFurnsByConditionPage
(@RequestParam(defaultValue = "1") Integer pageNo,
 @RequestParam(defaultValue = "5") Integer pageSize,
 @RequestParam(defaultValue = "") String condition) {
    //先创建QueryWrapper,可以将检索条件封装到QueryWrapper
    QueryWrapper<Furn> queryWrapper = Wrappers.query();
    //判断条件是否为可空
    if (StringUtils.hasText(condition)) {
        //name为表中的字段
        queryWrapper.like("name", condition);
    }
    //有条件的分页查询
    Page<Furn> page = furnService.page(new Page<>(pageNo, pageSize), queryWrapper);
    return Result.success(page);
}

使用postman测试:

day03-功能实现03-小白菜博客
image-20230330140150570

10.3.2前端代码

在搜索按钮上绑定list方法,list方法修改请求地址,当condition搜索条件为空时,就查询的是所有的数据

list() {//考虑检索条件
  request.get("/api/furnsBySearchPage", {
    params: {//params代表请求的数据
      pageNo: this.currentPage,
      pageSize: this.pageSize,
      condition: this.search
    }
  }).then(res => {
    // console.log(res)
    //将返回的数据和tableData绑定
    this.tableData = res.data.records;
    //由返回结果修改对应的total
    this.total = res.data.total;
  })
},

页面测试:可以看到点击下一页,检索条件没有失效

day03-功能实现03-小白菜博客
image-20230330141226417

11.功能10-家居表单前后端校验

11.1需求分析

如果在新增家居表单中,直接提交空表单,后端会报错,因为对应的字段不允许为空。

因此需要在表单前端进行校验,当数据不符合条件时无法提交,并给予提示;同时在后端页应该对接受的数据进行校验,如果后端校验不通过也应该给予相应的提示。

11.2思路分析

  1. 前端使用ElementPlus--表单rules验证
  2. 后端使用JSR303数据校验

11.3代码实现

11.3.1前端代码

修改HomeView.vue,增加表单验证处理代码

部分代码:

<el-dialog title="提示" v-model="dialogVisible" width="35%">
  <el-form :model="form" :rules="rules" ref="form" label-width="120px">
    <!--prop表示和rules的哪个规则进行校验-->
    <el-form-item label="家居名" prop="name">
      <el-input v-model="form.name" style="width: 80%"></el-input>
    </el-form-item>
    <el-form-item label="厂商" prop="maker">
      <el-input v-model="form.maker" style="width: 80%"></el-input>
    </el-form-item>
    <el-form-item label="价格" prop="price">
      <el-input v-model="form.price" style="width: 80%"></el-input>
    </el-form-item>
    <el-form-item label="销量" prop="sales">
      <el-input v-model="form.sales" style="width: 80%"></el-input>
    </el-form-item>
    <el-form-item label="库存" prop="stock">
      <el-input v-model="form.stock" style="width: 80%"></el-input>
    </el-form-item>
  </el-form>
  <template #footer>
    <span class="dialog-footer">
      <el-button @click="dialogVisible = false">取 消</el-button>
      <el-button type="primary" @click="save">确 定</el-button>
    </span>
  </template>
</el-dialog>
data() {//数据池
  return {
      ...
    rules: {//提交表单的校验规则
      name: [{required: true, message: '请输入家居名', trigger: 'blur'}],
      maker: [{required: true, message: '请输入厂商', trigger: 'blur'}],
      price: [
        {required: true, message: '请输入价格', trigger: 'blur'},
        {pattern: /^(([1-9]\d*)|0)(\.\d+)?$/, message: '请输入数字', trigger: 'blur'}
      ],
      sales: [
        {required: true, message: '请输入销量', trigger: 'blur'},
        {pattern: /^(([1-9]\\d*)|0)$/, message: '请输入数字', trigger: 'blur'}
      ],
      stock: [
        {required: true, message: '请输入库存', trigger: 'blur'},
        {pattern: /^(([1-9]\\d*)|0)$/, message: '请输入数字', trigger: 'blur'}
      ],
    }
  }
},
methods: {
    save() {//(1)添加 (2)修改
      if (this.form.id) {
        ...
      } else {
        //当添加家居时,弹出窗口的表单id是空的
        //发送添加家居请求
          
        //添加时和表单验证关联起来,如果没有通过验证,就不能提交
        this.$refs['form'].validate(valid => {
          if (valid) {//如果校验通过,可以提交表单
            request.post("/api/save", this.form)
                .then(res => {//res为后端返回的结果
                  console.log("res=", res)
                  this.dialogVisible = false;//发送请求后隐藏表单
                  this.list();
                })
          } else {//否则不能提交
            this.$message({
              type: "error",
              message: "数据格式不正确"
            })
            return false;
          }
        })
      }
    }
  }
...

页面效果:

image-20230330203418408 image-20230330203548246

11.3.2后端代码

为了防止如postman之类的软件绕过前端直接发送数据,还需要在后端进行校验。如果

(1)使用JSR303数据校验,在pom.xml中引入hibernate-validator.jar

<!--JSR303校验-->
<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-validator</artifactId>
    <version>6.1.0.Final</version>
</dependency>

(2)修改Furn.java实体类

package com.li.furn.bean;

import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableId;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import org.hibernate.validator.constraints.Range;

import javax.validation.constraints.Min;
import javax.validation.constraints.NotEmpty;
import javax.validation.constraints.NotNull;
import java.math.BigDecimal;

/**
 * @author 李
 * @version 1.0
 */
@Data
@NoArgsConstructor
@AllArgsConstructor
public class Furn {
    //IdType.AUTO-主键类型为自增长
    @TableId(type = IdType.AUTO)
    private Integer id;
    
    //对字符串进行非空校验,应该使用@NotEmpty
    @NotEmpty(message = "请输入家居名")
    private String name;

    @NotEmpty(message = "请输入厂商")
    private String maker;

    @NotNull(message = "请输入数字")
    @Range(min = 0, message = "价格不能小于0")
    private BigDecimal price;

    @NotNull(message = "请输入数字")
    @Range(min = 0, message = "销量不能小于0")
    private Integer sales;

    @NotNull(message = "请输入数字")
    @Range(min = 0, message = "库存不能小于0")
    private Integer stock;
}

(3)修改FurnController.java的save()方法

@PostMapping("/save")
public Result save(@Validated @RequestBody Furn furn, Errors errors) {
    //如果出现校验错误,SpringBoot底层会把错误信息封装到errors
    HashMap<String, Object> map = new HashMap<>();
    List<FieldError> fieldErrors = errors.getFieldErrors();
    //遍历errors,将错误信息放入map中
    for (FieldError fieldError : fieldErrors) {
        map.put(fieldError.getField(), fieldError.getDefaultMessage());
    }
    //如果没有错误信息,说明后端校验成功
    if (map.isEmpty()) {
        furnService.save(furn);
        return Result.success();//返回成功数据
    } else {//如果有错误信息,就不提交数据,并且将错误信息通过map返回客户端显示
        return Result.error("400", "数据校验错误", map);
    }
}

(4)Postman测试

image-20230330211330443

测试结果:

image-20230330211344660

(5)接入前端

在HomeView.vue的数据池中定义一个对象validMsg,用于接收后端的校验信息。

在save方法中,发送添加的ajax请求后,如果返回的操作码为400,说明后端校验出错,取出错误信息

image-20230330212530049

将错误信息显示在添加表单中:

image-20230330212949121

(6)页面结果:

image-20230330213407720