主播数据查询接口实现

src/main/java/com/yupi/springbootinit/model/dto/host/HostInfoDTO.java

@@ -1,7 +1,12 @@
 package com.yupi.springbootinit.model.dto.host;
 
+import com.fasterxml.jackson.annotation.JsonFormat;
+import com.yupi.springbootinit.common.PageRequest;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 
+import java.io.Serializable;
 import java.util.Date;
 
 /*
@@ -9,80 +14,157 @@ import java.util.Date;
  * @date: 2025/6/10 18:58
  */
 @Data
-public class HostInfoDTO {
+@ApiModel("主播信息DTO类")
+public class HostInfoDTO extends PageRequest implements Serializable {
 
     /**
      * 主键
      */
+    @ApiModelProperty(value = "主键ID", example = "1")
     private Long id;
 
     /**
      * 主播id
      */
+    @ApiModelProperty(value = "主播ID", example = "host123")
     private String hostsId;
 
     /**
      * 主播等级
      */
+    @ApiModelProperty(value = "主播等级", example = "A")
     private String hostsLevel;
 
     /**
      * 主播金币
      */
+    @ApiModelProperty(value = "主播当前金币数", example = "5000")
     private Integer hostsCoins;
 
+    /**
+     * 主播金币最大值
+     */
+    @ApiModelProperty(value = "主播金币查询最大值", example = "10000")
+    private Integer hostsCoinsMax;
+
+    /**
+     * 主播金币最小值
+     */
+    @ApiModelProperty(value = "主播金币查询最小值", example = "1000")
+    private Integer hostsCoinsMin;
+
     /**
      * 邀请类型
      */
+    @ApiModelProperty(value = "邀请类型(1:普票 2:金票)", example = "1")
     private Integer invitationType;
 
     /**
      * 粉丝数量
      */
+    @ApiModelProperty(value = "粉丝数量", example = "10000")
     private Integer fans;
 
+    /**
+     * 粉丝数量最大值
+     */
+    @ApiModelProperty(value = "粉丝数量查询最大值", example = "50000")
+    private Integer fansMax;
+
+    /**
+     * 粉丝数量最小值
+     */
+    @ApiModelProperty(value = "粉丝数量查询最小值", example = "1000")
+    private Integer fansMin;
+
     /**
      * 关注数量
      */
+    @ApiModelProperty(value = "关注数量", example = "500")
     private Integer fllowernum;
 
+    /**
+     * 关注数量最大值
+     */
+    @ApiModelProperty(value = "关注数量查询最大值", example = "1000")
+    private Integer fllowernumMax;
+
+    /**
+     * 关注数量最小值
+     */
+    @ApiModelProperty(value = "关注数量查询最小值", example = "100")
+    private Integer fllowernumMin;
+
     /**
      * 昨日金币
      */
+    @ApiModelProperty(value = "主播昨日金币数", example = "2000")
     private Integer yesterdayCoins;
 
+    /**
+     * 昨日金币最大值
+     */
+    @ApiModelProperty(value = "昨日金币查询最大值", example = "5000")
+    private Integer yesterdayCoinsMax;
+
+    /**
+     * 昨日金币最小值
+     */
+    @ApiModelProperty(value = "昨日金币查询最小值", example = "500")
+    private Integer yesterdayCoinsMin;
+
     /**
      * 主播国家
      */
+    @ApiModelProperty(value = "主播所在国家", example = "美国")
     private String country;
 
     /**
      * 直播类型 娱乐，游戏
      */
+    @ApiModelProperty(value = "直播类型(娱乐/游戏)", example = "娱乐")
     private String hostsKind;
 
     /**
      * 租户 Id
      */
+    @ApiModelProperty(value = "租户ID", example = "1001")
     private Long tenantId;
 
     /**
      * 入库人
      */
+    @ApiModelProperty(value = "数据创建人ID", example = "101")
     private Integer creator;
 
     /**
      * 数据插入时间
      */
+    @ApiModelProperty(value = "创建时间(yyyy-MM-dd)", example = "2023-01-01")
+    @JsonFormat(pattern = "yyyy-MM-dd", timezone = "GMT+8")
     private Date createTime;
 
     /**
-     * 更新人
+     * 数据插入最大
      */
-    private String updater;
+    @ApiModelProperty(value = "创建时间查询上限(yyyy-MM-dd)", example = "2023-12-31")
+    private Date createTimeMax;
 
     /**
-     * 更新时间
+     * 数据插入最小
      */
-    private Date updateTime;
+    @ApiModelProperty(value = "创建时间查询下限(yyyy-MM-dd)", example = "2023-01-01")
+    private Date createTimeMin;
+
+    /**
+     * 排序规则
+     */
+    @ApiModelProperty(value = "排序方式(asc/desc)", example = "desc")
+    private String sort;
+
+    /**
+     * 按照何种业务排序
+     */
+    @ApiModelProperty(value = "排序字段(createTime/hostsCoins/fans等)", example = "hostsCoins")
+    private String sortName;
 }

src/main/java/com/yupi/springbootinit/model/vo/hosts/NewHostsVO.java

@@ -2,6 +2,7 @@ package com.yupi.springbootinit.model.vo.hosts;
 
 import com.baomidou.mybatisplus.annotation.IdType;
 import com.baomidou.mybatisplus.annotation.TableId;
+import com.fasterxml.jackson.annotation.JsonFormat;
 import lombok.Data;
 
 import java.util.Date;
@@ -15,42 +16,49 @@ public class NewHostsVO {
     /**
     * 主键
     */
-    @TableId(value = "id", type = IdType.AUTO)
+    @TableId(value = "id")
     private Long id;
 
     /**
     * 主播id
     */
+    @TableId(value = "hosts_id")
     private String hostsId;
 
     /**
     * 主播等级
     */
+    @TableId(value = "hosts_level")
     private String hostsLevel;
 
     /**
     * 主播金币
     */
+    @TableId(value = "hosts_coins")
     private Integer hostsCoins;
 
     /**
     * 邀请类型
     */
+    @TableId(value = "invitation_type")
     private Integer invitationType;
 
     /**
     * 粉丝数量
     */
+    @TableId(value = "fans")
     private Integer fans;
 
     /**
     * 关注数量
     */
+    @TableId(value = "fllowernum")
     private Integer fllowernum;
 
     /**
     * 昨日金币
     */
+    @TableId(value = "yesterday_coins")
     private Integer yesterdayCoins;
 
     /**
@@ -61,21 +69,14 @@ public class NewHostsVO {
     /**
     * 直播类型 娱乐，游戏 
     */
+    @TableId(value = "hosts_kind")
     private String hostsKind;
 
-    /**
-    * 租户 Id
-    */
-    private Long tenantId;
-
-    /**
-    * 入库人
-    */
-    private Long creator;
-
     /**
     * 数据插入时间
     */
+    @TableId(value = "create_time")
+    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
     private Date createTime;
 
 }