【Flask开发】嘿马文学web完整flask项目第4篇：4.分类,4.分类【附代码文档】

举报
程序员一诺python 发表于 2025/07/25 14:05:09 2025/07/25
【摘要】 2. 目标 1.1产品与开发 1.2环境配置 1.3 运行方式 1.4目录说明 1.5数据库设计 2.用户认证 Json Web Token(JWT) 3.书架 4.1分类列表 5.搜索 5.3搜索-精准&高匹配&推荐 6.小说 6.4推荐-同类热门推荐 7.浏览记录 8.1配置-阅读偏好 8.配置 9.1项目部署uWSGI 配置 启动 9.部署 10.1异常和日志 10.补充

教程总体简介：2.用户认证、Json Web Token(JWT)、3.书架、4.分类、5.搜索、6.小说、7.浏览记录、8.配置、9.部署、10.补充

https://bbs.huaweicloud.com/blogs/453522

https://bbs.huaweicloud.com/blogs/456271

https://bbs.huaweicloud.com/blogs/455379

全套教程部分目录：

4.分类

  • 分类书本列表
  • 分类列表大类，男生、女生

4.2分类书本列表

  • 在applet_app/category.py文件中实现业务。

1-1 分类书本列表接口设计

  • 接口名称：分类-书本列表-筛选
  • 接口路径：/categoryies/filters
  • 请求方法：GET
  • 请求参数：
参数名称 是否必须 参数类型 参数位置 备注
page True int query 当前页数
pagesize True int query 每页数据大小，默认10条
category_id True int query 分类id
words True int query 字数类型id，0 所有 ，1表示50万字以下，2表示50~100万字，3表示100万字以上
order True int query 排序条件，1表示书籍的热度，2表示书籍的收藏数量
  • 返回数据：
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
{
    "counts": 11,
    "items": [
        ...
        {
            "author": "",
            "categoryID": 1,
            "categoryName": null,
            "id": 9,
            "imgURL": "
            "introduction": "腹黑总裁..",
            "state": 1,
            "title": "腹黑总裁，宠溺娇妻"
        },
        {
            "author": "",
            "categoryID": 1,
            "categoryName": null,
            "id": 10,
            "imgURL": "
            "introduction": "不要再纠缠爱我...",
            "state": 1,
            "title": "不要再纠缠爱我"
        }
    ],
    "page": 1,
    "pages": 2,
    "pagesize": 10
}

1-2 分类书本列表的基本业务：

  • 获取参数
  • 根据分类id，查询书籍大分类
  • 根据查询结果，使用关系引用，获取分类信息，使用set存储分类数据
  • 根据分类信息，查询书籍表，获取分类范围内的书籍的查询对象
  • 根据参数words判断查询条件，使用查询对象，进一步按书籍字数进行过滤查询
  • 根据参数order判断查询条件，使用查询对象，按照书籍的热度或是收藏数量排序查询
  • 对查询结果进行分页处理
  • 定义临时列表，遍历查询结果，添加数据
  • 返回结果

1-3 代码实现

1、创建蓝图

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
from flask import Blueprint

category_bp = Blueprint('category', __name__)

2、定义视图

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
# 定义路由，分类书籍列表


@category_bp.route('/filters')
def category_book_list():
    # 1.获取参数:page/pagesize/category_id/words/order
    page = request.args.get('page',1,int)
    pagesize = request.args.get('pagesize',10,int)
    category_id = request.args.get('category_id',0,int)
    # 字数类型说明：0表示所有，1表示50万字以下，2表示50~100万字，3表示100万字以上
    words = request.args.get('words',-1,int)
    # 排序条件说明：1表示按热度，2表示按收藏
    order = request.args.get('order',1,int)
    # 参数判断
    if not category_id:
        return jsonify(msg='缺少分类id'),400
    # 2.根据分类条件category_id，查询数据，查询书籍大分类数据
    categories = BookBigCategory.query.get(category_id)
    # 3.判断查询结果，根据大分类数据，使用关系引用，获取二级分类数据
    # 使用列表推导式,使用set集合
    seconds_id = set([i.cate_id for i in categories.second_cates])
    # 4.根据分类数据，查询书籍表，获取分类范围内的书籍数据
    # -----过滤查询：保存的是查询结果对象，因为，后续需要对数据进行再次查询的操作
    query = Book.query.filter(Book.cate_id.in_(seconds_id))
    # 5.根据字数条件words查询书籍数据
    # -----1表示50万字以下，2表示50~100万字，3表示100万字以上
    if words == 1:
        query = query.filter(Book.word_count < 500000)
    elif words == 2:
        query = query.filter(Book.word_count.between(500000,1000000))
    elif words == 3:
        query = query.filter(Book.word_count > 1000000)

    # 6.根据排序条件order，按照最热、收藏数量进行排序查询
    # -----1表示按热度，2表示按收藏
    if order == 1:
        query = query.order_by(Book.heat.desc())
    elif order == 2:
        query = query.order_by(Book.collect_count.desc())
    else:
        return jsonify(msg='错误的排序选项'),400
    # 7.对查询结果进行分页处理，paginate
    # -----paginate函数表示分页：返回结果为分页的对象
    # 第一个参数表示页数，第二个参数表示每页的条目数，第三个参数False表示分页异常不报错
    paginate = query.paginate(page,pagesize,False)
    # items表示获取分页后的数据、page表示当前页数、
    # pages表示每页数据条目数total表示分页的总页数
    books_list = paginate.items
    items = []
    # 8.遍历分页数据，获取每页数据、总页数
    for item in books_list:
        items.append({
            'id':item.book_id,
            'title':item.book_name,
            'introduction':item.intro,
            'author':item.author_name,
            'state':item.status,
            'category_id':item.cate_id,
            'category_name':item.cate_name,
            'imgURL':'
        })
    # 9.转成json，返回数据
    data = {
        'counts':paginate.total,
        'pagesize':pagesize,
        'pages':paginate.pages,
        'page':paginate.page,
        'items':items
    }
    return jsonify(data)

3、使用postman对接口进行测试：

4.分类

  • 分类书本列表
  • 分类列表大类，男生、女生

5.1搜索热门搜索词

  • 在applet_app/search.py文件中实现业务。

1-1 热门搜索词接口设计

  • 接口名称：搜索-热门搜索词
  • 接口路径：/search/tags
  • 请求方法：GET
  • 请求参数：
参数名称 是否必须 参数类型 参数位置 备注
key_word True query 关键词
  • 返回数据：
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
{
    'title':'搜索词',
      'isHot':'是否热门'
}

1-2 热门搜索词的基本业务：

  • 获取参数
  • 根据关键词参数，搜索关键词表进行过滤包含关键词查询
  • 返回结果

1-3 代码实现

  • 1.创建蓝图
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
# 导入蓝图


from flask import Blueprint



# 创建蓝图对象


search_bp = Blueprint('search',__name__,url_prefix='/search')
  • 2.定义视图
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
# 定义路由，关键词热门搜索


@search_bp.route("/tags")
def tag_list():
    # 1.获取参数，用户搜索的关键词key_word
    key_word = request.args.get("key_word")
    # 校验参数
    if not key_word:
        return jsonify([])
    # 2.根据参数，查询数据库，搜索关键词表进行过滤查询、过滤关键词
    # 热门搜索词，默认提供10条数据
    search_list = SearchKeyWord.query.filter(SearchKeyWord.keyword.contains(key_word)).limit(10)
    # 3.返回查询结果
    data = [{
        'title':index.keyword,
        'isHot':index.is_hot,
    }for index in search_list]
    # 转成json返回
    return jsonify(data)
  • 因为数据库search_key_word表里目前没有数据，可以在搜索-精准高匹配推荐功能完成后，再进行功能测试。

5.2搜索书本列表

  • 在applet_app/search.py文件中实现业务。

1-1 搜索书本列表接口设计

  • 接口名称：搜索-书本列表-模糊
  • 接口路径：/search/books
  • 请求方法：GET
  • 请求参数：
参数名称 是否必须 参数类型 参数位置 备注
page True int query 当前页数
pagesize True int query 页大小，默认10条
key_word True string query 关键词
  • 返回数据：
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
{
    "counts": 11,
    "items": [
        ...
        {
            "author": "",
            "categoryID": 1,
            "categoryName": null,
            "id": 9,
            "imgURL": "
            "introduction": "腹黑总裁..",
            "state": 1,
            "title": "腹黑总裁，宠溺娇妻"
        },
        {
            "author": "",
            "categoryID": 1,
            "categoryName": null,
            "id": 10,
            "imgURL": "
            "introduction": "不要再纠缠爱我...",
            "state": 1,
            "title": "不要再纠缠爱我"
        }
    ],
    "page": 1,
    "pages": 2,
    "pagesize": 10
}

1-2 搜索书本列表的基本业务：

  • 获取参数
  • 判断查询关键词是否存在
  • 如果存在关键词，按照书籍名称进行包含关键词过滤查询
  • 对查询结果进行分页处理
  • 遍历分页结果，添加数据
  • 返回数据

1-3 代码实现

1、创建蓝图

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
from flask import Blueprint

search_bp = Blueprint('search', __name__,url_prefix='/search')

2、定义视图

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
# 定义路由，搜索书本列表


@search_bp.route('/books')
def search_books():
    # 1.获取参数，key_word/page/pagesize
    key_word = request.args.get("key_word")
    page = request.args.get('page',1,int)
    pagesize = request.args.get("pagesize",10,int)
    # 2.检查关键词参数
    if not key_word:
        return jsonify(msg='参数错误'),400
    # 3.根据关键词参数，对书籍数据库进行过滤查询，包含
    query = Book.query.filter(Book.book_name.contains(key_word))
    # 4.判断查询结果
    # 5.对查询结果进行分页处理，items/page/pages
    paginate = query.paginate(page,pagesize,False)
    # 获取分页后的书本数据
    book_list = paginate.items
    # 6.遍历分页后的数据，获取每本书籍的数据
    items = []
    for book in book_list:
        items.append({
            'id':book.book_id,
            'title':book.book_name,
            'intro':book.intro,
            'author':book.author_name,
            'state':book.status,
            'category_id':book.cate_id,
            'category_name':book.cate_name,
            'imgURL':'
        })
    # 7.返回结果
    data = {
        'counts':paginate.total,
        'pages':paginate.pages,
        'page':paginate.page,
        'items':items
    }
    return jsonify(data)

3、使用postman对接口进行测试：

【声明】本内容来自华为云开发者社区博主，不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源（华为云社区）、文章链接、文章作者等基本信息，否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容，欢迎发送邮件进行举报，并提供相关证据，一经查实，本社区将立刻删除涉嫌侵权内容，举报邮箱： cloudbbs@huaweicloud.com
5G Flask Python 后端
  • 点赞
  • 收藏
  • 关注作者

评论（0）

0/1000
抱歉，系统识别当前为高风险访问，暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称，即可参与社区互动！

*长度不超过10个汉字或20个英文字符，设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符，设置后3个月内不可修改。

确认 取消

加入云驻计划，成为创作者

  • 华为云周边好礼
  • 免费体验产品
  • 特殊身份标识
  • 线下官方门票
  • 内部专家零距离
  • 与10000+优质创作者共同成长
立即加入