目录
项目框架: spring+springMVC+Mybatis
项目所涉及的页面及对应功能:
项目设计思路:
数据库设计:
所涉及的功能的对象主要包括用户信息、音乐信息、所收藏音乐信息。因而根据功能建立如下三 张表。
Http响应数据格式设计:
返回相应数据body包括三个主要信息:分别是状态码"status",表明当前数据响应状态;"message"对当前状态信息描述;"body"为具体返回给前端的Json数据。在这里并没有使用@ControllerAdvice + ResponseBodyAdvice注解来封装返回数据信息,因为该方式较难灵活调节status和message。
页面各个功能的请求响应格式设计:
1.登录功能:
功能实现描述:当前端提交form表单发送请求至服务器,服务器代码通过mybatis框架在数据库中查询username对应的user,如果存在则比较密码是否相同。
因为数据库中存储的密码采用了BCrypt加密方式,将用户密码和数据库存储的密码通过bcryptpasswordEncoder方法来进行判定,如果错误,则返回登录失败信息,前端对应则提示用户重新登录;如果密码正确,则把用户信息存入settion并返回登录成功信息(返回user数据之前把用户密码置空)。
2.上传音乐功能
功能实现描述:当客户端点击"上传"按钮时,发送请求到服务器端,由于统一使用拦截器做了登录校验,此处不再做校验。
①首先检查所上传的歌曲是否在数据库中已经存在,如果存在则不可重复插入,前端提示。
②获取到完整的音乐文件名称,并保存至服务器指定路径中
③上传文件到数据库中,如果上传成功重定向页面至音乐列表,并返回响应信息
④如果上传文件至数据库失败,则将服务器端的文件删除后返回失败相应信息。
3.删除音乐功能
功能实现描述:当客户端点击"删除"按钮时,发送post请求到服务器端。
①服务器端在数据库中根据id对音乐查询,如果音乐存在则继续删除,否则返回失败响应信息。
②如果音乐存在则继续删除,首先拿到存储路径+歌曲名+歌曲后缀,并删除服务器的歌曲
③服务器端删除成功,根据id删除数据库的歌曲数据,服务器和客户端均删除成功返回成功响应。
④如果删除的音乐在音乐收藏列表中存在,则一并删除
4.批量删除音乐
功能实现描述:当客户端勾选checkbox标签,前端就能拿到被选中音乐元素的id值,将id值传给后端。
①服务器端的逻辑和单个删除相同,区别是这里拿到的是一个id数组。
②当某个音乐删除成功后,不能直接返回响应信息,而是定义一个count来累加删除的次数,如果和数组的长度相等则说明批量删除成功,再返回响应信息。
③如果所选删除的音乐在音乐收藏列表中存在,则一并删除
5.查询音乐信息
功能实现描述:查询音乐信息囊括了两部分功能,一是当页面加载时自动载入所有音乐信息,二是当用户在查询输入框输入歌曲名称的关键字即可实现模糊匹配,查询到对应歌曲。
①当音乐列表页面加载时会调用查询音乐接口,后端收到请求发现data为空则将该用户的所有音乐信息返回给前端。
②当用户在输入框输入歌曲关键字并点击查询按钮时,给后端发送带有参数的请求,则服务器按照模糊查询查找到相应的歌曲信息并返回。
6.收藏音乐/取消收藏音乐
功能实现描述:当用户点击收藏音乐按钮时,给服务器发送post请求,服务器端逻辑处理完成后返回是否收藏成功的响应。
①当服务器端收到前端传来的所选收藏音乐的id,首先要根据settion拿到user对象,判断该用户之前是否收藏过该音乐,没有的话继续下一步处理。
②执行insert语句,将音乐id和user对象id插入数据库。后续在音乐收藏页面中则可根据user对象和musci id来实现喜欢列表的页面加载等一系列操作。
7.播放音乐
功能实现描述:当用户点击“播放”按钮,调用自定义的播放函数并传入参数URL(音乐播放路径),URL是在页面加载时查询音乐列表时拿到的(功能5)。当执行到音乐播放函数时调用第三方库的toplay函数(也可使用HTML的原生audio标签来播放),传入url和相关信息则会发送get请求去拿到对应音乐的字节码信息,从而实现音乐播放功能。
开源播放器的gitee地址:https://github.com/jackzhang1204/sewise-player
音乐收藏页面的加载、查询、播放、删除功能原理与音乐列表页基本相同。
源码Gitee地址:
music_project: 音乐服务器项目 (gitee.com)https://gitee.com/zzwanghaibin/project