restful是web编程里重要的概念

– 一种接口规范也是一种接口设计风格

设计接口：
要考虑：数据返回、接收数据的方式、url、方法

统一风格
rest–表现层状态转移
web–每一类数据–资源
资源通过http的动作来实现状态转移 GET、PUT、POST、DELETE

path组成:
/{version}/{resources}/{resource_id}

restful api设计
方法
/v1/product POST 新增
GET 查询所有
/v1/product/id PUT 修改
DELETE 删除
GET 查询某一个

router/product_view/product_api.py

from flask import Blueprint, request
from flask_restful import Api, Resource
from libs.response import generate_response
from . import product_bp

# 将restful api对象和蓝图绑定
api = Api(product_bp)

# 每个资源就是类，定义类
class ProductView(Resource):
    def get(self, id = None):
        return generate_response(msg="get product")
    def post(self):
        generate_response(msg="add product")
    def put(self, id):
        generate_response(msg="modify success!")
    def delete(self, id):
        return generate_response(msg="delete success!")


# 路由
api.add_resource(ProductView, "/product")
api.add_resource(ProductView, "/product/<id>", endpoint="productid")

为什么要设置endpoint：由flask路由管理可知endpoint全局唯一，不指定的话都会默认endpoint为函数名（这里为类名）ProductView重复名了。

这行代码是使用Flask框架（一个Python微型web框架）来定义一个路由。‘api.add_resource’是Flask-RESTful扩展提供的方法，用于将资源（这里是’ProductView’）映射到URL（这里是’/product’）。‘ProductView’可能是一个你定义的类，它继承自Flask-RESTful的’Resource’类，用于处理与产品相关的HTTP请求。’/product’是URL路径，当用户发送请求到这个路径时，Flask会调用’ProductView’类中对应的方法来处理请求。

接着将增删改查功能都实现restful接口规范
router/product_view/product_api.py

"""
@date: 2023/9/12
@file: product_api
@author: Jiangda
@desc: test

"""
from flask import Blueprint, request
from flask_restful import Api, Resource
from libs.response import generate_response
from . import product_bp
from models.product import ProductInfo
from models import db

# 将restful api对象和蓝图绑定
api = Api(product_bp)

# 每个资源就是类，定义类
class ProductView(Resource):
    def get(self, id = None):
        if id:
            result = ProductInfo.query.get(id)
        else:
            result = ProductInfo.query.all()
        if result:
            if isinstance(result, list):
                result2 = [dict(pro) for pro in result]
            else:
                result2 = dict(result)
            return generate_response(msg="get success!", data=result2)
        else:
            return generate_response(code=1010, msg="data empty!")
    def post(self):
        pro_name = request.json.get("proname")
        pro_kind = request.json.get("prokind")
        pro_price = request.json.get("proprice")
        pro_address = request.json.get("proadd")
        if pro_name and pro_kind and pro_price and pro_address:

            proinfo = ProductInfo(product_name = pro_name,
                                  product_kind = pro_kind,
                                  product_price = pro_price,
                                  product_address = pro_address)
            db.session.add(proinfo)
            db.session.commit()
            return generate_response(msg="add success!")
        else:
            return generate_response(msg="add fail!", code=1011)
    def put(self, id):
        p1 = ProductInfo.query.get(id)
        if p1:
            # 接收客户端的传递
            pro_name = request.json.get("proname")
            pro_kind = request.json.get("prokind")
            pro_price = request.json.get("proprice")
            pro_address = request.json.get("proadd")

            p1.product_name = pro_name
            p1.product_kind = pro_kind
            p1.product_price = pro_price
            p1.product_address = pro_address

            db.session.add(p1)
            db.session.commit()
            return generate_response(msg="modify success!")
        else:
            return generate_response(msg="no such product!", code=1012)
    def delete(self, id):
        p2 = ProductInfo.query.get(id)
        if p2:
            db.seesion.delete(p2)
            db.session.commit()
            return generate_response(msg="delete success!")
        else:
            return generate_response(msg="delete failed!", code=1013)

# 路由
api.add_resource(ProductView, "/product")
api.add_resource(ProductView, "/product/<id>", endpoint="productid")

不做前后端分离的项目的话：直接返回网页 web开发模式：MVC（model数据模型+view视图用户界面+control控制路由查找）

flask – MTV模型（M-model，T-template，V-view），写网站（Jinjia模板引擎）

router/view01.py

#render_template()函数：页面渲染
import render_template
@view01_bp.route("index2")
def index2():
    return render_template("index.html", message = "hello k8s")

templates/index.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
{{ message }}
<img src="/static/images/k8s.jpg">
</body>
</html>

使用bootstrap4实例：

router/product_view/product.py
添加

import render_template


return render_template("product.html", prolist=result2)

访问http://127.0.0.1:9000/v1/product/get

templates/product.html
在body加入

  <table class="table">
      <th><td>产品名称</td>
      <td>产品种类</td>
      <td>产品价格</td>
      <td>产品产地</td>
      </th>
      {% for pro in prolist %}
      <tr><td></td>
      <td>{{ pro["product_name"] }}</td>
      <td>{{ pro["product_kind"] }}</td>
      <td>{{ pro["product_price"] }}</td>
      <td>{{ pro["product_address"] }}</td>
  </tr>
      {% endfor %}
  </table>

加按钮，且利用url_for()通过endpoint找url
templates/product.html

<td>操作</td>
<td><button type="button" class="btn btn-light"><a href="{{ url_for('product_bp.productdelete', id = pro.product_id) }}">删除</a></button></td>

router/product_view/product2.py

@product_bp.route("/product2/delete", methods=['GET'])
def productdelete():
    id = request.args.get("id")
    p2 = ProductInfo.query.get(id)
    if p2:
        db.session.delete(p2)
        db.session.commit()
        return render_template("product.html",msg="delete success!")
    else:
        return generate_response(msg="no such product", code=6)

添加增加功能
router/product_view/product2.py

@product_bp.route("/product2/add" ,methods=['GET','POST'])
def productadd():
    # 接收客户端的传递
    pro_name = request.form.get("proname")
    pro_kind = request.form.get("prokind")
    pro_price = request.form.get("proprice")
    pro_address = request.form.get("proadd")

    proinfo = ProductInfo(product_name = pro_name,
                          product_kind = pro_kind,
                          product_price = pro_price,
                          product_address = pro_address)

    # 生效到数据库
    db.session.add(proinfo)
    db.session.commit()

    return render_template("product_add.html")

templates/product_add.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
    <link rel="stylesheet" type="text/css" href="/static/css/bootstrap.css">
</head>
<body>
<form method="post">

  <div class="form-group row">
    <label for="inputPassword" class="col-sm-2 col-form-label">产品名称</label>
    <div class="col-sm-10">
      <input class="form-control" name="proname">
    </div>
  </div>

      <div class="form-group row">
    <label for="inputPassword" class="col-sm-2 col-form-label">产品类型</label>
    <div class="col-sm-10">
      <input class="form-control" name="prokind">
    </div>
  </div>

      <div class="form-group row">
    <label for="inputPassword" class="col-sm-2 col-form-label">产品价格</label>
    <div class="col-sm-10">
      <input class="form-control" name="proprice">
    </div>
  </div>

      <div class="form-group row">
    <label for="inputPassword" class="col-sm-2 col-form-label">产品产地</label>
    <div class="col-sm-10">
      <input class="form-control" name="proadd">
    </div>
  </div>
    <input type="submit" value="新增">
    <input type="reset" value="取消">
</form>
</body>
</html>

为什么用orm？什么是orm？
对象关系映射，它不需要和复杂的sql语句打交道，直接操控对象就是操控数据库，把表映射为类，把字段映射为属性，每一行记录映射为对象，提高我们开发的速度，方便开发。
可以不用，我们用过pymysql去创建sql语句去做的。

对象关系映射（Object Relational Mapping，简称ORM）是一种程序技术，用于实现面向对象编程语言里不同类型系统的数据之间的转换。它通过使用描述对象和数据库之间映射的元数据，将程序中的对象自动持久化到关系数据库中。
ORM的由来：面向对象是从软件工程基本原则（如耦合、聚合、封装）的基础上发展起来的，而关系数据库则是从数学理论发展而来的，两套理论存在显著的区别。为了解决这个不匹配的现象，对象关系映射技术应运而生。
简单的说，ORM是通过使用描述对象和数据库之间映射的元数据，将程序中的对象自动持久化到关系数据库中。 ORM提供了实现持久化层的另一种模式，它采用映射元数据来描述对象关系的映射，使得ORM中间件能在任何一个应用的业务逻辑层和数据库层之间充当桥梁。

什么是restful？
一种接口规范也是一种接口设计风格，一般来说api的设计都会遵循，他是表现层状态转移，它将每一类数据看做成资源，每一类资源又为其设计一种url，这种资源的增删改查通过http的动作（get post put delete）等方法来实现

RESTful是一种网络应用程序的设计风格和开发方式，基于HTTP，可以使用XML格式定义或JSON格式定义。它适用于移动互联网厂商作为业务使能接口的场景，实现第三方OTT调用移动网络资源的功能。
在RESTful中，每个资源都有一个唯一的URL，可以通过HTTP请求来获取或修改该资源的状态。RESTful采用了一种无状态协议，即服务器不维护与客户端的连接状态，每个请求都是独立的。这种无状态协议使得RESTful更加灵活和可扩展，可以轻松地支持并发请求和负载均衡。
RESTful的核心思想是将网络资源视为一种状态，并通过HTTP协议来传输和操作这些状态。在RESTful中，每个资源都有一个唯一的URL，可以通过HTTP请求来获取或修改该资源的状态。客户端使用GET、POST、PUT、DELETE4个表示操作方式的动词对服务端资源进行操作：GET用来获取资源，POST用来新建资源（也可以用于更新资源），PUT用来更新资源，DELETE用来删除资源。

统一接口返回
也是restful接口返回的一种规范，返回json数据，返回data,code,message。