tingshu0712-md/第1章 专辑管理.md

谷粒随享

第1章 环境搭建、专辑管理

学习目标：

• 了解听书项目业务背景
• 搭建项目环境
  • 虚拟机环境（Docker软件）
  • 数据库环境
  • Maven项目环境（基础代码）
• 专辑管理
  • MinIO分布式文件存储服务

随堂流程图：https://kdocs.cn/join/gb0rjqi?f=101

项目地址：https://gitee.com/lvhonlgong/tingshu-0712.git

课件更新命令：

git pull origin master

如果修改过课件导致本地跟远端不一致，强制更新（远端覆盖本地）

git fetch --all
git reset --hard origin/master
git pull

1、谷粒随享

1.1 项目背景

随着智能手机和高速互联网的普及，人们开始寻求更便捷的方式来获取信息和娱乐。有声书的出现使得人们可以在旅途中、跑步时、做家务时等各种场景下，以更加灵活的方式享受阅读。

在过去，有声书主要是由专业的演员朗读，制作成录音带或CD。但随着数字化媒体的发展，听书软件应运而生，为用户提供了更多选择，包括自助出版的有声书和多样化的内容。

意义：

1. 便捷性：听书软件使得阅读不再局限于纸质书籍，用户可以通过手机等设备在任何时间、任何地点收听有声书，节省了携带实体书的麻烦。
2. 多样化内容：听书软件提供了广泛的有声书选择，涵盖了各种类型的图书、小说、杂志、教育内容等。这样的多样性使得用户能够根据个人兴趣和需求选择内容。
3. 阅读体验：通过专业的朗读演员和音效制作，听书软件可以提供更加生动、有趣的阅读体验，有助于吸引更多读者，尤其是那些不太喜欢阅读纸质书籍的人。
4. 辅助功能：听书软件通常还具备一些辅助功能，如调整朗读速度、书签功能、字幕显示等，有助于提高可访问性，使得视力受损或其他障碍的用户也能轻松阅读。
5. 支持作家和内容创作者：听书软件为作家和内容创作者提供了另一种传播作品的渠道，有助于扩大影响力和读者群。
6. 学习工具：听书软件也可以用作学习工具，提供学术教材、外语学习材料等，帮助用户在学习过程中更好地理解和吸收知识。

总的来说，听书软件的开发推动了阅读体验的数字化和个性化，为用户提供了更加便捷、多样化的阅读方式，也促进了作家和内容创作者的创作和传播。

内容创作者： 将书籍录制成有声书（音频）制作成专辑，在听书平台上发布专辑，可以达到盈利目的。

听书运营端：运营听书平台上所有的专辑，对专辑进行审核、发布、订单管理、支付管理。消费者消费（购买VIP会员，购买专辑、购买声音）可以达到盈利目的。

用户：收听平台上优质资源（知识付费），购买会员，购买专辑，购买声音

1.2 项目技术栈

• SpringBoot：简化Spring应用的初始搭建以及开发过程
• SpringCloud：基于Spring Boot实现的云原生应用开发工具，SpringCloud使用的技术：（Spring Cloud Gateway、Spring Cloud Task和Spring Cloud Feign、Spring Cloud Nacos、Sentinel等）
• MyBatis-Plus：持久层框架（简化持久层开发）基于Mybatis
• Redis：内存做缓存
• Redisson：基于redis的Java驻内存数据网格 - 框架；操作redis的框架
• MongoDB: 分布式文档型数据库
• Kafka：消息中间件；大型分布式项目是标配；分布式事务最终一致性
• ElasticSearch+Kibana+Logstash/Filebeat 全文检索服务器+可视化数据监控：检索
• ThreadPoolExecutor+CompletableFuture：线程池来实现异步操作，提高效率
• Xxl-Job: 分布式定时任务调用中心
• Swagger/Knife4J/YAPI：Api接口文档工具
• MinIO（私有化对象存储集群）：分布式文件存储 类似于OSS（公有）
• 在线支付平台：微信支付
• MySQL：关系型数据库
• Hutool：Java工具类库
• Lombok: 实体类的中get/set 生成的jar包
• Natapp：内网穿透工具
• Docker：容器化技术; 生产环境（运维人员）；快速搭建环境
• Git：代码管理工具；git使用，拉代码、提交、推送、合并、冲突解决
• Canal：阿里开源增量订阅组件，数据增量同步
• Seata：阿里开源分布式事务解决方案

前端技术栈

• UniApp
• Vue3全家桶
• TypeScript
• GraceUI
• UniUI
• uniapp-axios-adapter

1.3 项目架构图

1.4 环境搭建

1. 参考听书软件环境安装.md

2. 导入听书初始化项目资料中的tingshu-parent项目导入idea开发工具中即可！

1.4.1 虚拟机环境

第一步：

第二步：改NAT模式的子网IP：192.168.200.0

第三步：应用确定

第四步：启动虚拟机

第五步：登录虚拟机

IP：192.168.200.6
登录用户：root
登录密码：root

1.4.2 虚拟机容器列表

目前在虚拟机中安装以下容器服务都是开机自启动！

名	URL	账号密码
Portainer	http://192.168.200.6:19000	admin/admin1234567
MySQL	192.168.200.6:3306	root/root
Redis	192.168.200.6:6379
Elasticsearch	http://192.168.200.6:9200	elastic/111111
Kibana	http://192.168.200.6:5601	elastic/111111
Logstash	收集日志的后台进程，无需访问
Zookeeper	192.168.200.6:2181
Kafka	192.168.200.6:9092
Kafdrop	http://192.168.200.6:9093
Zipkin	http://192.168.200.6:9411
Nacos	http://192.168.200.6:8848/nacos	nacos/nacos
MinIO	http://192.168.200.6:9001	admin/admin123456
YAPI	http://192.168.200.6:3000	admin@admin.com/ymfe.org
MongoDB	192.168.200.6:27017

Tips:如果发现某些容器启动失败（说明该容器依赖其他容器，确保被依赖容器先正常启动），重启虚拟机

Nacos容器依赖MySQL容器-先启动MySQL容器

Kibana容器依赖ElasticSearch容器：先启动ES容器

Kafka容器依赖zookeeper容器：先启动zookeeper

Kafdrop容器依赖Kafka容器:先启动Kafka

YAPI容器依赖MongoDB容器：先启动MongoDB

如果发现Docker服务重启/启动报错。将Docker服务重启,所有容器开机自启

systemctl restart docker

1.4.3 小程序工程

1. 找到配套资料中mp-weixin-微信小程序.zip解压

   

2. 配套资料\02-软件\找到安装微信开发者工具

   

3. 每个同学注册申请微信小程序测试号（微信登录会使用到）测试账号申请入口https://mp.weixin.qq.com/wxamp/sandbox?doc=1

   appId:测试号应用ID
   appSecret：测试号对应秘钥
   

4. 在微信开发者工具中导入，导入选择信任项目，注意:这里填写自己申请测试号应用ID

1. 小程序默认访问的后端网关地址为本地8500端口

1.4.4 导入初始化工程

1. 听书/配套资料/初始后台代码/tingshu-parent.zip压缩包解压
2. 在Idea中导入

将Nacos配置中心所有配置文件全部删除,再次重新导入

将MySQL数据库中业务库全部删除，再次重新导入

1.4.5 MP入门

Mybatis 增强工具包 - 只做增强不做改变，简化CRUD操作，

• 无侵入：Mybatis-Plus 在 Mybatis 的基础上进行扩展，只做增强不做改变，引入 Mybatis-Plus 不会对您现有的 Mybatis 构架产生任何影响，而且 MP 支持所有 Mybatis 原生的特性
• 依赖少：仅仅依赖 Mybatis 以及 Mybatis-Spring
• 损耗小：启动即会自动注入基本CURD，性能基本无损耗，直接面向对象操作
• 通用CRUD操作：内置通用 Mapper、通用 Service，仅仅通过少量配置即可实现单表大部分 CRUD 操作，更有强大的条件构造器，满足各类使用需求
• 多种主键策略：支持多达4种主键策略（内含分布式唯一ID生成器），可自由配置，完美解决主键问题
• 支持ActiveRecord：支持 ActiveRecord 形式调用，实体类只需继承 Model 类即可实现基本 CRUD 操作
• 支持代码生成：采用代码或者 Maven 插件可快速生成 Mapper 、 Model 、 Service 、 Controller 层代码，支持模板引擎，更有超多自定义配置等您来使用（P.S. 比 Mybatis 官方的 Generator 更加强大！）
• 支持自定义全局通用操作：支持全局通用方法注入( Write once, use anywhere )
• 内置分页插件：基于Mybatis物理分页，开发者无需关心具体操作，配置好插件之后，写分页等同于写基本List查询
• 内置性能分析插件：可输出Sql语句以及其执行时间，建议开发测试时启用该功能，能有效解决慢查询
• 内置全局拦截插件：提供全表 delete 、 update 操作智能分析阻断，预防误操作

1. 创建数据库：user_demo

2. 初始化用户表

   CREATE TABLE `user`
   (
      id BIGINT NOT NULL COMMENT '主键ID',
      name VARCHAR(30) NULL DEFAULT NULL COMMENT '姓名',
      age INT NULL DEFAULT NULL COMMENT '年龄',
      email VARCHAR(50) NULL DEFAULT NULL COMMENT '邮箱',
      PRIMARY KEY (id)
   );
      
   INSERT INTO `user` (id, name, age, email) VALUES
   (1, 'Jone', 18, 'test1@baomidou.com'),
   (2, 'Jack', 20, 'test2@baomidou.com'),
   (3, 'Tom', 28, 'test3@baomidou.com'),
   (4, 'Sandy', 21, 'test4@baomidou.com'),
   (5, 'Billie', 24, 'test5@baomidou.com');
   

3. 创建demo工程mp_demo

   

4. pom.xml

   <?xml version="1.0" encoding="UTF-8"?>
   <project xmlns="http://maven.apache.org/POM/4.0.0"
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
           xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
      <modelVersion>4.0.0</modelVersion>
      
      <groupId>com.atguigu</groupId>
      <artifactId>mp_demo</artifactId>
      <version>1.0-SNAPSHOT</version>
      
      <parent>
          <groupId>org.springframework.boot</groupId>
          <artifactId>spring-boot-starter-parent</artifactId>
          <version>3.0.5</version>
          <!-- 版本对应： https://start.spring.io/actuator/info -->
      </parent>
      
      <properties>
          <maven.compiler.source>17</maven.compiler.source>
          <maven.compiler.target>17</maven.compiler.target>
          <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
          <mybatis-plus.version>3.5.3.1</mybatis-plus.version>
          <mysql.version>8.0.30</mysql.version>
      </properties>
      <dependencies>
          <dependency>
              <groupId>org.springframework.boot</groupId>
              <artifactId>spring-boot-starter-web</artifactId>
          </dependency>
          <dependency>
              <groupId>com.baomidou</groupId>
              <artifactId>mybatis-plus-boot-starter</artifactId>
              <version>${mybatis-plus.version}</version>
          </dependency>
          <!--mysql-->
          <dependency>
              <groupId>mysql</groupId>
              <artifactId>mysql-connector-java</artifactId>
              <version>${mysql.version}</version>
          </dependency>
          <dependency>
              <groupId>org.projectlombok</groupId>
              <artifactId>lombok</artifactId>
          </dependency>
          <dependency>
              <groupId>org.springframework.boot</groupId>
              <artifactId>spring-boot-starter-test</artifactId>
              <scope>test</scope>
          </dependency>
      </dependencies>
   </project>
      
   

5. applicaton.yaml

   server:
    port: 8801
   spring:
    datasource:
      type: com.zaxxer.hikari.HikariDataSource
      driver-class-name: com.mysql.cj.jdbc.Driver
      url: jdbc:mysql://192.168.200.6:3306/db_user?serverTimezone=UTC&characterEncoding=utf8&useUnicode=true&useSSL=true
      username: root
      password: root
      hikari:
        connection-test-query: SELECT 1
        connection-timeout: 60000
        idle-timeout: 500000
        max-lifetime: 540000
        maximum-pool-size: 10
        minimum-idle: 5
        pool-name: GuliHikariPool
   mybatis-plus:
    configuration:
      log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
    mapper-locations: classpath:mapper/*Mapper.xml
   

6. 启动类

   package com.atguigu;
      
   import org.mybatis.spring.annotation.MapperScan;
   import org.springframework.boot.SpringApplication;
   import org.springframework.boot.autoconfigure.SpringBootApplication;
      
   /**
   * @author: atguigu
   * @create: 2023-11-11 14:00
   */
   @SpringBootApplication
   public class MPDemoApp {
      
      public static void main(String[] args) {
          SpringApplication.run(MPDemoApp.class, args);
      }
   }
   

7. MyBatisPlus配置

   package com.atguigu.mp.config;
      
   import com.baomidou.mybatisplus.annotation.DbType;
   import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor;
   import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor;
   import org.mybatis.spring.annotation.MapperScan;
   import org.springframework.context.annotation.Bean;
   import org.springframework.context.annotation.Configuration;
      
   @Configuration
   @MapperScan("com.atguigu.mp.mapper")
   public class MybatisPlusConfig {
      
      /**
       * 添加分页插件
       */
      @Bean
      public MybatisPlusInterceptor mybatisPlusInterceptor() {
          MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
          interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));//如果配置多个插件,切记分页最后添加
          //interceptor.addInnerInterceptor(new PaginationInnerInterceptor()); 如果有多数据源可以不配具体类型 否则都建议配上具体的DbType
          return interceptor;
      }
   }
   

8. 创建实体类

   package com.atguigu.mp.model;
      
   import com.baomidou.mybatisplus.annotation.IdType;
   import com.baomidou.mybatisplus.annotation.TableField;
   import com.baomidou.mybatisplus.annotation.TableId;
   import com.baomidou.mybatisplus.annotation.TableName;
   import lombok.Data;
      
   @Data
   @TableName("`user`")
   public class User {
      @TableId(type = IdType.AUTO)
      private Long id;
      
      @TableField("user_name") //默认开启驼峰映射
      private String userName;
      
      private Integer age;
      
      private String email;
   }
      
   

9. 新增持久层Mapper继承BaseMapper

   package com.atguigu.mp.mapper;
      
   import com.atguigu.mp.model.User;
   import com.baomidou.mybatisplus.core.mapper.BaseMapper;
      
   public interface UserMapper extends BaseMapper<User> {
   }
      
   

10. 新增业务层接口,继承 IService<实体类class>

    package com.atguigu.mp.service;
        
    import com.atguigu.mp.model.User;
    import com.baomidou.mybatisplus.extension.service.IService;
        
    public interface UserService extends IService<User> {
        
        //继承MP父接口未实现方法
    }
    

11. Service实现类

    package com.atguigu.mp.service.impl;
        
    import com.atguigu.mp.mapper.UserMapper;
    import com.atguigu.mp.model.User;
    import com.atguigu.mp.service.UserService;
    import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
    import org.springframework.stereotype.Service;
        
    /**
     * @author: atguigu
     * @create: 2023-11-11 14:25
     */
    @Service
    public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements UserService {
    }
    

12. 调用持久层或者业务层CURD方法。业务层提供方法都是Mapper持久层方法

    package com.atguigu.mp.service.impl;
        
    import com.atguigu.mp.mapper.UserMapper;
    import com.atguigu.mp.model.User;
    import com.atguigu.mp.service.UserService;
    import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
    import org.springframework.stereotype.Service;
        
    /**
     * @author: atguigu
     * @create: 2023-12-06 13:58
     */
    @Service
    public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements UserService {
        
    }
    

    1. 测试类

       package com.atguigu.mp;
           
       import com.atguigu.mp.mapper.UserMapper;
       import com.atguigu.mp.model.User;
       import com.atguigu.mp.service.UserService;
       import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
       import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
       import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
       import org.junit.jupiter.api.Test;
       import org.junit.platform.commons.util.StringUtils;
       import org.springframework.beans.factory.annotation.Autowired;
       import org.springframework.boot.test.context.SpringBootTest;
           
       import java.util.List;
           
       import static org.junit.jupiter.api.Assertions.*;
           
       @SpringBootTest
       class MpDemoAppTest {
           
       @Autowired
       private UserMapper userMapper;
           
           
       /**
        * 测试持久层Mapper基本CURD操作
        */
       @Test
       public void testMapper(){
           //1.新增
           //User user = new User();
           //user.setUserName("张三");
           //user.setAge(15);
           //user.setEmail("zhangsagn@qq.con");
           //userMapper.insert(user);
           
           //2.查询
           //User user1 = userMapper.selectById(5);
           //System.out.println(user1);
           
           //List<User> userList = userMapper.selectList(null);
           //System.out.println(userList);
           
           //3.修改
           //User user = new User();
           //user.setId(5L);
           //user.setUserName("zhagnsan");
           //userMapper.updateById(user);
           
           //4.删除
           userMapper.deleteById(5L);
       }
           
           
           
       @Autowired
       private UserService userService;
           
       @Test
       public void testService(){
           //1.新增
           //User user = new User();
           //user.setUserName("李四");
           //user.setAge(16);
           //user.setEmail("lisi@qq.con");
           //userService.save(user);
           
           //2.查询
           //User user = userService.getById(7L);
           //System.out.println(user);
           
           //List<User> userList = userService.list();
           //System.out.println(userList);
           
           //3.修改
           //User user = new User();
           //user.setId(4L);
           //user.setUserName("zhagnsan");
           //userService.updateById(user);
           
           //4.删除
           userService.removeById(4);
       }
           
           
       /**
        * 需求：根据用户名称查询用户列表
        * select * from user where name = ?
        * 条件构造器
        */
       @Test
       public void testQueryWrapper(){
           String name = "jack";
           //1.创建传统条件构造器
          /* QueryWrapper<User> queryWrapper = new QueryWrapper<>();
           //queryWrapper.eq("user_name", name);
           //queryWrapper.like("user_name", name);
           //queryWrapper.ge("age", 20);
           queryWrapper.like("user_name", name).ge("age", 20);
           List<User> userList = userMapper.selectList(queryWrapper);
           System.out.println(userList);*/
           
           //2.采用Lambda表达式创建条件构造器
           //LambdaQueryWrapper<User> queryWrapper = new LambdaQueryWrapper<>();
           //queryWrapper.eq(User::getUserName, name);
           //List<User> userList = userService.list(queryWrapper);
           //System.out.println(userList);
           
           //3.分页+条件查询
           //userService.page();
           //3.1 创建分页对象
           Page<User> page = new Page<>(1, 3);
           //3.2 构建条件
           LambdaQueryWrapper<User> queryWrapper = new LambdaQueryWrapper<>();
           queryWrapper.gt(User::getAge, 16);
           //3.3 执行分页查询
           page = userMapper.selectPage(page, queryWrapper);
           
           
           System.out.println("总记录数："+page.getTotal());
           System.out.println("总页数："+page.getPages());
           System.out.println("数据："+page.getRecords());
           
       }
           
       }
       

2、专辑管理添加

功能入口：运行app项目-->我的-->创作中心-->专辑-->点击 + 添加专辑。提供给内容创作者/平台运营人员。使用（该功能必须登录才能访问），专辑经过审核（文字+封面）机制，审核通过内容创作者用户录制声音（音频文件-声音管理）新增专辑，将声音关联到专辑下。其他的普通用户（网民）可以在APP/小程序中进行获取内容资源（有声书等资源）

主要功能如下：

1. 先获取到专辑分类
2. 查询专辑标签
3. 文件上传
4. 保存专辑

2.1 查看分类数据

需求：在保存专辑需要为新增专辑关联分类，三级分类数据需要采用列表展示

创建视图：

# 视图 view :是一个虚拟表，本身并不存放数据，数据来源于原始表(单表，关联查询多条)
# 语法：create [or replace] view 视图名称 as SQL语句；
# 作用1：屏蔽掉敏感字段，不希望某些开发者查看的列（创建只读视图，视图数据只有非敏感列，给指定开发者设置权限-只能查看视图）
# 作用2：将一些复杂关联查询结果封装到视图中，方便得到数据，视图当成表来使用，事务跟其他表关联查询

#场景视图对象
create or replace  view v_album_info as select id,album_title,album_intro from album_info;

#使用视图对象（类似表）
select  * from v_album_info;
update v_album_info set album_title = '《夜色钢琴曲》' where id = 1;


select * from v_album_info v left join album_stat stat on stat.album_id = v.id;


#利用视图封装所有1,2,3级分类
select *
from base_category1 bc1  left join base_category2 bc2 on bc2.category1_id= bc1.id left join base_category3 bc3 on bc3.category2_id = bc2.id;


create or replace view base_category_view as
select
    bc3.id,
    bc1.id category1_id,
    bc1.name category1_name,
    bc2.id category2_id,
    bc2.name category2_name,
    bc3.id category3_id,
    bc3.name category3_name,
    bc3.is_deleted,
    bc3.create_time,
    bc3.update_time
from base_category1 bc1  left join base_category2 bc2 on bc2.category1_id= bc1.id left join base_category3 bc3 on bc3.category2_id = bc2.id;

#查询视图中数据
select *
from base_category_view;

涉及到的视图对象: base_category_view ，在这张视图中存储了所有的分类数据。展示分类数据的格式如下：

[
 {
    "categoryName":"音乐",   #一级分类名称
    "categoryId":1,                       #一级分类ID
    "categoryChild":[                     #当前一级分类包含的二级分类集合
        {
            "categoryName":"音乐音效",     #二级分类名称
            "categoryId":101,               #二级分类ID
            "categoryChild":[             #当前二级分类包含的三级分类集合
               {
                  "categoryName": "催眠音乐",
                  "categoryId": 1001
                },
                {
                  "categoryName": "放松音乐",
                  "categoryId": 1002
                },
                {
                  "categoryName": "提神音乐",
                  "categoryId": 1003
                }
            ]
        }
    ]
},
{
    "categoryName":"有声书",
    "categoryId":2,
    "categoryChild":[
        {
            "categoryName":"男频小说",
            "categoryId":104,
            "categoryChild":[
                {
                    "categoryName":"军事小说",
                    "categoryId":1009
                }
            ]
        }
    ]
 }
]

YAP接口地址：http://192.168.200.6:3000/project/11/interface/api/11

2.1.1 控制器

在service-album模块中BaseCategoryApiController控制器编写

package com.atguigu.tingshu.album.api;

import com.alibaba.fastjson.JSONObject;
import com.atguigu.tingshu.album.service.BaseCategoryService;
import com.atguigu.tingshu.common.result.Result;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.tags.Tag;
import org.apache.tomcat.Jar;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.Arrays;
import java.util.List;


@Tag(name = "分类管理")
@RestController
@RequestMapping(value = "/api/album")
@SuppressWarnings({"all"})
public class BaseCategoryApiController {

    @Autowired
    private BaseCategoryService baseCategoryService;


    /**
     * 查询所有分类（1、2、3级分类）
     *
     * @return
     */
    @Operation(summary = "查询所有分类（1、2、3级分类）")
    @GetMapping("/category/getBaseCategoryList")
    public Result<List<JSONObject>> getBaseCategoryList() {
        List<JSONObject> list = baseCategoryService.getBaseCategoryList();
        return Result.ok(list);
    }


}

2.2.2 业务层

接口与实现类

package com.atguigu.tingshu.album.service;

import com.alibaba.fastjson.JSONObject;
import com.atguigu.tingshu.model.album.BaseCategory1;
import com.baomidou.mybatisplus.extension.service.IService;

import java.util.List;

public interface BaseCategoryService extends IService<BaseCategory1> {


    /**
     * 查询所有分类（1、2、3级分类）
     *
     * @return
     */
    List<JSONObject> getBaseCategoryList();
}

package com.atguigu.tingshu.album.service.impl;

import cn.hutool.core.collection.CollectionUtil;
import com.alibaba.fastjson.JSONObject;
import com.atguigu.tingshu.album.mapper.BaseCategory1Mapper;
import com.atguigu.tingshu.album.mapper.BaseCategory2Mapper;
import com.atguigu.tingshu.album.mapper.BaseCategory3Mapper;
import com.atguigu.tingshu.album.mapper.BaseCategoryViewMapper;
import com.atguigu.tingshu.album.service.BaseCategoryService;
import com.atguigu.tingshu.model.album.BaseCategory1;
import com.atguigu.tingshu.model.album.BaseCategoryView;
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.util.ArrayList;
import java.util.List;
import java.util.Map;
import java.util.stream.Collectors;

@Service
@SuppressWarnings({"all"})
public class BaseCategoryServiceImpl extends ServiceImpl<BaseCategory1Mapper, BaseCategory1> implements BaseCategoryService {

    @Autowired
    private BaseCategory1Mapper baseCategory1Mapper;

    @Autowired
    private BaseCategory2Mapper baseCategory2Mapper;

    @Autowired
    private BaseCategory3Mapper baseCategory3Mapper;

    @Autowired
    private BaseCategoryViewMapper baseCategoryViewMapper;


    /**
     * 查询所有分类（1、2、3级分类）
     * tips:数据从封装分类视图中获取，在业务代码中进行业务处理
     *
     * @return
     */
    @Override
    public List<JSONObject> getBaseCategoryList() {
        //1.创建目标集合对象
        List<JSONObject> allList = new ArrayList<>();

        //2.查询分类视图得到所有分类数据 共计401条记录
        List<BaseCategoryView> allCategoryList = baseCategoryViewMapper.selectList(null);

        //3.处理一级分类，对所有分类数据根据-根据一级分类ID分组
        //3.1 采用Stream流进行集合分组，得到Map集合，Map中key:1级分类ID Map中Value：1级分类集合
        Map<Long, List<BaseCategoryView>> category1Map =
                allCategoryList.stream()
                        .collect(Collectors.groupingBy(BaseCategoryView::getCategory1Id));
        if (CollectionUtil.isNotEmpty(category1Map)) {
            for (Map.Entry<Long, List<BaseCategoryView>> entry1 : category1Map.entrySet()) {
                //每遍历一次处理一个一级分类
                //3.2 获取一级分类ID 以及 名称
                Long category1Id = entry1.getKey();
                String category1Name = entry1.getValue().get(0).getCategory1Name();
                //3.3 构建一级分类JSON对象
                JSONObject jsonObject1 = new JSONObject();
                jsonObject1.put("categoryId", category1Id);
                jsonObject1.put("categoryName", category1Name);
                //4.在某个一级分类内，处理二级分类，对一级分类集合根据二级分类ID分组
                Map<Long, List<BaseCategoryView>> category2Map = entry1.getValue().stream().collect(Collectors.groupingBy(BaseCategoryView::getCategory2Id));
                //4.2 对某个一级分类集合按照二级分类ID进行分组 得到二级分类Map Map-key 二级分类ID Map-Value 二级分类集合
                if (CollectionUtil.isNotEmpty(category2Map)) {
                    List<JSONObject> jsonObject2List = new ArrayList<>();
                    for (Map.Entry<Long, List<BaseCategoryView>> entry2 : category2Map.entrySet()) {
                        //4.3 获取二级分类ID 以及 名称
                        Long category2Id = entry2.getKey();
                        String category2Name = entry2.getValue().get(0).getCategory2Name();
                        //4.4 遍历构建二级分类JSON对象 将二级分类对象加入到集合中
                        JSONObject jsonObject2 = new JSONObject();
                        jsonObject2.put("categoryId", category2Id);
                        jsonObject2.put("categoryName", category2Name);
                        //5.TODO 在某个二级分类内，处理三级分类
                        //5.1 遍历二级分类Map中Value
                        List<JSONObject> jsonObject3List = new ArrayList<>();
                        for (BaseCategoryView baseCategoryView : entry2.getValue()) {
                            //5.2 获取三级分类ID跟名称
                            Long category3Id = baseCategoryView.getCategory3Id();
                            String category3Name = baseCategoryView.getCategory3Name();
                            //5.3 构建三级分类JSON对象
                            JSONObject jsonObject3 = new JSONObject();
                            jsonObject3.put("categoryId", category3Id);
                            jsonObject3.put("categoryName", category3Name);
                            jsonObject3List.add(jsonObject3);
                        }
                        //5.4 将构建三级分类集合放入二级分类对象中"categoryChild"属性中
                        jsonObject2.put("categoryChild", jsonObject3List);
                        jsonObject2List.add(jsonObject2);
                    }
                    //4.5 将二级分类集合放入一级分类对象中"categoryChild"中
                    jsonObject1.put("categoryChild", jsonObject2List);
                }
                //3.4 将一级分类对象加入到所有目标集合对象中
                allList.add(jsonObject1);
            }
        }
        return allList;
    }
}

2.2 专辑标签列表

YAPI接口地址： http://192.168.200.6:3000/project/11/interface/api/15

2.2.1 控制器

在BaseCategoryApiController控制器中添加代码

/**
 * 根据一级分类Id获取分类（标签名包含标签值） 列表
 * @param category1Id 1级分类ID
 * @return
 */
@Operation(summary = "根据一级分类Id获取分类（标签名包含标签值） 列表")
@GetMapping("/category/findAttribute/{category1Id}")
public Result<List<BaseAttribute>> getAttributesByCategory1Id(@PathVariable Long category1Id){
    List<BaseAttribute> list = baseCategoryService.getAttributesByCategory1Id(category1Id);
    return Result.ok(list);
}

2.2.2 业务层

BaseCategoryService

/**
 * 根据一级分类Id获取分类（标签名包含标签值） 列表
 * @param category1Id 1级分类ID
 * @return
 */
List<BaseAttribute> getAttributesByCategory1Id(Long category1Id);

BaseCategoryServiceImpl

@Autowired
private BaseAttributeMapper baseAttributeMapper;


/**
 * 根据一级分类Id获取分类（标签名包含标签值） 列表
 * @param category1Id 1级分类ID
 * @return
 */
@Override
public List<BaseAttribute> getAttributesByCategory1Id(Long category1Id) {
    //调用持久层动态SQL完成一对多查询
    return baseAttributeMapper.getAttributesByCategory1Id(category1Id);
}

2.2.3 持久层

在BaseAttributeMapper中添加方法

package com.atguigu.tingshu.album.mapper;

import com.atguigu.tingshu.model.album.BaseAttribute;
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

@Mapper
public interface BaseAttributeMapper extends BaseMapper<BaseAttribute> {


    /**
     * 根据一级分类Id获取分类（标签名包含标签值） 列表
     * @param category1Id 1级分类ID
     * @return
     */
    List<BaseAttribute> getAttributesByCategory1Id(@Param("category1Id") Long category1Id);
}

动态SQL：

#根据1级分类ID查询该分类下关联标签及标签值 标签-标签：一对多
# 查询表：base_attribute，base_attribute_value
# 关联条件：base_attribute_value值表中逻辑外键：标签ID 跟 base_attribute标签表主键
# 关联方式：内连接（满足关联条件记录才会显示），外连接（左外连接，即使不满足关联条件，左表所有记录都会显示，右表列使用null） 都可以
# 确定查询条件：根据1级分类ID查询
# 确认分组，确定排序等

select *
from base_attribute;

select *
from base_attribute_value;


select
    ba.id,
    ba.category1_id,
    ba.attribute_name,
    bav.id base_attribute_value_id,
    bav.attribute_id,
    bav.value_name
    from base_attribute ba left join base_attribute_value bav on bav.attribute_id = ba.id
where ba.category1_id = ? and ba.is_deleted = 0

在resources目录下创建mapper目录并添加配置文件BaseAttributeMapper.xml

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd" >
<mapper namespace="com.atguigu.tingshu.album.mapper.BaseAttributeMapper">

    <!--自定义结果集：封装一对多，将某个标签下包含标签值封装到一方集合属性中-->
    <resultMap id="baseAttributeMap" type="com.atguigu.tingshu.model.album.BaseAttribute" autoMapping="true">
        <!--封装主键及普通字段-->
        <id column="id" property="id"></id>
        <!--collection标签 封装集合属性attributeValueList ofType：多方对应类型-->
        <collection property="attributeValueList" ofType="com.atguigu.tingshu.model.album.BaseAttributeValue" autoMapping="true">
            <!--封装多方注解及普通字段-->
            <id column="base_attribute_value_id" property="id"></id>
        </collection>
    </resultMap>

    <!--根据一级分类Id获取分类（标签名包含标签值） 列表-->
    <select id="getAttributesByCategory1Id" resultMap="baseAttributeMap">
        select
            ba.id,
            ba.category1_id,
            ba.attribute_name,
            bav.id base_attribute_value_id,
            bav.attribute_id,
            bav.value_name
        from base_attribute ba left join base_attribute_value bav on bav.attribute_id = ba.id
        where ba.category1_id = #{category1Id}
          and ba.is_deleted = 0
    </select>
</mapper>

2.3 分布式文件存储

2.3.1 MinIO 简介

​ MinIO 是一个基于Apache License v3.0开源协议的对象存储服务。它兼容亚马逊S3云存储服务接口，非常适合于存储大容量非结构化的数据，例如图片、视频、日志文件、备份数据和容器/虚拟机镜像等，而一个对象文件可以是任意大小，从几kb到最大5T不等。

MinIO是一个非常轻量的服务,可以很简单的和其他应用的结合，类似 NodeJS, Redis 或者 MySQL。

https://docs.min.io/ 英文

特点

• 高性能：作为高性能对象存储，在标准硬件条件下它能达到55GB/s的读、35GB/s的写速率

• 可扩容：不同MinIO集群可以组成联邦，并形成一个全局的命名空间，并跨越多个数据中心

• 云原生：容器化、基于K8S的编排、多租户支持

• Amazon S3兼容：Minio使用Amazon S3 v2 / v4 API。可以使用Minio SDK，Minio Client，AWS SDK和AWS CLI访问Minio服务器。

• 可对接后端存储: 除了Minio自己的文件系统，还支持DAS、 JBODs、NAS、Google云存储和Azure Blob存储。

• SDK支持: 基于Minio轻量的特点，它得到类似Java、Python或Go等语言 的sdk支持

• Lambda计算: Minio服务器通过其兼容AWS SNS / SQS的事件通知服务触发Lambda功能。支持的目标是消息队列，如Kafka，NATS，AMQP，MQTT，Webhooks以及Elasticsearch，Redis，Postgres和MySQL等数据库。

• 有操作页面

• 功能简单: 这一设计原则让MinIO不容易出错、更快启动

• 支持纠删码：MinIO使用纠删码、Checksum来防止硬件错误和静默数据污染。在最高冗余度配置下，即使丢失1/2的磁盘也能恢复数据！

存储机制

​ Minio使用纠删码erasure code和校验和checksum。 即便丢失一半数量（N/2）的硬盘，仍然可以恢复数据。纠删码是一种恢复丢失和损坏数据的数学算法。

2.3.2 Docker安装(已完成)

docker pull minio/minio

docker run \ -p 9000:9000 \ -p 9001:9001 \ --name minio \ -d --restart=always \ -e "MINIO_ROOT_USER=admin" \ -e "MINIO_ROOT_PASSWORD=admin123456" \ -v /home/data:/data \ -v /home/config:/root/.minio \ minio/minio server /data --console-address ":9001"

浏览器访问：http://192.168.200.6:9001/minio/login，如图：

登录账户说明：安装时指定了登录账号：admin/admin123456

注意：文件上传时，需要调整一下linux 服务器的时间与windows 时间一致！

> 第一步：安装ntp服务
> yum -y install ntp
> 第二步：开启开机启动服务
> systemctl enable ntpd
> 第三步：启动服务  Tips:联网正常前提下如果定时同步失败，先停止服务，再启动
> systemctl stop ntpd
> systemctl start ntpd
> 第四步：更改时区
> timedatectl set-timezone Asia/Shanghai
> 第五步：启用ntp同步
> timedatectl set-ntp yes
> 第六步：同步时间
> ntpq -p
> ```

### 2.3.3 专辑图片上传

MinIO-JavaAPI：https://min.io/docs/minio/linux/developers/java/API.html

Tomcat默认限制上传文件大小：1MB

通过修改配置更改：

yaml spring: servlet:

multipart:
  max-file-size: 10MB     #单个文件最大限制
  max-request-size: 20MB  #多个文件最大限制

**业务需求**：在新增专辑前需要为专辑设置专辑封面，选中本机图片文件后将文件上传到MInIO，且返回上传后文件在线地址，方便用户进行预览。效果如下：

 ![image-20231001112153675](assets/image-20231001112153675.png)

> YAPI文档地址：http://192.168.200.6:3000/project/11/interface/api/13

java package com.atguigu.tingshu.album.api;

import com.atguigu.tingshu.album.service.FileUploadService; import com.atguigu.tingshu.common.result.Result; import io.swagger.v3.oas.annotations.Operation; import io.swagger.v3.oas.annotations.tags.Tag; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.web.bind.annotation.PostMapping; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; import org.springframework.web.multipart.MultipartFile;

@Tag(name = "上传管理接口") @RestController @RequestMapping("api/album") public class FileUploadApiController {

@Autowired
private FileUploadService fileUploadService;


/**
 * 将文件上传到分布式存储服务MinIO中
 *
 * @param file
 * @return
 */
@Operation(summary = "将文件上传到分布式存储服务MinIO中")
@PostMapping("/fileUpload")
public Result<String> fileUpload(MultipartFile file) {
    String fileUrl = fileUploadService.imageUpload(file);
    return Result.ok(fileUrl);
}

}

**配置MinIO客户端对象**

java package com.atguigu.tingshu.album.config;

import io.minio.MinioClient; import lombok.Data; import org.springframework.boot.context.properties.ConfigurationProperties; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration;

@Configuration @ConfigurationProperties(prefix = "minio") //读取节点 @Data public class MinioConstantProperties {

private String endpointUrl;
private String accessKey;
private String secreKey;
private String bucketName;


/**
 * 注册操作MInIO客户端对象
 * @return
 */
@Bean
public MinioClient minioClient() {
    return MinioClient.builder()
            .endpoint(endpointUrl)
            .credentials(accessKey, secreKey)
            .build();
}

}

**FileUploadService**

java package com.atguigu.tingshu.album.service;

import org.springframework.web.multipart.MultipartFile;

public interface FileUploadService {

/**
 * 将图片文件上传到MInIO
 * @param file 图片文件
 * @return 上传后图片在线地址
 */
String imageUpload(MultipartFile file);

}

**FileUploadServiceImpl**

java package com.atguigu.tingshu.album.service.impl;

import cn.hutool.core.date.DateUtil; import cn.hutool.core.io.FileUtil; import cn.hutool.core.util.IdUtil; import com.atguigu.tingshu.album.config.MinioConstantProperties; import com.atguigu.tingshu.album.service.FileUploadService; import com.atguigu.tingshu.common.execption.GuiguException; import io.minio.MinioClient; import io.minio.PutObjectArgs; import io.minio.errors.*; import lombok.extern.slf4j.Slf4j; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Service; import org.springframework.web.multipart.MultipartFile;

import javax.imageio.ImageIO; import java.awt.image.BufferedImage; import java.io.IOException; import java.security.InvalidKeyException; import java.security.NoSuchAlgorithmException;

/**

• @author: atguigu

• @create: 2023-12-08 10:24 */ @Slf4j @Service public class FileUploadServiceImpl implements FileUploadService {

  @Autowired private MinioClient minioClient;

  @Autowired private MinioConstantProperties props;

  /**

  • 将图片文件上传到MInIO *
  • @param file 图片文件

  • @return 上传后图片在线地址 */ @Override public String imageUpload(MultipartFile file) { try {

    //1.业务校验验证文件是否为图片，借助ImageIO读取图片。继续判断图片文件后缀名是否符合要求，图片长宽
    BufferedImage read = ImageIO.read(file.getInputStream());
    if (read == null) {
        throw new GuiguException(400, "图片格式非法！");
    }
    
    //2.调用MInIO-Java客户端对象将文件上传到MInIO-文件上传
    //2.1 动态生成上传文件名称 /当日日期/UUID.后缀
    String folderName = "/" + DateUtil.today() + "/";
    String fileName = IdUtil.randomUUID();
    String extName = FileUtil.extName(file.getOriginalFilename());  //
    String objectName = folderName + fileName + "." + extName;
    //2.2 调用文件上传接口
    minioClient.putObject(
            PutObjectArgs.builder().bucket(props.getBucketName()).object(objectName).stream(
                            file.getInputStream(), file.getSize(), -1)
                    .contentType(file.getContentType())
                    .build());
    
    //3.拼接上传文件成功后在线地址 http://ip:9000/存储空间名称/路径/文件标识名称
    return props.getEndpointUrl()+"/"+props.getBucketName()+objectName;
    

    } catch (Exception e) {

    log.error("[专辑服务]上传图片文件异常：{}", e);
    throw new RuntimeException(e);
    

    } } }

    
    ## 2.4 保存专辑
    
    设为私密：表示不发布的意思，后续可以通过这个按钮选项实现专辑的上架-下架操作
    
    涉及的表：
    
    - **album_info** 专辑表  
    - 初始化userId 默认值1 为了后续能查到数据
    - 并设置初始化状态为审核通过
    - 如果是付费专辑则设置前五集为免费试看
    
    - **album_attribute_value** 专辑属性值表
    - 设置专辑Id
    
    - **album_stat** 专辑统计表
    - 初始化统计数目为0
    
    ### 2.4.1 控制层
    
    > YAPI接口地址：http://192.168.200.6:3000/project/11/interface/api/17
    
    **Tips**：新增的专辑需要将专辑关联到主播用户，但由于还未完成登录功能，故在获取用户工具类`AuthContextHolder`中**getUserId方法中**将获取用户ID的返回值写为固定。
    
    ![image-20231002093707199](assets/image-20231002093707199.png)
    
    在`service-album`模块中**AlbumInfoApiController**
    
    

    java

package com.atguigu.tingshu.album.api;

import com.atguigu.tingshu.album.service.AlbumInfoService; import com.atguigu.tingshu.common.result.Result; import com.atguigu.tingshu.common.util.AuthContextHolder; import com.atguigu.tingshu.model.album.AlbumInfo; import com.atguigu.tingshu.vo.album.AlbumInfoVo; import com.tencentcloudapi.cat.v20180409.models.AlarmInfo; import io.swagger.v3.oas.annotations.Operation; import io.swagger.v3.oas.annotations.tags.Tag; import org.apache.commons.lang3.StringUtils; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.validation.annotation.Validated; import org.springframework.web.bind.annotation.PostMapping; import org.springframework.web.bind.annotation.RequestBody; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController;

@Tag(name = "专辑管理") @RestController @RequestMapping("api/album") @SuppressWarnings({"all"}) public class AlbumInfoApiController {

@Autowired private AlbumInfoService albumInfoService;

/** * TODO 该接口登录才能访问，目前并未实现登录无法获取用户ID * 提供给内容创作者/运营人员保存专辑 * @param albumInfoVo * @return */ @Operation(summary = "保存专辑") @PostMapping("/albumInfo/saveAlbumInfo") public Result saveAlbumInfo(@RequestBody @Validated AlbumInfoVo albumInfoVo){ //1.获取登录用户ID 从ThreadLocal工具类中获取 暂时硬编码为：1 Long userId = AuthContextHolder.getUserId(); //2.调用业务逻辑保存专辑 albumInfoService.saveAlbumInfo(userId, albumInfoVo); return Result.ok(); } }

### 2.4.2 业务层

**AlbumInfoService接口**

java package com.atguigu.tingshu.album.service;

import com.atguigu.tingshu.model.album.AlbumInfo; import com.atguigu.tingshu.vo.album.AlbumInfoVo; import com.baomidou.mybatisplus.extension.service.IService;

public interface AlbumInfoService extends IService {

/**
 * 保存专辑方法
 * @param userId 用户ID
 * @param albumInfoVo 专辑信息VO对象
 */
void saveAlbumInfo(Long userId, AlbumInfoVo albumInfoVo);


/**
 * 保存专辑统计信息
 * @param albumId 专辑ID
 * @param statType 统计类型
 * @param statNum 统计数量
 */
void saveAlbumStat(Long albumId, String statType, int statNum);

}

**AlbumInfoServiceImpl实现类**

java package com.atguigu.tingshu.album.service.impl;

import cn.hutool.core.bean.BeanUtil; import cn.hutool.core.collection.CollectionUtil; import com.atguigu.tingshu.album.mapper.AlbumAttributeValueMapper; import com.atguigu.tingshu.album.mapper.AlbumInfoMapper; import com.atguigu.tingshu.album.mapper.AlbumStatMapper; import com.atguigu.tingshu.album.service.AlbumInfoService; import com.atguigu.tingshu.common.constant.SystemConstant; import com.atguigu.tingshu.model.album.AlbumAttributeValue; import com.atguigu.tingshu.model.album.AlbumInfo; import com.atguigu.tingshu.model.album.AlbumStat; import com.atguigu.tingshu.model.search.AlbumInfoIndex; import com.atguigu.tingshu.vo.album.AlbumAttributeValueVo; import com.atguigu.tingshu.vo.album.AlbumInfoVo; import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl; import lombok.extern.slf4j.Slf4j; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional;

import java.util.List;

@Slf4j @Service @SuppressWarnings({"all"}) public class AlbumInfoServiceImpl extends ServiceImpl implements AlbumInfoService {

@Autowired
private AlbumInfoMapper albumInfoMapper;

@Autowired
private AlbumAttributeValueMapper albumAttributeValueMapper;

@Autowired
private AlbumStatMapper albumStatMapper;

/**
 * 保存专辑方法
 * 1.将提交专辑VO转为PO对象，新增专辑
 * 2.将提交专辑标签封装为专辑标签关系集合对象，进行批量保存
 * 3.为新增专辑标签，批量保存专辑统计信息
 *
 * @param userId      用户ID
 * @param albumInfoVo 专辑信息VO对象
 */
@Override
@Transactional(rollbackFor = Exception.class) //默认事务注解修饰方法捕获运行时异常或者Error
public void saveAlbumInfo(Long userId, AlbumInfoVo albumInfoVo) {
    //1.保存专辑
    //1.1 将提交专辑VO拷贝到专辑PO对象中 仅限同名同类型属性才会被拷贝
    AlbumInfo albumInfo = BeanUtil.copyProperties(albumInfoVo, AlbumInfo.class);

    //1.2 手动为用户id、包含声音数量（0）、是否完结、免费试听集数、审核状态（TODO：审核通过，实则有内容审核机制）
    albumInfo.setUserId(userId);
    albumInfo.setIncludeTrackCount(0);
    albumInfo.setIsFinished("0");
    albumInfo.setTracksForFree(5);
    albumInfo.setStatus(SystemConstant.ALBUM_STATUS_PASS);
    //1.3 保存专辑，得到专辑ID
    albumInfoMapper.insert(albumInfo);
    Long albumId = albumInfo.getId();

    //2.保存专辑标签关系
    //2.1 将提交专辑标签关系VO集合转为PO集合
    List<AlbumAttributeValueVo> albumAttributeValueVoList = albumInfoVo.getAlbumAttributeValueVoList();
    if (CollectionUtil.isNotEmpty(albumAttributeValueVoList)) {
        //2.2 关联专辑ID批量保存专辑标签关系
        for (AlbumAttributeValueVo albumAttributeValueVo : albumAttributeValueVoList) {
            AlbumAttributeValue albumAttributeValue = BeanUtil.copyProperties(albumAttributeValueVo, AlbumAttributeValue.class);
            albumAttributeValue.setAlbumId(albumId);
            albumAttributeValueMapper.insert(albumAttributeValue);
        }

    }
    //3.保存专辑统计信息（4条）
    this.saveAlbumStat(albumId, SystemConstant.ALBUM_STAT_PLAY, 0);
    this.saveAlbumStat(albumId, SystemConstant.ALBUM_STAT_SUBSCRIBE, 0);
    this.saveAlbumStat(albumId, SystemConstant.ALBUM_STAT_BUY, 0);
    this.saveAlbumStat(albumId, SystemConstant.ALBUM_STAT_COMMENT, 0);
}

/**
 * 保存专辑统计信息
 * @param albumId 专辑ID
 * @param statType 统计类型
 * @param statNum 统计数量
 */
@Override
public void saveAlbumStat(Long albumId, String statType, int statNum) {
    AlbumStat albumStat = new AlbumStat();
    albumStat.setAlbumId(albumId);
    albumStat.setStatType(statType);
    albumStat.setStatNum(statNum);
    albumStatMapper.insert(albumStat);
}

}

# 3、查看专辑列表

​   需求：创作者中心-->查询**当前登录用户**发布的专辑列表,每个专辑包含：专辑ID，专辑封面图片、专辑名称、专辑包含声音个数、创建时间、**播放量、购买量、订阅数、评论数量**等 ；根据专辑审核状态及任意关键字进行模糊查询。

  ![](assets/image-20231114083625117.png)

> YAPI接口文档：http://192.168.200.6:3000/project/11/interface/api/19

## 3.1 控制层

**AlbumInfoApiController控制器**

查询数据的时候，我们将页面渲染的数据封装到一个实体类中AlbumListVo，只需要返回这个类的集合即可！

java /**

• TODO 该接口登录才能访问
• 查询当前用户专辑分页列表
• @param page 页码
• @param limit 页大小
• @param albumInfoQuery 查询条件对象

• @return */ @Operation(summary = "查询当前用户专辑分页列表") @PostMapping("/albumInfo/findUserAlbumPage/{page}/{limit}") public Result> getUserAlbumPage( @PathVariable int page, @PathVariable int limit, @RequestBody AlbumInfoQuery albumInfoQuery){ //1.获取登录用户ID 从ThreadLocal工具类中获取 暂时硬编码为：1 Long userId = AuthContextHolder.getUserId(); albumInfoQuery.setUserId(userId); //2.构建MP分页对象Page web层封装页码页大小 Page pageInfo = new Page<>(page, limit); //3.调用业务逻辑分页专辑 其余分页属性：总记录数，总页数，当前页数据到持久层查询完成封装 pageInfo = albumInfoService.getUserAlbumPage(pageInfo, albumInfoQuery); return Result.ok(pageInfo); }

  
  ## 3.2 业务层
  
  **AlbumInfoService接口**
  
  

  java

  /**

  • 查询当前用户专辑分页列表
  • @param pageInfo 分页对象
  • @param albumInfoQuery 查询条件对象

  • @return */ Page getUserAlbumPage(Page pageInfo, AlbumInfoQuery albumInfoQuery);

    
    **AlbumInfoServiceImpl实现类**
    
    

    java

    /**

    • 查询当前用户专辑分页列表 *
    • @param pageInfo 分页对象
    • @param albumInfoQuery 查询条件对象

    • @return */ @Override public Page getUserAlbumPage(Page pageInfo, AlbumInfoQuery albumInfoQuery) { return albumInfoMapper.getUserAlbumPage(pageInfo, albumInfoQuery); }

      
      ## 3.3 持久层
      
      SQL演练：
      
      

      sql

      #需求：分页条件查询专辑列表，包含每个专辑四项统计信息（播放、订阅、购买、评论） #分页：只要在持久层传递Page对象,MP会自动完成分页（自动拼接limit SQL） #确定数据涉及到表：专辑信息表album_info、专辑统计信息表album_stat #确定表关联条件：统计表中逻辑外键album_id跟专辑表中主键ID关联 #确定关联方式：内->专辑包含统计信息记录会被展示 #查询条件：用户ID、审核状态、关键字模糊查询 select * from album_info; select * from album_stat;

      select * from album_info where id = 1; select * from album_stat where album_id = 1;

      #第一步：进行两张表关联查询 select * from album_info ai

           inner join album_stat stat
                      on stat.album_id = ai.id;
      

      #第二步：对以上查询SQL进一步进行处理：将每个专辑对应四条统计记录由行转为列。四项统计信息封装到专辑对象中四个属性中 select

      ai.id albumId,
      ai.album_title,
      ai.cover_url,
      ai.include_track_count,
      ai.create_time,
      stat.stat_type,
      stat.stat_num
      

      from album_info ai

           inner join album_stat stat
                      on stat.album_id = ai.id;
      

      #第三步，根据专辑ID进行分组 select

      ai.id albumId,
      ai.album_title,
      ai.cover_url,
      ai.include_track_count,
      ai.create_time
      

      from album_info ai

           inner join album_stat stat
                      on stat.album_id = ai.id
      

      group by ai.id;

      #违背SQL严格模式only_full_group_by规则：在select中只能出现group by子句中列或者聚合函数 select

      ai.id albumId,
      ai.album_title,
      ai.cover_url,
      ai.include_track_count,
      ai.create_time,
      stat.stat_type,
      stat.stat_num
      

      from album_info ai

           inner join album_stat stat
                      on stat.album_id = ai.id
      

      group by ai.id;

      #第四步：通过判断if函数得到每个统计数值。select 子句可以出现聚合函数 select if(1=2, 'true', 'false'); #p1条件 满足条件则返回p2 否则返回p3 select

      ai.id albumId,
      ai.album_title,
      ai.cover_url,
      ai.include_track_count,
      ai.create_time,
      max(if(stat.stat_type = '0401', stat_num, 0)) playStatNum,
      max(if(stat.stat_type = '0402', stat_num, 0)) subscribeStatNum,
      max(if(stat.stat_type = '0403', stat_num, 0)) buyStatNum,
      max(if(stat.stat_type = '0404', stat_num, 0)) commentStatNum
      

      from album_info ai

           inner join album_stat stat
                      on stat.album_id = ai.id
      

      group by ai.id;

      #第五步完善查询条件，排序 select

      ai.id albumId,
      ai.album_title,
      ai.cover_url,
      ai.include_track_count,
      ai.create_time,
      max(if(stat.stat_type = '0401', stat_num, 0)) playStatNum,
      max(if(stat.stat_type = '0402', stat_num, 0)) subscribeStatNum,
      max(if(stat.stat_type = '0403', stat_num, 0)) buyStatNum,
      max(if(stat.stat_type = '0404', stat_num, 0)) commentStatNum
      

      from album_info ai

           inner join album_stat stat
                      on stat.album_id = ai.id
      

      where ai.user_id = ? and ai.is_deleted = 0

      and status = ?
      and ai.album_title like ?
      

      group by ai.id order by ai.id desc

      
      **AlbumInfoMapper **
      
      

      java package com.atguigu.tingshu.album.mapper;

      import com.atguigu.tingshu.model.album.AlbumInfo; import com.atguigu.tingshu.query.album.AlbumInfoQuery; import com.atguigu.tingshu.vo.album.AlbumListVo; import com.baomidou.mybatisplus.core.mapper.BaseMapper; import com.baomidou.mybatisplus.extension.plugins.pagination.Page; import org.apache.ibatis.annotations.Mapper; import org.apache.ibatis.annotations.Param;

      @Mapper public interface AlbumInfoMapper extends BaseMapper {

      /**
       * 查询当前用户专辑分页列表
       * @param pageInfo 分页对象 MP框架会自动识别到分页对象自动完成分页SQL（1.根据条件查询数量 2.根据条件查询当前页数据）
       * @param albumInfoQuery 查询条件对象
       * @return
       */
      Page<AlbumListVo> getUserAlbumPage(Page<AlbumListVo> pageInfo, @Param("vo") AlbumInfoQuery albumInfoQuery);
      

      }

      
      **AlbumInfoMapper.xml 实现**
      
      

      xml <?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd" >

      <!--查询当前用户专辑分页列表-->
      <select id="getUserAlbumPage" resultType="com.atguigu.tingshu.vo.album.AlbumListVo">
          select
              ai.id albumId,
              ai.album_title,
              ai.cover_url,
              ai.include_track_count,
              ai.create_time,
              max(if(stat.stat_type = '0401', stat_num, 0)) playStatNum,
              max(if(stat.stat_type = '0402', stat_num, 0)) subscribeStatNum,
              max(if(stat.stat_type = '0403', stat_num, 0)) buyStatNum,
              max(if(stat.stat_type = '0404', stat_num, 0)) commentStatNum
          from album_info ai
                   inner join album_stat stat
                              on stat.album_id = ai.id
          <where>
              <if test="vo.userId != null">
                  ai.user_id = #{vo.userId}
              </if>
              <if test="vo.status != null and vo.status != ''">
                  and ai.status = #{vo.status}
              </if>
              <if test="vo.albumTitle != null and vo.albumTitle != ''">
                  and ai.album_title like concat('%', #{vo.albumTitle} ,'%')
              </if>
          </where>
          and ai.is_deleted = 0
          group by ai.id
          order by ai.id desc
      </select>
      

      
      # 4、删除专辑
      
      在本项目中所有删除都采用逻辑删除，利用MybatisPlus提供逻辑删除。在表中提供逻辑删除字段：is_deleted
      
      在Java实体类中映射逻辑删除字段，属性使用@TableLogic，调用MP提供持久层或者业务层删除方法时候，自动实现逻辑删除（修改操作）
      
      > YAPI接口地址：http://192.168.200.6:3000/project/11/interface/api/21
      
      ## 4.1 控制层
      
      **AlbumInfoApiController控制器**
      
      

      java /**

      • TODO 该接口登录才能访问
      • 根据专辑ID删除专辑
      • @param id

      • @return */ @Operation(summary = "根据专辑ID删除专辑") @DeleteMapping("/albumInfo/removeAlbumInfo/{id}") public Result removeAlbumInfo(@PathVariable Long id){ albumInfoService.removeAlbumInfo(id); return Result.ok(); }

        
        ## 4.2 业务层
        
        **AlbumInfoService接口**
        
        

        java

      /**

      • 根据专辑ID删除专辑
      • @param id

      • @return */ void removeAlbumInfo(Long id);

        
        **AlbumInfoServiceImpl实现类**
        
        

        java

      @Autowired private TrackInfoMapper trackInfoMapper;

      /**

      • 根据专辑ID删除专辑 *
      • @param id

      • @return */ @Override @Transactional(rollbackFor = Exception.class) public void removeAlbumInfo(Long id) { //1.根据专辑ID查询该专辑下包含声音 如果关联声音则不允许删除 LambdaQueryWrapper queryWrapper = new LambdaQueryWrapper<>(); queryWrapper.eq(TrackInfo::getAlbumId, id); Long count = trackInfoMapper.selectCount(queryWrapper); if (count > 0) {

        throw new GuiguException(400, "该专辑下存在未删除声音！");
        

        } //2.根据主键删除专辑 albumInfoMapper.deleteById(id);

        //3.根据专辑ID删除专辑标签 LambdaQueryWrapper albumAttributeValueLambdaQueryWrapper = new LambdaQueryWrapper<>(); albumAttributeValueLambdaQueryWrapper.eq(AlbumAttributeValue::getAlbumId, id); albumAttributeValueMapper.delete(albumAttributeValueLambdaQueryWrapper);

        //4.根据专辑ID删除专辑统计数据 LambdaQueryWrapper albumStatLambdaQueryWrapper = new LambdaQueryWrapper<>(); albumStatLambdaQueryWrapper.eq(AlbumStat::getAlbumId, id); albumStatMapper.delete(albumStatLambdaQueryWrapper);

        }

        
        # 5、专辑修改
        
        ## 5.1 回显数据
        
        1. 需要根据专辑id获取到对应的回显数据，需要回显专辑与属性数据，不需要回显统计数据！
        2. 根据修改内容保存最新数据
        
        > YAPI接口地址：http://192.168.200.6:3000/project/11/interface/api/23
        
        **AlbumInfoApiController控制器**
        
        

        java /**

        • 根据专辑ID查询专辑信息（包含专辑标签及值）
        • @param id

        • @return */ @GetMapping("/albumInfo/getAlbumInfo/{id}") @Operation(summary = "根据专辑ID查询专辑信息（包含专辑标签及值）") public Result getAlbumInfo(@PathVariable Long id){ AlbumInfo albumInfo = albumInfoService.getAlbumInfo(id); return Result.ok(albumInfo); }

          
          **AlbumInfoService接口**
          
          

          java

        /**

        • 根据专辑ID查询专辑信息（包含专辑标签及值）
        • @param id

        • @return */ AlbumInfo getAlbumInfo(Long id);

          
          **AlbumInfoServiceImpl实现类**
          
          

          java

        /**

        • 根据专辑ID查询专辑信息（包含专辑标签及值） *
        • @param id

        • @return */ @Override public AlbumInfo getAlbumInfo(Long id) { //1.根据专辑ID主键查询专辑信息 AlbumInfo albumInfo = albumInfoMapper.selectById(id); //2.根据专辑ID查询标签列表 if (albumInfo != null) {

          LambdaQueryWrapper<AlbumAttributeValue> queryWrapper = new LambdaQueryWrapper<>();
          queryWrapper.eq(AlbumAttributeValue::getAlbumId, id);
          List<AlbumAttributeValue> attributeValueList = albumAttributeValueMapper.selectList(queryWrapper);
          albumInfo.setAlbumAttributeValueVoList(attributeValueList);
          

          } return albumInfo; }

          
          
          
          ## 5.2 保存修改后数据
          
          涉及的表：
          
          - album_info    根据主键进行更新
          - album_attribute_value  先删除所有数据，再新增数据
          
          > YAPI接口地址：http://192.168.200.6:3000/project/11/interface/api/25
          
          **AlbumInfoApiController控制器**
          
          

          java

        /**

        • TODO 该接口登录才能访问
        • 修改专辑信息
        • @param id 专辑ID
        • @param albumInfoVo 修改专辑信息VO对象

        • @return */ @Operation(summary = "修改专辑信息") @PutMapping("/albumInfo/updateAlbumInfo/{id}") public Result updateAlbumInfo(@PathVariable Long id, @RequestBody @Validated AlbumInfoVo albumInfoVo){ albumInfoService.updateAlbumInfo(id, albumInfoVo); return Result.ok(); }

          
          **AlbumInfoService接口**
          
          

          java

        /**

        • 修改专辑信息
        • @param id 专辑ID
        • @param albumInfoVo 修改专辑信息VO对象

        • @return */ void updateAlbumInfo(Long id, AlbumInfoVo albumInfoVo);

          
          **AlbumInfoServiceImpl实现类**
          
          

          java

        /**

        • 修改专辑信息 *
        • @param id 专辑ID
        • @param albumInfoVo 修改专辑信息VO对象

        • @return */ @Override @Transactional(rollbackFor = Exception.class) public void updateAlbumInfo(Long id, AlbumInfoVo albumInfoVo) { //1.修改专辑信息 //2.1 将修改专辑信息转为PO对象 封装专辑ID AlbumInfo albumInfo = BeanUtil.copyProperties(albumInfoVo, AlbumInfo.class); albumInfo.setId(id); //2.2 修改专辑 albumInfoMapper.updateById(albumInfo);

          //2.修改专辑标签 先删再新增 //2.1 根据专辑ID将以前关联标签记录全部删除 LambdaQueryWrapper queryWrapper = new LambdaQueryWrapper<>(); queryWrapper.eq(AlbumAttributeValue::getAlbumId, id); albumAttributeValueMapper.delete(queryWrapper);

          //2.2 在根据提交专辑标签做新增 List albumAttributeValueVoList = albumInfoVo.getAlbumAttributeValueVoList(); if (CollectionUtil.isNotEmpty(albumAttributeValueVoList)) {

          //2.2 关联专辑ID批量保存专辑标签关系
          for (AlbumAttributeValueVo albumAttributeValueVo : albumAttributeValueVoList) {
              AlbumAttributeValue albumAttributeValue = BeanUtil.copyProperties(albumAttributeValueVo, AlbumAttributeValue.class);
              albumAttributeValue.setAlbumId(id);
              albumAttributeValueMapper.insert(albumAttributeValue);
          }
          

          } } ```