当前位置：首页 > news >正文

Spring Boot音乐服务器项目-上传音乐模块

news 2025/7/23 8:35:25

项目结构图

相较于上次新增集中在这些地方：

🚀 上传音乐的核心流程

前端投递：用户填写歌手名 + 选择MP3文件
后端接收：/music/upload 接口化身音乐快递员
安全验证：先查用户是否“持证上岗”（登录态）
仓库选址：把音乐存到服务器的“音乐保险柜”(暂时就是存在自己的电脑)
数据库登记：给音乐办张“身份证”（标题、歌手、存储路径等）

⭐接口预览设计：

请求： { post, /music/upload {singer，MultipartFilefile}， }

响应： { "status":0, "message":"上传成功！", "data":true }

🔍 技术揭秘：关键代码与骚操作

⚙️ 1. 接口设计：音乐快递签收单

实体类：新建Music类

import lombok.Data;@Datapublic class Music {private int id;private String title;private String singer;private String url;private String time;private int userid;
}

Controller层：MusicController

@RestController
@RequestMapping("/music")
public class MusicController {@Value("${music.local.path}")private String SAVE_PATH;@Resourceprivate MusicMapper musicMapper;@RequestMapping(value = "/upload")public ResponseBodyMessage<Boolean> insertMusic(@RequestParam String singer,@RequestParam("filename") MultipartFile file,HttpServletRequest req,HttpServletResponse resp) throws IOException {//无session就不创建HttpSession httpSession = req.getSession(false);if (httpSession == null || httpSession.getAttribute(Constant.USERINFO_SESSION_KEY) == null) {System.out.println("没有登录！");return new ResponseBodyMessage<>(-1, "没有登录！", false);}String filenameAndType = file.getOriginalFilename();System.out.println("filenameAndType---->>>>>>>>>>" + filenameAndType);String path = SAVE_PATH + "\\ " + filenameAndType;File dest = new File(path);System.out.println("dest:=>" + dest.getPath());if (!dest.exists()) {dest.mkdirs();}try {file.transferTo(dest);} catch (IOException e) {e.printStackTrace();return new ResponseBodyMessage<>(-1, "上传失败", false);}//数据库当中存储的歌曲不包括.mp3.所以需要进行截取String title = filenameAndType.substring(0, filenameAndType.lastIndexOf("."));//SimpleDateFormat来格式化当前的系统时间SimpleDateFormat sf = new SimpleDateFormat("yyyy-MM-dd");String time = sf.format(new Date());//这里会被用到 播放音乐的模块String url = "/CloudMusic/get?path="+title;User user =(User)httpSession.getAttribute(Constant.USERINFO_SESSION_KEY);int userId = user.getId();int ret = musicMapper.insert(title,singer,time,url,userId);if(ret == 1){}else{dest.delete();return new ResponseBodyMessage<>(-1,"数据库上传失败,删除上传的⾳乐！",false);}return new ResponseBodyMessage<>(0,"上传成功！",true);}
}

String url = "/CloudMusic/get?path="+title;

注意这个地方的路径/http请求方法

注解介绍：

1. 使⽤@Value("${music.local.path}")，获取到配置⽂件当中的值。不建议中⽂路径。

#⾳乐上传后的路径 music.local.path=D:/work/local/music

2. MultipartFile类，在org.springframework.web.multipart包当中，是Spring框架中处理⽂件上传的主要类。

接口层：MusicMapper 现在还未将数据插⼊到数据库当中，接下来我们实现数据库中数据的写⼊。

@Mapper
public interface MusicMapper {int insert(String title,String singer,String time,String url,int userid);}

定义MusicMapper.xml

<mapper namespace="com.example.musicplayer.mapper.MusicMapper"><insert id="insert">insert into music(title,singer,time,url,userid)values(#{title},#{singer},#{time},#{url},#{userid})</insert>
</mapper>

注意自己的文件名

基于此这个插入一个.MP3形式文件到数据库的接口就已经完成了

我们其实可以看到在我们的service中是写下了这样一段逻辑的

HttpServletResponse resp) throws IOException {//没有session不创建 HttpSession httpSession = req.getSession(false);if(httpSession == null || 
httpSession.getAttribute(Constant.USERINFO_SESSION_KEY) == null) {System.out.println("没有登录！");return new ResponseBodyMessage<>(-1,"没有登录！",false);}

同时还有一些配置要记得配置，我的这个配置文件如下
application.propertied <用来对照>

#配置数据库
spring.datasource.url=jdbc:mysql://127.0.0.1:3306/musicserver?characterEncoding=utf8&serverTimezone=UTC
spring.datasource.username=root
spring.datasource.password=1234
spring.datasource.driver-class-name=com.mysql.jdbc.Driver#配置xml
mybatis.mapper-locations=classpath:mybatis/**Mapper.xml#配置springboot上传文件的大小，默认每个文件的配置最大为15Mb，单次请求的文件的总数不能大于100Mb
spring.servlet.multipart.max-file-size = 15MB
spring.servlet.multipart.max-request-size=100MB#音乐上传后的路径
music.local.path=D:/CloudMusic
#music.local.path=/home/gb/music# 配置springboot日志调试模式是否开启
debug=true
# 设置打印日志的级别，及打印sql语句
#日志级别：trace,debug,info,warn,error
#基本日志
logging.level.root=INFO
logging.level.com.example.onlinemusic.mapper=debug
#扫描的包：druid.sql.Statement类和frank包
logging.level.druid.sql.Statement=DEBUG
logging.level.com.example=DEBUG

于是我们看到当我们在postman中测试的时候是无法直接调用这个insertMusic接口的

于是我们可以知道

测试场景	请求姿势	结果
未登录上传	不传Session	❌ “请先登录！”
上传伪造MP3(你可以做这个效果)	把.txt改成.mp3	❌ “假MP3警告！”
正常上传	歌手名+真实MP3文件	✅ 成功入库！
同名文件覆盖(你可以做这个效果)	再次上传相同文件	❌ 需自行处理重复！

💡 一些总结

事务性操作：文件存盘 + 数据库登记 = 原子操作（要么全成功，要么回滚）
路径解耦：@Value 动态读取存储路径，搬家不用改代码！
安全防线：Session验证 + 文件类型检测（虽然检测逻辑要自己补全😉）
扩展空间：
- 加文件去重？👉 SELECT * FROM music WHERE title=?
- 加音乐元数据解析？👉 用 JAudiotagger 库读ID3标签！