IM/backend/IM_API/Interface/Services/IFriendSerivce.cs
nanxun 2d22b4bd27 后端:添加添加好友处理事件
文档:添加测试环境文档
2026-01-30 22:13:56 +08:00

72 lines
2.7 KiB
C#

using IM_API.Dtos;
using IM_API.Models;
namespace IM_API.Interface.Services
{
public interface IFriendSerivce
{
/// <summary>
/// 获取好友列表
/// </summary>
/// <param name="userId">指定用户</param>
/// <param name="page">当前页</param>
/// <param name="limit">分页大小</param>
/// <returns></returns>
Task<List<FriendInfoDto>> GetFriendListAsync(int userId,int page,int limit,bool desc);
/// <summary>
/// 新增好友请求
/// </summary>
/// <param name="friendRequest"></param>
/// <returns></returns>
Task<bool> SendFriendRequestAsync(FriendRequestDto friendRequest);
/// <summary>
/// 获取好友请求
/// </summary>
/// <param name="userId"></param>
/// <param name="isReceived">是否为接受请求方</param>
/// <param name="page"></param>
/// <param name="limit"></param>
/// <returns></returns>
Task<List<FriendRequestResDto>> GetFriendRequestListAsync(int userId,int page,int limit, bool desc);
/// <summary>
/// 处理好友请求
/// </summary>
/// <param name="requestDto"></param>
/// <returns></returns>
Task<bool> HandleFriendRequestAsync(HandleFriendRequestDto requestDto);
/// <summary>
/// 通过用户Id删除好友关系
/// </summary>
/// <param name="userId">操作用户Id</param>
/// <param name="toUserId">被删除用户ID</param>
/// <returns></returns>
Task<bool> DeleteFriendByUserIdAsync(int userId,int toUserId);
/// <summary>
/// 通过好友关系Id删除好友关系
/// </summary>
/// <param name="friendId">好友关系id</param>
/// <returns></returns>
Task<bool> DeleteFriendAsync(int friendId);
/// <summary>
/// 通过用户Id拉黑好友关系
/// </summary>
/// <param name="userId">操作用户Id</param>
/// <param name="toUserId">被拉黑用户ID</param>
/// <returns></returns>
Task<bool> BlockFriendByUserIdAsync(int userId, int toUserId);
/// <summary>
/// 通过好友关系Id拉黑好友关系
/// </summary>
/// <param name="friendId">好友关系id</param>
/// <returns></returns>
Task<bool> BlockeFriendAsync(int friendId);
/// <summary>
/// 创建好友关系
/// </summary>
/// <param name="userAId"></param>
/// <param name="userBId"></param>
/// <returns></returns>
Task MakeFriendshipAsync(int userAId, int userBId, string? remarkName);
}
}