【Flask】测试平台开发,产品管理实现添加功能-第五篇

发布于:2025-08-30 ⋅ 阅读:(16) ⋅ 点赞:(0)

 概述

在前面的几篇开发文章中,我们只是让数据在界面上进行了展示,但是没有添加按钮的功能,接下来我们需要开发一个添加的按钮,用户产品功能的创建和添加

  1. 抽公共数据链接方法

  2. 添加接口掌握post实现和请求数据处理

  3. 前端掌握Button\Dilog\Form\Input\Notification组件

服务端实现添加接口

封装数据库链接 在product.py 文件中我们需要增加一个create添加接口,不过再次之前我们需要先封装下面直接写在外边的数据链接对象,因为多方法中如增\改删使用完后会关闭数据库连接,所以不能一次声明到处使用,我们需要在每次接口请求处理业务前,进行新的数据库初始化,保证数据库正在链接状态。

def connectDB():
    connection = pymysql.connect(host='localhost',   # 数据库IP地址或链接域名
                                 user='root',     # 设置的具有增改查权限的用户
                                 password='', # 用户对应的密码
                                 database='tpmdatas',# 数据表
                                 charset='utf8mb4',  # 字符编码
                                 cursorclass=pymysql.cursors.DictCursor) # 结果作为字典返回游标
    return connection

增加添加接口 同之前的查询接口一样,我们设定新的route,用POST方法实现产品添加接口的处理,这里主要是掌握post的定义,以及请求传递的body如何处理,关键点如下:

  1. methods 定义为POST请求

  2. flask request模块的get_data()获取body

  3. json 请求处理请求的JSON格式数据

新增依赖引用

from flask import request
import json

添加功能的接口

@app_product.route("/api/product/create",methods=['POST'])
def product_create():
    # 初始化数据库链接
    connection = connectDB()
    # 定义默认返回结构体
    resp_data = {
        "code": 20000,
        "message": "success",
        "data": []
    }

    # 获取请求传递json body
    body = request.get_data()
    body = json.loads(body)

    with connection:
        # 先做个查询,判断keyCode是否重复(这里的关键词最初定义为唯一项目编号或者为服务的应用名)
        with connection.cursor() as cursor:
            select = "SELECT * FROM `products` WHERE `keyCode`=%s AND `status`=0"
            cursor.execute(select, (body["keyCode"],))
            result = cursor.fetchall()

        # 有数据说明存在相同值,封装提示直接返回
        if len(result) > 0:
            resp_data["code"] = 20001
            resp_data["message"] = "唯一编码keyCode已存在"
            return resp_data

        with connection.cursor() as cursor:
            # 拼接插入语句,并用参数化%s构造防止基本的SQL注入
            # 其中id为自增,插入数据默认数据设置的当前时间
            sql = "INSERT INTO `products` (`keyCode`,`title`,`desc`,`operator`) VALUES (%s,%s,%s,%s)"
            cursor.execute(sql, (body["keyCode"], body["title"], body["desc"], body["operator"]))
            # 提交执行保存插入数据
            connection.commit()

        # 按返回模版格式进行json结果返回
        return resp_data

添加新增接口之后,后端产品管理页面的完整代码如下

# -*- coding:utf-8 -*-

from flask import Blueprint, jsonify
import pymysql.cursors
from flask import request
import json
from configs import config
from dbutils.pooled_db import PooledDB


app_product = Blueprint("app_product", __name__)

# 使用用户名密码创建数据库链接
# PyMySQL使用文档  https://pymysql.readthedocs.io
def connectDB():
    connection = pymysql.connect(host=config.MYSQL_HOST,   # 数据库IP地址或链接域名
                             user=config.MYSQL_USER,     # 设置的具有增改查权限的用户
                             password=config.MYSQL_PASSWORD, # 用户对应的密码
                             database=config.MYSQL_DATABASE,# 数据表
                             charset='utf8mb4',  # 字符编码
                             cursorclass=pymysql.cursors.DictCursor) # 结果作为字典返回游标
    # 返回新的书库链接对象
    return connection
// 获取列表数据展示的接口
@app_product.route("/api/product/list", methods=['GET'])
def product_list():
    # 初始化数据库链接
    connection = connectDB()
    # 使用python的with..as控制流语句(相当于简化的try except finally)
    with connection.cursor() as cursor:
        # 查询产品信息表-按更新时间新旧排序
        sql = "SELECT * FROM `products` WHERE `status`=0 ORDER BY `update` DESC"
        cursor.execute(sql)
        data = cursor.fetchall()

    # 按返回模版格式进行json结果返回
    resp_data = {
        "code": 20000,
        "data": data
    }

    return resp_data

// 添加产品功能的接口
@app_product.route("/api/product/create",methods=['POST'])
def product_create():
    # 初始化数据库链接
    connection = connectDB()
    # 定义默认返回结构体
    resp_data = {
        "code": 20000,
        "message": "success",
        "data": []
    }

    # 获取请求传递json body
    body = request.get_data()
    body = json.loads(body)

    with connection:
        # 先做个查询,判断keyCode是否重复(这里的关键词最初定义为唯一项目编号或者为服务的应用名)
        with connection.cursor() as cursor:
            select = "SELECT * FROM `products` WHERE `keyCode`=%s AND `status`=0"
            cursor.execute(select, (body["keyCode"],))
            result = cursor.fetchall()

        # 有数据说明存在相同值,封装提示直接返回
        if len(result) > 0:
            resp_data["code"] = 20001
            resp_data["message"] = "唯一编码keyCode已存在"
            return resp_data

        with connection.cursor() as cursor:
            # 拼接插入语句,并用参数化%s构造防止基本的SQL注入
            # 其中id为自增,插入数据默认数据设置的当前时间
            sql = "INSERT INTO `products` (`keyCode`,`title`,`desc`,`operator`) VALUES (%s,%s,%s,%s)"
            cursor.execute(sql, (body["keyCode"], body["title"], body["desc"], body["operator"]))
            # 提交执行保存插入数据
            connection.commit()

        # 按返回模版格式进行json结果返回
        return resp_data

对于产品添加中有个字段keyCode我们需求上定义为项目唯一编码,所以对于插入不应该有重复项,所以我们需要在正式插入操作前进行查询判断,如果重复给出提示,code 定义20001,那么在前端request.js 进行处理的时候,由于不是20000就会拦截,并按照message内容错误提示。

以上编写完成再次用ide或者命令运行 app.py 启动后端程序,用postman进行请求测试,验证产品新增接口服务没有问题

1)重复提示

前端实现添加功能

先看下想要实现成的页面样式

定义接口请求 首先对已经测试通过添加接口定义到前端src/api/product.js中,这里主要就是学会post请求接口的方式,以及注意参数定义,在查询定义下方,新增如下定义

data: 就是请求的json格式的参数,稍后在前端定义

export function apiProductCreate(requestBody) {
  return request({
    url: '/api/product/create',
    method: 'post',
    data: requestBody
  })
}

定义请求参数 在 product.vue页面script中的data()返回数据集里定义

  • 一个变量获取之前登录的用户名后边作为操作者值

  • 定义product的json,默认赋值undefined,操作人赋予op_user

  • dialogProductShow 用户添加对话框的显示和隐藏属性变量

// 导入全局存储
import store from '@/store'
     op_user: store.getters.name,
      // 定义产品参数
      product: {
        id: undefined,
        title: undefined,
        keyCode: undefined,
        desc: undefined,
        operator: this.op_user
      },
      // 控制嵌套表单显示和隐藏
      dialogProductShow: false,

这里要清楚一点是,其他变量的引用需要通过this.来给定

定义添加按钮 直接使用element-ui的button组件,在原来界面table之上定义,使用的图标按钮,掌握 el-button 另外对于组件的使用,初期都在想用什么的时候直接去官方参考就行。


<div class="filter-container">      
<el-button type="primary" icon="el-icon-plus" style="float:right" @click="dialogProduct()">新增</el-button>
</div>

属性type=为类型,主要就是不同样式;

icon=内部的一些图标,见icon图标组件说明;

style= 就是自定义的css样式了

@click 指定点击的时候的动作 dialogProduct() 执行下边边自定义方法

其他按钮样式或属性参考官网:https://element.eleme.io/#/zh-CN/component/button

实现dialogProduct()方法 在product.vue 中的 methods模块中,增加初始化数据和显示增加对话框页面逻辑

dialogProduct() {
      // 添加先初始化空状态
      this.product.id = undefined
      this.product.keyCode = ''
      this.product.title = ''
      this.product.desc = ''
      this.product.operator = this.op_user

      // 弹出对话框设置为true
      this.dialogProductShow = true
    },

页面实现添加窗体 使用Dialog组件和嵌套form来实现创建表单的页面,掌握el-dialog 、 el-form 和el-input 三个组件,再定义两个button按钮实现取消/确定的操作逻辑

<!--对话框嵌套表,使用el-dialog-->
    <el-dialog title="添加产品或项目" :visible.sync="dialogProductShow">
      <el-form :model="product">
        <el-form-item label="名称" label-width="100px">
          <el-input v-model="product.title" placeholder="请填写中文名称" style="width: 80%"></el-input>
        </el-form-item>
        <el-form-item  label="唯一码" label-width="100px">
          <el-input v-model="product.keyCode" placeholder="产品/项目唯一码" style="width: 80%"></el-input>
        </el-form-item>
        <el-form-item  label="备注" label-width="100px">
          <el-input v-model="product.desc" type="textarea" placeholder="备注说明" style="width: 80%"></el-input>
        </el-form-item>
      </el-form>
      <span slot="footer" class="dialog-footer">
        <el-button @click="dialogProductShow = false">取 消</el-button>
        <el-button type="primary" @click="pCreate()">确 定</el-button>
      </span>
    </el-dialog>

本例 :visible.sync="dialogProductShow" 属性绑定上边定义的变量,控制是否显示此对话框,flase为隐藏,true为显示;

:model="product" 动态数据绑定 v-model 子数据绑定;

label="" 标题;placeholder="" 输入框内部提示说明;

type="textarea" 输入组件指定为多行文本框;

其他按钮样式或属性参考官网:

https://element.eleme.io/#/zh-CN/component/dialog

https://element.eleme.io/#/zh-CN/component/form

https://element.eleme.io/#/zh-CN/component/input

实现pCreate()方法 最终弹窗内容填写后,点击确定按钮触发真正的保存操作,由于vue已经在上边动态的显示数据绑定,所以参考之前查询操作,这里请求apiProductCreate 并给定data()中的product请求数据即可,本列掌握传参接口请求,以及成功后的 Notification 组件

引入api

// 导入src/api/proudct 配置的请求列表方法
import { apiProductList, apiProductCreate } from '@/api/product'

具体代码实现和其他逻辑处理

 pCreate() {
      // 请求API进行添加
      apiProductCreate(this.product).then(response => {
        // 如果request.js没有拦截即表示成功,给出对应提示和操作
        this.$notify({
          title: '成功',
          message: '项目或产品添加成功',
          type: 'success'
        })
        // 关闭对话框
        this.dialogProductShow = false
        // 重新查询刷新数据显示
        this.getProductList()
      })
    },

https://element.eleme.io/#/zh-CN/component/notification

顺利敲下来,就可以npm run dev 启动查看最终效果了,如测接口一样,分别测试下重复添加和正常添加功能是否OK。

经过我们测试下来,添加功能正常使用,命名和唯一编码也有去重处理,相同code不能重复添加,另外我们在对于项目名称和唯一标识符做下前端输入显示,不能为空输入提示

添加了输入必填校验,使得功能更加完善