news 2026/6/25 23:23:04

web应用技术第8次课(1)--诗人管理接口文档创建数据库

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
web应用技术第8次课(1)--诗人管理接口文档创建数据库

一、诗人管理接口文档

1. 概述

本文档描述诗人信息管理相关的API接口,包括诗人信息的查询和删除功能。

基础信息:

  • 响应格式:JSON
  • 字符编码:UTF-8

2. 通用响应格式

2.1 成功响应(含数据)

{"code":1,"msg":"success","data":{}}

2.2 成功响应(无数据)

{"code":1,"msg":"success","data":null}

2.3 失败响应

{"code":0,"msg":"错误描述信息","data":null}

2.4 响应字段说明

字段类型说明
codeInteger响应码:1-成功,0-失败
msgString响应信息描述
dataObject返回的数据对象

3. 数据模型

3.1 诗人对象(Peot)

字段类型说明是否必填
idInteger诗人ID(主键)
authorString作者姓名
genderString性别
dynastyString朝代
titleString诗词标题
styleString诗词风格

4. API接口

4.1 查询全部诗人(返回Result格式)

接口描述:查询所有诗人信息,返回标准Result格式响应

请求信息:

项目说明
请求URL/peotfindAllJson
请求方法GET
请求参数

响应示例(成功):

{"code":1,"msg":"success","data":[{"id":1,"author":"李白","gender":"男","dynasty":"唐","title":"静夜思","style":"浪漫主义"},{"id":2,"author":"杜甫","gender":"男","dynasty":"唐","title":"春望","style":"现实主义"}]}

响应示例(失败):

{"code":0,"msg":"查询失败","data":null}

4.2 查询全部诗人(返回List格式)

接口描述:查询所有诗人信息,直接返回诗人列表

请求信息:

项目说明
请求URL/peotfindAll
请求方法GET
请求参数

响应示例(成功):

[{"id":1,"author":"李白","gender":"男","dynasty":"唐","title":"静夜思","style":"浪漫主义"},{"id":2,"author":"杜甫","gender":"男","dynasty":"唐","title":"春望","style":"现实主义"}]

响应示例(失败):异常情况返回错误页面或空列表


4.3 根据ID删除诗人(路径参数)

接口描述:根据诗人ID删除指定诗人信息

请求信息:

项目说明
请求URL/deletebyID/{id}
请求方法GET
请求参数路径参数

请求参数说明:

参数名位置类型必填说明
idPathInteger诗人ID

请求示例:

GET /deletebyID/1

响应示例(成功):
无返回值(void),HTTP状态码200表示成功

响应示例(失败):
抛出异常,返回错误信息


4.4 根据ID删除诗人(请求参数)

接口描述:根据诗人ID删除指定诗人信息

请求信息:

项目说明
请求URL/deletebyID
请求方法GET
请求参数Query参数

请求参数说明:

参数名位置类型必填说明
idQueryInteger诗人ID

请求示例:

GET /deletebyID?id=1

响应示例(成功):
无返回值(void),HTTP状态码200表示成功

响应示例(失败):
抛出异常,返回错误信息


5. 错误码说明

错误码说明
1操作成功
0操作失败

二、创建数据库表

use 自己数据库的名称;--诗人表 create tablepeom(id int unsigned primary key auto_increment comment'ID',authorvarchar(100)comment'姓名',gendervarchar(4)comment'性别, 1:男, 2:女',dynastyvarchar(100)comment'朝代',titlevarchar(100)comment'头衔',stylevarchar(100)comment'风格')comment'诗人表';--测试数据 insert intopeom(id,author,gender,dynasty,title,style)VALUES(null,'陶渊明','1','东晋末至南朝宋初期','诗人和辞赋家','古今隐逸诗人之宗');insert intopeom(id,author,gender,dynasty,title,style)VALUES(null,'王维','1','唐代','诗佛','空灵、寂静');insert intopeom(id,author,gender,dynasty,title,style)VALUES(null,'李商隐','2','唐代','诗坛鬼才','无');insert intopeom(id,author,gender,dynasty,title,style)VALUES(null,'李白','1','唐代','诗仙','豪放飘逸的诗风和丰富的想象力');insert intopeom(id,author,gender,dynasty,title,style)VALUES(null,'李清照','2','宋代','女词人','婉约风格');insert intopeom(id,author,gender,dynasty,title,style)VALUES(null,'杜甫','1','唐代','诗圣','反映社会现实和人民疾苦');insert intopeom(id,author,gender,dynasty,title,style)VALUES(null,'苏轼','1','北宋','文学家、书画家,诗神','清新豪健的诗风和独特的艺术表现力');

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/6/25 23:22:09

跨端智能助手 OpenClaw 2.7.9 系统配置与日常使用教程(含安装包)

OpenClaw 2.7.9 本地 AI 自动化程序 Windows 完整部署指南 文章导读 日常工作中大量重复的文件整理、网页检索、文档汇总操作会耗费大量时间,OpenClaw 俗称小龙虾,是一款可以部署在本地设备的 AI 智能工具。软件依托可视化交互界面,不用编写…

作者头像 李华
网站建设 2026/6/25 23:12:20

RAG原理与工程实践:从知识检索到可信生成的完整链路

1. 项目概述:RAG不是新模型,而是一套“给大模型配外挂”的工程方法论你肯定见过这样的场景:问一个刚上线的AI助手“我们公司上季度财报里提到的海外市场拓展策略是什么”,它眨巴眨巴眼睛,礼貌地告诉你“我无法访问实时…

作者头像 李华
网站建设 2026/6/25 23:10:15

2026年,市场知名测功机台架销售厂家,哪家才是靠谱之选?

在当今科技飞速发展的时代,测功机台架在汽车、航空航天、军工、机器人、新能源等众多行业中发挥着至关重要的作用。随着市场需求的不断增长,测功机台架销售厂家如雨后春笋般涌现,然而,如何在众多厂家中选择一家靠谱的合作伙伴&…

作者头像 李华
网站建设 2026/6/25 23:08:25

博弈论实战指南:从纳什均衡到日常决策操作系统

1. 这不是数学课,是现实世界的决策操作系统“Game Theory Made Simple”——看到这个标题,我第一反应不是翻开教材,而是想起上周和供应商谈季度返点时那个微妙的停顿:他端起茶杯,没立刻接我报的数字,而是说…

作者头像 李华
网站建设 2026/6/25 23:06:12

COB和SMD LED显示屏有什么区别?采购时应该怎么选?

随着LED显示技术不断升级,越来越多客户在咨询产品时都会遇到两个专业名词:COB和SMD。那么,这两种封装方式到底有什么区别?采购时应该如何选择? 首先需要了解的是,COB和SMD本质上都是LED显示屏的封装技术&am…

作者头像 李华