发表于: 2018-10-19 23:13:44
1 318
3.2.3 内容管理
3.2.3.1 首页banner
需求1:
(1)用户可以在列表中看到每条首页banner图的基本信息展示在列表中,列表可翻页。
(2)用户可以通过填写查询条件搜索出相关banner图在列表中展示
方案:
(1)调用 “banner图列表” 这个接口,限定 “类型” 的参数为 “首页banner”,则返回 首页banner。如果有筛选条件则根据前端返回的查询条件,使用 动态SQL语句,筛选出符合条件的数据,同时以最近更新时间来顺序排序数据,返回的参数与上面讲述的一致;
所调用的接口:
接口名称: banner图列表
请求地址: POST /a/banner
请求参数:
字段 | 说明 | 类型 | 是否必填 | 备注 |
---|---|---|---|---|
tilesName | 标题 | String | 非必填 | |
isOnline | 状态 | int | 非必填 | 见约定: 0:未上线 1:已上线 |
type | 类型 | int | 非必填 | |
createBy | 创建者 | String | 非必填 | |
createAtStart | 创建开始时间 | long | 非必填 | |
createAtEnd | 创建结束时间 | long | 非必填 | |
page | 页码 | int | 非必填 | |
size | 页长 | int | 非必填 |
返回参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
code | 状态码 | int | |
message | 信息 | String | |
page | 页码 | int | |
size | 页长 | int | |
total | 总行数 | int | |
data | 数据 | list |
data:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
photo | 图片地址URL | String | |
tilesName | 标题 | String | |
type | 类型 | int | |
createBy | 创建者 | String | |
createBy | 创建时间 | long | |
updateBy | 更新时间 | long | |
isOnline | 状态 | int | 见约定: 0:未上线 1:已上线 |
page | 页码 | int | |
total | 总数 | int |
code 码:
code | msg | 字段 | 描述 | 备注 |
---|---|---|---|---|
1 | 成功 | SUCCESS | ||
10001 | 参数无效 | PARAM_IS_INVALID | ||
10002 | 参数为空 | PARAM_IS_BLANK | ||
10003 | 参数类型错误 | PARAM_TYPE_BIND_ERROR | ||
10004 | 参数缺失 | PARAM_NOT_COMPLETE | ||
40001 | 系统繁忙,请稍后重试 | SYSTEM_INNER_ERROR |
SQL语句:
select photo,tiles_Name,type,create_By,gmt_create,update_By,is_Online from banner_showwheretiles_Name like "%?%"AND create_By like "%?%"AND type =1AND is_Online =1AND gmt_Create between "?" and "?"<p data-line="1408" class="sync-line" style="margin:0;"></p>
需求2:
用户可以通过列表对banner图进行新增、删除、编辑、查看、状态改变(上架/下架)以及改变列表排序
- 方案:
(1)用户新增banner图时,编辑页面会有 "存为草稿" 和 “立即上线”,两种提交方式分别对应是否认证 “is_online” 的 0 和 1,涉及到图片上传的功能,调用的接口都是一样的,方案也都一样。
(2)若是要对banner图修改,编辑职位,则先调用 “获取单个banner图图像” 接口,在参数修改后,再调用 "修改banner图单个对象" 接口,对更改过信息的数据表,更新其更新人和更新时间的属性。
(3)修改banner状态(上架/下架),在这里则是调用 “修改banner上线状态” 接口,前端返回它现有的冻结状态参数,后端对状态进行修改,并更新相应的更改记录,最后再返回结果信息到前端。如果只能显示一张banner图的地方,先判断是否下架,未下线则不可修改新banner图上架状态。
(4)删除公司信息,调用 "删除单个banner图对象" 这个接口,前端提供需要删除公司对应的ID,处于未下架的banner图不可删除,许下架后才可以删除。删除时,如果有关联的表,一同删除。
所调用的接口:
新增banner图图像
请求地址: POST /a/banner/
请求参数:
字段 | 说明 | 类型 | 是否必填 | 备注 |
---|---|---|---|---|
type | 类型 | int | 必填 | |
tilesName | 标题 | String | 必填 | |
jumpURL | 点击图片跳转链接 | String | 必填 | |
photo | 图片地址URL | String | 必填 | |
isOnline | 状态 | int | 必填 | 见约定: 0:未上线 1:已上线 |
industryType | 行业类型 | int | 必填 | 见约定 |
返回参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
code | 状态码 | int | |
message | 信息 | String |
code 码:
code | msg | 字段 | 描述 | 备注 |
---|---|---|---|---|
1 | 成功 | SUCCESS | ||
10001 | 参数无效 | PARAM_IS_INVALID | ||
10002 | 参数为空 | PARAM_IS_BLANK | ||
10003 | 参数类型错误 | PARAM_TYPE_BIND_ERROR | ||
10004 | 参数缺失 | PARAM_NOT_COMPLETE | ||
40001 | 系统繁忙,请稍后重试 | SYSTEM_INNER_ERROR |
SQL语句
insert into banner_show(type,tiles_Name,jump_URL,photo,is_Online,industry_Type,gmt_create,gmt_update,create_by,update_by)values(1,"?","?","?",1,1,14,14,"?","?");<p data-line="1464" class="sync-line" style="margin:0;"></p>
所调用的接口:
接口名称: 修改banner上线状态
请求地址: PUT /a/banner/{id}/isOnline
请求参数:
字段 | 说明 | 类型 | 是否必填 | 备注 |
---|---|---|---|---|
id | banner图id | Long | 是 | |
isOnline | 状态 | int |
返回参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
code | 状态码 | int | |
message | 信息 | String |
code码:
code | msg | 字段 | 描述 | 备注 |
---|---|---|---|---|
1 | 成功 | SUCCESS | ||
40001 | 系统繁忙,请稍后重试 | SYSTEM_INNER_ERROR |
SQL语句
update banner_show set is_Online=1 where id=1;<p data-line="1494" class="sync-line" style="margin:0;"></p>
所调用的接口:
接口名称: 修改banner图单个对象
请求地址: PUT /a/banner/{id}
请求参数:
字段 | 说明 | 类型 | 是否必填 | 备注 |
---|---|---|---|---|
id | banner图id | long | 非必填 | |
type | 类型 | int | 非必填 | |
tilesName | 标题 | String | 非必填 | |
jumpURL | 点击图片跳转链接 | String | 非必填 | |
photo | 图片地址URL | String | 非必填 | |
isOnline | 状态 | int | 非必填 | 见约定: 0:未上线 1:已上线 |
industryType | 行业类型 | int | 非必填 | 见约定 |
返回参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
code | 状态码 | int | |
message | 信息 | String |
code 码:
code | msg | 字段 | 描述 | 备注 |
---|---|---|---|---|
1 | 成功 | SUCCESS | ||
10001 | 参数无效 | PARAM_IS_INVALID | ||
10002 | 参数为空 | PARAM_IS_BLANK | ||
10003 | 参数类型错误 | PARAM_TYPE_BIND_ERROR | ||
10004 | 参数缺失 | PARAM_NOT_COMPLETE | ||
40001 | 系统繁忙,请稍后重试 | SYSTEM_INNER_ERROR |
SQL语句
update banner_show b setb.type=1AND b.tiles_Name="?"AND b.jump_URL="?"AND b.photo="?"AND b.is_Online=1AND b.industry_Type=1where b.id=1<p data-line="1542" class="sync-line" style="margin:0;"></p>
所调用的接口:
接口名称: 获取单个banner图图像
请求地址: GET /a/banner/{id}
请求参数:
字段 | 说明 | 类型 | 是否必填 | 备注 |
---|---|---|---|---|
id | banner图id | long | 必填 |
返回参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
code | 状态码 | int | |
message | 信息 | String | |
data | 数据 | object |
data:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
id | banner图id | long | |
type | 类型 | int | |
tilesName | 标题 | String | |
jumpURL | 点击图片跳转链接 | String | |
photo | 图片地址URL | String | |
isOnline | 状态 | int | 见约定: 0:未上线 1:已上线 |
industryType | 行业类型 | int | 见约定 |
code码:
code | msg | 字段 | 描述 | 备注 |
---|---|---|---|---|
1 | 成功 | SUCCESS | ||
40001 | 系统繁忙,请稍后重试 | SYSTEM_INNER_ERROR |
SQL语句
select id,type,tiles_Name,jump_URL,photo,industry_Type from banner_show where id=1<p data-line="1584" class="sync-line" style="margin:0;"></p>
所调用的接口:
接口名称: 删除单个banner图对象
请求地址: DELETE /a/banner/{id}
请求参数:
字段 | 说明 | 类型 | 是否必填 | 备注 |
---|---|---|---|---|
id | banner图id | Long | 必填 |
返回参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
code | 状态码 | int | |
message | 信息 | String |
code码:
code | msg | 字段 | 描述 | 备注 |
---|---|---|---|---|
1 | 成功 | SUCCESS | ||
40001 | 系统繁忙,请稍后重试 | SYSTEM_INNER_ERROR |
SQL语句
delete from banner_show where id=1;<p data-line="1614" class="sync-line" style="margin:0;"></p>
需求4:
用户可以通过改变列表排序控制前台banner图的播放顺序
- 方案:
(1)前台banner图的播放顺序以最近更新时间为倒序显示。
备选方案:
(1)后台管理页面,通过拖动banner图的位置,从而更改banner图在前台显示的顺序。在这里,用户拖动一条banner图之后,页面发起一起请求,调用 “banner图拖动排序” 这个接口。前端返回一组数组,通过与数据库获取的列表信息进行对比,找出更给点,并更新表中的更新信息。
所调用的接口:
请求地址: PUT /a/banner/order
请求参数:
字段 | 说明 | 类型 | 是否必填 | 备注 |
---|---|---|---|---|
oldIdArray | 旧id顺序 | Long型数组 | 必填 | |
newIdArray | xinid顺序表 | Long型数组 | 必填 |
返回参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
code | 状态码 | int | |
message | 信息 | String |
code码:
code | msg | 字段 | 描述 | 备注 |
---|---|---|---|---|
1 | 成功 | SUCCESS | ||
40001 | 系统繁忙,请稍后重试 | SYSTEM_INNER_ERROR |
3.2.4 后台管理
3.2.4.1 账号管理
需求1:
用户可以在账户列表中看到所有账户的基本信息展示在列表中
- 方案:
(1)调用 “账号列表” 接口,请求参数为空时,则查看所有账户的信息,带有返回的查询条件,则使用 动态SQL语句,筛选出符合条件的数据,同时以最近更新时间来顺序排序数据,查询出来的数据参数包括 登录名、角色、创建人、创建时间、登录人、更新时间。
所调用的接口:
接口名称: 账号列表
请求地址: POST /a/user
请求参数:
字段 | 说明 | 类型 | 是否必填 | 备注 |
---|---|---|---|---|
roleId | 角色id | int | 必填 | |
name | 用户名 | String | 必填 | |
page | 页码 | int | 非必填 | 默认值为:1 |
size | 页长 | int | 非必填 | 默认值为:10 |
返回参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
code | 状态码 | int | |
message | 信息 | String | |
data | 数据 | list |
data:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
id | 用户id | long | |
name | 用户名 | String | |
role | 角色 | String | |
gmtCreate | 注册时间 | long | |
gmtUpdate | 更新时间 | long | |
createBy | 创建人 | String | |
updateBy | 更新人 | String | |
page | 页码 | int | |
size | 页长 | int | |
total | 总数 | int |
code 码:
code | msg | 字段 | 描述 | 备注 |
---|---|---|---|---|
1 | 成功 | SUCCESS | ||
10001 | 参数无效 | PARAM_IS_INVALID | ||
10002 | 参数为空 | PARAM_IS_BLANK | ||
10003 | 参数类型错误 | PARAM_TYPE_BIND_ERROR | ||
10004 | 参数缺失 | PARAM_NOT_COMPLETE | ||
40001 | 系统繁忙,请稍后重试 | SYSTEM_INNER_ERROR |
sql语句:
-- 查询所有账户SELECTu.`name`,u.id,u.create_by,u.update_by,u.gmt_create,u.gmt_update,r.role_nameFROM`user` AS uLEFT JOIN ( user_roler AS ur LEFT JOIN role AS r ON ur.role_id = r.id ) ON u.id = ur.user_idORDER BYu.update_by-- 根据条件查询账户SELECTu.`name`,u.id,u.create_by,u.update_by,u.gmt_create,u.gmt_update,r.role_nameFROM`user` AS uLEFT JOIN ( user_roler AS ur LEFT JOIN role AS r ON ur.role_id = r.id ) ON u.id = ur.user_idWHEREu.`name` LIKE "%豆%"<p data-line="1747" class="sync-line" style="margin:0;"></p>
需求3:
用户可以通过列表对账户进行新增、删除、编辑、查看操作
- 方案:
(1)新增账户,判断用户是否具有新增用户的权限,有用户权限方可调用 新增账号 。
(2)删除账户,判断是否具有删除账户的权限,如有,则调用 删除账号,账号信息存在用户表中,用户关联角色,这里删除账户的同时,也删除用户关联角色的表,与此保证数据的同步。
(3)编辑账户,判断是否具有编辑账户的权限,如有,先调用 “获取单个账号” 接口,获取相应的用户信息,待用户修改信息提交之后,再调用 “编辑账号” 接口,来对用户信息进行修改。
- 备用方案:
(1) 新增一个用户头像上传功能,这里的实现与前面文件上上传是一样的。
所调用的接口:
新增账号
请求地址: POST /a/user
请求参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
name | 用户名 | String | |
phoneNum | 手机号 | String | |
salt | 盐 | String | |
headImage | 头像 | String | 新增需求(头像的URL) |
返回参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
code | 状态码 | int | |
message | 信息 | String |
code 码:
code | msg | 字段 | 描述 | 备注 |
---|---|---|---|---|
1 | 成功 | SUCCESS | ||
10001 | 参数无效 | PARAM_IS_INVALID | ||
10002 | 参数为空 | PARAM_IS_BLANK | ||
10003 | 参数类型错误 | PARAM_TYPE_BIND_ERROR | ||
10004 | 参数缺失 | PARAM_NOT_COMPLETE | ||
40001 | 系统繁忙,请稍后重试 | SYSTEM_INNER_ERROR |
sql语句:
INSERT INTO `user` (`user`.`name`,`user`.phone_num,`user`.salt,`user`.`password`,`user`.head_image,gmt_create,gmt_update,`user`.create_by,`user`.update_by)VALUES ( 9, 9, 9, 9, 9, 9, 9, 9, 9 )<p data-line="1815" class="sync-line" style="margin:0;"></p>
所调用的接口:
获取单个用户信息
请求地址: GET /admin/a/u/user/{id}
请求参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
id | 用户id | Long |
返回参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
code | 状态码 | int | |
message | 信息 | String | |
data | 数据 | object |
date:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
name | 用户名 | String | |
phoneNum | 手机号 | String | |
headImage | 头像 | String | 新增需求(头像的URL) |
code码:
code | msg | 字段 | 描述 | 备注 |
---|---|---|---|---|
1 | 成功 | SUCCESS | ||
40001 | 系统繁忙,请稍后重试 | SYSTEM_INNER_ERROR |
sql语句:
SELECT`name`,phone_numFROM`user`WHERE`user`.id = 1<p data-line="1859" class="sync-line" style="margin:0;"></p>
所调用的接口:
接口名称: 编辑账号
请求地址: PUT /a/user/{id}
请求参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
id | 用户id | Long | |
name | 用户名 | String | |
phoneNum | 手机号 | String | |
passwoed | 登录密码 | String | |
headImage | 头像 | String | 新增需求(头像的URL) |
返回参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
code | 状态码 | int | |
message | 信息 | String |
code 码:
code | msg | 字段 | 描述 | 备注 |
---|---|---|---|---|
1 | 成功 | SUCCESS | ||
10001 | 参数无效 | PARAM_IS_INVALID | ||
10002 | 参数为空 | PARAM_IS_BLANK | ||
10003 | 参数类型错误 | PARAM_TYPE_BIND_ERROR | ||
10004 | 参数缺失 | PARAM_NOT_COMPLETE | ||
40001 | 系统繁忙,请稍后重试 | SYSTEM_INNER_ERROR |
sql语句:
UPDATE `user`SET NAME = 22,phone_num = 22,salt = 22,PASSWORD = "?",head_image = 22,update_by = 22,gmt_update = 22WHERE `user`.id = 1<p data-line="1908" class="sync-line" style="margin:0;"></p>
所调用的接口:
接口名称: 删除账号
请求地址: DELETE /a/user/{id}
请求参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
id | 用户id | Long |
返回参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
code | 状态码 | int | |
message | 信息 | String |
code码:
code | msg | 字段 | 描述 | 备注 |
---|---|---|---|---|
1 | 成功 | SUCCESS | ||
40001 | 系统繁忙,请稍后重试 | SYSTEM_INNER_ERROR |
sql语句:
DELETEFROMuserWHERE`user`.id = ?<p data-line="1942" class="sync-line" style="margin:0;"></p>
3.2.4.2 角色管理
需求1:
用户可以在角色列表中看到所有角色的基本信息展示在列表中
- 方案:
(1)调用 “角色列表” 接口,默认返回第一页的参数,一页10条数据,参数包括 登录名、角色id、角色名称、注册时间、更新时间、创建人、总行数等。请求参数带有 page 和size时,则根据请求参数返回相应的数据。
需求2:
用户可以通过列表对角色进行新增、删除、编辑、查看操作
- 方案:
(1)新增角色,调用 新增角色 。
(2)删除账户,调用 删除角色,角色信息存在用户表中,角色关联权限,这里删除角色的同时,也删除角色关联权限的表,于此保证数据的同步。
(3)编辑账户,先调用 “获取单个角色” 接口,获取相应的角色信息,待用户修改角色信息提交之后,再调用 “编辑账号” 接口,来对角色信息进行修改。
- 备用方案:
(1)将用户的操作权限明细到方法级别上。根据用户的角色,查询出该角色所拥有的权限,然后在调用接口,执行方法前会先对用户进行一个 “角色” 的认证,不符合认证条件的,则无法调用方法。若符合认证条件则还会在调用方法之前判断是否有权限,(其中用户的所有权限信息,在用户登录时已经获得,加密并保存在请求的头文件中),从请求头文件中获取JWT中的相关信息,含有该权限时才可以调用方法。
接口名称: 角色列表
请求地址: GET /a/role
请求参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
id | 用户id |
返回参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
code | 状态码 | int | |
message | 信息 | String | |
data | 数据 | list |
data:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
id | 角色id | long | |
roleName | 角色名称 | String | |
gmtCreate | 注册时间 | long | |
gmtUpdate | 更新时间 | long | |
createBy | 创建人 | String | |
updateBy | 更新人 | String | |
page | 页码 | int | |
size | 页长 | int | |
total | 总数 | int |
code码:
code | msg | 字段 | 描述 | 备注 |
---|---|---|---|---|
1 | 成功 | SUCCESS | ||
40001 | 系统繁忙,请稍后重试 | SYSTEM_INNER_ERROR |
sql语句:
SELECT u.id, r.role_name, r.create_by, r.update_by, r.gmt_create, r.gmt_updateFROM `user` AS u LEFT JOIN ( user_roler AS ur LEFT JOIN role AS r ON ur.role_id = r.id ) ON u.id = ur.user_idORDER BY r.update_by<p data-line="2023" class="sync-line" style="margin:0;"></p>
接口名称: 新增角色
请求地址: POST /a/role
请求参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
roleName | 角色名称 | String | |
method | 方法 | String | 这里应该是一个数据 |
返回参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
code | 状态码 | int | |
message | 信息 | String |
code码
code | msg | 字段 | 描述 | 备注 |
---|---|---|---|---|
1 | 成功 | SUCCESS | ||
10001 | 参数无效 | PARAM_IS_INVALID | ||
10002 | 参数为空 | PARAM_IS_BLANK | ||
10003 | 参数类型错误 | PARAM_TYPE_BIND_ERROR | ||
10004 | 参数缺失 | PARAM_NOT_COMPLETE | ||
40001 | 系统繁忙,请稍后重试 | SYSTEM_INNER_ERROR |
sql语句:
-- 1.首先先增加用权限信心INSERT INTO permission (permission_name,gmt_create,gmt_update,create_by,update_by)VALUES ( 9, 9, 9, 9, 9 )-- 2.增加角色信息INSERT INTO role ( role_name, gmt_create, gmt_update, create_by, update_by )VALUES ( (SELECT Auto_increment FROM information_schema.`TABLES` WHERE Table_Schema = 'more_pineapple' AND table_name = 'role' LIMIT 1 ), 9, 9, 9, 9 )-- 3.将上面新生成的信息整合在 角色权限关联表中INSERT INTO role_permission ( role_id, node_id, STATUS, gmt_create, gmt_update, create_by, update_by )VALUES ( ( SELECT Auto_increment FROM information_schema.`TABLES` WHERE Table_Schema = 'more_pineapple' AND table_name = 'role' LIMIT 1 ), ( SELECT Auto_increment FROM information_schema.`TABLES` WHERE Table_Schema = 'more_pineapple' AND table_name = 'permission' LIMIT 1 ), 9, 9, 9, 9, 9 )<p data-line="2097" class="sync-line" style="margin:0;"></p>
接口名称: 编辑角色
请求地址: PUT /admin/a/u/role/{id}
请求参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
id | 角色id | long |
返回参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
code | 状态码 | int | |
message | 信息 | String |
code码
code | msg | 字段 | 描述 | 备注 |
---|---|---|---|---|
1 | 成功 | SUCCESS | ||
10001 | 参数无效 | PARAM_IS_INVALID | ||
10002 | 参数为空 | PARAM_IS_BLANK | ||
10003 | 参数类型错误 | PARAM_TYPE_BIND_ERROR | ||
10004 | 参数缺失 | PARAM_NOT_COMPLETE | ||
40001 | 系统繁忙,请稍后重试 | SYSTEM_INNER_ERROR |
sql语句:
-- 1、更新权限信息UPDATE roleSET role_name = 9,gmt_create = 9,gmt_update = 9,create_by = 9,update_by = 9WHERE id = 1-- 2.删除原有的权限关联信息,再重新生成一份DELETEFROM role_permissionWHERE role_id = ( SELECT id FROM role WHERE role_name = "1" )-- 3.插入角色权限关联信息INSERT INTO role_permission ( role_id, node_id, STATUS, gmt_create, gmt_update, create_by, update_by )VALUES ( ( SELECT id FROM role WHERE role_name = "8" ), ( SELECT id FROM permission WHERE permission_name = "9" ), 9, 9, 9, 9, 9 )<p data-line="2156" class="sync-line" style="margin:0;"></p>
接口名称: 删除角色
请求地址: DELETE /admin/a/u/role/{id}
请求参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
id | 角色id | long |
返回参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
code | 状态码 | int | |
message | 信息 | String |
code码:
code | msg | 字段 | 描述 | 备注 |
---|---|---|---|---|
1 | 成功 | SUCCESS | ||
40001 | 系统繁忙,请稍后重试 | SYSTEM_INNER_ERROR |
sql语句:
-- 1、删除角色信息DELETEFROM roleWHERE id = "?"-- 2.删除原有的权限关联信息,再重新生成一份DELETEFROM role_permissionWHERE role_id = ( SELECT id FROM role WHERE role_name = "1" )<p data-line="2201" class="sync-line" style="margin:0;"></p>
接口名称: 获取单个角色信息
请求地址: GET /admin/a/u/role/{id}
请求参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
id | 角色id | long |
返回参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
code | 状态码 | int | |
message | 信息 | String | |
data | 数据 | list |
data:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
id | 角色id | long | |
method | 方法 | List |
code码:
code | msg | 字段 | 描述 | 备注 |
---|---|---|---|---|
1 | 成功 | SUCCESS | ||
40001 | 系统繁忙,请稍后重试 | SYSTEM_INNER_ERROR |
sql语句:
SELECT p.permission_name, p.create_by, p.update_by, p.gmt_create, p.gmt_update , r.role_nameFROM permission AS p LEFT JOIN ( role_permission AS rp LEFT JOIN role AS r ON rp.role_id = r.id ) ON p.id = rp.node_idORDER BY p.update_by<p data-line="2251" class="sync-line" style="margin:0;"></p>
3.2.4.3 修改密码
需求1:
用户可以修改当前登录账户的密码
- 方案:先通过验证用户手机号码是否符合,再调用 获取验证码 接口来获取验证码,再调用 修改密码 接口。
接口名称: 修改密码
请求地址: PUT /admin/a/u/user/password/{id}
请求参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
id | 角色id | long | |
oldPassword | 旧密码 | String | |
NewPassword | 新密码 | String |
返回参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
code | 状态码 | int | |
message | 信息 | String |
code码
code | msg | 字段 | 描述 | 备注 |
---|---|---|---|---|
1 | 成功 | SUCCESS | ||
10001 | 参数无效 | PARAM_IS_INVALID | ||
10002 | 参数为空 | PARAM_IS_BLANK | ||
10003 | 参数类型错误 | PARAM_TYPE_BIND_ERROR | ||
10004 | 参数缺失 | PARAM_NOT_COMPLETE | ||
40001 | 系统繁忙,请稍后重试 | SYSTEM_INNER_ERROR |
sql语句:
UPDATE `user`SETPASSWORD = "?",update_by = 22,gmt_update = 22WHERE `user`.id = 1<p data-line="2304" class="sync-line" style="margin:0;"></p>
3.2.4.4 模块管理
需求1:
用户可以在模块列表中看到后台系统所有模块的基本信息展示在列表中
- 方案:
(1)调用 获取模块管理列表 接口,默认返回第一页的参数,一页10条数据,请求参数带有 page 和size时,则根据请求参数返回相应的数据。
需求2:
用户可以通过列表对模块进行新增、删除、编辑、查看操作
- 方案:
(1)新增模块,调用 接口名称:新增模块 。
(2)删除账户,调用 删除模块。
(3)编辑账户,先调用 “获取单个模块信息” 接口,获取相应的模块信息,待用户修改角色信息提交之后,再调用 “编辑模块信息” 接口,来对模块信息进行修改。
接口名称: 获取模块管理列表
请求地址: GET /a/manage/module
请求参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
page | 页码 | int | |
size | 页长 | int |
返回参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
code | 状态码 | int | |
message | 信息 | String | |
data | 数据 | list |
data:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
id | id | long | |
name | 模块名 | 模块名 | |
url | URL地址 | String | |
parentModuleID | 父模块ID | long | |
moduleCategory | 模块类别 | String | |
gmtCreate | 注册时间 | long | |
gmtUpdate | 更新时间 | long | |
createBy | 创建人 | String | |
updatebBy | 更新人 | String | |
total | 总行数 | int | |
page | 页数 | int |
code码:
code | msg | 字段 | 描述 | 备注 |
---|---|---|---|---|
1 | 成功 | SUCCESS | ||
40001 | 系统繁忙,请稍后重试 | SYSTEM_INNER_ERROR |
sql语句:
SELECT id, NAME, menuld, url, parent_module_ID, module_category, gmt_create, gmt_update, create_by, update_byFROM module_table<p data-line="2388" class="sync-line" style="margin:0;"></p>
接口名称:新增模块
请求地址: POST /a/manage/module
请求参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
name | 模块名 | String | |
url | URL地址 | String | |
menuld | 菜单ID | long | 暂留 |
parentModuleID | 父模块ID | long | |
moduleCategory | 模块类别 | String | |
createBy | 创建人 | String | |
gmtCreate | 创建时间 | Long |
返回参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
code | 状态码 | int | |
message | 信息 | String |
code码:
code | msg | 字段 | 描述 | 备注 |
---|---|---|---|---|
1 | 成功 | SUCCESS | ||
40001 | 系统繁忙,请稍后重试 | SYSTEM_INNER_ERROR |
sql语句:
INSERT INTO module_table ( id, NAME, menuld, url, parent_module_ID, module_category, gmt_create, gmt_update, create_by, update_by )VALUES ( 9, 9 ,9, 9 ,9, 9 ,9, 9 ,9, 9)<p data-line="2428" class="sync-line" style="margin:0;"></p>
接口名称:修改模块
请求地址: PUT /admin/a/u/manage/module/{one}
请求参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
id | 模块id | id | |
name | 模块名 | String | |
url | URL地址 | String | |
menuld | 模块ID | id | |
parentModuleID | 父模块ID | long | |
moduleCategory | 模块类别 | String | |
createBy | 创建人 | String | |
gmtCreate | 创建时间 | Long |
返回参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
code | 状态码 | int | |
message | 信息 | String |
code码:
code | msg | 字段 | 描述 | 备注 |
---|---|---|---|---|
1 | 成功 | SUCCESS | ||
40001 | 系统繁忙,请稍后重试 | SYSTEM_INNER_ERROR |
sql语句:
INSERT INTO module_table ( id, NAME, menuld, url, parent_module_ID, module_category, gmt_create, gmt_update, create_by, update_by )VALUES ( 9, 9 ,9, 9 ,9, 9 ,9, 9 ,9, 9)<p data-line="2470" class="sync-line" style="margin:0;"></p>
接口名称:删除模块
请求地址: DELETE /admin/a/u/manage/module/{one}
请求参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
id | 模块id | id |
返回参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
code | 状态码 | int | |
message | 信息 | String |
code码:
code | msg | 字段 | 描述 | 备注 |
---|---|---|---|---|
1 | 成功 | SUCCESS | ||
40001 | 系统繁忙,请稍后重试 | SYSTEM_INNER_ERROR |
sql语句:
DELETEFROM module_tableWHERE id = 2<p data-line="2506" class="sync-line" style="margin:0;"></p>
接口名称: 获取单个模块信息
请求地址: GET /admin/a/u/manage/module/{id}
请求参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
id | id | long |
返回参数:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
code | 状态码 | int | |
message | 信息 | String | |
data | 数据 | object |
data:
字段 | 说明 | 类型 | 备注 |
---|---|---|---|
id | id | long | |
name | 模块名 | 模块名 | |
url | URL地址 | String | |
parentModuleID | 父模块ID | long | |
moduleCategory | 模块类别 | String |
code码:
code | msg | 字段 | 描述 | 备注 |
---|---|---|---|---|
1 | 成功 | SUCCESS | ||
40001 | 系统繁忙,请稍后重试 | SYSTEM_INNER_ERROR |
sql语句:
SELECT *FROM module_tableWHERE id = 1<p data-line="2553" class="sync-line" style="margin:0;"></p>
总结:
1.学到的东西:
1.1.完成方案设计并评审。
2.明天计划的事情:
2.1.编写假数据。
3.遇到的问题:
4.收获:
收获了上述知识点,坚持!
评论