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

一、诗人管理接口文档1. 概述本文档描述诗人信息管理相关的API接口包括诗人信息的查询和删除功能。基础信息响应格式JSON字符编码UTF-82. 通用响应格式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响应示例成功无返回值voidHTTP状态码200表示成功响应示例失败抛出异常返回错误信息4.4 根据ID删除诗人请求参数接口描述根据诗人ID删除指定诗人信息请求信息项目说明请求URL/deletebyID请求方法GET请求参数Query参数请求参数说明参数名位置类型必填说明idQueryInteger是诗人ID请求示例GET /deletebyID?id1响应示例成功无返回值voidHTTP状态码200表示成功响应示例失败抛出异常返回错误信息5. 错误码说明错误码说明1操作成功0操作失败二、创建数据库表use 自己数据库的名称;--诗人表 create tablepeom(id int unsigned primary key auto_increment commentID,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,北宋,文学家、书画家诗神,清新豪健的诗风和独特的艺术表现力);