统一网易云音乐、QQ音乐，自定义注解+反射+lombok+RestTemplate+FastJson构造云博音乐服务框架

落日映苍穹つ 2023-01-03 06:12 166阅读 0赞

### 已发布到maven中央仓库 ###

仓库地址：[https://mvnrepository.com/artifact/top.yumbo.music/yumbo-music-utils][https_mvnrepository.com_artifact_top.yumbo.music_yumbo-music-utils]

可能下载不下来，可以先通过在线将jar包下载下来，一个是jar包一个是源码包自带api文档。

**gav坐标:**  
注意版本，暂时还没有更新的需求。更新版本可以在仓库中搜索选择对应版本即可

<dependency>
        <groupId>top.yumbo.music</groupId>
        <artifactId>yumbo-music-utils</artifactId>
        <version>1.1</version>
    </dependency>

--------------------

我是一只喜欢听音乐的猿，不知何时起，我养成了一边听歌一边学习的习惯。

我喜欢在听着音乐敲代码、我喜欢听着歌看视频教程、我喜欢听着歌去思考问题。

就在我大二的时候我诞生了要自己做网站的想法，大二的时候我通过阿里云的云翼计划购买了学生云服务器，因为便宜后面我续购了几年一下子买到了2024年  
![在这里插入图片描述][20210107191856357.png]  
从大二开始我就一直想做一个属于自己的博客系统，用于自己日后写博客，这个想法我想了非常的久，因此在后面当我学过非常多的知识后，我对于这个想法有了更多幻想，我想在我的博客系统中加入音乐播放功能。

我模仿了：[https://netease-music.fe-mm.com/\#/music/playlist][https_netease-music.fe-mm.com_music_playlist]的界面，采用`Vue+ElementUI`自己设计了一个音乐播放器

下面是大致布局（响应式布局）

采用的是一个单组件  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxODEzMjA4_size_16_color_FFFFFF_t_70]  
下面的Music.vue就是上面这个布局，github地址：[https://github.com/1015770492/music][https_github.com_1015770492_music]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxODEzMjA4_size_16_color_FFFFFF_t_70 1]

在我的想法中，我想把 `QQ音乐` 和 `网易云音乐` 的 api 进行统一管理，例如搜索一首歌曲的资源，可以统一两个库中的音乐，这样就不容易因为版权问题不能播放。

--------------------

因此诞生了统一`QQ音乐` 和 `网易云音乐` 的 api 的想法。

在我去实现的过程中，我在思考我平常使用的springboot注解例如`@Autowired`、`@GetMapping`等注解，我想模仿一下springboot中的做法

我想做到这样：

@MusicService(url = "/search/hot",serviceProvider = MusicEnum.NeteaseCloudMusic)
    JSONObject jsonObject;// 调用网易云音乐api，将返回的数据注入到这个对象中

当时我想做到的是在局部变量中进行注入，也就是注解作用：`@Target({ElementType.LOCAL_VARIABLE})`，但是我失败了，因为通过反射只能得到局部变量的名称，却得不到局部变量的值，也就是实现不了将json注入到jsonObject中。

--------------------

如果能这样做，那么使用起来最方便，可以直接在需要的地方直接加注解注入进去，然后直接使用。

--------------------

另外我还要解决一个问题，那就是通过反射得到注解信息后，需要在调用它的时候才发请求（懒加载的含义）也就是代码执行到这个注解的时候才去发请求，得到返回的json数据。

这是一个比较麻烦的事情，我的处理方式是，将反射的时机放在了`get`方法中在get的时候执行反射并且将请求得到的数据返回

### 一个调用的例子 ###

下面是网易云音乐的一个接口  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxODEzMjA4_size_16_color_FFFFFF_t_70 2]

import com.alibaba.fastjson.JSONObject;
    import top.yumbo.util.music.musicImpl.netease.NeteaseCloudMusicInfo;
    
    public class NeteaseCloudMusicDemo { 
        
        public static void main(String[] args) { 
        	// 得到封装网易云音乐信息的工具类
            final NeteaseCloudMusicInfo neteaseCloudMusicInfo = new NeteaseCloudMusicInfo();
            // 调用网易云的热搜服务，返回json数据
            final JSONObject jsonObject = neteaseCloudMusicInfo.searchHot();
            System.out.println(jsonObject);// 打印得到的json数据
    
        }
    }

下面是控制台中打印的信息，最后一行就是json对象的打印，前面两行是反射的时候我为了方便`debug`将调用的方法信息都打印一下

当前执行:class top.yumbo.util.music.musicImpl.netease.NeteaseCloudMusicInfo.searchHot()
    请求的相对路径:/search/hot
    { "result":{ "hots":[{ "iconType":1,"first":"四季予你","second":1},{ "iconType":1,"first":"有何不可","second":1},{ "iconType":1,"first":"我的世界守则","second":1},{ "iconType":1,"first":"踏山河","second":1},{ "iconType":1,"first":"薛之谦","second":1},{ "iconType":1,"first":"张杰","second":1},{ "iconType":1,"first":"We Can't Stop","second":1},{ "iconType":1,"first":"红黑","second":1},{ "iconType":1,"first":"起风了","second":1},{ "iconType":1,"first":"林俊杰","second":1}]},"code":200}

### 项目地址（未完待续，暂时只是第一次提交，做了一个架子） ###

[https://github.com/1015770492/yumbo-music-utils][https_github.com_1015770492_yumbo-music-utils]

如果想要调用QQ音乐的api则调用我写好的工具类就行了  
也就是替换上面`new NeteaseCloudMusicInfo();`改为`new QQMusicInfo();`  
  因为两个音乐平台的地址以及功能是不一样的，因此我没有将他们再进行抽象化，准备后面通过类来完成它们的统一。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxODEzMjA4_size_16_color_FFFFFF_t_70 3]

也为了日后方便，我计划会将他做成一个工具类通过maven发布到maven仓库中，这个工具或许日后我会把它做成springboot启动器以微服务的方式暴露出去。

### 项目后期工作 ###

做好了这个架子，后面就非常简单，只需要按照文档

[网易云音乐api文档在线地址][api]  
[QQ音乐api文档在线地址][QQ_api]

如下写封装方法即可  
以热搜`/search/hot`为例  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxODEzMjA4_size_16_color_FFFFFF_t_70 4]

#### NeteaseCloudMusicInfo类中的定义如下即可，具体代码见github ####

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxODEzMjA4_size_16_color_FFFFFF_t_70 5]

最近在厦门做我的毕业设计，在未来的两个月里，我准备一个人完成我的分布式项目yumbo博客系统。

如果感兴趣，可以关注yumbo博客系统的github地址：

前端项目地址：[https://github.com/1015770492/yumbo-vue][https_github.com_1015770492_yumbo-vue]  
后端项目地址：[https://github.com/1015770492/yumbo][https_github.com_1015770492_yumbo]

前端技术栈；：`Vue+ElementUI`  
后端技术栈：`springCloudAlibaba技术栈 + MybatisPlus + MySQL + MongoDB + Redis + springsecurity`

[https_mvnrepository.com_artifact_top.yumbo.music_yumbo-music-utils]: https://mvnrepository.com/artifact/top.yumbo.music/yumbo-music-utils
[20210107191856357.png]: /images/20221119/4d3cbca054494ff5b251d07f6c48777d.png
[https_netease-music.fe-mm.com_music_playlist]: https://netease-music.fe-mm.com/#/music/playlist
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxODEzMjA4_size_16_color_FFFFFF_t_70]: /images/20221119/b592642bc3574e588223e4a702f7526a.png
[https_github.com_1015770492_music]: https://github.com/1015770492/music
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxODEzMjA4_size_16_color_FFFFFF_t_70 1]: /images/20221119/8dc40373284049bc97ff2c0527a71bde.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxODEzMjA4_size_16_color_FFFFFF_t_70 2]: /images/20221119/2fd0d6fe5f6a4d9db17d7dde9c09096e.png
[https_github.com_1015770492_yumbo-music-utils]: https://github.com/1015770492/yumbo-music-utils
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxODEzMjA4_size_16_color_FFFFFF_t_70 3]: /images/20221119/bd530c41aa6d4e78a9e50110d9b8ce2c.png
[api]: https://binaryify.github.io/NeteaseCloudMusicApi
[QQ_api]: https://jsososo.github.io/QQMusicApi
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxODEzMjA4_size_16_color_FFFFFF_t_70 4]: /images/20221119/a03fb259cfd742859fa5ed99b920478d.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzQxODEzMjA4_size_16_color_FFFFFF_t_70 5]: /images/20221119/c288edf67817424ea1eb08c30d7a3501.png
[https_github.com_1015770492_yumbo-vue]: https://github.com/1015770492/yumbo-vue
[https_github.com_1015770492_yumbo]: https://github.com/1015770492/yumbo