using Dpz.Core.Public.ViewModel.Request;
using Dpz.Core.Public.ViewModel.Response;

namespace Dpz.Core.Service.RepositoryService;

public interface IMumbleService
{
    /// <summary>
    /// 创建新的碎碎念
    /// </summary>
    /// <param name="request"></param>
    /// <param name="cancellationToken">传播通知操作应取消的通知令牌</param>
    /// <returns></returns>
    Task<MumbleResponse> CreateAsync(
        CreateMumbleRequest request,
        CancellationToken cancellationToken = default
    );

    /// <summary>
    /// 编辑碎碎念
    /// </summary>
    /// <param name="request"></param>
    /// <param name="cancellationToken">传播通知操作应取消的通知令牌</param>
    /// <returns></returns>
    Task<MumbleResponse?> EditContentAsync(
        EditMumbleRequest request,
        CancellationToken cancellationToken = default
    );

    /// <summary>
    /// 获取分页信息
    /// </summary>
    /// <param name="pageIndex"></param>
    /// <param name="pageSize"></param>
    /// <param name="content"></param>
    /// <param name="account">账号</param>
    /// <param name="cancellationToken">传播通知操作应取消的通知令牌</param>
    /// <returns></returns>
    Task<IPagedList<MumbleResponse>> GetPagesAsync(
        int pageIndex,
        int pageSize,
        string? content = null,
        string? account = null,
        CancellationToken cancellationToken = default
    );

    /// <summary>
    /// 获取历史上的今天的碎碎念
    /// 如果历史上的今天没有发布碎碎念,将会随机返回
    /// </summary>
    /// <param name="count"></param>
    /// <param name="cancellationToken">传播通知操作应取消的通知令牌</param>
    /// <returns></returns>
    Task<List<MumbleResponse>> GetHistoryMumblesAsync(
        int count,
        CancellationToken cancellationToken = default
    );

    /// <summary>
    /// 根据ID查找碎碎念信息
    /// </summary>
    /// <param name="id"></param>
    /// <param name="cancellationToken">传播通知操作应取消的通知令牌</param>
    /// <returns></returns>
    Task<MumbleResponse?> FindAsync(string id, CancellationToken cancellationToken = default);

    /// <summary>
    /// 根据ID删除碎碎念信息
    /// </summary>
    /// <param name="id"></param>
    /// <param name="cancellationToken"></param>
    /// <returns></returns>
    Task DeleteAsync(string[] id, CancellationToken cancellationToken = default);

    /// <summary>
    /// 点赞
    /// </summary>
    /// <param name="id"></param>
    /// <param name="cancellationToken">传播通知操作应取消的通知令牌</param>
    /// <returns></returns>
    Task<MumbleResponse?> LikeAsync(string id, CancellationToken cancellationToken = default);

    /// <summary>
    /// 更新碎碎念评论数
    /// </summary>
    /// <param name="mumbleId">碎碎念ID</param>
    /// <param name="count">评论数</param>
    /// <param name="cancellationToken"></param>
    Task UpdateCommentCountAsync(
        string mumbleId,
        int count,
        CancellationToken cancellationToken = default
    );
}
⚠⚠    以下内容为AI分析的结果,请根据实际情况进行判断。

代码解释

这是一个 C# 接口定义文件,定义了一个名为 IMumbleService 的服务接口,用于管理"碎碎念"(Mumble)功能的业务逻辑。

整体结构

  • 命名空间: Dpz.Core.Service.RepositoryService
  • 接口名称: IMumbleService
  • 功能: 提供碎碎念(类似微博、Twitter 的短消息)的 CRUD 操作及相关业务功能

接口方法详解

1. CreateAsync - 创建碎碎念

Task<MumbleResponse> CreateAsync(CreateMumbleRequest request, CancellationToken cancellationToken)
  • 创建新的碎碎念记录
  • 返回创建后的碎碎念响应对象

2. EditContentAsync - 编辑碎碎念

Task<MumbleResponse?> EditContentAsync(EditMumbleRequest request, CancellationToken cancellationToken)
  • 编辑现有碎碎念的内容
  • 返回更新后的碎碎念(可能为 null)

3. GetPagesAsync - 分页查询

Task<IPagedList<MumbleResponse>> GetPagesAsync(int pageIndex, int pageSize, string? content, string? account, CancellationToken cancellationToken)
  • 支持分页获取碎碎念列表
  • 可选参数:按内容搜索、按账号筛选
  • 返回分页结果集

4. GetHistoryMumblesAsync - 历史上的今天

Task<List<MumbleResponse>> GetHistoryMumblesAsync(int count, CancellationToken cancellationToken)
  • 获取历史上同一天发布的碎碎念
  • 如果当天历史记录为空,则随机返回
  • 类似于"回忆功能"

5. FindAsync - 按 ID 查找

Task<MumbleResponse?> FindAsync(string id, CancellationToken cancellationToken)
  • 根据唯一标识符查找单条碎碎念

6. DeleteAsync - 批量删除

Task DeleteAsync(string[] id, CancellationToken cancellationToken)
  • 支持批量删除多条碎碎念
  • 接收 ID 数组

7. LikeAsync - 点赞功能

Task<MumbleResponse?> LikeAsync(string id, CancellationToken cancellationToken)
  • 对指定碎碎念进行点赞
  • 返回更新后的碎碎念信息

8. UpdateCommentCountAsync - 更新评论数

Task UpdateCommentCountAsync(string mumbleId, int count, CancellationToken cancellationToken)
  • 更新碎碎念的评论计数
  • 用于同步评论数量

设计特点

  1. 异步设计: 所有方法都返回 Task,支持异步操作
  2. 取消令牌: 每个方法都支持 CancellationToken,可以取消长时间运行的操作
  3. 可空返回: 部分方法返回可空类型(?),处理找不到数据的情况
  4. 分层架构: 使用 Request/Response 模式,清晰分离输入输出
  5. 社交功能: 包含点赞、评论等社交网络常见功能

这是一个典型的 Repository Service 层接口,遵循依赖倒置原则,具体实现会在实现类中完成。

评论加载中...